@unispechq/unispec-core 0.3.2 → 0.3.4

package/dist/src/diff/change-reports.js

@@ -1,366 +0,0 @@
-/**
- * Generate a markdown report from enhanced diff result.
- */
-function generateMarkdownReport(diff, options) {
-    const lines = [];
-    // Title and metadata
-    lines.push(`# ${options.title || "UniSpec Changes Report"}`);
-    lines.push("");
-    if (options.versionInfo) {
-        lines.push("## Version Information");
-        if (options.versionInfo.oldVersion) {
-            lines.push(`- **From:** ${options.versionInfo.oldVersion}`);
-        }
-        if (options.versionInfo.newVersion) {
-            lines.push(`- **To:** ${options.versionInfo.newVersion}`);
-        }
-        if (options.versionInfo.comparisonDate) {
-            lines.push(`- **Date:** ${options.versionInfo.comparisonDate}`);
-        }
-        lines.push("");
-    }
-    // Executive summary
-    lines.push("## Executive Summary");
-    lines.push("");
-    lines.push(`- **Total Changes:** ${diff.summary.totalChanges}`);
-    lines.push(`- **Critical Changes:** ${diff.summary.criticalChanges}`);
-    lines.push(`- **High Risk Changes:** ${diff.summary.highRiskChanges}`);
-    lines.push(`- **Compatibility Score:** ${diff.metrics.overallCompatibility}%`);
-    lines.push(`- **Migration Effort:** ${diff.metrics.migrationEffort}`);
-    lines.push("");
-    // Compatibility metrics
-    lines.push("## Compatibility Metrics");
-    lines.push("");
-    lines.push("| Metric | Score | Status |");
-    lines.push("|--------|-------|--------|");
-    const overallStatus = diff.metrics.overallCompatibility >= 80
-        ? "✅ Good"
-        : diff.metrics.overallCompatibility >= 60
-            ? "⚠️ Moderate"
-            : "❌ Poor";
-    lines.push(`| Overall Compatibility | ${diff.metrics.overallCompatibility}% | ${overallStatus} |`);
-    const clientStatus = diff.metrics.clientCompatibilityScore >= 80
-        ? "✅ Good"
-        : diff.metrics.clientCompatibilityScore >= 60
-            ? "⚠️ Moderate"
-            : "❌ Poor";
-    lines.push(`| Client Compatibility | ${diff.metrics.clientCompatibilityScore}% | ${clientStatus} |`);
-    const serverStatus = diff.metrics.serverCompatibilityScore >= 80
-        ? "✅ Good"
-        : diff.metrics.serverCompatibilityScore >= 60
-            ? "⚠️ Moderate"
-            : "❌ Poor";
-    lines.push(`| Server Compatibility | ${diff.metrics.serverCompatibilityScore}% | ${serverStatus} |`);
-    lines.push("");
-    // Group changes
-    const groupedChanges = groupChanges(diff.changes, options);
-    for (const section of groupedChanges) {
-        lines.push(`## ${section.title}`);
-        lines.push("");
-        lines.push(section.summary);
-        lines.push("");
-        if (section.changes.length === 0) {
-            lines.push("No changes in this category.");
-            lines.push("");
-            continue;
-        }
-        for (const change of section.changes) {
-            lines.push(`### ${getChangeIcon(change.riskLevel)} ${getChangeTitle(change)}`);
-            lines.push("");
-            lines.push(`- **Path:** \`${change.path}\``);
-            lines.push(`- **Protocol:** ${change.protocol || "Unknown"}`);
-            lines.push(`- **Risk Level:** ${change.riskLevel.toUpperCase()}`);
-            lines.push(`- **Impact:** ${formatImpact(change.impact)}`);
-            lines.push("");
-            if (change.description) {
-                lines.push(`**Description:** ${change.description}`);
-                lines.push("");
-            }
-            if (options.includeSuggestions && change.suggestions.length > 0) {
-                lines.push("**Migration Suggestions:**");
-                for (const suggestion of change.suggestions) {
-                    lines.push(`- ${suggestion}`);
-                }
-                lines.push("");
-            }
-        }
-    }
-    // Migration recommendations
-    if (diff.summary.criticalChanges > 0 || diff.summary.highRiskChanges > 0) {
-        lines.push("## Migration Recommendations");
-        lines.push("");
-        if (diff.summary.criticalChanges > 0) {
-            lines.push("⚠️ **Critical Changes Detected**");
-            lines.push("");
-            lines.push("Immediate action required:");
-            lines.push("- Review all critical changes");
-            lines.push("- Plan migration strategy");
-            lines.push("- Communicate changes to all stakeholders");
-            lines.push("- Consider feature flags for gradual rollout");
-            lines.push("");
-        }
-        if (diff.metrics.migrationEffort === "major") {
-            lines.push("🔧 **Major Migration Effort**");
-            lines.push("");
-            lines.push("Recommended approach:");
-            lines.push("- Break migration into phases");
-            lines.push("- Use parallel development");
-            lines.push("- Implement comprehensive testing");
-            lines.push("- Provide detailed migration guides");
-            lines.push("");
-        }
-    }
-    return lines.join("\n");
-}
-/**
- * Generate an HTML report from enhanced diff result.
- */
-function generateHtmlReport(diff, options) {
-    const styles = `
-    <style>
-      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; margin: 40px; }
-      .header { border-bottom: 2px solid #e1e5e9; padding-bottom: 20px; margin-bottom: 30px; }
-      .metric { display: inline-block; margin: 10px 20px 10px 0; text-align: center; }
-      .metric-value { font-size: 2em; font-weight: bold; display: block; }
-      .metric-label { color: #666; font-size: 0.9em; }
-      .critical { color: #dc3545; }
-      .high { color: #fd7e14; }
-      .medium { color: #ffc107; }
-      .low { color: #28a745; }
-      .change { border: 1px solid #e1e5e9; border-radius: 8px; padding: 20px; margin: 20px 0; }
-      .change-header { font-weight: bold; margin-bottom: 10px; }
-      .suggestions { background: #f8f9fa; padding: 15px; border-radius: 5px; margin-top: 10px; }
-      .compatibility-bar { height: 20px; background: #e9ecef; border-radius: 10px; overflow: hidden; margin: 10px 0; }
-      .compatibility-fill { height: 100%; transition: width 0.3s ease; }
-    </style>
-  `;
-    const groupedChanges = groupChanges(diff.changes, options);
-    let html = `
-    <!DOCTYPE html>
-    <html>
-    <head>
-      <title>${options.title || "UniSpec Changes Report"}</title>
-      ${styles}
-    </head>
-    <body>
-      <div class="header">
-        <h1>${options.title || "UniSpec Changes Report"}</h1>
-        <p>Generated on ${new Date().toLocaleDateString()}</p>
-      </div>
-      
-      <div class="summary">
-        <h2>Executive Summary</h2>
-        <div class="metric">
-          <span class="metric-value">${diff.summary.totalChanges}</span>
-          <span class="metric-label">Total Changes</span>
-        </div>
-        <div class="metric">
-          <span class="metric-value critical">${diff.summary.criticalChanges}</span>
-          <span class="metric-label">Critical</span>
-        </div>
-        <div class="metric">
-          <span class="metric-value high">${diff.summary.highRiskChanges}</span>
-          <span class="metric-label">High Risk</span>
-        </div>
-        <div class="metric">
-          <span class="metric-value">${diff.metrics.overallCompatibility}%</span>
-          <span class="metric-label">Compatibility</span>
-        </div>
-      </div>
-      
-      <div class="compatibility">
-        <h2>Compatibility Metrics</h2>
-        <div>
-          <strong>Overall Compatibility: ${diff.metrics.overallCompatibility}%</strong>
-          <div class="compatibility-bar">
-            <div class="compatibility-fill ${getCompatibilityClass(diff.metrics.overallCompatibility)}" 
-                 style="width: ${diff.metrics.overallCompatibility}%"></div>
-          </div>
-        </div>
-        <div>
-          <strong>Client Compatibility: ${diff.metrics.clientCompatibilityScore}%</strong>
-          <div class="compatibility-bar">
-            <div class="compatibility-fill ${getCompatibilityClass(diff.metrics.clientCompatibilityScore)}" 
-                 style="width: ${diff.metrics.clientCompatibilityScore}%"></div>
-          </div>
-        </div>
-        <div>
-          <strong>Server Compatibility: ${diff.metrics.serverCompatibilityScore}%</strong>
-          <div class="compatibility-bar">
-            <div class="compatibility-fill ${getCompatibilityClass(diff.metrics.serverCompatibilityScore)}" 
-                 style="width: ${diff.metrics.serverCompatibilityScore}%"></div>
-          </div>
-        </div>
-      </div>
-  `;
-    for (const section of groupedChanges) {
-        html += `
-      <div class="section">
-        <h2>${section.title}</h2>
-        <p>${section.summary}</p>
-    `;
-        for (const change of section.changes) {
-            html += `
-        <div class="change ${change.riskLevel}">
-          <div class="change-header">
-            ${getChangeIcon(change.riskLevel)} ${getChangeTitle(change)}
-          </div>
-          <p><strong>Path:</strong> <code>${change.path}</code></p>
-          <p><strong>Protocol:</strong> ${change.protocol || "Unknown"}</p>
-          <p><strong>Risk Level:</strong> <span class="${change.riskLevel}">${change.riskLevel.toUpperCase()}</span></p>
-          <p><strong>Description:</strong> ${change.description}</p>
-          <p><strong>Impact:</strong> ${formatImpact(change.impact)}</p>
-      `;
-            if (options.includeSuggestions && change.suggestions.length > 0) {
-                html += `
-          <div class="suggestions">
-            <strong>Migration Suggestions:</strong>
-            <ul>
-        `;
-                for (const suggestion of change.suggestions) {
-                    html += `<li>${suggestion}</li>`;
-                }
-                html += `
-            </ul>
-          </div>
-        `;
-            }
-            html += `
-        </div>
-      `;
-        }
-        html += `
-      </div>
-    `;
-    }
-    html += `
-    </body>
-    </html>
-  `;
-    return html;
-}
-/**
- * Group changes by risk level or protocol.
- */
-function groupChanges(changes, options) {
-    const sections = [];
-    if (options.groupByRisk) {
-        const riskGroups = {
-            critical: changes.filter((c) => c.riskLevel === "critical"),
-            high: changes.filter((c) => c.riskLevel === "high"),
-            medium: changes.filter((c) => c.riskLevel === "medium"),
-            low: changes.filter((c) => c.riskLevel === "low"),
-        };
-        for (const [risk, riskChanges] of Object.entries(riskGroups)) {
-            sections.push({
-                title: `${risk.charAt(0).toUpperCase() + risk.slice(1)} Risk Changes`,
-                changes: riskChanges,
-                summary: `${riskChanges.length} ${risk} risk changes that ${getRiskDescription(risk)}.`,
-            });
-        }
-    }
-    if (options.groupByProtocol) {
-        const protocolGroups = {
-            rest: changes.filter((c) => c.protocol === "rest"),
-            graphql: changes.filter((c) => c.protocol === "graphql"),
-            websocket: changes.filter((c) => c.protocol === "websocket"),
-            other: changes.filter((c) => !c.protocol || !["rest", "graphql", "websocket"].includes(c.protocol)),
-        };
-        for (const [protocol, protocolChanges] of Object.entries(protocolGroups)) {
-            if (protocolChanges.length > 0) {
-                sections.push({
-                    title: `${protocol.charAt(0).toUpperCase() + protocol.slice(1)} Protocol Changes`,
-                    changes: protocolChanges,
-                    summary: `${protocolChanges.length} changes affecting ${protocol} protocol.`,
-                });
-            }
-        }
-    }
-    // If no grouping, create a single section
-    if (sections.length === 0) {
-        sections.push({
-            title: "All Changes",
-            changes,
-            summary: `${changes.length} total changes detected.`,
-        });
-    }
-    return sections;
-}
-/**
- * Helper functions for formatting.
- */
-function getChangeIcon(riskLevel) {
-    switch (riskLevel) {
-        case "critical":
-            return "🚨";
-        case "high":
-            return "⚠️";
-        case "medium":
-            return "⚡";
-        case "low":
-            return "✅";
-        default:
-            return "📝";
-    }
-}
-function getChangeTitle(change) {
-    const parts = change.path.split("/").filter(Boolean);
-    const lastPart = parts[parts.length - 1];
-    if (change.kind) {
-        return `${change.kind.replace(/\./g, " ").toUpperCase()} - ${lastPart}`;
-    }
-    return `${change.description} - ${lastPart}`;
-}
-function formatImpact(impact) {
-    const parts = [];
-    if (impact.backwardCompatibility !== "unknown") {
-        parts.push(`Compatibility: ${impact.backwardCompatibility}`);
-    }
-    if (impact.clientImpact !== "none") {
-        parts.push(`Client: ${impact.clientImpact}`);
-    }
-    if (impact.serverImpact !== "none") {
-        parts.push(`Server: ${impact.serverImpact}`);
-    }
-    return parts.join(", ");
-}
-function getRiskDescription(risk) {
-    switch (risk) {
-        case "critical":
-            return "require immediate attention and breaking changes";
-        case "high":
-            return "involve breaking changes or significant impact";
-        case "medium":
-            return "require attention but are manageable";
-        case "low":
-            return "are minor and easily handled";
-        default:
-            return "have unknown impact";
-    }
-}
-function getCompatibilityClass(score) {
-    if (score >= 80)
-        return "low";
-    if (score >= 60)
-        return "medium";
-    return "high";
-}
-/**
- * Generate a comprehensive change report.
- *
- * @param diff - Enhanced diff result
- * @param options - Report generation options
- * @returns Formatted report in the specified format
- */
-export function generateChangeReport(diff, options) {
-    switch (options.format) {
-        case "markdown":
-            return generateMarkdownReport(diff, options);
-        case "html":
-            return generateHtmlReport(diff, options);
-        case "json":
-            return JSON.stringify(diff, null, 2);
-        default:
-            throw new Error(`Unsupported format: ${options.format}`);
-    }
-}

