@machina.ai/openapi-contract-tester 2.1.0

package/dist/mcp/handlers/compare-sources.js

@@ -0,0 +1,182 @@
+/**
+ * Compare Sources Handler
+ *
+ * Handles the compare-sources tool which compares OpenAPI spec vs Code vs PRD.
+ *
+ * @module mcp/handlers/compare-sources
+ */
+import { BaseToolHandler } from './base-handler.js';
+import { compareSources } from '../../analyzers/source-comparator.js';
+/**
+ * Handler for source comparison tool
+ */
+export class CompareSourcesHandler extends BaseToolHandler {
+    specService;
+    fileService;
+    name = 'compare-sources';
+    description = 'STANDALONE TOOL — Compare an OpenAPI specification against actual code endpoints and/or a PRD ' +
+        'to find gaps and inconsistencies. ' +
+        'Use this when you want to verify that the spec matches what is actually implemented in the code, ' +
+        'or that all PRD requirements are covered by the spec. ' +
+        'Returns lists of: endpoints in spec but missing from code, endpoints in code but missing from spec, ' +
+        'and endpoints that exist in both but differ (method, path, auth requirements). ' +
+        'This is independent of generate-tests/run-tests — it does not execute any HTTP requests. ' +
+        'Enable enableSemanticAnalysis=true for AI-powered matching that handles renamed or refactored endpoints.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            specPath: {
+                type: 'string',
+                description: 'Path to the OpenAPI specification file (YAML or JSON) to use as the source of truth. ' +
+                    'Example: "/project/api/openapi.yaml".'
+            },
+            codeEndpoints: {
+                type: 'array',
+                description: 'List of endpoints actually implemented in the source code. ' +
+                    'Each item must have at minimum "method" and "path". ' +
+                    'Example: [{ "method": "GET", "path": "/users/{id}", "sourceFile": "src/routes/users.ts", "requiresAuth": true }].',
+                items: {
+                    type: 'object',
+                    properties: {
+                        method: {
+                            type: 'string',
+                            description: 'HTTP method in uppercase: GET, POST, PUT, PATCH, DELETE'
+                        },
+                        path: {
+                            type: 'string',
+                            description: 'Endpoint path with parameters in curly-brace format, e.g. /users/{id}'
+                        },
+                        sourceFile: {
+                            type: 'string',
+                            description: 'Source file where this endpoint is defined (optional, for traceability)'
+                        },
+                        handlerName: {
+                            type: 'string',
+                            description: 'Name of the handler function or controller method (optional)'
+                        },
+                        requiresAuth: {
+                            type: 'boolean',
+                            description: 'Whether the endpoint requires authentication (optional)'
+                        },
+                        parameters: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Parameter names accepted by this endpoint (optional)'
+                        }
+                    },
+                    required: ['method', 'path']
+                }
+            },
+            prdPath: {
+                type: 'string',
+                description: 'Path to a Product Requirements Document (Markdown, JSON, or YAML). ' +
+                    'When provided, the comparison also checks whether PRD requirements are covered by the spec. ' +
+                    'Example: "/project/docs/prd.md".'
+            },
+            format: {
+                type: 'string',
+                enum: ['json', 'html'],
+                description: 'Output format. ' +
+                    'json: returns comparison data as structured JSON (default, useful for programmatic use). ' +
+                    'html: generates an interactive HTML report saved to outputPath.'
+            },
+            outputPath: {
+                type: 'string',
+                description: 'File path where the HTML report is saved. Required when format="html". ' +
+                    'Example: "/tmp/comparison-report.html".'
+            },
+            workingDirectory: {
+                type: 'string',
+                description: 'Working directory used to resolve relative file paths for specPath and prdPath.'
+            },
+            enableSemanticAnalysis: {
+                type: 'boolean',
+                description: 'Enable AI-powered semantic matching (default: false). ' +
+                    'When true, uses an LLM to match endpoints that differ by name but serve the same purpose ' +
+                    '(e.g., /user vs /users/{id}). Slower but more accurate for refactored codebases.'
+            }
+        },
+        required: ['specPath']
+    };
+    constructor(specService, fileService) {
+        super();
+        this.specService = specService;
+        this.fileService = fileService;
+    }
+    async handle(args) {
+        const params = args;
+        const format = params.format || 'json';
+        const enableSemanticAnalysis = params.enableSemanticAnalysis || false;
+        this.log.info('Comparing sources', {
+            specPath: params.specPath,
+            hasCodeEndpoints: !!params.codeEndpoints,
+            hasPrd: !!params.prdPath,
+            format,
+            enableSemanticAnalysis
+        });
+        try {
+            // Parse OpenAPI spec
+            const specPath = this.fileService.resolveFilePath(params.specPath, params.workingDirectory);
+            const spec = await this.specService.parseSpec(specPath);
+            const openApiEndpoints = await this.specService.extractEndpoints(spec);
+            this.log.info('Extracted OpenAPI endpoints', {
+                count: openApiEndpoints.length,
+                sample: openApiEndpoints.slice(0, 3).map(e => `${e.method} ${e.path}`)
+            });
+            // Load PRD if provided
+            let prd;
+            if (params.prdPath) {
+                prd = await this.fileService.loadPrd(params.prdPath, params.workingDirectory);
+            }
+            // Compare sources
+            const result = compareSources(openApiEndpoints, params.codeEndpoints, prd, { normalizePathParams: true, includeInfo: true });
+            // Run semantic analysis if enabled and code endpoints available
+            let semanticAnalysis;
+            if (enableSemanticAnalysis && params.codeEndpoints && params.codeEndpoints.length > 0) {
+                this.log.info('Running AI-powered semantic analysis');
+                try {
+                    const { performSemanticAnalysis } = await import('../../analyzers/semantic-matcher.js');
+                    semanticAnalysis = await performSemanticAnalysis(openApiEndpoints, params.codeEndpoints, prd);
+                    this.log.info('Semantic analysis complete', {
+                        semanticMatches: semanticAnalysis.semanticMatches.length,
+                        semanticMismatches: semanticAnalysis.semanticMismatches.length,
+                        businessRuleMappings: semanticAnalysis.businessRuleMappings.length
+                    });
+                }
+                catch (error) {
+                    this.log.warn('Semantic analysis failed', { error });
+                    // Continue without semantic analysis - not fatal
+                }
+            }
+            // Add semantic analysis to result
+            const enhancedResult = semanticAnalysis
+                ? { ...result, semanticAnalysis }
+                : result;
+            // Handle output format
+            if (format === 'html') {
+                if (!params.outputPath) {
+                    throw new Error('outputPath is required when format=html');
+                }
+                const { generateComparisonHtmlReport } = await import('../../reporters/comparison-report-generator.js');
+                const htmlContent = generateComparisonHtmlReport(enhancedResult);
+                await this.fileService.saveFile(params.outputPath, htmlContent, params.workingDirectory);
+                return this.formatResponse({
+                    success: true,
+                    format: 'html',
+                    outputPath: params.outputPath,
+                    summary: result.summary,
+                    semanticAnalysisIncluded: !!semanticAnalysis
+                });
+            }
+            // Default: JSON format
+            return this.formatResponse({
+                success: true,
+                data: enhancedResult
+            });
+        }
+        catch (error) {
+            return this.formatError(error);
+        }
+    }
+}
+//# sourceMappingURL=compare-sources.js.map

