@aquex/cmos-mcp 1.0.0

package/dist/tools/combine-packs.js

@@ -0,0 +1,283 @@
+"use strict";
+/**
+ * combine_packs MCP Tool
+ *
+ * Combines multiple domain packs into a single cohesive pack with
+ * dependency resolution and merge strategy support.
+ *
+ * Algorithm:
+ * 1. Validate input pack names
+ * 2. Load packs from registry
+ * 3. Resolve dependencies
+ * 4. Combine using specified strategy
+ * 5. Return combined pack as YAML
+ *
+ * @module tools/combine-packs
+ */
+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.CombinePacksToolImpl = exports.combinePacksToolDefinitionDeprecated = exports.createCombinedPackToolDefinition = void 0;
+exports.createCombinePacksTool = createCombinePacksTool;
+exports.handleCombinePacks = handleCombinePacks;
+const YAML = __importStar(require("yaml"));
+const pack_combiner_1 = require("../combination/pack-combiner");
+/**
+ * MCP Tool Definition for creating combined packs
+ */
+exports.createCombinedPackToolDefinition = {
+    name: 'create_combined_pack',
+    description: 'Combines multiple domain packs into a single cohesive pack. Automatically resolves dependencies, ' +
+        'detects circular dependencies, and applies the specified merge strategy. Use this tool when you need ' +
+        'to create a mission that uses functionality from multiple domain packs.',
+    inputSchema: {
+        type: 'object',
+        required: ['packNames'],
+        properties: {
+            packNames: {
+                type: 'array',
+                items: { type: 'string' },
+                minItems: 1,
+                description: 'Array of domain pack names to combine (use get_available_domains to see options)',
+            },
+            strategy: {
+                type: 'string',
+                enum: ['deep-merge', 'override', 'selective'],
+                default: 'deep-merge',
+                description: 'Merge strategy: "deep-merge" (recursive merge), "override" (last wins), or "selective" (user-controlled)',
+            },
+            overridePaths: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'For selective strategy: field paths to override (e.g., ["spec.resources"])',
+            },
+            mergePaths: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'For selective strategy: field paths to merge (e.g., ["spec.dependencies"])',
+            },
+            resolveDependencies: {
+                type: 'boolean',
+                default: true,
+                description: 'Whether to automatically resolve and include dependencies',
+            },
+            format: {
+                type: 'string',
+                enum: ['yaml', 'json'],
+                default: 'yaml',
+                description: 'Output format for the combined pack',
+            },
+        },
+    },
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+exports.combinePacksToolDefinitionDeprecated = {
+    ...exports.createCombinedPackToolDefinition,
+    name: 'combine_packs',
+    description: '[DEPRECATED] Use create_combined_pack instead. Provides the same multi-pack combination workflow.',
+};
+/**
+ * CombinePacksToolImpl
+ *
+ * Main implementation class for pack combination
+ */
+class CombinePacksToolImpl {
+    constructor(packLoader, combiner, registry, loader) {
+        this.packLoader = packLoader;
+        this.combiner = combiner;
+        this.registry = registry;
+        this.loader = loader;
+    }
+    /**
+     * Execute the combine_packs tool
+     *
+     * @param params - Tool parameters
+     * @param registryPath - Path to domain pack registry
+     * @returns Combined pack as formatted string with metadata
+     */
+    async execute(params, registryPath) {
+        try {
+            // Step 1: Validate inputs
+            if (!params.packNames || params.packNames.length === 0) {
+                return {
+                    success: false,
+                    errors: ['At least one pack name is required'],
+                };
+            }
+            if (params.strategy === 'selective') {
+                if (!params.overridePaths && !params.mergePaths) {
+                    return {
+                        success: false,
+                        errors: ['Selective strategy requires at least one of overridePaths or mergePaths'],
+                    };
+                }
+            }
+            // Step 2: Load registry
+            const registryEntries = await this.registry.loadRegistry(registryPath);
+            // Step 3: Load all available packs (for dependency resolution)
+            const availablePacks = await Promise.all(registryEntries.map((entry) => this.packLoader.loadPack(entry.name, registryEntries)));
+            // Step 4: Load requested packs
+            const requestedPacks = await Promise.all(params.packNames.map((name) => this.packLoader.loadPack(name, registryEntries)));
+            // Step 5: Combine packs
+            const result = this.combiner.combine(requestedPacks, availablePacks, {
+                strategy: params.strategy || 'deep-merge',
+                overridePaths: params.overridePaths,
+                mergePaths: params.mergePaths,
+                resolveDependencies: params.resolveDependencies ?? true,
+                validate: true,
+            });
+            if (!result.success || !result.combinedPack) {
+                return {
+                    success: false,
+                    errors: result.errors,
+                    warnings: result.warnings,
+                };
+            }
+            // Step 6: Format output
+            const format = params.format || 'yaml';
+            const combinedPackStr = this.formatOutput(result.combinedPack, format);
+            return {
+                success: true,
+                combinedPack: combinedPackStr,
+                loadOrder: result.dependencyResolution?.loadOrder || [],
+                errors: result.errors,
+                warnings: result.warnings,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return {
+                    success: false,
+                    errors: [error.message],
+                };
+            }
+            return {
+                success: false,
+                errors: ['Unknown error occurred during pack combination'],
+            };
+        }
+    }
+    /**
+     * Preview pack combination without executing
+     *
+     * @param params - Tool parameters
+     * @param registryPath - Path to domain pack registry
+     * @returns Preview information
+     */
+    async preview(params, registryPath) {
+        try {
+            // Load registry and packs
+            const registryEntries = await this.registry.loadRegistry(registryPath);
+            const availablePacks = await Promise.all(registryEntries.map((entry) => this.packLoader.loadPack(entry.name, registryEntries)));
+            const requestedPacks = await Promise.all(params.packNames.map((name) => this.packLoader.loadPack(name, registryEntries)));
+            // Get preview
+            const preview = this.combiner.preview(requestedPacks, availablePacks, {
+                strategy: params.strategy || 'deep-merge',
+                resolveDependencies: params.resolveDependencies ?? true,
+            });
+            return {
+                success: preview.warnings.length === 0,
+                loadOrder: preview.loadOrder,
+                dependencies: preview.dependencies.loadOrder,
+                warnings: preview.warnings,
+                errors: [],
+            };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                return {
+                    success: false,
+                    errors: [error.message],
+                };
+            }
+            return {
+                success: false,
+                errors: ['Unknown error occurred during preview'],
+            };
+        }
+    }
+    /**
+     * Format combined pack as YAML or JSON
+     */
+    formatOutput(combinedPack, format) {
+        if (format === 'json') {
+            return JSON.stringify(combinedPack, null, 2);
+        }
+        // YAML format (default)
+        const doc = new YAML.Document(combinedPack);
+        return doc.toString();
+    }
+}
+exports.CombinePacksToolImpl = CombinePacksToolImpl;
+/**
+ * Factory function to create tool instance
+ */
+function createCombinePacksTool(packLoader, registry, loader) {
+    const combiner = new pack_combiner_1.PackCombiner();
+    return new CombinePacksToolImpl(packLoader, combiner, registry, loader);
+}
+/**
+ * Tool handler function for MCP server integration
+ */
+async function handleCombinePacks(params, registryPath, packLoader, registry, loader) {
+    const tool = createCombinePacksTool(packLoader, registry, loader);
+    const result = await tool.execute(params, registryPath);
+    if (!result.success) {
+        const errors = result.errors?.join('\n') || 'Unknown error';
+        throw new Error(`Pack combination failed:\n${errors}`);
+    }
+    // Format response with metadata
+    let response = `✓ Successfully combined ${params.packNames.length} pack(s)\n\n`;
+    if (result.loadOrder && result.loadOrder.length > 0) {
+        response += `Load order (dependency-resolved):\n`;
+        result.loadOrder.forEach((name, i) => {
+            response += `  ${i + 1}. ${name}\n`;
+        });
+        response += '\n';
+    }
+    if (result.warnings && result.warnings.length > 0) {
+        response += `Warnings:\n`;
+        result.warnings.forEach((w) => {
+            response += `  ⚠ ${w}\n`;
+        });
+        response += '\n';
+    }
+    response += `Combined Pack:\n`;
+    response += `${'='.repeat(60)}\n`;
+    response += result.combinedPack || '';
+    return response;
+}
+//# sourceMappingURL=combine-packs.js.map

