@aquex/cmos-mcp 1.0.0

package/dist/tools/export-template.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * MCP Tool: export_template
+ *
+ * Exposes the template export functionality as an MCP tool
+ * for use in Claude Desktop and other MCP-compatible environments.
+ *
+ * Exports templates in Strict YAML format (safe for import).
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exportTemplateToolDefinitionDeprecated = exports.getTemplateExportToolDefinition = void 0;
+exports.exportTemplate = exportTemplate;
+exports.createTemplateFromMission = createTemplateFromMission;
+const path_1 = __importDefault(require("path"));
+const zod_1 = require("zod");
+const validation_error_1 = require("../errors/validation-error");
+const handler_1 = require("../errors/handler");
+const template_exporter_1 = require("../import-export/template-exporter");
+const common_1 = require("../validation/common");
+const middleware_1 = require("../validation/middleware");
+const file_path_schema_1 = require("../validation/schemas/file-path-schema");
+const template_schema_1 = require("../validation/schemas/template-schema");
+const errors_1 = require("../validation/errors");
+/**
+ * Main entry point for the export_template MCP tool
+ */
+async function exportTemplate(params) {
+    let contextData = {
+        outputPath: params.outputPath,
+        format: params.format ?? 'yaml',
+        templateName: params.template?.metadata?.name,
+        templateVersion: params.template?.metadata?.version,
+    };
+    try {
+        const validated = await validateParams(params);
+        contextData = {
+            outputPath: validated.outputPath,
+            format: validated.format ?? 'yaml',
+            templateName: validated.template.metadata.name,
+            templateVersion: validated.template.metadata.version,
+        };
+        // Determine base directory
+        const baseDir = validated.baseDir
+            ? await (0, common_1.safeFilePath)(path_1.default.resolve(validated.baseDir), { allowRelative: false })
+            : process.cwd();
+        // Build export options
+        const options = {
+            format: validated.format ?? 'yaml',
+            includeComments: validated.includeComments !== false, // Default true
+            pretty: validated.pretty !== false, // Default true
+        };
+        // Create exporter
+        const exporter = new template_exporter_1.TemplateExporter(baseDir);
+        const allowedExtensions = options.format === 'json' ? ['.json'] : ['.yaml', '.yml'];
+        const sanitizedOutputPath = await (0, common_1.safeFilePath)(validated.outputPath, {
+            allowRelative: true,
+            allowedExtensions,
+        });
+        // Execute export
+        const success = await exporter.export(validated.template, sanitizedOutputPath, options);
+        if (!success) {
+            throw new validation_error_1.ValidationError('Export operation failed', {
+                context: contextData,
+            });
+        }
+        // Generate preview
+        const content = exporter.exportToString(validated.template, options);
+        const preview = content.slice(0, 500) + (content.length > 500 ? '...' : '');
+        // Resolve output path for display
+        const resolvedPath = path_1.default.resolve(baseDir, sanitizedOutputPath);
+        return {
+            success: true,
+            outputPath: resolvedPath,
+            format: options.format,
+            message: `Template "${validated.template.metadata.name}" v${validated.template.metadata.version} exported successfully to ${resolvedPath}`,
+            preview,
+        };
+    }
+    catch (error) {
+        if (error instanceof errors_1.ValidationError) {
+            const maybeMessages = error.data?.messages;
+            const dataMessages = Array.isArray(maybeMessages)
+                ? maybeMessages.filter((message) => typeof message === 'string')
+                : undefined;
+            const detailMessages = dataMessages && dataMessages.length > 0
+                ? dataMessages
+                : error.issues?.map((issue) => issue.message).filter(Boolean);
+            const detail = detailMessages && detailMessages.length > 0 ? detailMessages[0] : error.message;
+            return {
+                success: false,
+                message: `Export failed: ${detail}`,
+            };
+        }
+        const missionError = handler_1.ErrorHandler.handle(error, 'tools.get_template_export.execute', {
+            module: 'tools/export-template',
+            data: contextData,
+        }, {
+            rethrow: false,
+        });
+        const publicError = handler_1.ErrorHandler.toPublicError(missionError);
+        const baseMessage = missionError.category === 'validation'
+            ? missionError.message
+            : publicError.message || 'Template export failed.';
+        const message = publicError.correlationId
+            ? `${baseMessage} (correlationId=${publicError.correlationId})`
+            : baseMessage;
+        return {
+            success: false,
+            message: `Export failed: ${message}`,
+        };
+    }
+}
+/**
+ * Validate input parameters
+ */
+const ExportTemplateParamsSchema = zod_1.z
+    .object({
+    template: template_schema_1.MissionTemplateSchema,
+    outputPath: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }),
+    baseDir: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }).optional(),
+    format: zod_1.z.enum(['yaml', 'json']).optional(),
+    includeComments: zod_1.z.boolean().optional(),
+    pretty: zod_1.z.boolean().optional(),
+})
+    .strict();
+async function validateParams(params) {
+    return (0, middleware_1.validateAndSanitize)(params, ExportTemplateParamsSchema);
+}
+/**
+ * Helper function to create a template from mission data
+ * Useful for converting existing mission files to templates
+ */
+function createTemplateFromMission(missionData, metadata) {
+    return {
+        apiVersion: 'mission-template.v1',
+        kind: 'MissionTemplate',
+        metadata,
+        spec: missionData,
+        dependencies: [],
+    };
+}
+/**
+ * MCP Tool Registration
+ * This would be called by the MCP server to register the tool
+ */
+exports.getTemplateExportToolDefinition = {
+    name: 'get_template_export',
+    description: 'Export a mission template to Strict YAML or JSON format. Uses safe serialization with no language-specific tags.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            template: {
+                type: 'object',
+                description: 'Mission template object conforming to mission-template.v1 schema',
+                required: ['apiVersion', 'kind', 'metadata', 'spec'],
+                properties: {
+                    apiVersion: {
+                        type: 'string',
+                        const: 'mission-template.v1',
+                    },
+                    kind: {
+                        type: 'string',
+                        const: 'MissionTemplate',
+                    },
+                    metadata: {
+                        type: 'object',
+                        description: 'Template metadata including name, version, author, and signature',
+                    },
+                    spec: {
+                        type: 'object',
+                        description: 'Mission specification (business logic)',
+                    },
+                    dependencies: {
+                        type: 'array',
+                        description: 'Optional array of template dependencies',
+                    },
+                },
+            },
+            outputPath: {
+                type: 'string',
+                description: 'Output file path (relative to baseDir)',
+            },
+            baseDir: {
+                type: 'string',
+                description: 'Base directory for export operations (optional, defaults to current directory)',
+            },
+            format: {
+                type: 'string',
+                enum: ['yaml', 'json'],
+                description: 'Export format: yaml (default) or json',
+            },
+            includeComments: {
+                type: 'boolean',
+                description: 'Include header comments in YAML output (default: true)',
+            },
+            pretty: {
+                type: 'boolean',
+                description: 'Pretty print output (default: true)',
+            },
+        },
+        required: ['template', 'outputPath'],
+    },
+};
+exports.exportTemplateToolDefinitionDeprecated = {
+    ...exports.getTemplateExportToolDefinition,
+    name: 'export_template',
+    description: '[DEPRECATED] Use get_template_export instead. Provides the same strict serialization workflow.',
+};
+//# sourceMappingURL=export-template.js.map