package/dist/src/diff/core.d.ts

@@ -1,26 +0,0 @@
-import type { UniSpecDocument } from "../types/index.js";
-import { type DiffOptions, type DiffResult } from "./types.js";
-/**
- * Compare two UniSpec documents and return detected changes.
- *
- * This function performs a deep comparison between two UniSpec documents
- * and categorizes changes by severity and protocol. Useful for:
- * - API change detection in CI/CD pipelines
- * - Breaking change analysis
- * - Version compatibility checks
- * - Audit trails for API evolution
- *
- * Features:
- * - Detects added/removed fields at any depth
- * - Special handling for named collections (routes, operations, channels)
- * - Severity classification: "breaking" | "non-breaking" | "unknown"
- * - Protocol categorization: "rest" | "graphql" | "websocket"
- * - Detailed change descriptions with JSON paths
- * - Configurable named collection paths and comparison depth
- *
- * @param oldDoc - The previous version of the UniSpec document
- * @param newDoc - The current version of the UniSpec document
- * @param options - Configuration options for diff behavior
- * @returns Object containing all detected changes
- */
-export declare function diffUniSpec(oldDoc: UniSpecDocument, newDoc: UniSpecDocument, options?: DiffOptions): DiffResult;

package/dist/src/diff/core.js

@@ -1,155 +0,0 @@
-import { annotateGraphQLChange, annotateRestChange, annotateWebSocketChange, } from "./annotators.js";
-import { DEFAULT_NAMED_COLLECTION_PATHS, } from "./types.js";
-/**
- * Check if a value is a plain object (not array, null, or other object types).
- *
- * @param value - The value to check
- * @returns true if the value is a plain object, false otherwise
- */
-function isPlainObject(value) {
-    return Object.prototype.toString.call(value) === "[object Object]";
-}
-function diffValues(oldVal, newVal, basePath, out, options = {}) {
-    if (oldVal === newVal) {
-        return;
-    }
-    // Both plain objects → recurse by keys
-    if (isPlainObject(oldVal) && isPlainObject(newVal)) {
-        const oldKeys = new Set(Object.keys(oldVal));
-        const newKeys = new Set(Object.keys(newVal));
-        // Removed keys
-        for (const key of oldKeys) {
-            if (!newKeys.has(key)) {
-                out.push({
-                    path: `${basePath}/${key}`,
-                    description: "Field removed",
-                    severity: "unknown",
-                });
-            }
-        }
-        // Added / changed keys
-        for (const key of newKeys) {
-            const childPath = `${basePath}/${key}`;
-            if (!oldKeys.has(key)) {
-                out.push({
-                    path: childPath,
-                    description: "Field added",
-                    severity: "unknown",
-                });
-                continue;
-            }
-            const shouldRecurse = options.deepComparison !== false;
-            if (shouldRecurse) {
-                diffValues(oldVal[key], newVal[key], childPath, out, options);
-            }
-        }
-        return;
-    }
-    // Arrays
-    if (Array.isArray(oldVal) && Array.isArray(newVal)) {
-        // Special handling for UniSpec collections identified by "name"
-        const _namedCollectionPaths = options.namedCollectionPaths || DEFAULT_NAMED_COLLECTION_PATHS;
-        const isNamedCollection = (options.namedCollectionPaths || [...DEFAULT_NAMED_COLLECTION_PATHS]).includes(basePath) || basePath.endsWith("/messages"); // Handle messages in channels
-        if (isNamedCollection) {
-            const oldByName = new Map();
-            const newByName = new Map();
-            for (const item of oldVal) {
-                if (item && typeof item === "object" && typeof item.name === "string") {
-                    oldByName.set(item.name, item);
-                }
-            }
-            for (const item of newVal) {
-                if (item && typeof item === "object" && typeof item.name === "string") {
-                    newByName.set(item.name, item);
-                }
-            }
-            // Removed
-            for (const [name, oldItem] of oldByName.entries()) {
-                if (!newByName.has(name)) {
-                    out.push({
-                        path: `${basePath}/${name}`,
-                        description: "Item removed",
-                        severity: "unknown",
-                    });
-                }
-                else {
-                    const newItem = newByName.get(name);
-                    const shouldRecurse = options.deepComparison !== false;
-                    if (shouldRecurse) {
-                        diffValues(oldItem, newItem, `${basePath}/${name}`, out, options);
-                    }
-                }
-            }
-            // Added
-            for (const [name, _newItem] of newByName.entries()) {
-                if (!oldByName.has(name)) {
-                    out.push({
-                        path: `${basePath}/${name}`,
-                        description: "Item added",
-                        severity: "unknown",
-                    });
-                }
-            }
-            return;
-        }
-        // Regular array comparison
-        const maxLength = Math.max(oldVal.length, newVal.length);
-        for (let i = 0; i < maxLength; i++) {
-            if (i >= oldVal.length) {
-                out.push({
-                    path: `${basePath}/${i}`,
-                    description: "Item added",
-                    severity: "unknown",
-                });
-            }
-            else if (i >= newVal.length) {
-                out.push({
-                    path: `${basePath}/${i}`,
-                    description: "Item removed",
-                    severity: "unknown",
-                });
-            }
-            else {
-                const shouldRecurse = options.deepComparison !== false;
-                if (shouldRecurse) {
-                    diffValues(oldVal[i], newVal[i], `${basePath}/${i}`, out, options);
-                }
-            }
-        }
-    }
-    // Primitive values or different types
-    out.push({
-        path: basePath,
-        description: "Value changed",
-        severity: "unknown",
-    });
-}
-/**
- * Compare two UniSpec documents and return detected changes.
- *
- * This function performs a deep comparison between two UniSpec documents
- * and categorizes changes by severity and protocol. Useful for:
- * - API change detection in CI/CD pipelines
- * - Breaking change analysis
- * - Version compatibility checks
- * - Audit trails for API evolution
- *
- * Features:
- * - Detects added/removed fields at any depth
- * - Special handling for named collections (routes, operations, channels)
- * - Severity classification: "breaking" | "non-breaking" | "unknown"
- * - Protocol categorization: "rest" | "graphql" | "websocket"
- * - Detailed change descriptions with JSON paths
- * - Configurable named collection paths and comparison depth
- *
- * @param oldDoc - The previous version of the UniSpec document
- * @param newDoc - The current version of the UniSpec document
- * @param options - Configuration options for diff behavior
- * @returns Object containing all detected changes
- */
-export function diffUniSpec(oldDoc, newDoc, options = {}) {
-    const changes = [];
-    diffValues(oldDoc, newDoc, "", changes, options);
-    const annotated = changes.map((change) => annotateWebSocketChange(annotateGraphQLChange(annotateRestChange(change))));
-    return { changes: annotated };
-}