package/dist/mcp/handlers/compare-sources.js.map

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

package/dist/mcp/handlers/export-results.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Export Results Handler
+ *
+ * Handles the export-results tool which formats and exports test results.
+ *
+ * @module mcp/handlers/export-results
+ */
+import { BaseToolHandler } from './base-handler.js';
+import type { ToolResponse } from './types.js';
+import { ReportService } from '../services/report-service.js';
+import { FileService } from '../services/file-service.js';
+/**
+ * Handler for results export tool
+ */
+export declare class ExportResultsHandler extends BaseToolHandler {
+    private reportService;
+    private fileService;
+    readonly name = "export-results";
+    readonly description: string;
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            results: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                };
+            };
+            format: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            outputPath: {
+                type: string;
+                description: string;
+            };
+            includeCharts: {
+                type: string;
+                description: string;
+            };
+            title: {
+                type: string;
+                description: string;
+            };
+        };
+        required: string[];
+    };
+    constructor(reportService: ReportService, fileService: FileService);
+    handle(args: unknown): Promise<ToolResponse>;
+}
+//# sourceMappingURL=export-results.d.ts.map

package/dist/mcp/handlers/export-results.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-results.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/export-results.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAK1D;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,eAAe;IAiDrD,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,WAAW;IAjDrB,QAAQ,CAAC,IAAI,oBAAoB;IACjC,QAAQ,CAAC,WAAW,SAOiE;IAErF,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAmClB;gBAGQ,aAAa,EAAE,aAAa,EAC5B,WAAW,EAAE,WAAW;IAK5B,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAgFnD"}