package/dist/tools/export-template.js.map

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

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

@@ -0,0 +1,106 @@
+/**
+ * MCP Tool: extract_template
+ *
+ * Exposes the template extraction functionality as an MCP tool
+ * for use in Claude Desktop and other MCP-compatible environments.
+ */
+import { ExtractionResult } from '../extraction/types';
+/**
+ * MCP Tool Interface for Template Extraction
+ */
+export interface ExtractTemplateParams {
+    /** Path to the source mission file or directory */
+    missionFile: string;
+    /** Name for the template (used to generate templateId) */
+    templateName: string;
+    /** Author name or email */
+    author: string;
+    /** Optional: Output directory for the template (defaults to ./templates) */
+    outputDir?: string;
+    /** Optional: Minimum confidence threshold (0.0 to 1.0, default 0.6) */
+    confidenceThreshold?: number;
+}
+/**
+ * Main entry point for the extract_template MCP tool
+ */
+export declare function extractTemplate(params: ExtractTemplateParams): Promise<ExtractionResult>;
+/**
+ * Write the extracted template to disk
+ */
+export declare function writeTemplate(templateDir: string, result: ExtractionResult): Promise<void>;
+/**
+ * Generate a human-readable extraction report
+ */
+export declare function generateExtractionReport(result: ExtractionResult): string;
+/**
+ * MCP Tool Registration
+ * Canonical specification for template extraction
+ */
+export declare const getTemplateExtractionToolDefinition: {
+    readonly name: "get_template_extraction";
+    readonly description: "Extract a reusable template from a successful mission using the three-stage hybrid extraction algorithm";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionFile: {
+                readonly type: "string";
+                readonly description: "Path to the source mission file or directory";
+            };
+            readonly templateName: {
+                readonly type: "string";
+                readonly description: "Name for the template (used to generate templateId)";
+            };
+            readonly author: {
+                readonly type: "string";
+                readonly description: "Author name or email";
+            };
+            readonly outputDir: {
+                readonly type: "string";
+                readonly description: "Output directory for the template (optional, defaults to ./templates)";
+            };
+            readonly confidenceThreshold: {
+                readonly type: "number";
+                readonly description: "Minimum confidence threshold for parameterization (0.0 to 1.0, default 0.6)";
+                readonly minimum: 0;
+                readonly maximum: 1;
+            };
+        };
+        readonly required: readonly ["missionFile", "templateName", "author"];
+    };
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+export declare const extractTemplateToolDefinitionDeprecated: {
+    readonly name: "extract_template";
+    readonly description: "[DEPRECATED] Use get_template_extraction instead. Performs the same three-stage extraction workflow.";
+    readonly inputSchema: {
+        readonly type: "object";
+        readonly properties: {
+            readonly missionFile: {
+                readonly type: "string";
+                readonly description: "Path to the source mission file or directory";
+            };
+            readonly templateName: {
+                readonly type: "string";
+                readonly description: "Name for the template (used to generate templateId)";
+            };
+            readonly author: {
+                readonly type: "string";
+                readonly description: "Author name or email";
+            };
+            readonly outputDir: {
+                readonly type: "string";
+                readonly description: "Output directory for the template (optional, defaults to ./templates)";
+            };
+            readonly confidenceThreshold: {
+                readonly type: "number";
+                readonly description: "Minimum confidence threshold for parameterization (0.0 to 1.0, default 0.6)";
+                readonly minimum: 0;
+                readonly maximum: 1;
+            };
+        };
+        readonly required: readonly ["missionFile", "templateName", "author"];
+    };
+};
+//# sourceMappingURL=extract-template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extract-template.d.ts","sourceRoot":"","sources":["../../src/tools/extract-template.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,OAAO,EAAoB,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAOzE;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mDAAmD;IACnD,WAAW,EAAE,MAAM,CAAC;IAEpB,0DAA0D;IAC1D,YAAY,EAAE,MAAM,CAAC;IAErB,2BAA2B;IAC3B,MAAM,EAAE,MAAM,CAAC;IAEf,4EAA4E;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,uEAAuE;IACvE,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA8E9F;AAuDD;;GAEG;AACH,wBAAsB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6DhG;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA8DzE;AAED;;;GAGG;AACH,eAAO,MAAM,mCAAmC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCtC,CAAC;AAEX;;GAEG;AACH,eAAO,MAAM,uCAAuC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAK1C,CAAC"}