package/dist/src/diff/enhanced-diff.d.ts

@@ -1,51 +0,0 @@
-import type { UniSpecDocument } from "../types/index.js";
-import { type RiskLevel } from "./risk-calculator.js";
-import type { UniSpecChange } from "./types.js";
-export interface ChangeImpact {
-    backwardCompatibility: "compatible" | "incompatible" | "unknown";
-    clientImpact: "none" | "low" | "medium" | "high";
-    serverImpact: "none" | "low" | "medium" | "high";
-    migrationComplexity: "none" | "simple" | "moderate" | "complex";
-}
-export interface EnhancedUniSpecChange extends UniSpecChange {
-    impact: ChangeImpact;
-    suggestions: string[];
-    examples?: {
-        before: UniSpecDocument;
-        after: UniSpecDocument;
-    };
-    riskLevel: RiskLevel;
-}
-export interface CompatibilityMetrics {
-    overallCompatibility: number;
-    breakingChangesCount: number;
-    nonBreakingChangesCount: number;
-    clientCompatibilityScore: number;
-    serverCompatibilityScore: number;
-    migrationEffort: "minimal" | "moderate" | "significant" | "major";
-}
-export interface EnhancedDiffResult {
-    changes: EnhancedUniSpecChange[];
-    metrics: CompatibilityMetrics;
-    summary: {
-        totalChanges: number;
-        criticalChanges: number;
-        highRiskChanges: number;
-        mediumRiskChanges: number;
-        lowRiskChanges: number;
-    };
-}
-/**
- * Perform enhanced diff analysis with impact assessment and compatibility metrics.
- *
- * This function extends the basic diff functionality with:
- * - Detailed impact analysis for each change
- * - Compatibility metrics
- * - Migration suggestions
- * - Risk assessment
- *
- * @param oldDoc - The previous version of the UniSpec document
- * @param newDoc - The current version of the UniSpec document
- * @returns Enhanced diff result with comprehensive analysis
- */
-export declare function diffUniSpecEnhanced(oldDoc: UniSpecDocument, newDoc: UniSpecDocument): EnhancedDiffResult;

