driftdetect-core 0.4.6 → 0.6.0

package/dist/simulation/scorers/friction-scorer.js

@@ -0,0 +1,336 @@
+/**
+ * Friction Scorer
+ *
+ * Calculates friction metrics for an approach:
+ * - Code churn (how much code needs to change)
+ * - Pattern deviation (how far from established patterns)
+ * - Testing effort (how much testing is needed)
+ * - Refactoring required (structural changes needed)
+ * - Learning curve (complexity for developers)
+ *
+ * @module simulation/scorers/friction-scorer
+ */
+// ============================================================================
+// Friction Scorer
+// ============================================================================
+/**
+ * Scores the friction of implementing an approach
+ */
+export class FrictionScorer {
+    // Config stored for potential future use
+    constructor(_config) {
+        // Config available for future extensions
+    }
+    /**
+     * Calculate friction metrics for an approach
+     */
+    async score(approach) {
+        const breakdown = [];
+        // 1. Code Churn (0-100)
+        const codeChurn = this.calculateCodeChurn(approach);
+        breakdown.push({
+            metric: 'codeChurn',
+            value: codeChurn,
+            weight: 0.25,
+            contribution: codeChurn * 0.25,
+            reason: this.getCodeChurnReason(approach),
+        });
+        // 2. Pattern Deviation (0-100)
+        const patternDeviation = await this.calculatePatternDeviation(approach);
+        breakdown.push({
+            metric: 'patternDeviation',
+            value: patternDeviation,
+            weight: 0.25,
+            contribution: patternDeviation * 0.25,
+            reason: this.getPatternDeviationReason(approach, patternDeviation),
+        });
+        // 3. Testing Effort (0-100)
+        const testingEffort = this.calculateTestingEffort(approach);
+        breakdown.push({
+            metric: 'testingEffort',
+            value: testingEffort,
+            weight: 0.20,
+            contribution: testingEffort * 0.20,
+            reason: this.getTestingEffortReason(approach),
+        });
+        // 4. Refactoring Required (0-100)
+        const refactoringRequired = this.calculateRefactoringRequired(approach);
+        breakdown.push({
+            metric: 'refactoringRequired',
+            value: refactoringRequired,
+            weight: 0.15,
+            contribution: refactoringRequired * 0.15,
+            reason: this.getRefactoringReason(approach),
+        });
+        // 5. Learning Curve (0-100)
+        const learningCurve = this.calculateLearningCurve(approach);
+        breakdown.push({
+            metric: 'learningCurve',
+            value: learningCurve,
+            weight: 0.15,
+            contribution: learningCurve * 0.15,
+            reason: this.getLearningCurveReason(approach),
+        });
+        // Calculate overall friction (weighted average)
+        const overall = breakdown.reduce((sum, b) => sum + b.contribution, 0);
+        return {
+            codeChurn,
+            patternDeviation,
+            testingEffort,
+            refactoringRequired,
+            learningCurve,
+            overall,
+            breakdown,
+        };
+    }
+    // ==========================================================================
+    // Code Churn
+    // ==========================================================================
+    calculateCodeChurn(approach) {
+        const linesAdded = approach.estimatedLinesAdded ?? 0;
+        const linesModified = approach.estimatedLinesModified ?? 0;
+        const filesAffected = approach.targetFiles.length;
+        const newFiles = approach.newFiles?.length ?? 0;
+        // Score based on total changes
+        // Low: < 50 lines, < 3 files
+        // Medium: 50-200 lines, 3-10 files
+        // High: > 200 lines, > 10 files
+        let score = 0;
+        // Lines score (0-50)
+        const totalLines = linesAdded + linesModified;
+        if (totalLines < 50) {
+            score += (totalLines / 50) * 25;
+        }
+        else if (totalLines < 200) {
+            score += 25 + ((totalLines - 50) / 150) * 25;
+        }
+        else {
+            score += 50 + Math.min(50, (totalLines - 200) / 200 * 50);
+        }
+        // Files score (0-50)
+        const totalFiles = filesAffected + newFiles;
+        if (totalFiles < 3) {
+            score += (totalFiles / 3) * 25;
+        }
+        else if (totalFiles < 10) {
+            score += 25 + ((totalFiles - 3) / 7) * 25;
+        }
+        else {
+            score += 50 + Math.min(50, (totalFiles - 10) / 10 * 50);
+        }
+        return Math.min(100, Math.round(score));
+    }
+    getCodeChurnReason(approach) {
+        const linesAdded = approach.estimatedLinesAdded ?? 0;
+        const linesModified = approach.estimatedLinesModified ?? 0;
+        const totalFiles = approach.targetFiles.length + (approach.newFiles?.length ?? 0);
+        if (linesAdded + linesModified < 50 && totalFiles < 3) {
+            return 'Minimal code changes required';
+        }
+        else if (linesAdded + linesModified < 200 && totalFiles < 10) {
+            return 'Moderate code changes across several files';
+        }
+        else {
+            return 'Significant code changes across many files';
+        }
+    }
+    // ==========================================================================
+    // Pattern Deviation
+    // ==========================================================================
+    async calculatePatternDeviation(approach) {
+        // If approach follows patterns, lower deviation
+        const followsPatterns = approach.followsPatterns?.length ?? 0;
+        if (followsPatterns >= 3) {
+            return 10; // Very aligned with patterns
+        }
+        else if (followsPatterns >= 1) {
+            return 30; // Somewhat aligned
+        }
+        // Check if strategy is common for the language
+        const commonStrategies = {
+            typescript: ['middleware', 'decorator', 'wrapper', 'guard'],
+            javascript: ['middleware', 'wrapper'],
+            python: ['decorator', 'middleware', 'mixin'],
+            java: ['aspect', 'interceptor', 'filter', 'guard'],
+            csharp: ['filter', 'middleware', 'attribute'],
+            php: ['middleware', 'policy', 'guard'],
+        };
+        const langStrategies = commonStrategies[approach.language] ?? [];
+        if (langStrategies.includes(approach.strategy)) {
+            return 40; // Common strategy but no pattern match
+        }
+        return 70; // Uncommon approach
+    }
+    getPatternDeviationReason(approach, score) {
+        if (score <= 20) {
+            return `Follows ${approach.followsPatterns?.length ?? 0} established patterns`;
+        }
+        else if (score <= 40) {
+            return 'Partially aligned with existing patterns';
+        }
+        else if (score <= 60) {
+            return 'Uses common strategy but no direct pattern match';
+        }
+        else {
+            return 'May introduce new patterns to the codebase';
+        }
+    }
+    // ==========================================================================
+    // Testing Effort
+    // ==========================================================================
+    calculateTestingEffort(approach) {
+        // Base testing effort on strategy complexity
+        const strategyTestingEffort = {
+            middleware: 40, // Easy to test in isolation
+            decorator: 35, // Easy to test
+            wrapper: 45, // Moderate
+            'per-route': 60, // Need to test each route
+            'per-function': 70, // Need to test each function
+            centralized: 30, // Single point to test
+            distributed: 75, // Many points to test
+            aspect: 50, // Moderate
+            filter: 40, // Easy to test
+            interceptor: 45, // Moderate
+            guard: 35, // Easy to test
+            policy: 40, // Easy to test
+            dependency: 35, // Easy with DI
+            mixin: 50, // Moderate
+            custom: 65, // Unknown complexity
+        };
+        let score = strategyTestingEffort[approach.strategy] ?? 50;
+        // Adjust based on files affected
+        const filesAffected = approach.targetFiles.length;
+        if (filesAffected > 10) {
+            score += 15;
+        }
+        else if (filesAffected > 5) {
+            score += 10;
+        }
+        // Adjust based on new files (need new tests)
+        const newFiles = approach.newFiles?.length ?? 0;
+        score += newFiles * 5;
+        return Math.min(100, Math.round(score));
+    }
+    getTestingEffortReason(approach) {
+        const score = this.calculateTestingEffort(approach);
+        if (score <= 35) {
+            return 'Easy to test in isolation';
+        }
+        else if (score <= 50) {
+            return 'Moderate testing effort required';
+        }
+        else if (score <= 70) {
+            return 'Significant testing effort across multiple components';
+        }
+        else {
+            return 'Extensive testing required due to distributed changes';
+        }
+    }
+    // ==========================================================================
+    // Refactoring Required
+    // ==========================================================================
+    calculateRefactoringRequired(approach) {
+        // Strategies that typically require more refactoring
+        const refactoringIntensity = {
+            middleware: 20, // Usually additive
+            decorator: 15, // Usually additive
+            wrapper: 30, // May need to wrap existing code
+            'per-route': 50, // Need to modify each route
+            'per-function': 60, // Need to modify each function
+            centralized: 25, // May need to redirect calls
+            distributed: 55, // Changes spread out
+            aspect: 20, // Usually non-invasive
+            filter: 25, // Usually additive
+            interceptor: 25, // Usually additive
+            guard: 20, // Usually additive
+            policy: 25, // Usually additive
+            dependency: 35, // May need DI setup
+            mixin: 40, // May need class changes
+            custom: 50, // Unknown
+        };
+        let score = refactoringIntensity[approach.strategy] ?? 40;
+        // Adjust based on modified lines
+        const linesModified = approach.estimatedLinesModified ?? 0;
+        if (linesModified > 100) {
+            score += 20;
+        }
+        else if (linesModified > 50) {
+            score += 10;
+        }
+        return Math.min(100, Math.round(score));
+    }
+    getRefactoringReason(approach) {
+        const score = this.calculateRefactoringRequired(approach);
+        if (score <= 25) {
+            return 'Mostly additive changes, minimal refactoring';
+        }
+        else if (score <= 45) {
+            return 'Some structural changes required';
+        }
+        else if (score <= 65) {
+            return 'Moderate refactoring of existing code';
+        }
+        else {
+            return 'Significant refactoring required';
+        }
+    }
+    // ==========================================================================
+    // Learning Curve
+    // ==========================================================================
+    calculateLearningCurve(approach) {
+        // Base learning curve on strategy familiarity
+        const strategyComplexity = {
+            middleware: 25, // Well-known pattern
+            decorator: 30, // Common but requires understanding
+            wrapper: 25, // Simple concept
+            'per-route': 20, // Straightforward
+            'per-function': 20, // Straightforward
+            centralized: 30, // Need to understand central point
+            distributed: 45, // Need to understand all points
+            aspect: 55, // AOP concepts
+            filter: 25, // Well-known
+            interceptor: 35, // Framework-specific
+            guard: 30, // Framework-specific
+            policy: 35, // Framework-specific
+            dependency: 40, // DI concepts
+            mixin: 45, // Multiple inheritance concepts
+            custom: 50, // Unknown
+        };
+        let score = strategyComplexity[approach.strategy] ?? 40;
+        // Adjust based on framework
+        if (approach.framework) {
+            // Framework-specific approaches may have steeper learning curve
+            // if team is unfamiliar
+            score += 10;
+        }
+        // Adjust based on new files (new concepts to learn)
+        const newFiles = approach.newFiles?.length ?? 0;
+        score += newFiles * 3;
+        return Math.min(100, Math.round(score));
+    }
+    getLearningCurveReason(approach) {
+        const score = this.calculateLearningCurve(approach);
+        if (score <= 30) {
+            return 'Uses familiar patterns, easy to understand';
+        }
+        else if (score <= 45) {
+            return 'Moderate complexity, some learning required';
+        }
+        else if (score <= 60) {
+            return 'Requires understanding of specific concepts';
+        }
+        else {
+            return 'Steep learning curve, advanced concepts';
+        }
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create a friction scorer
+ */
+export function createFrictionScorer(config) {
+    return new FrictionScorer(config);
+}
+//# sourceMappingURL=friction-scorer.js.map

package/dist/simulation/scorers/friction-scorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction-scorer.js","sourceRoot":"","sources":["../../../src/simulation/scorers/friction-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAoBH,+EAA+E;AAC/E,kBAAkB;AAClB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,OAAO,cAAc;IACzB,yCAAyC;IACzC,YAAY,OAA6B;QACvC,yCAAyC;IAC3C,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK,CAAC,QAA4B;QACtC,MAAM,SAAS,GAAwB,EAAE,CAAC;QAE1C,wBAAwB;QACxB,MAAM,SAAS,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QACpD,SAAS,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,WAAW;YACnB,KAAK,EAAE,SAAS;YAChB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,SAAS,GAAG,IAAI;YAC9B,MAAM,EAAE,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC;SAC1C,CAAC,CAAC;QAEH,+BAA+B;QAC/B,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC,yBAAyB,CAAC,QAAQ,CAAC,CAAC;QACxE,SAAS,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,kBAAkB;YAC1B,KAAK,EAAE,gBAAgB;YACvB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,gBAAgB,GAAG,IAAI;YACrC,MAAM,EAAE,IAAI,CAAC,yBAAyB,CAAC,QAAQ,EAAE,gBAAgB,CAAC;SACnE,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,aAAa,GAAG,IAAI;YAClC,MAAM,EAAE,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;SAC9C,CAAC,CAAC;QAEH,kCAAkC;QAClC,MAAM,mBAAmB,GAAG,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QACxE,SAAS,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,qBAAqB;YAC7B,KAAK,EAAE,mBAAmB;YAC1B,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,mBAAmB,GAAG,IAAI;YACxC,MAAM,EAAE,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC;SAC5C,CAAC,CAAC;QAEH,4BAA4B;QAC5B,MAAM,aAAa,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QAC5D,SAAS,CAAC,IAAI,CAAC;YACb,MAAM,EAAE,eAAe;YACvB,KAAK,EAAE,aAAa;YACpB,MAAM,EAAE,IAAI;YACZ,YAAY,EAAE,aAAa,GAAG,IAAI;YAClC,MAAM,EAAE,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC;SAC9C,CAAC,CAAC;QAEH,gDAAgD;QAChD,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;QAEtE,OAAO;YACL,SAAS;YACT,gBAAgB;YAChB,aAAa;YACb,mBAAmB;YACnB,aAAa;YACb,OAAO;YACP,SAAS;SACV,CAAC;IACJ,CAAC;IAED,6EAA6E;IAC7E,aAAa;IACb,6EAA6E;IAErE,kBAAkB,CAAC,QAA4B;QACrD,MAAM,UAAU,GAAG,QAAQ,CAAC,mBAAmB,IAAI,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,sBAAsB,IAAI,CAAC,CAAC;QAC3D,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;QAClD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;QAEhD,+BAA+B;QAC/B,6BAA6B;QAC7B,mCAAmC;QACnC,gCAAgC;QAEhC,IAAI,KAAK,GAAG,CAAC,CAAC;QAEd,qBAAqB;QACrB,MAAM,UAAU,GAAG,UAAU,GAAG,aAAa,CAAC;QAC9C,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YACpB,KAAK,IAAI,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;QAClC,CAAC;aAAM,IAAI,UAAU,GAAG,GAAG,EAAE,CAAC;YAC5B,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAC5D,CAAC;QAED,qBAAqB;QACrB,MAAM,UAAU,GAAG,aAAa,GAAG,QAAQ,CAAC;QAC5C,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACnB,KAAK,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QACjC,CAAC;aAAM,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YAC3B,KAAK,IAAI,EAAE,GAAG,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,KAAK,IAAI,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1D,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEO,kBAAkB,CAAC,QAA4B;QACrD,MAAM,UAAU,GAAG,QAAQ,CAAC,mBAAmB,IAAI,CAAC,CAAC;QACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,sBAAsB,IAAI,CAAC,CAAC;QAC3D,MAAM,UAAU,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC;QAElF,IAAI,UAAU,GAAG,aAAa,GAAG,EAAE,IAAI,UAAU,GAAG,CAAC,EAAE,CAAC;YACtD,OAAO,+BAA+B,CAAC;QACzC,CAAC;aAAM,IAAI,UAAU,GAAG,aAAa,GAAG,GAAG,IAAI,UAAU,GAAG,EAAE,EAAE,CAAC;YAC/D,OAAO,4CAA4C,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,OAAO,4CAA4C,CAAC;QACtD,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,oBAAoB;IACpB,6EAA6E;IAErE,KAAK,CAAC,yBAAyB,CAAC,QAA4B;QAClE,gDAAgD;QAChD,MAAM,eAAe,GAAG,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,CAAC;QAE9D,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,CAAC,CAAC,6BAA6B;QAC1C,CAAC;aAAM,IAAI,eAAe,IAAI,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,CAAC,mBAAmB;QAChC,CAAC;QAED,+CAA+C;QAC/C,MAAM,gBAAgB,GAA6B;YACjD,UAAU,EAAE,CAAC,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,CAAC;YAC3D,UAAU,EAAE,CAAC,YAAY,EAAE,SAAS,CAAC;YACrC,MAAM,EAAE,CAAC,WAAW,EAAE,YAAY,EAAE,OAAO,CAAC;YAC5C,IAAI,EAAE,CAAC,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,OAAO,CAAC;YAClD,MAAM,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC;YAC7C,GAAG,EAAE,CAAC,YAAY,EAAE,QAAQ,EAAE,OAAO,CAAC;SACvC,CAAC;QAEF,MAAM,cAAc,GAAG,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACjE,IAAI,cAAc,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,OAAO,EAAE,CAAC,CAAC,uCAAuC;QACpD,CAAC;QAED,OAAO,EAAE,CAAC,CAAC,oBAAoB;IACjC,CAAC;IAEO,yBAAyB,CAAC,QAA4B,EAAE,KAAa;QAC3E,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,WAAW,QAAQ,CAAC,eAAe,EAAE,MAAM,IAAI,CAAC,uBAAuB,CAAC;QACjF,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,0CAA0C,CAAC;QACpD,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,kDAAkD,CAAC;QAC5D,CAAC;aAAM,CAAC;YACN,OAAO,4CAA4C,CAAC;QACtD,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAErE,sBAAsB,CAAC,QAA4B;QACzD,6CAA6C;QAC7C,MAAM,qBAAqB,GAA2B;YACpD,UAAU,EAAE,EAAE,EAAE,4BAA4B;YAC5C,SAAS,EAAE,EAAE,EAAE,eAAe;YAC9B,OAAO,EAAE,EAAE,EAAE,WAAW;YACxB,WAAW,EAAE,EAAE,EAAE,0BAA0B;YAC3C,cAAc,EAAE,EAAE,EAAE,6BAA6B;YACjD,WAAW,EAAE,EAAE,EAAE,uBAAuB;YACxC,WAAW,EAAE,EAAE,EAAE,sBAAsB;YACvC,MAAM,EAAE,EAAE,EAAE,WAAW;YACvB,MAAM,EAAE,EAAE,EAAE,eAAe;YAC3B,WAAW,EAAE,EAAE,EAAE,WAAW;YAC5B,KAAK,EAAE,EAAE,EAAE,eAAe;YAC1B,MAAM,EAAE,EAAE,EAAE,eAAe;YAC3B,UAAU,EAAE,EAAE,EAAE,eAAe;YAC/B,KAAK,EAAE,EAAE,EAAE,WAAW;YACtB,MAAM,EAAE,EAAE,EAAE,qBAAqB;SAClC,CAAC;QAEF,IAAI,KAAK,GAAG,qBAAqB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE3D,iCAAiC;QACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,WAAW,CAAC,MAAM,CAAC;QAClD,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;YACvB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,6CAA6C;QAC7C,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;QAChD,KAAK,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEO,sBAAsB,CAAC,QAA4B;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,2BAA2B,CAAC;QACrC,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,kCAAkC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,uDAAuD,CAAC;QACjE,CAAC;aAAM,CAAC;YACN,OAAO,uDAAuD,CAAC;QACjE,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,uBAAuB;IACvB,6EAA6E;IAErE,4BAA4B,CAAC,QAA4B;QAC/D,qDAAqD;QACrD,MAAM,oBAAoB,GAA2B;YACnD,UAAU,EAAE,EAAE,EAAE,mBAAmB;YACnC,SAAS,EAAE,EAAE,EAAE,mBAAmB;YAClC,OAAO,EAAE,EAAE,EAAE,iCAAiC;YAC9C,WAAW,EAAE,EAAE,EAAE,4BAA4B;YAC7C,cAAc,EAAE,EAAE,EAAE,+BAA+B;YACnD,WAAW,EAAE,EAAE,EAAE,6BAA6B;YAC9C,WAAW,EAAE,EAAE,EAAE,qBAAqB;YACtC,MAAM,EAAE,EAAE,EAAE,uBAAuB;YACnC,MAAM,EAAE,EAAE,EAAE,mBAAmB;YAC/B,WAAW,EAAE,EAAE,EAAE,mBAAmB;YACpC,KAAK,EAAE,EAAE,EAAE,mBAAmB;YAC9B,MAAM,EAAE,EAAE,EAAE,mBAAmB;YAC/B,UAAU,EAAE,EAAE,EAAE,oBAAoB;YACpC,KAAK,EAAE,EAAE,EAAE,yBAAyB;YACpC,MAAM,EAAE,EAAE,EAAE,UAAU;SACvB,CAAC;QAEF,IAAI,KAAK,GAAG,oBAAoB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAE1D,iCAAiC;QACjC,MAAM,aAAa,GAAG,QAAQ,CAAC,sBAAsB,IAAI,CAAC,CAAC;QAC3D,IAAI,aAAa,GAAG,GAAG,EAAE,CAAC;YACxB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;aAAM,IAAI,aAAa,GAAG,EAAE,EAAE,CAAC;YAC9B,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEO,oBAAoB,CAAC,QAA4B;QACvD,MAAM,KAAK,GAAG,IAAI,CAAC,4BAA4B,CAAC,QAAQ,CAAC,CAAC;QAC1D,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,8CAA8C,CAAC;QACxD,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,kCAAkC,CAAC;QAC5C,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,uCAAuC,CAAC;QACjD,CAAC;aAAM,CAAC;YACN,OAAO,kCAAkC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,6EAA6E;IAC7E,iBAAiB;IACjB,6EAA6E;IAErE,sBAAsB,CAAC,QAA4B;QACzD,8CAA8C;QAC9C,MAAM,kBAAkB,GAA2B;YACjD,UAAU,EAAE,EAAE,EAAE,qBAAqB;YACrC,SAAS,EAAE,EAAE,EAAE,oCAAoC;YACnD,OAAO,EAAE,EAAE,EAAE,iBAAiB;YAC9B,WAAW,EAAE,EAAE,EAAE,kBAAkB;YACnC,cAAc,EAAE,EAAE,EAAE,kBAAkB;YACtC,WAAW,EAAE,EAAE,EAAE,mCAAmC;YACpD,WAAW,EAAE,EAAE,EAAE,gCAAgC;YACjD,MAAM,EAAE,EAAE,EAAE,eAAe;YAC3B,MAAM,EAAE,EAAE,EAAE,aAAa;YACzB,WAAW,EAAE,EAAE,EAAE,qBAAqB;YACtC,KAAK,EAAE,EAAE,EAAE,qBAAqB;YAChC,MAAM,EAAE,EAAE,EAAE,qBAAqB;YACjC,UAAU,EAAE,EAAE,EAAE,cAAc;YAC9B,KAAK,EAAE,EAAE,EAAE,gCAAgC;YAC3C,MAAM,EAAE,EAAE,EAAE,UAAU;SACvB,CAAC;QAEF,IAAI,KAAK,GAAG,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAExD,4BAA4B;QAC5B,IAAI,QAAQ,CAAC,SAAS,EAAE,CAAC;YACvB,gEAAgE;YAChE,wBAAwB;YACxB,KAAK,IAAI,EAAE,CAAC;QACd,CAAC;QAED,oDAAoD;QACpD,MAAM,QAAQ,GAAG,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC,CAAC;QAChD,KAAK,IAAI,QAAQ,GAAG,CAAC,CAAC;QAEtB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAC1C,CAAC;IAEO,sBAAsB,CAAC,QAA4B;QACzD,MAAM,KAAK,GAAG,IAAI,CAAC,sBAAsB,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YAChB,OAAO,4CAA4C,CAAC;QACtD,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,6CAA6C,CAAC;QACvD,CAAC;aAAM,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;YACvB,OAAO,6CAA6C,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,OAAO,yCAAyC,CAAC;QACnD,CAAC;IACH,CAAC;CACF;AAED,+EAA+E;AAC/E,mBAAmB;AACnB,+EAA+E;AAE/E;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAA4B;IAC/D,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;AACpC,CAAC"}

package/dist/simulation/scorers/impact-scorer.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Impact Scorer
+ *
+ * Calculates impact metrics for an approach using the call graph:
+ * - Files affected
+ * - Functions affected
+ * - Entry points affected
+ * - Sensitive data paths
+ * - Risk assessment
+ *
+ * @module simulation/scorers/impact-scorer
+ */
+import type { CallGraph } from '../../call-graph/types.js';
+import type { SimulationApproach, ImpactMetrics } from '../types.js';
+export interface ImpactScorerConfig {
+    projectRoot: string;
+    callGraph?: CallGraph | undefined;
+    maxDepth?: number | undefined;
+}
+/**
+ * Scores the impact of implementing an approach
+ */
+export declare class ImpactScorer {
+    private readonly config;
+    private impactAnalyzer;
+    constructor(config: ImpactScorerConfig);
+    /**
+     * Calculate impact metrics for an approach
+     */
+    score(approach: SimulationApproach): Promise<ImpactMetrics>;
+    /**
+     * Analyze impact of all target files
+     */
+    private analyzeTargetFiles;
+    /**
+     * Calculate overall risk score (0-100)
+     */
+    private calculateRiskScore;
+    /**
+     * Get risk level from score
+     */
+    private getRiskLevel;
+    /**
+     * Detect potential breaking changes
+     */
+    private detectBreakingChanges;
+    /**
+     * Estimate impact when call graph is not available
+     */
+    private estimateImpact;
+}
+/**
+ * Create an impact scorer
+ */
+export declare function createImpactScorer(config: ImpactScorerConfig): ImpactScorer;
+//# sourceMappingURL=impact-scorer.d.ts.map

package/dist/simulation/scorers/impact-scorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-scorer.d.ts","sourceRoot":"","sources":["../../../src/simulation/scorers/impact-scorer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAE3D,OAAO,KAAK,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,aAAa,CAAC;AAMrB,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B;AAMD;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAA+B;gBAEzC,MAAM,EAAE,kBAAkB;IAOtC;;OAEG;IACG,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,aAAa,CAAC;IAoCjE;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA2D1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4D1B;;OAEG;IACH,OAAO,CAAC,YAAY;IAWpB;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAwC7B;;OAEG;IACH,OAAO,CAAC,cAAc;CAiDvB;AAMD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,kBAAkB,GAAG,YAAY,CAE3E"}

package/dist/simulation/scorers/impact-scorer.js

@@ -0,0 +1,273 @@
+/**
+ * Impact Scorer
+ *
+ * Calculates impact metrics for an approach using the call graph:
+ * - Files affected
+ * - Functions affected
+ * - Entry points affected
+ * - Sensitive data paths
+ * - Risk assessment
+ *
+ * @module simulation/scorers/impact-scorer
+ */
+import { ImpactAnalyzer } from '../../call-graph/analysis/impact-analyzer.js';
+// ============================================================================
+// Impact Scorer
+// ============================================================================
+/**
+ * Scores the impact of implementing an approach
+ */
+export class ImpactScorer {
+    config;
+    impactAnalyzer = null;
+    constructor(config) {
+        this.config = config;
+        if (config.callGraph) {
+            this.impactAnalyzer = new ImpactAnalyzer(config.callGraph);
+        }
+    }
+    /**
+     * Calculate impact metrics for an approach
+     */
+    async score(approach) {
+        // If no call graph, estimate from approach metadata
+        if (!this.impactAnalyzer || !this.config.callGraph) {
+            return this.estimateImpact(approach);
+        }
+        // Analyze impact of each target file
+        const combinedResult = this.analyzeTargetFiles(approach.targetFiles);
+        // Calculate risk score
+        const riskScore = this.calculateRiskScore(combinedResult, approach);
+        const riskLevel = this.getRiskLevel(riskScore);
+        // Detect breaking changes
+        const { breakingChanges, breakingChangeRisks } = this.detectBreakingChanges(combinedResult, approach);
+        return {
+            filesAffected: combinedResult.filesAffected,
+            functionsAffected: combinedResult.functionsAffected,
+            entryPointsAffected: combinedResult.entryPointsAffected,
+            sensitiveDataPaths: combinedResult.sensitiveDataPaths,
+            riskScore,
+            riskLevel,
+            breakingChanges,
+            breakingChangeRisks,
+            maxDepthAffected: combinedResult.maxDepth,
+        };
+    }
+    // ==========================================================================
+    // Impact Analysis
+    // ==========================================================================
+    /**
+     * Analyze impact of all target files
+     */
+    analyzeTargetFiles(targetFiles) {
+        if (!this.impactAnalyzer) {
+            return {
+                filesAffected: targetFiles.length,
+                functionsAffected: 0,
+                entryPointsAffected: 0,
+                sensitiveDataPaths: 0,
+                maxDepth: 0,
+                results: [],
+            };
+        }
+        const results = [];
+        const affectedFiles = new Set();
+        const affectedFunctions = new Set();
+        const affectedEntryPoints = new Set();
+        let sensitiveDataPaths = 0;
+        let maxDepth = 0;
+        for (const file of targetFiles) {
+            const result = this.impactAnalyzer.analyzeFile(file, {
+                maxDepth: this.config.maxDepth ?? 10,
+            });
+            results.push(result);
+            // Collect affected items
+            for (const affected of result.affected) {
+                affectedFiles.add(affected.file);
+                affectedFunctions.add(affected.id);
+                if (affected.isEntryPoint) {
+                    affectedEntryPoints.add(affected.id);
+                }
+            }
+            sensitiveDataPaths += result.sensitiveDataPaths.length;
+            maxDepth = Math.max(maxDepth, result.summary.maxDepth);
+        }
+        return {
+            filesAffected: affectedFiles.size,
+            functionsAffected: affectedFunctions.size,
+            entryPointsAffected: affectedEntryPoints.size,
+            sensitiveDataPaths,
+            maxDepth,
+            results,
+        };
+    }
+    // ==========================================================================
+    // Risk Calculation
+    // ==========================================================================
+    /**
+     * Calculate overall risk score (0-100)
+     */
+    calculateRiskScore(analysis, approach) {
+        let score = 0;
+        // Files affected (0-25)
+        if (analysis.filesAffected > 20) {
+            score += 25;
+        }
+        else if (analysis.filesAffected > 10) {
+            score += 20;
+        }
+        else if (analysis.filesAffected > 5) {
+            score += 15;
+        }
+        else {
+            score += analysis.filesAffected * 2;
+        }
+        // Entry points affected (0-30)
+        if (analysis.entryPointsAffected > 10) {
+            score += 30;
+        }
+        else if (analysis.entryPointsAffected > 5) {
+            score += 25;
+        }
+        else if (analysis.entryPointsAffected > 2) {
+            score += 15;
+        }
+        else {
+            score += analysis.entryPointsAffected * 5;
+        }
+        // Sensitive data paths (0-30)
+        if (analysis.sensitiveDataPaths > 5) {
+            score += 30;
+        }
+        else if (analysis.sensitiveDataPaths > 2) {
+            score += 20;
+        }
+        else if (analysis.sensitiveDataPaths > 0) {
+            score += 10;
+        }
+        // Strategy risk (0-15)
+        const strategyRisk = {
+            middleware: 5,
+            decorator: 5,
+            wrapper: 8,
+            'per-route': 10,
+            'per-function': 12,
+            centralized: 6,
+            distributed: 12,
+            aspect: 7,
+            filter: 6,
+            interceptor: 7,
+            guard: 5,
+            policy: 6,
+            dependency: 8,
+            mixin: 10,
+            custom: 12,
+        };
+        score += strategyRisk[approach.strategy] ?? 10;
+        return Math.min(100, Math.round(score));
+    }
+    /**
+     * Get risk level from score
+     */
+    getRiskLevel(score) {
+        if (score >= 75)
+            return 'critical';
+        if (score >= 50)
+            return 'high';
+        if (score >= 25)
+            return 'medium';
+        return 'low';
+    }
+    // ==========================================================================
+    // Breaking Changes Detection
+    // ==========================================================================
+    /**
+     * Detect potential breaking changes
+     */
+    detectBreakingChanges(analysis, approach) {
+        const risks = [];
+        // Check for entry point modifications
+        if (analysis.entryPointsAffected > 0) {
+            risks.push(`${analysis.entryPointsAffected} API entry points may be affected`);
+        }
+        // Check for sensitive data path changes
+        if (analysis.sensitiveDataPaths > 0) {
+            risks.push(`${analysis.sensitiveDataPaths} sensitive data paths may be affected`);
+        }
+        // Check strategy-specific risks
+        if (approach.strategy === 'per-route' || approach.strategy === 'per-function') {
+            risks.push('Distributed changes may affect API contracts');
+        }
+        if (approach.strategy === 'wrapper') {
+            risks.push('Wrapper may change function signatures');
+        }
+        // Check for high depth impact
+        if (analysis.maxDepth > 5) {
+            risks.push(`Changes ripple ${analysis.maxDepth} levels deep in call graph`);
+        }
+        return {
+            breakingChanges: risks.length > 0,
+            breakingChangeRisks: risks,
+        };
+    }
+    // ==========================================================================
+    // Estimation (when no call graph)
+    // ==========================================================================
+    /**
+     * Estimate impact when call graph is not available
+     */
+    estimateImpact(approach) {
+        const filesAffected = approach.targetFiles.length + (approach.newFiles?.length ?? 0);
+        // Estimate functions based on files
+        const functionsAffected = filesAffected * 3;
+        // Estimate entry points based on strategy
+        const entryPointMultiplier = {
+            middleware: 0.5,
+            decorator: 0.3,
+            wrapper: 0.4,
+            'per-route': 1.0,
+            'per-function': 0.8,
+            centralized: 0.2,
+            distributed: 0.7,
+            aspect: 0.3,
+            filter: 0.4,
+            interceptor: 0.4,
+            guard: 0.3,
+            policy: 0.3,
+            dependency: 0.2,
+            mixin: 0.4,
+            custom: 0.5,
+        };
+        const multiplier = entryPointMultiplier[approach.strategy] ?? 0.5;
+        const entryPointsAffected = Math.round(filesAffected * multiplier);
+        // Calculate risk score
+        let riskScore = 0;
+        riskScore += Math.min(25, filesAffected * 3);
+        riskScore += Math.min(30, entryPointsAffected * 5);
+        riskScore += 10; // Base uncertainty
+        const riskLevel = this.getRiskLevel(riskScore);
+        return {
+            filesAffected,
+            functionsAffected,
+            entryPointsAffected,
+            sensitiveDataPaths: 0, // Unknown without call graph
+            riskScore,
+            riskLevel,
+            breakingChanges: entryPointsAffected > 0,
+            breakingChangeRisks: entryPointsAffected > 0
+                ? ['Entry points may be affected (call graph not available for precise analysis)']
+                : [],
+            maxDepthAffected: 0,
+        };
+    }
+}
+// ============================================================================
+// Factory Function
+// ============================================================================
+/**
+ * Create an impact scorer
+ */
+export function createImpactScorer(config) {
+    return new ImpactScorer(config);
+}
+//# sourceMappingURL=impact-scorer.js.map