package/dist/tools/extract-template.js

@@ -0,0 +1,322 @@
+"use strict";
+/**
+ * MCP Tool: extract_template
+ *
+ * Exposes the template extraction functionality as an MCP tool
+ * for use in Claude Desktop and other MCP-compatible environments.
+ */
+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.extractTemplateToolDefinitionDeprecated = exports.getTemplateExtractionToolDefinition = void 0;
+exports.extractTemplate = extractTemplate;
+exports.writeTemplate = writeTemplate;
+exports.generateExtractionReport = generateExtractionReport;
+const fs_1 = require("fs");
+const path = __importStar(require("path"));
+const zod_1 = require("zod");
+const template_extractor_1 = require("../extraction/template-extractor");
+const middleware_1 = require("../validation/middleware");
+const file_path_schema_1 = require("../validation/schemas/file-path-schema");
+const errors_1 = require("../validation/errors");
+const fs_2 = require("../utils/fs");
+const workspace_io_1 = require("../utils/workspace-io");
+/**
+ * Main entry point for the extract_template MCP tool
+ */
+async function extractTemplate(params) {
+    try {
+        const validated = await validateParams(params);
+        const missionPath = validated.missionFile;
+        // Determine if it's a file or directory
+        const stats = await fs_1.promises.stat(missionPath);
+        const sourcePath = stats.isDirectory() ? missionPath : path.dirname(missionPath);
+        // Create extraction config
+        const config = {
+            sourceMissionPath: sourcePath,
+            author: validated.author,
+            confidenceThreshold: validated.confidenceThreshold ?? 0.6,
+            enableASTAnalysis: true,
+            excludePatterns: [
+                'node_modules/**',
+                '.git/**',
+                'dist/**',
+                'build/**',
+                '*.log',
+                '.env',
+                '.env.*',
+            ],
+        };
+        // Run the extraction
+        const extractor = new template_extractor_1.TemplateExtractor(config);
+        const result = await extractor.extract();
+        // If successful, write the template to disk
+        if (result.success && result.template) {
+            const outputDir = validated.outputDir ?? (await (0, workspace_io_1.resolveWorkspacePath)('templates', { allowRelative: true }));
+            await (0, fs_2.ensureDir)(outputDir);
+            const templateDir = await (0, workspace_io_1.resolveWorkspacePath)(validated.templateName, {
+                allowRelative: true,
+                baseDir: outputDir,
+            });
+            await writeTemplate(templateDir, result);
+            console.error(`[INFO] Template extracted successfully to: ${path.resolve(templateDir)}`);
+            console.error(`[INFO] Files analyzed: ${result.stage1?.filesAnalyzed || 0}`);
+            console.error(`[INFO] Parameters generated: ${result.stage2?.parametersGenerated || 0}`);
+            console.error(`[INFO] Total time: ${result.totalTime}ms`);
+        }
+        return result;
+    }
+    catch (error) {
+        if (error instanceof errors_1.ValidationError) {
+            const maybeMessages = error.data?.messages;
+            const dataMessages = Array.isArray(maybeMessages)
+                ? maybeMessages.filter((message) => typeof message === 'string')
+                : undefined;
+            const detailMessages = dataMessages && dataMessages.length > 0
+                ? dataMessages
+                : error.issues?.map((issue) => issue.message).filter(Boolean);
+            const detail = detailMessages && detailMessages.length > 0 ? detailMessages[0] : error.message;
+            const errorsList = detailMessages && detailMessages.length > 0 ? detailMessages : [detail];
+            return {
+                success: false,
+                errors: errorsList,
+                totalTime: 0,
+            };
+        }
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            errors: [errorMessage],
+            totalTime: 0,
+        };
+    }
+}
+const ExtractTemplateParamsSchema = zod_1.z
+    .object({
+    missionFile: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }),
+    templateName: zod_1.z
+        .string()
+        .min(3)
+        .max(64)
+        .regex(/^[a-zA-Z0-9-_]+$/, 'templateName must contain only alphanumeric characters, hyphens, and underscores'),
+    author: zod_1.z.string().min(1).max(128),
+    outputDir: (0, file_path_schema_1.createFilePathSchema)({ allowRelative: true }).optional(),
+    confidenceThreshold: zod_1.z
+        .number({
+        invalid_type_error: 'confidenceThreshold must be a number',
+    })
+        .refine((value) => value >= 0 && value <= 1, {
+        message: 'confidenceThreshold must be between 0.0 and 1.0',
+    })
+        .optional(),
+})
+    .strict();
+async function validateParams(params) {
+    const validated = await (0, middleware_1.validateAndSanitize)(params, ExtractTemplateParamsSchema);
+    const sanitizedMissionFile = (await (0, workspace_io_1.resolveWorkspacePath)(validated.missionFile, {
+        allowRelative: true,
+        maxLength: 2048,
+    }));
+    if (!(await (0, fs_2.pathExists)(sanitizedMissionFile))) {
+        throw new Error(`Mission file does not exist: ${validated.missionFile}`);
+    }
+    const sanitizedOutputDir = validated.outputDir
+        ? (await (0, workspace_io_1.resolveWorkspacePath)(validated.outputDir, {
+            allowRelative: true,
+        }))
+        : undefined;
+    return {
+        ...validated,
+        missionFile: sanitizedMissionFile,
+        outputDir: sanitizedOutputDir,
+    };
+}
+/**
+ * Write the extracted template to disk
+ */
+async function writeTemplate(templateDir, result) {
+    if (!result.template) {
+        throw new Error('No template to write');
+    }
+    const { template } = result;
+    // Create template directory
+    const sanitizedDir = await (0, workspace_io_1.resolveWorkspacePath)(templateDir, { allowRelative: true });
+    await (0, fs_2.ensureDir)(sanitizedDir);
+    const writeTasks = template.fileStructure.map((file) => async () => {
+        const filePath = await (0, workspace_io_1.resolveWorkspacePath)(file.path, {
+            allowRelative: true,
+            baseDir: sanitizedDir,
+            maxLength: 4096,
+        });
+        await (0, fs_2.writeFileAtomic)(filePath, file.content, { encoding: 'utf-8' });
+    });
+    if (writeTasks.length > 0) {
+        await (0, fs_2.runWithConcurrency)(writeTasks, Math.min(8, writeTasks.length));
+    }
+    // Write metadata file
+    const metadataPath = await (0, workspace_io_1.resolveWorkspacePath)('template-metadata.json', {
+        allowRelative: true,
+        baseDir: sanitizedDir,
+    });
+    await (0, fs_2.writeFileAtomic)(metadataPath, JSON.stringify(template.metadata, null, 2), {
+        encoding: 'utf-8',
+    });
+    // Write extraction report
+    const reportPath = await (0, workspace_io_1.resolveWorkspacePath)('EXTRACTION_REPORT.md', {
+        allowRelative: true,
+        baseDir: sanitizedDir,
+    });
+    const report = generateExtractionReport(result);
+    await (0, fs_2.writeFileAtomic)(reportPath, report, { encoding: 'utf-8' });
+    // Write hooks if present
+    if (template.hooks?.preGenerate) {
+        const preHookPath = await (0, workspace_io_1.resolveWorkspacePath)(path.join('hooks', 'pre_gen_project.sh'), {
+            allowRelative: true,
+            baseDir: sanitizedDir,
+        });
+        await (0, fs_2.ensureDir)(path.dirname(preHookPath));
+        await (0, fs_2.writeFileAtomic)(preHookPath, template.hooks.preGenerate, { encoding: 'utf-8' });
+        await (0, fs_2.chmod)(preHookPath, 0o755);
+    }
+    if (template.hooks?.postGenerate) {
+        const postHookPath = await (0, workspace_io_1.resolveWorkspacePath)(path.join('hooks', 'post_gen_project.sh'), {
+            allowRelative: true,
+            baseDir: sanitizedDir,
+        });
+        await (0, fs_2.ensureDir)(path.dirname(postHookPath));
+        await (0, fs_2.writeFileAtomic)(postHookPath, template.hooks.postGenerate, { encoding: 'utf-8' });
+        await (0, fs_2.chmod)(postHookPath, 0o755);
+    }
+}
+/**
+ * Generate a human-readable extraction report
+ */
+function generateExtractionReport(result) {
+    const { template, stage1, stage2, totalTime } = result;
+    if (!template) {
+        return '# Extraction Report\n\nExtraction failed. See errors for details.';
+    }
+    let report = '# Template Extraction Report\n\n';
+    report += `## Summary\n\n`;
+    report += `- **Template ID**: ${template.metadata.templateId}\n`;
+    report += `- **Template Name**: ${template.metadata.name}\n`;
+    report += `- **Source Mission**: ${template.metadata.sourceMissionId}\n`;
+    report += `- **Author**: ${template.metadata.author}\n`;
+    report += `- **Generated**: ${template.metadata.creationDate}\n`;
+    report += `\n`;
+    report += `## Performance Metrics\n\n`;
+    report += `- **Total Execution Time**: ${totalTime}ms\n`;
+    report += `- **Stage 1 (Candidate Identification)**: ${stage1?.executionTime}ms\n`;
+    report += `- **Stage 2 (Parameterization)**: ${stage2?.executionTime}ms\n`;
+    report += `- **Files Analyzed**: ${stage1?.filesAnalyzed}\n`;
+    report += `- **Parameters Generated**: ${stage2?.parametersGenerated}\n`;
+    report += `\n`;
+    report += `## Extracted Parameters\n\n`;
+    report += `| Parameter | Type | Description | Default | Required |\n`;
+    report += `|-----------|------|-------------|---------|----------|\n`;
+    for (const [name, param] of Object.entries(template.metadata.parameters)) {
+        report += `| ${name} | ${param.type} | ${param.description} | ${param.default} | ${param.required ? 'Yes' : 'No'} |\n`;
+    }
+    report += `\n`;
+    report += `## Template Structure\n\n`;
+    report += `\`\`\`\n`;
+    for (const file of template.fileStructure) {
+        const prefix = file.optional ? '[OPTIONAL] ' : '';
+        report += `${prefix}${file.path}\n`;
+    }
+    report += `\`\`\`\n\n`;
+    report += `## Next Steps\n\n`;
+    report += `1. **Review Parameters**: Validate that parameter names and types are correct\n`;
+    report += `2. **Test Template**: Generate a test project using this template\n`;
+    report += `3. **Refine Logic**: Add any conditional blocks for optional features\n`;
+    report += `4. **Documentation**: Update template description and parameter descriptions\n`;
+    report += `5. **Publish**: Add template to the domain pack catalog\n`;
+    report += `\n`;
+    report += `## Human-in-the-Loop Refinement (Stage 3)\n\n`;
+    report += `This template has been auto-generated using Stages 1 and 2 of the extraction algorithm.\n`;
+    report += `The final Stage 3 (Human-in-the-Loop Refinement) requires manual review and enhancement:\n\n`;
+    report += `- [ ] Validate and rename auto-generated parameter names\n`;
+    report += `- [ ] Adjust parameter types and default values\n`;
+    report += `- [ ] Add or refine conditional logic for optional features\n`;
+    report += `- [ ] Enrich metadata with better descriptions and tags\n`;
+    report += `- [ ] Add validation rules (regex patterns) for string parameters\n`;
+    report += `- [ ] Test the template by generating a new mission\n`;
+    report += `\n`;
+    return report;
+}
+/**
+ * MCP Tool Registration
+ * Canonical specification for template extraction
+ */
+exports.getTemplateExtractionToolDefinition = {
+    name: 'get_template_extraction',
+    description: 'Extract a reusable template from a successful mission using the three-stage hybrid extraction algorithm',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            missionFile: {
+                type: 'string',
+                description: 'Path to the source mission file or directory',
+            },
+            templateName: {
+                type: 'string',
+                description: 'Name for the template (used to generate templateId)',
+            },
+            author: {
+                type: 'string',
+                description: 'Author name or email',
+            },
+            outputDir: {
+                type: 'string',
+                description: 'Output directory for the template (optional, defaults to ./templates)',
+            },
+            confidenceThreshold: {
+                type: 'number',
+                description: 'Minimum confidence threshold for parameterization (0.0 to 1.0, default 0.6)',
+                minimum: 0,
+                maximum: 1,
+            },
+        },
+        required: ['missionFile', 'templateName', 'author'],
+    },
+};
+/**
+ * Legacy alias maintained for one release cycle
+ */
+exports.extractTemplateToolDefinitionDeprecated = {
+    ...exports.getTemplateExtractionToolDefinition,
+    name: 'extract_template',
+    description: '[DEPRECATED] Use get_template_extraction instead. Performs the same three-stage extraction workflow.',
+};
+//# sourceMappingURL=extract-template.js.map