package/dist/src/diff/enhanced-diff.js

@@ -1,62 +0,0 @@
-import { diffUniSpec } from "./core.js";
-import { ImpactAnalysisStrategyFactory } from "./impact-strategies-refactored.js";
-import { MetricsCalculatorService } from "./metrics-calculator.js";
-import { RiskLevelCalculator } from "./risk-calculator.js";
-import { SuggestionGeneratorService } from "./suggestion-generator.js";
-/**
- * Service instances for better separation of concerns.
- */
-const suggestionGenerator = new SuggestionGeneratorService();
-const metricsCalculator = new MetricsCalculatorService();
-/**
- * Perform enhanced diff analysis with impact assessment and compatibility metrics.
- *
- * This function extends the basic diff functionality with:
- * - Detailed impact analysis for each change
- * - Compatibility metrics
- * - Migration suggestions
- * - Risk assessment
- *
- * @param oldDoc - The previous version of the UniSpec document
- * @param newDoc - The current version of the UniSpec document
- * @returns Enhanced diff result with comprehensive analysis
- */
-export function diffUniSpecEnhanced(oldDoc, newDoc) {
-    // Get basic diff
-    const basicDiff = diffUniSpec(oldDoc, newDoc);
-    // Enhance each change with impact analysis using strategy pattern
-    const enhancedChanges = basicDiff.changes.map((change) => {
-        // Get appropriate strategy for the protocol
-        const strategy = ImpactAnalysisStrategyFactory.getStrategy(change.protocol);
-        // Analyze impact using strategy
-        const impact = strategy.analyze(change);
-        // Generate suggestions
-        const suggestions = suggestionGenerator.generateSuggestions(change, impact);
-        // Calculate risk level using calculator
-        const riskLevel = RiskLevelCalculator.calculate(impact);
-        return {
-            ...change,
-            impact,
-            suggestions,
-            riskLevel,
-        };
-    });
-    // Calculate metrics
-    const metrics = metricsCalculator.calculateMetrics(enhancedChanges);
-    // Generate summary
-    const summary = {
-        totalChanges: enhancedChanges.length,
-        criticalChanges: enhancedChanges.filter((c) => c.riskLevel === "critical")
-            .length,
-        highRiskChanges: enhancedChanges.filter((c) => c.riskLevel === "high")
-            .length,
-        mediumRiskChanges: enhancedChanges.filter((c) => c.riskLevel === "medium")
-            .length,
-        lowRiskChanges: enhancedChanges.filter((c) => c.riskLevel === "low").length,
-    };
-    return {
-        changes: enhancedChanges,
-        metrics,
-        summary,
-    };
-}