package/dist/mcp/handlers/export-results.js

@@ -0,0 +1,132 @@
+/**
+ * Export Results Handler
+ *
+ * Handles the export-results tool which formats and exports test results.
+ *
+ * @module mcp/handlers/export-results
+ */
+import { BaseToolHandler } from './base-handler.js';
+import { analyzeFailures } from '../../analyzers/failure-analyzer.js';
+import { analyzeFailuresWithAI } from '../../analyzers/ai-failure-analyzer.js';
+/**
+ * Handler for results export tool
+ */
+export class ExportResultsHandler extends BaseToolHandler {
+    reportService;
+    fileService;
+    name = 'export-results';
+    description = 'STEP 3 of 3 (optional) — Export test results as a formatted report file. ' +
+        'Takes the "results" array from run-tests and produces an HTML dashboard, ' +
+        'a Markdown summary, or a raw JSON file. ' +
+        'HTML is the richest format: interactive charts, pass/fail breakdown by category, ' +
+        'per-endpoint details, and automatic AI failure analysis (if LLM available). ' +
+        'Use Markdown for GitHub PRs or documentation. Use JSON for programmatic processing. ' +
+        'AI analysis runs automatically when there are failed tests and LLM is available.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            results: {
+                type: 'array',
+                description: 'Test results array returned by run-tests. Pass it directly here.',
+                items: { type: 'object' }
+            },
+            format: {
+                type: 'string',
+                enum: ['html', 'markdown', 'json'],
+                description: 'Output format. ' +
+                    'html: interactive dashboard with charts (best for human review). ' +
+                    'markdown: plain text summary (good for GitHub PRs or docs). ' +
+                    'json: raw structured data (good for CI/CD pipelines or further processing). ' +
+                    'Default: "html".'
+            },
+            outputPath: {
+                type: 'string',
+                description: 'Absolute or relative path where the report file will be saved. ' +
+                    'The file extension should match the format. ' +
+                    'Examples: "/tmp/report.html", "./results/report.md", "~/tests/output.json".'
+            },
+            includeCharts: {
+                type: 'boolean',
+                description: 'Include interactive Chart.js charts in the HTML report (default: true). ' +
+                    'Set to false for a lighter report without JavaScript dependencies.'
+            },
+            title: {
+                type: 'string',
+                description: 'Title shown at the top of the report (default: "Test Results"). ' +
+                    'Example: "User Service API — Sprint 24 Test Report".'
+            }
+        },
+        required: ['results', 'outputPath']
+    };
+    constructor(reportService, fileService) {
+        super();
+        this.reportService = reportService;
+        this.fileService = fileService;
+    }
+    async handle(args) {
+        const params = args;
+        const format = params.format || 'html';
+        this.log.info('Exporting results', {
+            resultCount: params.results.length,
+            format,
+            outputPath: params.outputPath
+        });
+        try {
+            // Auto-detect failed tests and run AI analysis if available
+            let failureAnalysis;
+            const failedTests = params.results.filter(r => r.status === 'failed');
+            if (failedTests.length > 0) {
+                this.log.info('Running automatic failure analysis', { failedCount: failedTests.length });
+                // Step 1: Heuristic analysis (structured data)
+                const structuredAnalysis = analyzeFailures(failedTests);
+                // Step 2: AI analysis (human-readable insights) - automatic
+                this.log.info('Running AI analysis on failures (automatic)');
+                failureAnalysis = await analyzeFailuresWithAI(structuredAnalysis);
+                this.log.info('AI analysis complete', {
+                    recommendationsCount: failureAnalysis.recommendations?.length || 0,
+                    aiEnabled: failureAnalysis.recommendations && failureAnalysis.recommendations.length > 0
+                });
+            }
+            let content;
+            // Generate report based on format
+            if (format === 'html') {
+                content = this.reportService.generateHTML(params.results, {
+                    title: params.title,
+                    includeCharts: params.includeCharts !== false,
+                    includeFullDetails: true,
+                    aiAnalysis: failureAnalysis
+                });
+            }
+            else if (format === 'markdown') {
+                content = this.reportService.generateMarkdown(params.results);
+                // Add analysis to content for markdown
+                if (failureAnalysis) {
+                    content += `\n\n## Failure Analysis\n\`\`\`json\n${JSON.stringify(failureAnalysis, null, 2)}\n\`\`\``;
+                }
+            }
+            else {
+                content = this.reportService.generateJSON(params.results);
+            }
+            // Save file
+            await this.fileService.saveFile(params.outputPath, content);
+            this.log.info('Results exported successfully', {
+                format,
+                outputPath: params.outputPath,
+                size: content.length
+            });
+            return this.formatResponse({
+                success: true,
+                format,
+                outputPath: params.outputPath,
+                size: content.length,
+                summary: this.reportService.calculateSummary(params.results),
+                aiAnalysisIncluded: !!failureAnalysis,
+                failedTests: failedTests.length
+            });
+        }
+        catch (error) {
+            return this.formatError(error);
+        }
+    }
+}
+//# sourceMappingURL=export-results.js.map