package/dist/tools/combine-packs.js.map

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

package/dist/tools/create-mission.d.ts

@@ -0,0 +1,192 @@
+/**
+ * create_mission MCP Tool
+ *
+ * Creates a new mission by combining generic template with optional domain-specific fields.
+ * Returns validated mission YAML ready for execution.
+ *
+ * Algorithm:
+ * 1. Load generic mission template
+ * 2. Generate unique mission ID
+ * 3. Populate core fields from params
+ * 4. If domain specified, load and merge domainFields
+ * 5. Validate final mission against schema
+ * 6. Return YAML string
+ *
+ * @module tools/create-mission
+ * @version 1.0
+ */
+import { SecureYAMLLoader } from '../loaders/yaml-loader';
+import { RegistryParser } from '../registry/registry-parser';
+import { DomainPackLoader } from '../domains/domain-pack-loader';
+import { MissionMerger } from '../merge/deep-merge';
+import { DomainPackEntry } from '../types/registry';
+/**
+ * Parameters for create_mission tool
+ */
+export interface CreateMissionParams {
+    /** Clear, concise mission objective (required) */
+    objective: string;
+    /** Optional domain pack name */
+    domain?: string;
+    /** Optional success criteria list */
+    successCriteria?: string[];
+    /** Optional constraints list */
+    constraints?: string[];
+    /** Output format: yaml (default) or json */
+    outputFormat?: 'yaml' | 'json';
+    /** Optional mission ID (used as suggested_id in JSON format) */
+    missionId?: string;
+    /** Optional sprint ID (included in JSON output if provided) */
+    sprintId?: string;
+    /** Optional context description (included in JSON output if provided) */
+    context?: string;
+}
+/**
+ * MCP Tool Definition for create_mission
+ */
+export declare const createMissionToolDefinition: {
+    readonly name: "create_mission";
+    readonly description: "Use this tool to create a new mission based on a user's request. You must provide a clear and concise objective. You can optionally specify a domain from the list provided by get_available_domains (formerly list_available_domains). If no domain is specified, a generic mission will be created.\n\nOutput formats:\n- yaml (default): Rich YAML template for human editing\n- json: Structured JSON for database ingestion (e.g., CMOS)\n\nWhen using json format, Mission Protocol provides a suggested_id and clean structure. The consuming system handles ID assignment, defaults, and storage validation.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly required: readonly ["objective"];
+        readonly properties: {
+            readonly objective: {
+                readonly type: "string";
+                readonly description: "Clear, concise mission goal describing what success looks like";
+            };
+            readonly domain: {
+                readonly type: "string";
+                readonly description: "Optional domain pack name (use get_available_domains to see available options)";
+            };
+            readonly successCriteria: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional array of measurable success conditions";
+            };
+            readonly constraints: {
+                readonly type: "array";
+                readonly items: {
+                    readonly type: "string";
+                };
+                readonly description: "Optional array of limitations or boundaries";
+            };
+            readonly outputFormat: {
+                readonly type: "string";
+                readonly enum: readonly ["yaml", "json"];
+                readonly description: "Output format: yaml (default) for templates, json for database ingestion";
+            };
+            readonly missionId: {
+                readonly type: "string";
+                readonly description: "Optional mission ID (used as suggested_id in JSON format)";
+            };
+            readonly sprintId: {
+                readonly type: "string";
+                readonly description: "Optional sprint ID (included in JSON output if provided)";
+            };
+            readonly context: {
+                readonly type: "string";
+                readonly description: "Optional context description (included in JSON output if provided)";
+            };
+        };
+        readonly additionalProperties: false;
+    };
+};
+/**
+ * CreateMissionToolImpl
+ *
+ * Main implementation class for mission creation
+ */
+export declare class CreateMissionToolImpl {
+    private packLoader;
+    private merger;
+    private registry;
+    private loader;
+    private ajv;
+    constructor(packLoader: DomainPackLoader, merger: MissionMerger, registry: RegistryParser, loader: SecureYAMLLoader);
+    /**
+     * Execute mission creation
+     *
+     * @param params - Mission creation parameters
+     * @param registryEntries - Available domain pack entries
+     * @returns Formatted mission (YAML or JSON) depending on outputFormat
+     * @throws Error if validation fails or domain not found
+     */
+    execute(params: CreateMissionParams, registryEntries: DomainPackEntry[]): Promise<string>;
+    /**
+     * Validate input parameters
+     *
+     * @param params - Parameters to validate
+     * @throws Error if validation fails
+     */
+    private validateParams;
+    private buildContextFromParams;
+    /**
+     * Generate unique mission ID using timestamp and random suffix
+     *
+     * Format: mission-YYYYMMDD-HHmmss-rrr
+     *
+     * @returns Unique mission ID
+     */
+    private generateMissionId;
+    /**
+     * Load generic mission template from templates directory
+     *
+     * @returns Generic mission template object
+     * @throws Error if template cannot be loaded
+     */
+    private loadGenericTemplate;
+    /**
+     * Populate core fields from parameters
+     *
+     * @param template - Base generic template
+     * @param params - User-provided parameters
+     * @param missionId - Generated mission ID
+     * @returns Mission with populated core fields
+     */
+    private populateCoreFields;
+    /**
+     * Merge mission with domain-specific fields
+     *
+     * @param mission - Base mission object
+     * @param domainName - Name of domain pack to merge
+     * @param registryEntries - Available registry entries
+     * @returns Mission with merged domain fields
+     * @throws Error if domain not found or merge fails
+     */
+    private mergeWithDomain;
+    /**
+     * Validate mission against schema
+     *
+     * @param mission - Mission object to validate
+     * @throws Error if validation fails
+     */
+    private validateMission;
+    /**
+     * Convert mission object to YAML string
+     *
+     * @param mission - Mission object to serialize
+     * @returns Formatted YAML string
+     */
+    private toYAML;
+    /**
+     * Convert mission object to JSON format
+     *
+     * @param mission - Mission object to format
+     * @param params - Original parameters (for optional fields)
+     * @returns Formatted JSON string
+     */
+    private toJSON;
+    /**
+     * Format mission YAML for LLM consumption
+     *
+     * Adds helpful context and formatting for Claude to understand the output
+     *
+     * @param yamlString - YAML string to format
+     * @returns Formatted string for LLM
+     */
+    formatForLLM(yamlString: string): string;
+}
+//# sourceMappingURL=create-mission.d.ts.map

