api-tests-coverage 1.0.0

package/dist/src/mcp/prompts/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * MCP integration – prompt builders.
+ *
+ * Each builder produces a deterministic, structured prompt for a specific
+ * analysis category.  All prompts include analysis scope, metrics, gate
+ * status, and a request for structured output.
+ */
+import type { McpPromptRequest } from '../types';
+import type { CoverageResult } from '../../reporting';
+import type { SecurityScanSummary } from '../../security/types';
+export interface CoverageSummaryPromptInput {
+    results: CoverageResult[];
+    thresholds?: Record<string, number | undefined>;
+    projectName?: string;
+    branch?: string;
+    commitSha?: string;
+    gatePassed?: boolean;
+    failedCategories?: string[];
+}
+export declare function buildCoverageSummaryPrompt(input: CoverageSummaryPromptInput): McpPromptRequest;
+export interface SecurityScanPromptInput {
+    scanSummary: SecurityScanSummary;
+    projectName?: string;
+    branch?: string;
+    commitSha?: string;
+}
+export declare function buildSecurityScanPrompt(input: SecurityScanPromptInput): McpPromptRequest;
+export interface PerformancePromptInput {
+    coveragePercent: number;
+    totalScenarios: number;
+    coveredScenarios: number;
+    uncoveredScenarios?: string[];
+    projectName?: string;
+    branch?: string;
+}
+export declare function buildPerformancePrompt(input: PerformancePromptInput): McpPromptRequest;
+export interface CompatibilityPromptInput {
+    compatibilityPercent: number;
+    breakingChanges: number;
+    totalEndpoints: number;
+    projectName?: string;
+    branch?: string;
+}
+export declare function buildCompatibilityPrompt(input: CompatibilityPromptInput): McpPromptRequest;
+export interface IntelligencePromptInput {
+    totalFindings: number;
+    totalRecommendations: number;
+    maxRiskScore: number;
+    avgRiskScore: number;
+    criticalUncoveredItems: number;
+    unprotectedSecurityFindings: number;
+    recommendationsByPriority: Record<string, number>;
+    topFindings: Array<{
+        category: string;
+        severity: string;
+        title: string;
+        endpoint?: {
+            method?: string;
+            path?: string;
+        };
+    }>;
+    topRecommendations: Array<{
+        priority: string;
+        riskScore: number;
+        title: string;
+        recommendedTestType: string;
+        likelyLanguage?: string;
+        likelyFramework?: string;
+    }>;
+    languages?: string[];
+    frameworks?: string[];
+    projectName?: string;
+    branch?: string;
+}
+export declare function buildIntelligencePrompt(input: IntelligencePromptInput): McpPromptRequest;
+export interface CiSummaryPromptInput {
+    overallPassed: boolean;
+    coverageResults: CoverageResult[];
+    failedGates: string[];
+    projectName?: string;
+    branch?: string;
+    commitSha?: string;
+    buildId?: string;
+}
+export declare function buildCiSummaryPrompt(input: CiSummaryPromptInput): McpPromptRequest;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/prompts/index.d.ts.map

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

package/dist/src/mcp/prompts/index.js