package/dist/mcp/handlers/export-results.js.map

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

package/dist/mcp/handlers/export-to-postman.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Export to Postman Handler
+ *
+ * Handles the export-to-postman tool which converts test cases to Postman Collection v2.1.
+ *
+ * @module mcp/handlers/export-to-postman
+ */
+import { BaseToolHandler } from './base-handler.js';
+import type { ToolResponse } from './types.js';
+import { PostmanService } from '../services/postman-service.js';
+import { FileService } from '../services/file-service.js';
+/**
+ * Handler for Postman export tool
+ */
+export declare class ExportToPostmanHandler extends BaseToolHandler {
+    private postmanService;
+    private fileService;
+    readonly name = "export-to-postman";
+    readonly description: string;
+    readonly inputSchema: {
+        type: string;
+        properties: {
+            tests: {
+                type: string;
+                description: string;
+                items: {
+                    type: string;
+                };
+            };
+            outputPath: {
+                type: string;
+                description: string;
+            };
+            baseUrl: {
+                type: string;
+                description: string;
+            };
+            collectionName: {
+                type: string;
+                description: string;
+            };
+            includeTests: {
+                type: string;
+                description: string;
+            };
+            groupByCategory: {
+                type: string;
+                description: string;
+            };
+            auth: {
+                type: string;
+                description: string;
+                additionalProperties: boolean;
+            };
+        };
+        required: string[];
+    };
+    constructor(postmanService: PostmanService, fileService: FileService);
+    handle(args: unknown): Promise<ToolResponse>;
+    /**
+     * Counts total requests in the collection (including nested folders)
+     */
+    private countRequests;
+}
+//# sourceMappingURL=export-to-postman.d.ts.map

package/dist/mcp/handlers/export-to-postman.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export-to-postman.d.ts","sourceRoot":"","sources":["../../../src/mcp/handlers/export-to-postman.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,eAAe;IAsDvD,OAAO,CAAC,cAAc;IACtB,OAAO,CAAC,WAAW;IAtDrB,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,SAKwE;IAE5F,QAAQ,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MA0ClB;gBAGQ,cAAc,EAAE,cAAc,EAC9B,WAAW,EAAE,WAAW;IAK5B,MAAM,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAuDlD;;OAEG;IACH,OAAO,CAAC,aAAa;CAoBtB"}

package/dist/mcp/handlers/export-to-postman.js