package/dist/tools/create-mission.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-mission.d.ts","sourceRoot":"","sources":["../../src/tools/create-mission.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAWpD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,kDAAkD;IAClD,SAAS,EAAE,MAAM,CAAC;IAElB,gCAAgC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,qCAAqC;IACrC,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAE3B,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IAEvB,4CAA4C;IAC5C,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE/B,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,yEAAyE;IACzE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,2BAA2B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+C9B,CAAC;AAEX;;;;GAIG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,UAAU,CAAmB;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,QAAQ,CAAiB;IACjC,OAAO,CAAC,MAAM,CAAmB;IACjC,OAAO,CAAC,GAAG,CAAM;gBAGf,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,cAAc,EACxB,MAAM,EAAE,gBAAgB;IAS1B;;;;;;;OAOG;IACG,OAAO,CAAC,MAAM,EAAE,mBAAmB,EAAE,eAAe,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAyC/F;;;;;OAKG;IACH,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,sBAAsB;IAc9B;;;;;;OAMG;IACH,OAAO,CAAC,iBAAiB;IAezB;;;;;OAKG;YACW,mBAAmB;IAsBjC;;;;;;;OAOG;IACH,OAAO,CAAC,kBAAkB;IA0B1B;;;;;;;;OAQG;YACW,eAAe;IA2C7B;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IAoDvB;;;;;OAKG;IACH,OAAO,CAAC,MAAM;IA2Bd;;;;;;OAMG;IACH,OAAO,CAAC,MAAM;IAkCd;;;;;;;OAOG;IACH,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;CAiBzC"}