@monoes/monograph 1.0.0 → 1.2.0

package/dist/src/health/health-report.d.ts

@@ -0,0 +1,31 @@
+export interface HealthReportSummary {
+    healthScore: number;
+    healthGrade: 'A' | 'B' | 'C' | 'D' | 'F';
+    totalFiles: number;
+    totalLoc: number;
+    issueCount: number;
+    coverageModel: string;
+    generatedAt: string;
+}
+export interface HealthReport {
+    summary: HealthReportSummary;
+    findings?: unknown[];
+    fileScores?: unknown[];
+    coverageGaps?: unknown;
+    hotspots?: unknown[];
+    hotspotSummary?: unknown;
+    runtimeCoverage?: unknown;
+    largeFunctions?: unknown[];
+    targets?: unknown[];
+    targetThresholds?: unknown;
+    healthTrend?: unknown;
+    vitalSigns?: unknown;
+    distributionThresholds?: unknown;
+    analysisCounts?: unknown;
+    timings?: unknown;
+}
+export declare function createHealthReport(summary: HealthReportSummary, partials?: Omit<HealthReport, 'summary'>): HealthReport;
+export declare function createHealthReportSummary(healthScore: number, totalFiles: number, totalLoc: number, coverageModel?: string): HealthReportSummary;
+export declare function formatHealthReportSummary(s: HealthReportSummary): string;
+export declare function healthReportToJson(report: HealthReport): string;
+//# sourceMappingURL=health-report.d.ts.map

package/dist/src/health/health-report.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-report.d.ts","sourceRoot":"","sources":["../../../src/health/health-report.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,mBAAmB,CAAC;IAG7B,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,EAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IACpB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sBAAsB,CAAC,EAAE,OAAO,CAAC;IACjC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,mBAAmB,EAC5B,QAAQ,GAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAM,GAC3C,YAAY,CAQd;AAED,wBAAgB,yBAAyB,CACvC,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,aAAa,SAAS,GACrB,mBAAmB,CAgBrB;AAED,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,mBAAmB,GAAG,MAAM,CAOxE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAE/D"}

package/dist/src/health/health-report.js

@@ -0,0 +1,39 @@
+// Top-level container that bundles every health-pipeline output into a
+// single serializable object for LSP, CI, and dashboard consumers.
+export function createHealthReport(summary, partials = {}) {
+    const report = { summary };
+    for (const [key, value] of Object.entries(partials)) {
+        if (value !== undefined && value !== null) {
+            report[key] = value;
+        }
+    }
+    return report;
+}
+export function createHealthReportSummary(healthScore, totalFiles, totalLoc, coverageModel = 'none') {
+    // Use canonical thresholds from health-report-types.ts (A≥90, B≥75, C≥60, D≥40)
+    const grade = healthScore >= 90 ? 'A' :
+        healthScore >= 75 ? 'B' :
+            healthScore >= 60 ? 'C' :
+                healthScore >= 40 ? 'D' : 'F';
+    return {
+        healthScore,
+        healthGrade: grade,
+        totalFiles,
+        totalLoc,
+        issueCount: 0,
+        coverageModel,
+        generatedAt: new Date().toISOString(),
+    };
+}
+export function formatHealthReportSummary(s) {
+    return [
+        `Health: ${s.healthGrade} (${s.healthScore.toFixed(1)}/100)`,
+        `Files: ${s.totalFiles}  LOC: ${s.totalLoc}`,
+        `Coverage model: ${s.coverageModel}`,
+        `Generated: ${s.generatedAt}`,
+    ].join('\n');
+}
+export function healthReportToJson(report) {
+    return JSON.stringify(report, null, 2);
+}
+//# sourceMappingURL=health-report.js.map

