@opencodereview/core 1.9.1

package/dist/scorer/scoring-engine.js

@@ -0,0 +1,308 @@
+/**
+ * Scoring Engine V3
+ *
+ * Multi-dimensional scoring engine for AI-generated code quality.
+ *
+ * V3 scoring dimensions (total: 100):
+ *   - AI Faithfulness       (35): Hallucination — packages/APIs/methods existence
+ *   - Code Freshness        (25): Timeliness — deprecated APIs and methods
+ *   - Context Coherence     (20): Consistency across long files and functions
+ *   - Implementation Quality (20): Completeness, error handling, complexity
+ *
+ * Grade scale: A+ (95-100), A (90-94), B (80-89), C (70-79), D (60-69), F (0-59)
+ *
+ * Backward compatible: legacy scoreFile() is preserved (deprecated).
+ */
+import { AIDefectCategory } from '../types.js';
+// ─── V3 Scoring Dimensions ─────────────────────────────────────────
+export const DIMENSIONS = {
+    aiFaithfulness: { weight: 35, name: 'AI Faithfulness' },
+    codeFreshness: { weight: 25, name: 'Code Freshness' },
+    contextCoherence: { weight: 20, name: 'Context Coherence' },
+    implementationQuality: { weight: 20, name: 'Implementation Quality' },
+};
+// ─── Severity Deductions ───────────────────────────────────────────
+export const SEVERITY_DEDUCTIONS = {
+    critical: 15,
+    high: 10,
+    medium: 5,
+    low: 2,
+    info: 0,
+};
+// ─── Category → Dimension Mapping ──────────────────────────────────
+/**
+ * Maps each AIDefectCategory to a scoring dimension.
+ */
+export const CATEGORY_DIMENSION_MAP = {
+    [AIDefectCategory.HALLUCINATION]: 'aiFaithfulness',
+    [AIDefectCategory.SECURITY_ANTIPATTERN]: 'aiFaithfulness',
+    [AIDefectCategory.TRAINING_LEAK]: 'aiFaithfulness',
+    [AIDefectCategory.STALE_KNOWLEDGE]: 'codeFreshness',
+    [AIDefectCategory.CONTEXT_LOSS]: 'contextCoherence',
+    [AIDefectCategory.INCOMPLETE_IMPL]: 'implementationQuality',
+    [AIDefectCategory.OVER_ENGINEERING]: 'implementationQuality',
+    [AIDefectCategory.DUPLICATION]: 'implementationQuality',
+    [AIDefectCategory.TYPE_SAFETY]: 'implementationQuality',
+    [AIDefectCategory.ERROR_HANDLING]: 'implementationQuality',
+};
+// ─── Grade Computation ─────────────────────────────────────────────
+export function computeGrade(score) {
+    if (score >= 95)
+        return 'A+';
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+/** Legacy grade (without A+) for backward compatibility */
+function computeLegacyGrade(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 80)
+        return 'B';
+    if (score >= 70)
+        return 'C';
+    if (score >= 60)
+        return 'D';
+    return 'F';
+}
+// ─── Scoring Engine ────────────────────────────────────────────────
+export class ScoringEngine {
+    threshold;
+    constructor(threshold = 70) {
+        this.threshold = threshold;
+    }
+    // ─── V3 API ────────────────────────────────────────────────────
+    /**
+     * Score a set of UnifiedIssues.
+     * Can be used for file-level or project-level scoring.
+     */
+    score(issues) {
+        const dimensionIssues = this.groupByDimension(issues);
+        const dimensions = this.scoreDimensions(dimensionIssues);
+        const totalScore = Math.round(Object.values(dimensions).reduce((sum, d) => sum + d.score, 0));
+        return {
+            totalScore,
+            grade: computeGrade(totalScore),
+            dimensions,
+            issueCount: issues.length,
+            passed: totalScore >= this.threshold,
+            threshold: this.threshold,
+        };
+    }
+    /**
+     * Score issues grouped by file, returning per-file scores.
+     */
+    scoreByFile(issues) {
+        const fileMap = new Map();
+        for (const issue of issues) {
+            const existing = fileMap.get(issue.file);
+            if (existing) {
+                existing.push(issue);
+            }
+            else {
+                fileMap.set(issue.file, [issue]);
+            }
+        }
+        return Array.from(fileMap.entries()).map(([file, fileIssues]) => {
+            const result = this.score(fileIssues);
+            return { ...result, file };
+        });
+    }
+    /**
+     * Aggregate scores across multiple files into a project-level report.
+     */
+    aggregateV3(issues) {
+        const fileScores = this.scoreByFile(issues);
+        if (fileScores.length === 0) {
+            return {
+                overallScore: 100,
+                grade: 'A+',
+                totalFiles: 0,
+                passedFiles: 0,
+                failedFiles: 0,
+                files: [],
+                dimensions: this.emptyDimensions(),
+                issueCount: 0,
+                passed: true,
+                threshold: this.threshold,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        // Project-level score: score ALL issues together (not average of file scores)
+        const projectScore = this.score(issues);
+        const passedFiles = fileScores.filter(f => f.passed).length;
+        return {
+            overallScore: projectScore.totalScore,
+            grade: projectScore.grade,
+            totalFiles: fileScores.length,
+            passedFiles,
+            failedFiles: fileScores.length - passedFiles,
+            files: fileScores,
+            dimensions: projectScore.dimensions,
+            issueCount: issues.length,
+            passed: projectScore.passed,
+            threshold: this.threshold,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // ─── Legacy API (backward compatibility) ───────────────────────
+    /**
+     * @deprecated Use `score(issues)` instead.
+     * Score a single file based on legacy detector results.
+     */
+    scoreFile(filePath, hallucination, logicGap, duplication, contextBreak) {
+        const completeness = this.scoreLegacyDimension('Code Completeness', 30, hallucination?.issues ?? []);
+        const coherence = this.scoreLegacyDimension('Logic Coherence', 25, logicGap?.issues ?? []);
+        const consistency = this.scoreLegacyDimension('Architecture Consistency', 25, contextBreak?.issues ?? []);
+        const conciseness = this.scoreLegacyDimension('Code Conciseness', 20, duplication?.issues ?? []);
+        const totalScore = Math.round(completeness.score + coherence.score + consistency.score + conciseness.score);
+        return {
+            file: filePath,
+            totalScore,
+            grade: computeLegacyGrade(totalScore),
+            dimensions: { completeness, coherence, consistency, conciseness },
+            passed: totalScore >= this.threshold,
+        };
+    }
+    /**
+     * @deprecated Use `aggregateV3(issues)` instead.
+     * Aggregate scores across multiple files (legacy format).
+     */
+    aggregate(fileScores) {
+        if (fileScores.length === 0) {
+            return {
+                overallScore: 100,
+                grade: 'A',
+                totalFiles: 0,
+                passedFiles: 0,
+                failedFiles: 0,
+                files: [],
+                passed: true,
+                timestamp: new Date().toISOString(),
+            };
+        }
+        const overallScore = Math.round(fileScores.reduce((sum, f) => sum + f.totalScore, 0) / fileScores.length);
+        const passedFiles = fileScores.filter(f => f.passed).length;
+        return {
+            overallScore,
+            grade: computeLegacyGrade(overallScore),
+            totalFiles: fileScores.length,
+            passedFiles,
+            failedFiles: fileScores.length - passedFiles,
+            files: fileScores,
+            passed: overallScore >= this.threshold,
+            timestamp: new Date().toISOString(),
+        };
+    }
+    // ─── Internal Scoring Logic ────────────────────────────────────
+    /**
+     * Group issues by scoring dimension based on their category.
+     */
+    groupByDimension(issues) {
+        const groups = {
+            aiFaithfulness: [],
+            codeFreshness: [],
+            contextCoherence: [],
+            implementationQuality: [],
+        };
+        for (const issue of issues) {
+            const dimensionId = CATEGORY_DIMENSION_MAP[issue.category];
+            if (dimensionId) {
+                groups[dimensionId].push(issue);
+            }
+            else {
+                // Default unmapped categories to implementationQuality
+                groups.implementationQuality.push(issue);
+            }
+        }
+        return groups;
+    }
+    /**
+     * Score all dimensions from grouped issues.
+     */
+    scoreDimensions(grouped) {
+        const result = {};
+        for (const [id, config] of Object.entries(DIMENSIONS)) {
+            const issues = grouped[id] ?? [];
+            result[id] = this.scoreSingleDimension(id, config, issues);
+        }
+        return result;
+    }
+    /**
+     * Score a single dimension.
+     *
+     * Deduction calculation:
+     *   1. Sum raw deductions: Σ SEVERITY_DEDUCTIONS[issue.severity]
+     *   2. Normalize to dimension weight range:
+     *      normalizedDeduction = min(maxScore, (rawDeduction / 100) * maxScore)
+     *   3. Dimension score = maxScore - normalizedDeduction (clamped to [0, maxScore])
+     */
+    scoreSingleDimension(id, config, issues) {
+        const maxScore = config.weight;
+        let rawDeduction = 0;
+        for (const issue of issues) {
+            rawDeduction += SEVERITY_DEDUCTIONS[issue.severity] ?? 0;
+        }
+        const normalizedDeduction = Math.min(maxScore, (rawDeduction / 100) * maxScore);
+        const score = Math.max(0, Math.round((maxScore - normalizedDeduction) * 100) / 100);
+        return {
+            id,
+            name: config.name,
+            maxScore,
+            score,
+            issueCount: issues.length,
+            rawDeduction,
+            normalizedDeduction: Math.round(normalizedDeduction * 100) / 100,
+            issues,
+        };
+    }
+    /**
+     * Create empty dimension scores (for zero-issue projects).
+     */
+    emptyDimensions() {
+        const result = {};
+        for (const [id, config] of Object.entries(DIMENSIONS)) {
+            result[id] = {
+                id,
+                name: config.name,
+                maxScore: config.weight,
+                score: config.weight,
+                issueCount: 0,
+                rawDeduction: 0,
+                normalizedDeduction: 0,
+                issues: [],
+            };
+        }
+        return result;
+    }
+    /**
+     * Legacy dimension scoring for backward compatibility.
+     */
+    scoreLegacyDimension(name, maxScore, issues) {
+        const LEGACY_DEDUCTIONS = { error: 10, warning: 3 };
+        let deduction = 0;
+        const details = [];
+        for (const issue of issues) {
+            const amount = LEGACY_DEDUCTIONS[issue.severity] ?? LEGACY_DEDUCTIONS.warning;
+            deduction += amount;
+            details.push(issue.message);
+        }
+        const normalizedDeduction = Math.min(maxScore, (deduction / 100) * maxScore);
+        const score = Math.round((maxScore - normalizedDeduction) * 100) / 100;
+        return {
+            name,
+            maxScore,
+            score: Math.max(0, score),
+            issueCount: issues.length,
+            details: details.slice(0, 10),
+        };
+    }
+}
+export default ScoringEngine;
+//# sourceMappingURL=scoring-engine.js.map

package/dist/scorer/scoring-engine.js.map

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

package/dist/scorer/v4-adapter.d.ts

@@ -0,0 +1,87 @@
+/**
+ * V4 Score Adapter
+ *
+ * Bridges V4 DetectorResults to V3 scoring engine.
+ * Reuses V3 scoring logic (4 dimensions, 5 grades).
+ *
+ * @since 0.4.0
+ */
+import type { DetectorResult, DetectorCategory } from '../detectors/v4/types.js';
+import type { UnifiedIssue } from '../types.js';
+import { computeGrade } from '../scorer/scoring-engine.js';
+/**
+ * Convert a V4 DetectorResult to V3 UnifiedIssue format.
+ */
+export declare function v4ResultToV3Issue(result: DetectorResult): UnifiedIssue;
+/**
+ * Convert an array of V4 DetectorResults to V3 UnifiedIssues.
+ */
+export declare function v4ResultsToV3Issues(results: DetectorResult[]): UnifiedIssue[];
+/**
+ * Score result for V4 scan.
+ */
+export interface V4ScoreResult {
+    /** Total score (0-100) */
+    totalScore: number;
+    /** Letter grade */
+    grade: string;
+    /** Per-dimension scores */
+    dimensions: {
+        faithfulness: DimensionInfo;
+        freshness: DimensionInfo;
+        coherence: DimensionInfo;
+        quality: DimensionInfo;
+    };
+    /** Total issue count */
+    issueCount: number;
+    /** Whether the score passes the threshold */
+    passed: boolean;
+    /** The threshold used */
+    threshold: number;
+}
+/**
+ * Score info for a single dimension.
+ */
+export interface DimensionInfo {
+    /** Dimension name */
+    name: string;
+    /** Maximum possible score */
+    maxScore: number;
+    /** Actual score */
+    score: number;
+    /** Number of issues in this dimension */
+    issueCount: number;
+    /** Score as percentage */
+    percentage: number;
+}
+/**
+ * Score V4 results using the V3 scoring engine.
+ *
+ * @param results - V4 DetectorResults
+ * @param fileCount - Number of files scanned
+ * @param threshold - Passing threshold (default: 70)
+ * @returns V4ScoreResult
+ */
+export declare function scoreV4Results(results: DetectorResult[], fileCount: number, threshold?: number): V4ScoreResult;
+/**
+ * Compute grade from score.
+ */
+export { computeGrade };
+/**
+ * Count issues by category.
+ */
+export declare function countByCategory(results: DetectorResult[]): Record<DetectorCategory, number>;
+/**
+ * Count issues by severity.
+ */
+export declare function countBySeverity(results: DetectorResult[]): Record<string, number>;
+/**
+ * Get summary statistics for V4 results.
+ */
+export declare function getV4ResultStats(results: DetectorResult[]): {
+    total: number;
+    byCategory: Record<DetectorCategory, number>;
+    bySeverity: Record<string, number>;
+    filesWithIssues: number;
+};
+//# sourceMappingURL=v4-adapter.d.ts.map

package/dist/scorer/v4-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"v4-adapter.d.ts","sourceRoot":"","sources":["../../src/scorer/v4-adapter.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAiB,YAAY,EAA2C,MAAM,6BAA6B,CAAC;AAyBnH;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,cAAc,GAAG,YAAY,CActE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,YAAY,EAAE,CAE7E;AAID;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,2BAA2B;IAC3B,UAAU,EAAE;QACV,YAAY,EAAE,aAAa,CAAC;QAC5B,SAAS,EAAE,aAAa,CAAC;QACzB,SAAS,EAAE,aAAa,CAAC;QACzB,OAAO,EAAE,aAAa,CAAC;KACxB,CAAC;IACF,wBAAwB;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,6CAA6C;IAC7C,MAAM,EAAE,OAAO,CAAC;IAChB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAID;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,cAAc,EAAE,EACzB,SAAS,EAAE,MAAM,EACjB,SAAS,GAAE,MAAW,GACrB,aAAa,CAwBf;AAeD;;GAEG;AACH,OAAO,EAAE,YAAY,EAAE,CAAC;AAIxB;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAa3F;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYjF;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,cAAc,EAAE,GAAG;IAC3D,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;IAC7C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,eAAe,EAAE,MAAM,CAAC;CACzB,CAWA"}

package/dist/scorer/v4-adapter.js

@@ -0,0 +1,145 @@
+/**
+ * V4 Score Adapter
+ *
+ * Bridges V4 DetectorResults to V3 scoring engine.
+ * Reuses V3 scoring logic (4 dimensions, 5 grades).
+ *
+ * @since 0.4.0
+ */
+import { AIDefectCategory } from '../types.js';
+import { ScoringEngine, computeGrade } from '../scorer/scoring-engine.js';
+// ─── Category Mapping ───────────────────────────────────────────────
+/**
+ * Maps V4 DetectorCategory to V3 AIDefectCategory.
+ */
+const CATEGORY_MAP = {
+    'ai-faithfulness': AIDefectCategory.HALLUCINATION,
+    'code-freshness': AIDefectCategory.STALE_KNOWLEDGE,
+    'context-coherence': AIDefectCategory.CONTEXT_LOSS,
+    'implementation': AIDefectCategory.OVER_ENGINEERING,
+};
+/**
+ * Maps V4 detector severity to V3 Severity.
+ */
+const SEVERITY_MAP = {
+    'error': 'critical',
+    'warning': 'medium',
+    'info': 'info',
+};
+// ─── Adapter Functions ──────────────────────────────────────────────
+/**
+ * Convert a V4 DetectorResult to V3 UnifiedIssue format.
+ */
+export function v4ResultToV3Issue(result) {
+    return {
+        id: `${result.detectorId}:${result.file}:${result.line}`,
+        detector: result.detectorId,
+        category: CATEGORY_MAP[result.category] ?? AIDefectCategory.OVER_ENGINEERING,
+        severity: SEVERITY_MAP[result.severity] ?? 'medium',
+        message: result.message,
+        file: result.file,
+        line: result.line,
+        endLine: result.endLine,
+        confidence: result.confidence,
+        autoFixable: false,
+        detectionSource: 'static',
+    };
+}
+/**
+ * Convert an array of V4 DetectorResults to V3 UnifiedIssues.
+ */
+export function v4ResultsToV3Issues(results) {
+    return results.map(v4ResultToV3Issue);
+}
+// ─── V4 Score Adapter ────────────────────────────────────────────────
+/**
+ * Score V4 results using the V3 scoring engine.
+ *
+ * @param results - V4 DetectorResults
+ * @param fileCount - Number of files scanned
+ * @param threshold - Passing threshold (default: 70)
+ * @returns V4ScoreResult
+ */
+export function scoreV4Results(results, fileCount, threshold = 70) {
+    // Convert V4 results to V3 issues
+    const issues = v4ResultsToV3Issues(results);
+    // Use V3 scoring engine
+    const engine = new ScoringEngine(threshold);
+    const scoreResult = engine.score(issues);
+    // Map V3 dimension scores to V4 format
+    const dimensions = {
+        faithfulness: mapDimension(scoreResult.dimensions.aiFaithfulness, 'AI Faithfulness'),
+        freshness: mapDimension(scoreResult.dimensions.codeFreshness, 'Code Freshness'),
+        coherence: mapDimension(scoreResult.dimensions.contextCoherence, 'Context Coherence'),
+        quality: mapDimension(scoreResult.dimensions.implementationQuality, 'Implementation Quality'),
+    };
+    return {
+        totalScore: scoreResult.totalScore,
+        grade: scoreResult.grade,
+        dimensions,
+        issueCount: scoreResult.issueCount,
+        passed: scoreResult.passed,
+        threshold,
+    };
+}
+/**
+ * Map a V3 DimensionScoreV3 to V4 DimensionInfo.
+ */
+function mapDimension(dim, name) {
+    return {
+        name,
+        maxScore: dim.maxScore,
+        score: dim.score,
+        issueCount: dim.issueCount,
+        percentage: Math.round((dim.score / dim.maxScore) * 100),
+    };
+}
+/**
+ * Compute grade from score.
+ */
+export { computeGrade };
+// ─── Issue Counting Helpers ──────────────────────────────────────────
+/**
+ * Count issues by category.
+ */
+export function countByCategory(results) {
+    const counts = {
+        'ai-faithfulness': 0,
+        'code-freshness': 0,
+        'context-coherence': 0,
+        'implementation': 0,
+    };
+    for (const result of results) {
+        counts[result.category]++;
+    }
+    return counts;
+}
+/**
+ * Count issues by severity.
+ */
+export function countBySeverity(results) {
+    const counts = {
+        error: 0,
+        warning: 0,
+        info: 0,
+    };
+    for (const result of results) {
+        counts[result.severity]++;
+    }
+    return counts;
+}
+/**
+ * Get summary statistics for V4 results.
+ */
+export function getV4ResultStats(results) {
+    const byCategory = countByCategory(results);
+    const bySeverity = countBySeverity(results);
+    const filesWithIssues = new Set(results.map(r => r.file)).size;
+    return {
+        total: results.length,
+        byCategory,
+        bySeverity,
+        filesWithIssues,
+    };
+}
+//# sourceMappingURL=v4-adapter.js.map

package/dist/scorer/v4-adapter.js.map

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

package/dist/sla/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * SLA Module — Public API
+ */
+export { SLALevel, SLA_TARGET_DURATIONS, SLA_AI_ANALYSIS, SLA_ACCURACY_TARGETS, } from './types.js';
+export type { SLAMetrics, SLATimeoutCheck, } from './types.js';
+export { SLATracker, parseSLALevel } from './tracker.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/sla/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sla/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,UAAU,EACV,eAAe,GAChB,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/sla/index.js

@@ -0,0 +1,6 @@
+/**
+ * SLA Module — Public API
+ */
+export { SLALevel, SLA_TARGET_DURATIONS, SLA_AI_ANALYSIS, SLA_ACCURACY_TARGETS, } from './types.js';
+export { SLATracker, parseSLALevel } from './tracker.js';
+//# sourceMappingURL=index.js.map

package/dist/sla/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sla/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,QAAQ,EACR,oBAAoB,EACpB,eAAe,EACf,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAOpB,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC"}

package/dist/sla/tracker.d.ts

@@ -0,0 +1,70 @@
+/**
+ * SLA Tracker
+ *
+ * Tracks scan performance against SLA targets.
+ * Provides timeout checking and metric collection.
+ *
+ * Usage:
+ * ```ts
+ * const tracker = new SLATracker(SLALevel.L2_STANDARD, 47);
+ * tracker.start();
+ *
+ * // During scan — check if we should degrade
+ * const check = tracker.checkTimeout();
+ * if (check.shouldDegrade) {
+ *   // Skip remaining Tier 2/3 detectors
+ * }
+ *
+ * // After scan — collect final metrics
+ * const metrics = tracker.finalize(issues, detectorsUsed, detectorsTotal);
+ * ```
+ */
+import type { UnifiedIssue } from '../types.js';
+import { SLALevel, type SLAMetrics, type SLATimeoutCheck } from './types.js';
+export declare class SLATracker {
+    private startTime;
+    private level;
+    private fileCount;
+    private _degraded;
+    private _degradeReason?;
+    /**
+     * @param level - SLA level for this scan
+     * @param fileCount - Number of files to scan (used for scaling target duration)
+     */
+    constructor(level: SLALevel, fileCount?: number);
+    /**
+     * Start the SLA timer.
+     */
+    start(): void;
+    /**
+     * Get elapsed time since start (ms).
+     */
+    get elapsedMs(): number;
+    /**
+     * Calculate the target duration for the actual file count.
+     * Scales linearly from the per-100-files target.
+     * Minimum target is 1 second regardless of file count.
+     */
+    get targetDurationMs(): number;
+    /**
+     * Check if the scan is exceeding the SLA target.
+     * Returns whether degradation should occur.
+     *
+     * Degradation threshold: 80% of target time consumed → recommend degrading.
+     * This gives detectors remaining 20% to wrap up.
+     */
+    checkTimeout(): SLATimeoutCheck;
+    /**
+     * Mark this scan as degraded.
+     */
+    markDegraded(reason: string): void;
+    /**
+     * Collect final SLA metrics after the scan completes.
+     */
+    finalize(issues: UnifiedIssue[], detectorsUsed: number, detectorsTotal: number): SLAMetrics;
+}
+/**
+ * Parse an SLA level string to enum value.
+ */
+export declare function parseSLALevel(value: string): SLALevel;
+//# sourceMappingURL=tracker.d.ts.map

package/dist/sla/tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracker.d.ts","sourceRoot":"","sources":["../../src/sla/tracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAY,MAAM,aAAa,CAAC;AAC1D,OAAO,EACL,QAAQ,EAGR,KAAK,UAAU,EACf,KAAK,eAAe,EACrB,MAAM,YAAY,CAAC;AAEpB,qBAAa,UAAU;IACrB,OAAO,CAAC,SAAS,CAAa;IAC9B,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,SAAS,CAAkB;IACnC,OAAO,CAAC,cAAc,CAAC,CAAS;IAEhC;;;OAGG;gBACS,KAAK,EAAE,QAAQ,EAAE,SAAS,GAAE,MAAY;IAKpD;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAGtB;IAED;;;;OAIG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAG7B;IAED;;;;;;OAMG;IACH,YAAY,IAAI,eAAe;IAuB/B;;OAEG;IACH,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKlC;;OAEG;IACH,QAAQ,CACN,MAAM,EAAE,YAAY,EAAE,EACtB,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,UAAU;CA0Bd;AAsBD;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,CAQrD"}