@@ -0,0 +1,304 @@
+"use strict";
+/**
+ * MCP integration – prompt builders.
+ *
+ * Each builder produces a deterministic, structured prompt for a specific
+ * analysis category.  All prompts include analysis scope, metrics, gate
+ * status, and a request for structured output.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildCoverageSummaryPrompt = buildCoverageSummaryPrompt;
+exports.buildSecurityScanPrompt = buildSecurityScanPrompt;
+exports.buildPerformancePrompt = buildPerformancePrompt;
+exports.buildCompatibilityPrompt = buildCompatibilityPrompt;
+exports.buildIntelligencePrompt = buildIntelligencePrompt;
+exports.buildCiSummaryPrompt = buildCiSummaryPrompt;
+function buildCoverageSummaryPrompt(input) {
+    var _a, _b, _c, _d;
+    const lines = [
+        'Analyze the following API test coverage results.',
+        '',
+        '## Context',
+    ];
+    if (input.projectName)
+        lines.push(`Project: ${input.projectName}`);
+    if (input.branch)
+        lines.push(`Branch: ${input.branch}`);
+    if (input.commitSha)
+        lines.push(`Commit: ${input.commitSha}`);
+    lines.push('');
+    lines.push('## Coverage Metrics');
+    for (const r of input.results) {
+        const threshold = (_a = input.thresholds) === null || _a === void 0 ? void 0 : _a[r.type];
+        const status = threshold !== undefined
+            ? r.coveragePercent >= threshold ? 'PASS' : 'FAIL'
+            : 'no gate';
+        lines.push(`- ${r.type}: ${r.coveragePercent.toFixed(2)}% ` +
+            `(${r.coveredItems}/${r.totalItems} covered) [${status}]` +
+            (threshold !== undefined ? ` threshold=${threshold}%` : ''));
+    }
+    lines.push('');
+    if (((_c = (_b = input.failedCategories) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) > 0) {
+        lines.push(`## Failed Gates`);
+        lines.push(input.failedCategories.join(', '));
+        lines.push('');
+    }
+    lines.push('## Required Output');
+    lines.push('Provide a JSON response with the following fields:');
+    lines.push('- summary (string): one-paragraph executive summary');
+    lines.push('- keyFindings (string[]): bullet-point key findings');
+    lines.push('- topRisks (string[]): top risk items ordered by severity');
+    lines.push('- recommendedActions (string[]): concrete recommended actions');
+    lines.push('- missingCoverageAreas (string[]): specific coverage gaps');
+    lines.push('- confidence ("low"|"medium"|"high")');
+    return {
+        category: 'coverage',
+        prompt: lines.join('\n'),
+        context: {
+            projectName: input.projectName,
+            branch: input.branch,
+            commitSha: input.commitSha,
+            results: input.results.map((r) => {
+                var _a;
+                return ({
+                    type: r.type,
+                    coveragePercent: r.coveragePercent,
+                    coveredItems: r.coveredItems,
+                    totalItems: r.totalItems,
+                    threshold: (_a = input.thresholds) === null || _a === void 0 ? void 0 : _a[r.type],
+                });
+            }),
+            gatePassed: input.gatePassed,
+            failedCategories: (_d = input.failedCategories) !== null && _d !== void 0 ? _d : [],
+        },
+    };
+}
+function buildSecurityScanPrompt(input) {
+    var _a, _b, _c;
+    const s = input.scanSummary;
+    const lines = [
+        'Analyze the following security scan results for an API project.',
+        '',
+        '## Context',
+    ];
+    if (input.projectName)
+        lines.push(`Project: ${input.projectName}`);
+    if (input.branch)
+        lines.push(`Branch: ${input.branch}`);
+    if (input.commitSha)
+        lines.push(`Commit: ${input.commitSha}`);
+    lines.push('');
+    lines.push('## Security Findings');
+    lines.push(`Total findings: ${s.totalFindings}`);
+    lines.push(`Critical: ${s.bySeverity.CRITICAL}`);
+    lines.push(`High: ${s.bySeverity.HIGH}`);
+    lines.push(`Medium: ${s.bySeverity.MEDIUM}`);
+    lines.push(`Low: ${s.bySeverity.LOW}`);
+    lines.push(`Scanners run: ${s.scannersRun.join(', ')}`);
+    lines.push(`Gate passed: ${(_b = (_a = s.gateResult) === null || _a === void 0 ? void 0 : _a.passed) !== null && _b !== void 0 ? _b : 'not evaluated'}`);
+    lines.push('');
+    const blocking = s.findings
+        .filter((f) => f.severity === 'HIGH' || f.severity === 'CRITICAL')
+        .slice(0, 10);
+    if (blocking.length > 0) {
+        lines.push('## High / Critical Findings');
+        for (const f of blocking) {
+            lines.push(`- [${f.severity}] ${f.title} — ${f.category}`);
+        }
+        lines.push('');
+    }
+    lines.push('## Required Output');
+    lines.push('Provide a JSON response with:');
+    lines.push('- summary (string): executive summary of security posture');
+    lines.push('- keyFindings (string[]): key security findings');
+    lines.push('- topRisks (string[]): top risks by severity');
+    lines.push('- recommendedActions (string[]): remediation steps');
+    lines.push('- likelyRootCauses (string[]): probable root causes');
+    lines.push('- confidence ("low"|"medium"|"high")');
+    return {
+        category: 'security',
+        prompt: lines.join('\n'),
+        context: {
+            projectName: input.projectName,
+            branch: input.branch,
+            commitSha: input.commitSha,
+            totalFindings: s.totalFindings,
+            bySeverity: s.bySeverity,
+            byCategory: s.byCategory,
+            scannersRun: s.scannersRun,
+            gatePassed: (_c = s.gateResult) === null || _c === void 0 ? void 0 : _c.passed,
+        },
+    };
+}
+function buildPerformancePrompt(input) {
+    var _a, _b, _c;
+    const lines = [
+        'Analyze the following performance and resilience test coverage.',
+        '',
+        '## Metrics',
+        `Coverage: ${input.coveragePercent.toFixed(2)}%`,
+        `Scenarios: ${input.coveredScenarios}/${input.totalScenarios} covered`,
+    ];
+    if (((_b = (_a = input.uncoveredScenarios) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0) {
+        lines.push('');
+        lines.push('## Uncovered Scenarios');
+        for (const s of input.uncoveredScenarios.slice(0, 10)) {
+            lines.push(`- ${s}`);
+        }
+    }
+    lines.push('');
+    lines.push('## Required Output');
+    lines.push('Provide a JSON response with: summary, keyFindings, topRisks, recommendedActions, confidence');
+    return {
+        category: 'performance',
+        prompt: lines.join('\n'),
+        context: {
+            projectName: input.projectName,
+            branch: input.branch,
+            coveragePercent: input.coveragePercent,
+            totalScenarios: input.totalScenarios,
+            coveredScenarios: input.coveredScenarios,
+            uncoveredScenarios: (_c = input.uncoveredScenarios) !== null && _c !== void 0 ? _c : [],
+        },
+    };
+}
+function buildCompatibilityPrompt(input) {
+    const lines = [
+        'Analyze the following API compatibility and contract coverage results.',
+        '',
+        '## Metrics',
+        `Compatibility: ${input.compatibilityPercent.toFixed(2)}%`,
+        `Breaking changes: ${input.breakingChanges}`,
+        `Endpoints analyzed: ${input.totalEndpoints}`,
+        '',
+        '## Required Output',
+        'Provide a JSON response with: summary, keyFindings, topRisks, recommendedActions, confidence',
+    ];
+    return {
+        category: 'compatibility',
+        prompt: lines.join('\n'),
+        context: {
+            projectName: input.projectName,
+            branch: input.branch,
+            compatibilityPercent: input.compatibilityPercent,
+            breakingChanges: input.breakingChanges,
+            totalEndpoints: input.totalEndpoints,
+        },
+    };
+}
+function buildIntelligencePrompt(input) {
+    var _a, _b, _c, _d, _e, _f;
+    const lines = [
+        'Analyze the following Coverage Intelligence results for an API project.',
+        '',
+        '## Context',
+    ];
+    if (input.projectName)
+        lines.push(`Project: ${input.projectName}`);
+    if (input.branch)
+        lines.push(`Branch: ${input.branch}`);
+    if ((_a = input.languages) === null || _a === void 0 ? void 0 : _a.length)
+        lines.push(`Languages: ${input.languages.join(', ')}`);
+    if ((_b = input.frameworks) === null || _b === void 0 ? void 0 : _b.length)
+        lines.push(`Frameworks: ${input.frameworks.join(', ')}`);
+    lines.push('');
+    lines.push('## Intelligence Summary');
+    lines.push(`Total functional findings: ${input.totalFindings}`);
+    lines.push(`Total missing test recommendations: ${input.totalRecommendations}`);
+    lines.push(`Max risk score: ${input.maxRiskScore}`);
+    lines.push(`Avg risk score: ${input.avgRiskScore}`);
+    lines.push(`Critical uncovered items: ${input.criticalUncoveredItems}`);
+    lines.push(`Unprotected security findings: ${input.unprotectedSecurityFindings}`);
+    lines.push('');
+    lines.push('## Recommendations by Priority');
+    for (const [p, count] of Object.entries(input.recommendationsByPriority)) {
+        lines.push(`- ${p}: ${count}`);
+    }
+    lines.push('');
+    if (input.topFindings.length > 0) {
+        lines.push('## Top Functional Findings');
+        for (const f of input.topFindings.slice(0, 10)) {
+            const ep = f.endpoint ? ` [${(_c = f.endpoint.method) !== null && _c !== void 0 ? _c : ''} ${(_d = f.endpoint.path) !== null && _d !== void 0 ? _d : ''}]`.trim() : '';
+            lines.push(`- [${f.severity}] ${f.title}${ep} (${f.category})`);
+        }
+        lines.push('');
+    }
+    if (input.topRecommendations.length > 0) {
+        lines.push('## Top Missing Test Recommendations');
+        for (const r of input.topRecommendations.slice(0, 10)) {
+            lines.push(`- [${r.priority}] ${r.title} (risk: ${r.riskScore}, type: ${r.recommendedTestType})`);
+        }
+        lines.push('');
+    }
+    lines.push('## Required Output');
+    lines.push('Provide a JSON response with:');
+    lines.push('- summary (string): executive summary of testing intelligence gaps');
+    lines.push('- keyFindings (string[]): key functional findings');
+    lines.push('- topRisks (string[]): top risks ordered by severity and risk score');
+    lines.push('- recommendedActions (string[]): prioritized actions to close gaps');
+    lines.push('- missingCoverageAreas (string[]): specific areas lacking test coverage');
+    lines.push('- confidence ("low"|"medium"|"high")');
+    return {
+        category: 'intelligence',
+        prompt: lines.join('\n'),
+        context: {
+            projectName: input.projectName,
+            branch: input.branch,
+            totalFindings: input.totalFindings,
+            totalRecommendations: input.totalRecommendations,
+            maxRiskScore: input.maxRiskScore,
+            avgRiskScore: input.avgRiskScore,
+            criticalUncoveredItems: input.criticalUncoveredItems,
+            unprotectedSecurityFindings: input.unprotectedSecurityFindings,
+            recommendationsByPriority: input.recommendationsByPriority,
+            languages: (_e = input.languages) !== null && _e !== void 0 ? _e : [],
+            frameworks: (_f = input.frameworks) !== null && _f !== void 0 ? _f : [],
+        },
+    };
+}
+function buildCiSummaryPrompt(input) {
+    const lines = [
+        'Summarize the following CI API coverage analysis for a PR/build comment.',
+        '',
+        '## Build Context',
+    ];
+    if (input.projectName)
+        lines.push(`Project: ${input.projectName}`);
+    if (input.branch)
+        lines.push(`Branch: ${input.branch}`);
+    if (input.commitSha)
+        lines.push(`Commit: ${input.commitSha}`);
+    if (input.buildId)
+        lines.push(`Build ID: ${input.buildId}`);
+    lines.push(`Overall gate: ${input.overallPassed ? 'PASSED' : 'FAILED'}`);
+    lines.push('');
+    if (input.failedGates.length > 0) {
+        lines.push('## Failed Gates');
+        lines.push(input.failedGates.join(', '));
+        lines.push('');
+    }
+    lines.push('## Coverage Summary');
+    for (const r of input.coverageResults) {
+        lines.push(`- ${r.type}: ${r.coveragePercent.toFixed(2)}%`);
+    }
+    lines.push('');
+    lines.push('## Required Output');
+    lines.push('Provide a concise JSON summary suitable for a PR comment:');
+    lines.push('summary, keyFindings, topRisks, recommendedActions, confidence');
+    return {
+        category: 'ci-summary',
+        prompt: lines.join('\n'),
+        context: {
+            overallPassed: input.overallPassed,
+            projectName: input.projectName,
+            branch: input.branch,
+            commitSha: input.commitSha,
+            buildId: input.buildId,
+            failedGates: input.failedGates,
+            coverageResults: input.coverageResults.map((r) => ({
+                type: r.type,
+                coveragePercent: r.coveragePercent,
+            })),
+        },
+    };
+}

package/dist/src/mcp/templates/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * MCP integration – template mapper.
+ *
+ * Converts a NormalizedAiAnalysis into rendered markdown/HTML sections that
+ * can be embedded in dashboard pages, PR comments, and build summaries.
+ */
+import type { NormalizedAiAnalysis, TemplateContext } from '../types';
+/**
+ * Render a NormalizedAiAnalysis as a collapsible Markdown section.
+ * Compatible with GitHub Flavoured Markdown `<details>` blocks.
+ */
+export declare function renderAiAnalysisMarkdown(ctx: TemplateContext): string;
+/**
+ * Render a NormalizedAiAnalysis as an HTML `<details>` block.
+ * Used in published HTML reports.
+ */
+export declare function renderAiAnalysisHtml(ctx: TemplateContext): string;
+/**
+ * Convert a NormalizedAiAnalysis into a plain-object panel data structure
+ * consumed by the React dashboard.
+ */
+export declare function buildAiPanelData(analysis: NormalizedAiAnalysis): AiPanelData;
+/** Data shape consumed by the AiSummaryPanel React component */
+export interface AiPanelData {
+    summary: string;
+    keyFindings: string[];
+    topRisks: string[];
+    recommendedActions: string[];
+    missingCoverageAreas: string[];
+    likelyRootCauses: string[];
+    confidence: string;
+    isFallback: boolean;
+    category: string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/templates/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/mcp/templates/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAItE;;;GAGG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CA4DrE;AAID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAoDjE;AAID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,WAAW,CAY5E;AAED,gEAAgE;AAChE,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,EAAE,MAAM,EAAE,CAAC;IAC/B,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/src/mcp/templates/index.js

@@ -0,0 +1,143 @@
+"use strict";
+/**
+ * MCP integration – template mapper.
+ *
+ * Converts a NormalizedAiAnalysis into rendered markdown/HTML sections that
+ * can be embedded in dashboard pages, PR comments, and build summaries.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderAiAnalysisMarkdown = renderAiAnalysisMarkdown;
+exports.renderAiAnalysisHtml = renderAiAnalysisHtml;
+exports.buildAiPanelData = buildAiPanelData;
+// ─── Markdown template ────────────────────────────────────────────────────────
+/**
+ * Render a NormalizedAiAnalysis as a collapsible Markdown section.
+ * Compatible with GitHub Flavoured Markdown `<details>` blocks.
+ */
+function renderAiAnalysisMarkdown(ctx) {
+    var _a, _b, _c, _d;
+    const { analysis, categoryTitle, mcpEnabled, serverRef } = ctx;
+    const title = categoryTitle !== null && categoryTitle !== void 0 ? categoryTitle : ctx.category;
+    const lines = [
+        `<details>`,
+        `<summary>🤖 AI Analysis — ${title}${analysis.isFallback ? ' (fallback mode)' : ''}</summary>`,
+        '',
+        `### ${title} — AI Insights`,
+        '',
+        `**Summary:** ${analysis.summary}`,
+        '',
+    ];
+    if (analysis.keyFindings.length > 0) {
+        lines.push('**Key Findings:**');
+        for (const f of analysis.keyFindings)
+            lines.push(`- ${f}`);
+        lines.push('');
+    }
+    if (analysis.topRisks.length > 0) {
+        lines.push('**Top Risks:**');
+        for (const r of analysis.topRisks)
+            lines.push(`- ${r}`);
+        lines.push('');
+    }
+    if (((_b = (_a = analysis.missingCoverageAreas) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0) {
+        lines.push('**Missing Coverage Areas:**');
+        for (const a of analysis.missingCoverageAreas)
+            lines.push(`- ${a}`);
+        lines.push('');
+    }
+    if (((_d = (_c = analysis.likelyRootCauses) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0) {
+        lines.push('**Likely Root Causes:**');
+        for (const c of analysis.likelyRootCauses)
+            lines.push(`- ${c}`);
+        lines.push('');
+    }
+    if (analysis.recommendedActions.length > 0) {
+        lines.push('**Recommended Actions:**');
+        for (const a of analysis.recommendedActions)
+            lines.push(`- ${a}`);
+        lines.push('');
+    }
+    if (analysis.confidence) {
+        lines.push(`*Confidence: ${analysis.confidence}*`);
+        lines.push('');
+    }
+    if (mcpEnabled !== undefined) {
+        lines.push(`*MCP enabled: ${mcpEnabled}*`);
+    }
+    if (serverRef) {
+        lines.push(`*Server: ${serverRef}*`);
+    }
+    lines.push('</details>');
+    lines.push('');
+    return lines.join('\n');
+}
+// ─── HTML template ────────────────────────────────────────────────────────────
+/**
+ * Render a NormalizedAiAnalysis as an HTML `<details>` block.
+ * Used in published HTML reports.
+ */
+function renderAiAnalysisHtml(ctx) {
+    var _a, _b, _c, _d;
+    const { analysis, categoryTitle, mcpEnabled, serverRef } = ctx;
+    const title = categoryTitle !== null && categoryTitle !== void 0 ? categoryTitle : ctx.category;
+    const fallbackNote = analysis.isFallback
+        ? '<span class="ai-fallback"> (fallback mode)</span>'
+        : '';
+    const escHtml = (s) => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+    const li = (items) => items.map((i) => `<li>${escHtml(i)}</li>`).join('\n');
+    const sections = [];
+    sections.push(`<p><strong>Summary:</strong> ${escHtml(analysis.summary)}</p>`);
+    if (analysis.keyFindings.length > 0) {
+        sections.push(`<p><strong>Key Findings:</strong></p><ul>${li(analysis.keyFindings)}</ul>`);
+    }
+    if (analysis.topRisks.length > 0) {
+        sections.push(`<p><strong>Top Risks:</strong></p><ul>${li(analysis.topRisks)}</ul>`);
+    }
+    if (((_b = (_a = analysis.missingCoverageAreas) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0) > 0) {
+        sections.push(`<p><strong>Missing Coverage Areas:</strong></p><ul>${li(analysis.missingCoverageAreas)}</ul>`);
+    }
+    if (((_d = (_c = analysis.likelyRootCauses) === null || _c === void 0 ? void 0 : _c.length) !== null && _d !== void 0 ? _d : 0) > 0) {
+        sections.push(`<p><strong>Likely Root Causes:</strong></p><ul>${li(analysis.likelyRootCauses)}</ul>`);
+    }
+    if (analysis.recommendedActions.length > 0) {
+        sections.push(`<p><strong>Recommended Actions:</strong></p><ul>${li(analysis.recommendedActions)}</ul>`);
+    }
+    if (analysis.confidence) {
+        sections.push(`<p><em>Confidence: ${escHtml(analysis.confidence)}</em></p>`);
+    }
+    if (mcpEnabled !== undefined) {
+        sections.push(`<p><em>MCP enabled: ${mcpEnabled}</em></p>`);
+    }
+    if (serverRef) {
+        sections.push(`<p><em>Server: ${escHtml(serverRef)}</em></p>`);
+    }
+    return [
+        `<details class="ai-analysis-panel">`,
+        `  <summary>🤖 AI Analysis — ${escHtml(title)}${fallbackNote}</summary>`,
+        `  <div class="ai-analysis-content">`,
+        `    <h4>${escHtml(title)} — AI Insights</h4>`,
+        ...sections.map((s) => `    ${s}`),
+        `  </div>`,
+        `</details>`,
+        '',
+    ].join('\n');
+}
+// ─── Dashboard panel data ─────────────────────────────────────────────────────
+/**
+ * Convert a NormalizedAiAnalysis into a plain-object panel data structure
+ * consumed by the React dashboard.
+ */
+function buildAiPanelData(analysis) {
+    var _a, _b, _c, _d, _e;
+    return {
+        summary: analysis.summary,
+        keyFindings: analysis.keyFindings,
+        topRisks: analysis.topRisks,
+        recommendedActions: analysis.recommendedActions,
+        missingCoverageAreas: (_a = analysis.missingCoverageAreas) !== null && _a !== void 0 ? _a : [],
+        likelyRootCauses: (_b = analysis.likelyRootCauses) !== null && _b !== void 0 ? _b : [],
+        confidence: (_c = analysis.confidence) !== null && _c !== void 0 ? _c : 'medium',
+        isFallback: (_d = analysis.isFallback) !== null && _d !== void 0 ? _d : false,
+        category: (_e = analysis.category) !== null && _e !== void 0 ? _e : '',
+    };
+}

package/dist/src/mcp/testing/mock-server/index.d.ts

@@ -0,0 +1,47 @@
+/**
+ * MCP integration – mock MCP server.
+ *
+ * This module provides a deterministic mock MCP server for testing.
+ * It can operate in two modes:
+ *
+ *   1. **HTTP mode** – starts an HTTP server on a configurable port that
+ *      accepts POST /mcp requests and returns deterministic AI responses.
+ *
+ *   2. **stdio mode** – a standalone Node script that reads a JSON prompt
+ *      from stdin and writes a deterministic JSON response to stdout.
+ *
+ * The mock can be configured to:
+ *   - Return normal deterministic responses
+ *   - Simulate errors (status 500)
+ *   - Simulate timeouts (delayed response)
+ *   - Return malformed JSON
+ */
+import type { NormalizedAiAnalysis } from '../../types';
+/** Behaviours that the mock server can be configured to exhibit */
+export type MockBehaviour = 'normal' | 'error' | 'timeout' | 'malformed';
+/**
+ * Build a deterministic mock NormalizedAiAnalysis for a given category.
+ */
+export declare function buildMockAnalysisResponse(category: string, behaviour?: MockBehaviour): NormalizedAiAnalysis;
+export interface MockServerOptions {
+    port?: number;
+    behaviour?: MockBehaviour;
+    /** Delay in ms before responding (for timeout simulation) */
+    delayMs?: number;
+}
+export interface MockServerHandle {
+    url: string;
+    close(): Promise<void>;
+    /** Change behaviour after the server is started */
+    setBehaviour(behaviour: MockBehaviour, delayMs?: number): void;
+}
+/**
+ * Start an HTTP mock MCP server.
+ *
+ * @example
+ * const server = await startMockMcpServer({ port: 3099 });
+ * // use server.url in test MCP config
+ * await server.close();
+ */
+export declare function startMockMcpServer(options?: MockServerOptions): Promise<MockServerHandle>;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/mcp/testing/mock-server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/mcp/testing/mock-server/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAGH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,mEAAmE;AACnE,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,SAAS,GAAG,WAAW,CAAC;AAEzE;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,SAAS,GAAE,aAAwB,GAClC,oBAAoB,CAqBtB;AAQD,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,mDAAmD;IACnD,YAAY,CAAC,SAAS,EAAE,aAAa,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAChE;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B"}