package/dist/src/health/health-report.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-report.js","sourceRoot":"","sources":["../../../src/health/health-report.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,mEAAmE;AAgCnE,MAAM,UAAU,kBAAkB,CAChC,OAA4B,EAC5B,WAA0C,EAAE;IAE5C,MAAM,MAAM,GAAiB,EAAE,OAAO,EAAE,CAAC;IACzC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAqD,EAAE,CAAC;QACxG,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACzC,MAA6C,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;QAC9D,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,WAAmB,EACnB,UAAkB,EAClB,QAAgB,EAChB,aAAa,GAAG,MAAM;IAEtB,gFAAgF;IAChF,MAAM,KAAK,GACT,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACzB,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACzB,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;gBACzB,WAAW,IAAI,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;IAChC,OAAO;QACL,WAAW;QACX,WAAW,EAAE,KAAK;QAClB,UAAU;QACV,QAAQ;QACR,UAAU,EAAE,CAAC;QACb,aAAa;QACb,WAAW,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACtC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,CAAsB;IAC9D,OAAO;QACL,WAAW,CAAC,CAAC,WAAW,KAAK,CAAC,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO;QAC5D,UAAU,CAAC,CAAC,UAAU,UAAU,CAAC,CAAC,QAAQ,EAAE;QAC5C,mBAAmB,CAAC,CAAC,aAAa,EAAE;QACpC,cAAc,CAAC,CAAC,WAAW,EAAE;KAC9B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACf,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,MAAoB;IACrD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/src/health/health-score.d.ts

@@ -0,0 +1,37 @@
+export declare const HOTSPOT_SCORE_THRESHOLD = 50;
+export declare const MI_DENSITY_MIN_LINES = 50;
+export type HealthGrade = 'A' | 'B' | 'C' | 'D' | 'F';
+export interface HealthScorePenalties {
+    deadCode: number;
+    duplication: number;
+    complexityHigh: number;
+    complexityCritical: number;
+    crapHigh: number;
+    crapCritical: number;
+    hotspotDensity: number;
+    couplingConcentration: number;
+    busFactor: number;
+    largeFunctions: number;
+    unusedDeps: number;
+}
+export interface HealthScore {
+    value: number;
+    grade: HealthGrade;
+    penalties: HealthScorePenalties;
+}
+export interface VitalSignsInput {
+    deadCodePct: number;
+    duplicationPct: number;
+    complexityHighPct: number;
+    complexityCriticalPct: number;
+    crapHighPct: number;
+    crapCriticalPct: number;
+    hotspotDensity: number;
+    couplingHighPct: number;
+    busFactorRisk: number;
+    largeFunctionsPct: number;
+    unusedDepCount: number;
+}
+export declare function computeHealthScore(vs: VitalSignsInput, totalFiles: number): HealthScore;
+export declare function letterGradeFromScore(score: number): HealthGrade;
+//# sourceMappingURL=health-score.d.ts.map

package/dist/src/health/health-score.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.d.ts","sourceRoot":"","sources":["../../../src/health/health-score.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,MAAM,MAAM,WAAW,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEtD,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,oBAAoB,CAAC;CACjC;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,GAAG,WAAW,CAiBvF;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAM/D"}

package/dist/src/health/health-score.js

@@ -0,0 +1,32 @@
+export const HOTSPOT_SCORE_THRESHOLD = 50;
+export const MI_DENSITY_MIN_LINES = 50;
+export function computeHealthScore(vs, totalFiles) {
+    const p = {
+        deadCode: Math.min(15, vs.deadCodePct * 0.15),
+        duplication: Math.min(15, vs.duplicationPct * 0.15),
+        complexityHigh: Math.min(10, vs.complexityHighPct * 0.10),
+        complexityCritical: Math.min(10, vs.complexityCriticalPct * 0.20),
+        crapHigh: Math.min(10, vs.crapHighPct * 0.10),
+        crapCritical: Math.min(10, vs.crapCriticalPct * 0.20),
+        hotspotDensity: Math.min(10, vs.hotspotDensity * 0.10),
+        couplingConcentration: Math.min(5, vs.couplingHighPct * 0.05),
+        busFactor: Math.min(10, vs.busFactorRisk * 10),
+        largeFunctions: Math.min(5, vs.largeFunctionsPct * 0.10),
+        unusedDeps: Math.min(5, Math.min(vs.unusedDepCount, 10) * 0.5),
+    };
+    const total = Object.values(p).reduce((a, b) => a + b, 0);
+    const value = Math.max(0, Math.round(100 - total));
+    return { value, grade: letterGradeFromScore(value), penalties: p };
+}
+export function letterGradeFromScore(score) {
+    if (score >= 90)
+        return 'A';
+    if (score >= 75)
+        return 'B';
+    if (score >= 60)
+        return 'C';
+    if (score >= 40)
+        return 'D';
+    return 'F';
+}
+//# sourceMappingURL=health-score.js.map