@@ -0,0 +1,128 @@
+/**
+ * Export to Postman Handler
+ *
+ * Handles the export-to-postman tool which converts test cases to Postman Collection v2.1.
+ *
+ * @module mcp/handlers/export-to-postman
+ */
+import { BaseToolHandler } from './base-handler.js';
+/**
+ * Handler for Postman export tool
+ */
+export class ExportToPostmanHandler extends BaseToolHandler {
+    postmanService;
+    fileService;
+    name = 'export-to-postman';
+    description = 'OPTIONAL TOOL — Export test cases as a Postman Collection v2.1 (compatible with Newman). ' +
+        'Takes the "tests" array from generate-tests and produces a .postman_collection.json file ' +
+        'that can be imported into Postman or executed with Newman CLI. ' +
+        'Each test becomes a request in the collection with pre-configured method, URL, headers, body, and tests. ' +
+        'Use this to integrate with existing Postman workflows or run tests via Newman in CI/CD.';
+    inputSchema = {
+        type: 'object',
+        properties: {
+            tests: {
+                type: 'array',
+                description: 'Test cases array returned by generate-tests. Pass it directly here.',
+                items: { type: 'object' }
+            },
+            outputPath: {
+                type: 'string',
+                description: 'Path where the Postman collection JSON file will be saved. ' +
+                    'Example: "./postman-collection.json" or "/tmp/api-tests.postman_collection.json".'
+            },
+            baseUrl: {
+                type: 'string',
+                description: 'Base URL of the API (e.g., "https://api.example.com"). ' +
+                    'If provided, requests will use this as the base URL. ' +
+                    'If omitted, uses collection-level variables.'
+            },
+            collectionName: {
+                type: 'string',
+                description: 'Name for the Postman collection (default: "API Test Collection"). ' +
+                    'Example: "User Service Tests - v1.0".'
+            },
+            includeTests: {
+                type: 'boolean',
+                description: 'Include Postman test scripts that validate status codes and schemas (default: true). ' +
+                    'When true, each request includes pm.test() assertions.'
+            },
+            groupByCategory: {
+                type: 'boolean',
+                description: 'Group requests into folders by category (default: true). ' +
+                    'Creates folders: Happy Path, Edge Cases, Error Cases, Business Rules.'
+            },
+            auth: {
+                type: 'object',
+                description: 'Collection-level authentication configuration. ' +
+                    'Example: { "type": "bearer", "bearer": [{ "key": "token", "value": "{{API_TOKEN}}" }] }',
+                additionalProperties: true
+            }
+        },
+        required: ['tests', 'outputPath']
+    };
+    constructor(postmanService, fileService) {
+        super();
+        this.postmanService = postmanService;
+        this.fileService = fileService;
+    }
+    async handle(args) {
+        const params = args;
+        this.log.info('Exporting to Postman', {
+            testCount: params.tests.length,
+            outputPath: params.outputPath,
+            baseUrl: params.baseUrl,
+            groupByCategory: params.groupByCategory !== false
+        });
+        try {
+            // Generate Postman Collection
+            const collection = this.postmanService.generateCollection(params.tests, {
+                name: params.collectionName || 'API Test Collection',
+                baseUrl: params.baseUrl,
+                includeTests: params.includeTests !== false,
+                groupByCategory: params.groupByCategory !== false,
+                auth: params.auth
+            });
+            // Convert to JSON
+            const collectionJson = collection.toJSON();
+            // Save file
+            await this.fileService.saveFile(params.outputPath, JSON.stringify(collectionJson, null, 2));
+            this.log.info('Postman collection exported successfully', {
+                outputPath: params.outputPath,
+                requestCount: this.countRequests(collectionJson),
+                size: JSON.stringify(collectionJson).length
+            });
+            return this.formatResponse({
+                success: true,
+                outputPath: params.outputPath,
+                collectionName: collectionJson.info?.name || params.collectionName || 'API Test Collection',
+                requestCount: this.countRequests(collectionJson),
+                newmanCommand: `newman run ${params.outputPath}${params.baseUrl ? ` --env-var "baseUrl=${params.baseUrl}"` : ''}`
+            });
+        }
+        catch (error) {
+            return this.formatError(error);
+        }
+    }
+    /**
+     * Counts total requests in the collection (including nested folders)
+     */
+    countRequests(collectionJson) {
+        let count = 0;
+        function countItems(items) {
+            for (const item of items) {
+                if (item.request) {
+                    count++;
+                }
+                if (item.item && Array.isArray(item.item)) {
+                    countItems(item.item);
+                }
+            }
+        }
+        if (collectionJson.item) {
+            countItems(collectionJson.item);
+        }
+        return count;
+    }
+}
+//# sourceMappingURL=export-to-postman.js.map

package/dist/mcp/handlers/export-to-postman.js.map

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