package/dist/src/health/health-score.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"health-score.js","sourceRoot":"","sources":["../../../src/health/health-score.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAC;AAC1C,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,CAAC;AAsCvC,MAAM,UAAU,kBAAkB,CAAC,EAAmB,EAAE,UAAkB;IACxE,MAAM,CAAC,GAAyB;QAC9B,QAAQ,EAAc,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC;QACzD,WAAW,EAAW,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5D,cAAc,EAAQ,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC/D,kBAAkB,EAAI,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACnE,QAAQ,EAAc,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,WAAW,GAAG,IAAI,CAAC;QACzD,YAAY,EAAU,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,GAAG,IAAI,CAAC;QAC7D,cAAc,EAAQ,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,GAAG,IAAI,CAAC;QAC5D,qBAAqB,EAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAG,EAAE,CAAC,eAAe,GAAG,IAAI,CAAC;QAC7D,SAAS,EAAa,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC,aAAa,GAAG,EAAE,CAAC;QACzD,cAAc,EAAQ,IAAI,CAAC,GAAG,CAAC,CAAC,EAAG,EAAE,CAAC,iBAAiB,GAAG,IAAI,CAAC;QAC/D,UAAU,EAAY,IAAI,CAAC,GAAG,CAAC,CAAC,EAAG,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC;KAC1E,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC;IACnD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAa;IAChD,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,GAAG,CAAC;IAC5B,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/src/health/hotspot-utils.d.ts

@@ -0,0 +1,11 @@
+export declare function isTestPath(filePath: string): boolean;
+export interface NormalizationMaxima {
+    maxWeightedCommits: number;
+    maxComplexityDensity: number;
+}
+export declare function computeNormalizationMaxima(files: Array<{
+    weightedCommits: number;
+    complexityDensity: number;
+}>, percentile?: number): NormalizationMaxima;
+export declare function normalizeHotspotScore(rawChurn: number, rawComplexity: number, maxima: NormalizationMaxima): number;
+//# sourceMappingURL=hotspot-utils.d.ts.map

package/dist/src/health/hotspot-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspot-utils.d.ts","sourceRoot":"","sources":["../../../src/health/hotspot-utils.ts"],"names":[],"mappings":"AAAA,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAWpD;AAED,MAAM,WAAW,mBAAmB;IAClC,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,MAAM,CAAC;CAC9B;AAED,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,eAAe,EAAE,MAAM,CAAC;IAAC,iBAAiB,EAAE,MAAM,CAAA;CAAE,CAAC,EACpE,UAAU,SAAO,GAChB,mBAAmB,CAmBrB;AAED,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,mBAAmB,GAC1B,MAAM,CAQR"}

package/dist/src/health/hotspot-utils.js

@@ -0,0 +1,34 @@
+export function isTestPath(filePath) {
+    const normalized = filePath.replace(/\\/g, '/');
+    return (normalized.includes('/__tests__/') ||
+        normalized.includes('/__mocks__/') ||
+        normalized.includes('/test/') ||
+        normalized.includes('/tests/') ||
+        normalized.includes('/e2e/') ||
+        normalized.includes('.test.') ||
+        normalized.includes('.spec.'));
+}
+export function computeNormalizationMaxima(files, percentile = 0.95) {
+    if (files.length < 2) {
+        const maxWeightedCommits = files.length === 1 ? files[0].weightedCommits : 0;
+        const maxComplexityDensity = files.length === 1 ? files[0].complexityDensity : 0;
+        return { maxWeightedCommits, maxComplexityDensity };
+    }
+    const sortedWeighted = [...files.map(f => f.weightedCommits)].sort((a, b) => a - b);
+    const sortedDensity = [...files.map(f => f.complexityDensity)].sort((a, b) => a - b);
+    const idx = Math.min(Math.ceil(percentile * files.length) - 1, files.length - 1);
+    return {
+        maxWeightedCommits: sortedWeighted[idx],
+        maxComplexityDensity: sortedDensity[idx],
+    };
+}
+export function normalizeHotspotScore(rawChurn, rawComplexity, maxima) {
+    const normChurn = maxima.maxWeightedCommits > 0
+        ? rawChurn / maxima.maxWeightedCommits
+        : 0;
+    const normComplexity = maxima.maxComplexityDensity > 0
+        ? rawComplexity / maxima.maxComplexityDensity
+        : 0;
+    return Math.round((normChurn * 0.6 + normComplexity * 0.4) * 100 * 10) / 10;
+}
+//# sourceMappingURL=hotspot-utils.js.map

package/dist/src/health/hotspot-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspot-utils.js","sourceRoot":"","sources":["../../../src/health/hotspot-utils.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,UAAU,CAAC,QAAgB;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,CACL,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClC,UAAU,CAAC,QAAQ,CAAC,aAAa,CAAC;QAClC,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,SAAS,CAAC;QAC9B,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC;QAC5B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAC7B,UAAU,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAC9B,CAAC;AACJ,CAAC;AAOD,MAAM,UAAU,0BAA0B,CACxC,KAAoE,EACpE,UAAU,GAAG,IAAI;IAEjB,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,MAAM,kBAAkB,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;QAC7E,MAAM,oBAAoB,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC;QACjF,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,CAAC;IACtD,CAAC;IAED,MAAM,cAAc,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpF,MAAM,aAAa,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAErF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAClB,IAAI,CAAC,IAAI,CAAC,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,EACxC,KAAK,CAAC,MAAM,GAAG,CAAC,CACjB,CAAC;IAEF,OAAO;QACL,kBAAkB,EAAE,cAAc,CAAC,GAAG,CAAC;QACvC,oBAAoB,EAAE,aAAa,CAAC,GAAG,CAAC;KACzC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,QAAgB,EAChB,aAAqB,EACrB,MAA2B;IAE3B,MAAM,SAAS,GAAG,MAAM,CAAC,kBAAkB,GAAG,CAAC;QAC7C,CAAC,CAAC,QAAQ,GAAG,MAAM,CAAC,kBAAkB;QACtC,CAAC,CAAC,CAAC,CAAC;IACN,MAAM,cAAc,GAAG,MAAM,CAAC,oBAAoB,GAAG,CAAC;QACpD,CAAC,CAAC,aAAa,GAAG,MAAM,CAAC,oBAAoB;QAC7C,CAAC,CAAC,CAAC,CAAC;IACN,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,cAAc,GAAG,GAAG,CAAC,GAAG,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;AAC9E,CAAC"}

package/dist/src/health/hotspots.d.ts

@@ -0,0 +1,21 @@
+import type { ChurnResult } from '../analysis/churn.js';
+export interface HotspotEntry {
+    path: string;
+    score: number;
+    weightedCommits: number;
+    complexityDensity: number;
+    rank: number;
+}
+export interface HotspotSummary {
+    count: number;
+    topScore: number;
+    meanScore: number;
+}
+export declare function isTestPath(path: string): boolean;
+export declare function normalizeValue(value: number, max: number): number;
+export declare function computeHotspotScore(weightedCommits: number, maxWeighted: number, density: number, maxDensity: number): number;
+export declare function computeHotspots(churnResult: ChurnResult, complexityMap: Map<string, number>, minCommits?: number): {
+    entries: HotspotEntry[];
+    summary: HotspotSummary;
+};
+//# sourceMappingURL=hotspots.d.ts.map

package/dist/src/health/hotspots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hotspots.d.ts","sourceRoot":"","sources":["../../../src/health/hotspots.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,sBAAsB,CAAC;AAEnE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAcD,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKhD;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,EACvB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GACjB,MAAM,CAER;AAED,wBAAgB,eAAe,CAC7B,WAAW,EAAE,WAAW,EACxB,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAClC,UAAU,SAAI,GACb;IAAE,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,OAAO,EAAE,cAAc,CAAA;CAAE,CAmDtD"}

package/dist/src/health/hotspots.js

@@ -0,0 +1,69 @@
+const TEST_PATH_PATTERNS = [
+    '/__tests__/',
+    '.test.',
+    '.spec.',
+    '_test.',
+    '_spec.',
+    '/test/',
+    '/tests/',
+    '/spec/',
+    '/specs/',
+];
+export function isTestPath(path) {
+    for (const pattern of TEST_PATH_PATTERNS) {
+        if (path.includes(pattern))
+            return true;
+    }
+    return false;
+}
+export function normalizeValue(value, max) {
+    return max > 0 ? value / max : 0;
+}
+export function computeHotspotScore(weightedCommits, maxWeighted, density, maxDensity) {
+    return normalizeValue(weightedCommits, maxWeighted) * normalizeValue(density, maxDensity) * 100;
+}
+export function computeHotspots(churnResult, complexityMap, minCommits = 3) {
+    // Filter qualifying files
+    const qualifying = churnResult.files.filter((f) => !isTestPath(f.path) && f.totalCommits >= minCommits);
+    if (qualifying.length === 0) {
+        return {
+            entries: [],
+            summary: { count: 0, topScore: 0, meanScore: 0 },
+        };
+    }
+    // Compute normalization maxima from qualifying files only
+    let maxWeighted = 0;
+    let maxDensity = 0;
+    for (const f of qualifying) {
+        if (f.weightedCommits > maxWeighted)
+            maxWeighted = f.weightedCommits;
+        const density = complexityMap.get(f.path) ?? 0;
+        if (density > maxDensity)
+            maxDensity = density;
+    }
+    // Score each qualifying file
+    const scored = qualifying.map((f) => {
+        const density = complexityMap.get(f.path) ?? 0;
+        const score = computeHotspotScore(f.weightedCommits, maxWeighted, density, maxDensity);
+        return { f, score, density };
+    });
+    // Sort descending by score
+    scored.sort((a, b) => b.score - a.score);
+    // Build entries with 1-based rank
+    const entries = scored.map((item, idx) => ({
+        path: item.f.path,
+        score: item.score,
+        weightedCommits: item.f.weightedCommits,
+        complexityDensity: item.density,
+        rank: idx + 1,
+    }));
+    // Compute summary
+    const count = entries.length;
+    const topScore = entries[0]?.score ?? 0;
+    const meanScore = count > 0 ? entries.reduce((s, e) => s + e.score, 0) / count : 0;
+    return {
+        entries,
+        summary: { count, topScore, meanScore },
+    };
+}
+//# sourceMappingURL=hotspots.js.map

package/dist/src/health/hotspots.js.map

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

package/dist/src/health/large-functions.d.ts

@@ -0,0 +1,16 @@
+export declare const LARGE_FUNCTION_LOC_THRESHOLD = 60;
+export declare const LARGE_FUNCTION_REPORT_THRESHOLD_PCT = 0.03;
+export interface LargeFunctionEntry {
+    path: string;
+    functionName: string;
+    lineCount: number;
+    startLine: number;
+}
+export declare function shouldReportLargeFunctions(veryHighCount: number, totalFunctions: number): boolean;
+export declare function detectLargeFunctions(functions: Array<{
+    path: string;
+    name: string;
+    loc: number;
+    startLine: number;
+}>, threshold?: number): LargeFunctionEntry[];
+//# sourceMappingURL=large-functions.d.ts.map

package/dist/src/health/large-functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"large-functions.d.ts","sourceRoot":"","sources":["../../../src/health/large-functions.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,4BAA4B,KAAK,CAAC;AAC/C,eAAO,MAAM,mCAAmC,OAAO,CAAC;AAExD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,0BAA0B,CACxC,aAAa,EAAE,MAAM,EACrB,cAAc,EAAE,MAAM,GACrB,OAAO,CAKT;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EAChF,SAAS,SAA+B,GACvC,kBAAkB,EAAE,CAUtB"}

package/dist/src/health/large-functions.js

@@ -0,0 +1,20 @@
+export const LARGE_FUNCTION_LOC_THRESHOLD = 60;
+export const LARGE_FUNCTION_REPORT_THRESHOLD_PCT = 0.03;
+export function shouldReportLargeFunctions(veryHighCount, totalFunctions) {
+    if (totalFunctions <= 0) {
+        return false;
+    }
+    return veryHighCount / totalFunctions >= LARGE_FUNCTION_REPORT_THRESHOLD_PCT;
+}
+export function detectLargeFunctions(functions, threshold = LARGE_FUNCTION_LOC_THRESHOLD) {
+    return functions
+        .filter((f) => f.loc >= threshold)
+        .sort((a, b) => b.loc - a.loc)
+        .map((f) => ({
+        path: f.path,
+        functionName: f.name,
+        lineCount: f.loc,
+        startLine: f.startLine,
+    }));
+}
+//# sourceMappingURL=large-functions.js.map

package/dist/src/health/large-functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"large-functions.js","sourceRoot":"","sources":["../../../src/health/large-functions.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,4BAA4B,GAAG,EAAE,CAAC;AAC/C,MAAM,CAAC,MAAM,mCAAmC,GAAG,IAAI,CAAC;AASxD,MAAM,UAAU,0BAA0B,CACxC,aAAqB,EACrB,cAAsB;IAEtB,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,aAAa,GAAG,cAAc,IAAI,mCAAmC,CAAC;AAC/E,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,SAAgF,EAChF,SAAS,GAAG,4BAA4B;IAExC,OAAO,SAAS;SACb,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,SAAS,CAAC;SACjC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC;SAC7B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,YAAY,EAAE,CAAC,CAAC,IAAI;QACpB,SAAS,EAAE,CAAC,CAAC,GAAG;QAChB,SAAS,EAAE,CAAC,CAAC,SAAS;KACvB,CAAC,CAAC,CAAC;AACR,CAAC"}

package/dist/src/health/ownership-metrics.d.ts

@@ -0,0 +1,30 @@
+export type ContributorIdentifierFormat = 'raw' | 'handle' | 'hash';
+export interface ContributorEntry {
+    identifier: string;
+    format: ContributorIdentifierFormat;
+    share: number;
+    staleDays: number;
+    commits: number;
+}
+export interface OwnershipMetrics {
+    busFactor: number;
+    contributorCount: number;
+    topContributor: ContributorEntry;
+    recentContributors: ContributorEntry[];
+    suggestedReviewers: ContributorEntry[];
+    declaredOwner?: string;
+    unowned?: boolean;
+    drift: boolean;
+    driftReason?: string;
+}
+export interface HotspotSummary {
+    since: string;
+    minCommits: number;
+    filesAnalyzed: number;
+    filesExcluded: number;
+    shallowClone: boolean;
+}
+export declare function computeBusFactor(contributors: ContributorEntry[]): number;
+export declare function filterSuggestedReviewers(contributors: ContributorEntry[], topContributor: ContributorEntry, maxStaleDays?: number): ContributorEntry[];
+export declare function formatOwnershipMetrics(m: OwnershipMetrics): string;
+//# sourceMappingURL=ownership-metrics.d.ts.map

package/dist/src/health/ownership-metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership-metrics.d.ts","sourceRoot":"","sources":["../../../src/health/ownership-metrics.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,2BAA2B,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpE,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,2BAA2B,CAAC;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,gBAAgB,CAAC;IACjC,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,kBAAkB,EAAE,gBAAgB,EAAE,CAAC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,OAAO,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,CASzE;AAED,wBAAgB,wBAAwB,CACtC,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,gBAAgB,EAChC,YAAY,SAAK,GAChB,gBAAgB,EAAE,CAIpB;AAED,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CASlE"}

package/dist/src/health/ownership-metrics.js

@@ -0,0 +1,31 @@
+export function computeBusFactor(contributors) {
+    if (contributors.length === 0)
+        return 0;
+    const sorted = [...contributors].sort((a, b) => b.share - a.share);
+    let cumulative = 0;
+    for (let i = 0; i < sorted.length; i++) {
+        cumulative += sorted[i].share;
+        if (cumulative >= 0.5)
+            return i + 1;
+    }
+    return sorted.length;
+}
+export function filterSuggestedReviewers(contributors, topContributor, maxStaleDays = 90) {
+    return contributors
+        .filter(c => c.identifier !== topContributor.identifier && c.staleDays <= maxStaleDays)
+        .slice(0, 3);
+}
+export function formatOwnershipMetrics(m) {
+    const lines = [
+        `Bus factor: ${m.busFactor}  (${m.contributorCount} contributor${m.contributorCount !== 1 ? 's' : ''})`,
+        `Top: ${m.topContributor.identifier} (${(m.topContributor.share * 100).toFixed(1)}%)`,
+    ];
+    if (m.declaredOwner)
+        lines.push(`Owner: ${m.declaredOwner}`);
+    if (m.unowned)
+        lines.push('(unowned — no CODEOWNERS rule matched)');
+    if (m.drift)
+        lines.push(`Drift: ${m.driftReason ?? 'unknown reason'}`);
+    return lines.join('\n');
+}
+//# sourceMappingURL=ownership-metrics.js.map

package/dist/src/health/ownership-metrics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership-metrics.js","sourceRoot":"","sources":["../../../src/health/ownership-metrics.ts"],"names":[],"mappings":"AA8BA,MAAM,UAAU,gBAAgB,CAAC,YAAgC;IAC/D,IAAI,YAAY,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IACxC,MAAM,MAAM,GAAG,CAAC,GAAG,YAAY,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IACnE,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,UAAU,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAC9B,IAAI,UAAU,IAAI,GAAG;YAAE,OAAO,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,MAAM,CAAC,MAAM,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,YAAgC,EAChC,cAAgC,EAChC,YAAY,GAAG,EAAE;IAEjB,OAAO,YAAY;SAChB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,cAAc,CAAC,UAAU,IAAI,CAAC,CAAC,SAAS,IAAI,YAAY,CAAC;SACtF,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,CAAmB;IACxD,MAAM,KAAK,GAAa;QACtB,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,gBAAgB,eAAe,CAAC,CAAC,gBAAgB,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG;QACvG,QAAQ,CAAC,CAAC,cAAc,CAAC,UAAU,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI;KACtF,CAAC;IACF,IAAI,CAAC,CAAC,aAAa;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,CAAC,OAAO;QAAE,KAAK,CAAC,IAAI,CAAC,wCAAwC,CAAC,CAAC;IACpE,IAAI,CAAC,CAAC,KAAK;QAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,WAAW,IAAI,gBAAgB,EAAE,CAAC,CAAC;IACvE,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/src/health/ownership-risk.d.ts

@@ -0,0 +1,19 @@
+export interface ContributorRecord {
+    email: string;
+    commits: number;
+    lastCommit: string;
+}
+export interface OwnershipRisk {
+    busFactor: number;
+    contributorCount: number;
+    topContributor?: string;
+    topContributorShare: number;
+    isDrifted: boolean;
+    isStale: boolean;
+    staleDays: number;
+}
+export declare const BOT_PATTERNS: RegExp[];
+export declare function isBot(email: string, name?: string): boolean;
+export declare function computeBusFactor(contributors: ContributorRecord[]): number;
+export declare function computeOwnershipRisk(contributors: ContributorRecord[], referenceDate?: string): OwnershipRisk;
+//# sourceMappingURL=ownership-risk.d.ts.map

package/dist/src/health/ownership-risk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership-risk.d.ts","sourceRoot":"","sources":["../../../src/health/ownership-risk.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,YAAY,EAAE,MAAM,EAShC,CAAC;AAEF,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,iBAAiB,EAAE,GAAG,MAAM,CAa1E;AAKD,wBAAgB,oBAAoB,CAClC,YAAY,EAAE,iBAAiB,EAAE,EACjC,aAAa,CAAC,EAAE,MAAM,GACrB,aAAa,CA4Cf"}

package/dist/src/health/ownership-risk.js

@@ -0,0 +1,68 @@
+export const BOT_PATTERNS = [
+    /dependabot/i,
+    /renovate/i,
+    /github-actions/i,
+    /\[bot\]/i,
+    /greenkeeper/i,
+    /snyk-bot/i,
+    /semantic-release-bot/i,
+    /allcontributors/i,
+];
+export function isBot(email, name) {
+    const target = name != null ? `${email} ${name}` : email;
+    return BOT_PATTERNS.some(p => p.test(target));
+}
+export function computeBusFactor(contributors) {
+    const total = contributors.reduce((sum, c) => sum + c.commits, 0);
+    if (total === 0)
+        return 0;
+    const sorted = [...contributors].sort((a, b) => b.commits - a.commits);
+    let acc = 0;
+    let count = 0;
+    for (const c of sorted) {
+        acc += c.commits;
+        count++;
+        if (acc / total >= 0.5)
+            break;
+    }
+    return count;
+}
+const STALE_DAYS_THRESHOLD = 180;
+const MS_PER_DAY = 86_400_000;
+export function computeOwnershipRisk(contributors, referenceDate) {
+    const now = referenceDate != null ? new Date(referenceDate).getTime() : Date.now();
+    const human = contributors.filter(c => !isBot(c.email));
+    if (human.length === 0) {
+        return {
+            busFactor: 0,
+            contributorCount: 0,
+            topContributorShare: 0,
+            isDrifted: false,
+            isStale: true,
+            staleDays: Infinity,
+        };
+    }
+    const total = human.reduce((sum, c) => sum + c.commits, 0);
+    const sorted = [...human].sort((a, b) => b.commits - a.commits);
+    const busFactor = computeBusFactor(human);
+    const top = sorted[0];
+    const topContributorShare = total > 0 ? top.commits / total : 0;
+    const lastCommitMs = new Date(top.lastCommit).getTime();
+    const staleDays = Math.max(0, Math.floor((now - lastCommitMs) / MS_PER_DAY));
+    const isStale = staleDays > STALE_DAYS_THRESHOLD;
+    // Drift: current top-committer differs from the contributor with the oldest last-commit
+    // (proxy for "original owner" when first-commit timestamps aren't available).
+    const byAge = [...human].sort((a, b) => new Date(a.lastCommit).getTime() - new Date(b.lastCommit).getTime());
+    const originalTop = byAge[0];
+    const isDrifted = sorted.length > 1 && originalTop !== undefined && originalTop.email !== sorted[0].email;
+    return {
+        busFactor,
+        contributorCount: human.length,
+        topContributor: top.email,
+        topContributorShare,
+        isDrifted,
+        isStale,
+        staleDays,
+    };
+}
+//# sourceMappingURL=ownership-risk.js.map

package/dist/src/health/ownership-risk.js.map

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

package/dist/src/health/ownership.d.ts

@@ -0,0 +1,23 @@
+export type EmailMode = 'raw' | 'handle' | 'hash';
+export declare const DRIFT_MIN_FILE_AGE_DAYS = 30;
+export declare const DRIFT_MAX_ORIGINAL_SHARE = 0.1;
+export interface ContributorEntry {
+    email: string;
+    weightedCommits: number;
+    totalCommits: number;
+}
+export interface OwnershipMetrics {
+    busFactor: number;
+    driftedHotspots: string[];
+    contributorCount: number;
+    botFilteredCount: number;
+}
+export declare function normalizeEmail(email: string, mode: EmailMode): string;
+export declare function computeBusFactor(contributors: ContributorEntry[]): number;
+export declare function detectDrift(filePath: string, contributors: ContributorEntry[], originalAuthor: string, fileAgeDays: number): boolean;
+export declare function isBotEmail(email: string): boolean;
+export declare function computeOwnershipMetrics(contributors: ContributorEntry[][], hotspotPaths: string[], originalAuthors: Map<string, string>, fileAgeDays: Map<string, number>): OwnershipMetrics;
+export type ContributorIdentifierFormat = 'fullEmail' | 'domainEmail' | 'displayName';
+/** Normalize a raw git author string to the specified identifier format. */
+export declare function normalizeContributorId(raw: string, format: ContributorIdentifierFormat): string;
+//# sourceMappingURL=ownership.d.ts.map

package/dist/src/health/ownership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/health/ownership.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElD,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAC1C,eAAO,MAAM,wBAAwB,MAAO,CAAC;AAE7C,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,eAAe,EAAE,MAAM,CAAC;IACxB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,SAAS,GAAG,MAAM,CAqBrE;AAED,wBAAgB,gBAAgB,CAAC,YAAY,EAAE,gBAAgB,EAAE,GAAG,MAAM,CAmBzE;AAED,wBAAgB,WAAW,CACzB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,gBAAgB,EAAE,EAChC,cAAc,EAAE,MAAM,EACtB,WAAW,EAAE,MAAM,GAClB,OAAO,CAiBT;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CASjD;AAED,wBAAgB,uBAAuB,CACrC,YAAY,EAAE,gBAAgB,EAAE,EAAE,EAClC,YAAY,EAAE,MAAM,EAAE,EACtB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC/B,gBAAgB,CAqDlB;AAID,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,aAAa,GAAG,aAAa,CAAC;AAEtF,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,2BAA2B,GAAG,MAAM,CAS/F"}