@yalehwang/archguard 0.1.23 → 0.1.32

package/dist/analysis/atlas-metrics-analysis.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-metrics-analysis.d.ts","sourceRoot":"","sources":["../../src/analysis/atlas-metrics-analysis.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAEhF,MAAM,WAAW,mBAAoB,SAAQ,WAAW;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAQD,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,YAAY,GAAG;IAC7D,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC7B,CAUA;AAMD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,EAC1B,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,mBAAmB,EAAE,CAMvB"}

package/dist/analysis/atlas-metrics-analysis.js

@@ -0,0 +1,17 @@
+export function computePackageFanMetrics(graph) {
+    const fanIn = new Map();
+    const fanOut = new Map();
+    for (const edge of graph.edges) {
+        fanIn.set(edge.target, (fanIn.get(edge.target) ?? 0) + 1);
+        fanOut.set(edge.source, (fanOut.get(edge.source) ?? 0) + 1);
+    }
+    return { fanIn, fanOut };
+}
+export function enrichPackageNodes(nodes, fanIn, fanOut) {
+    return nodes.map((node) => ({
+        ...node,
+        fanIn: fanIn.get(node.id) ?? 0,
+        fanOut: fanOut.get(node.id) ?? 0,
+    }));
+}
+//# sourceMappingURL=atlas-metrics-analysis.js.map

package/dist/analysis/atlas-metrics-analysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"atlas-metrics-analysis.js","sourceRoot":"","sources":["../../src/analysis/atlas-metrics-analysis.ts"],"names":[],"mappings":"AAkBA,MAAM,UAAU,wBAAwB,CAAC,KAAmB;IAI1D,MAAM,KAAK,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEzC,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC;QAC/B,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3B,CAAC;AAMD,MAAM,UAAU,kBAAkB,CAChC,KAAoB,EACpB,KAA0B,EAC1B,MAA2B;IAE3B,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,GAAG,IAAI;QACP,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,CAAC;KACjC,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/analysis/fitness/dependency-checker.d.ts

@@ -0,0 +1,4 @@
+import type { DependencyConstraintRule, RuleResult } from './rule-types.js';
+import type { Relation } from '../../types/index.js';
+export declare function checkDependencyConstraint(rule: DependencyConstraintRule, relations: Relation[]): RuleResult;
+//# sourceMappingURL=dependency-checker.d.ts.map

package/dist/analysis/fitness/dependency-checker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/dependency-checker.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEjD,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,wBAAwB,EAC9B,SAAS,EAAE,QAAQ,EAAE,GACpB,UAAU,CAaZ"}

package/dist/analysis/fitness/dependency-checker.js

@@ -0,0 +1,16 @@
+import micromatch from 'micromatch';
+export function checkDependencyConstraint(rule, relations) {
+    for (const relation of relations) {
+        const sourceMatches = micromatch.isMatch(relation.source, rule.from);
+        const targetMatches = micromatch.isMatch(relation.target, rule.to);
+        if (sourceMatches && targetMatches) {
+            return {
+                rule,
+                passed: false,
+                detail: `Forbidden dependency: ${relation.source} → ${relation.target}. ${rule.message}`,
+            };
+        }
+    }
+    return { rule, passed: true };
+}
+//# sourceMappingURL=dependency-checker.js.map

package/dist/analysis/fitness/dependency-checker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-checker.js","sourceRoot":"","sources":["../../../src/analysis/fitness/dependency-checker.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,YAAY,CAAC;AAIpC,MAAM,UAAU,yBAAyB,CACvC,IAA8B,EAC9B,SAAqB;IAErB,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,aAAa,GAAG,UAAU,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACnE,IAAI,aAAa,IAAI,aAAa,EAAE,CAAC;YACnC,OAAO;gBACL,IAAI;gBACJ,MAAM,EAAE,KAAK;gBACb,MAAM,EAAE,yBAAyB,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,OAAO,EAAE;aACzF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;AAChC,CAAC"}

package/dist/analysis/fitness/rule-evaluator.d.ts

@@ -0,0 +1,6 @@
+import type { MetricThresholdRule, FitnessRule, RuleResult } from './rule-types.js';
+import type { MetricVector } from '../../types/metric-vector.js';
+import type { Relation } from '../../types/index.js';
+export declare function evaluateMetricRule(rule: MetricThresholdRule, vector: MetricVector): RuleResult;
+export declare function evaluateAllRules(rules: FitnessRule[], vector: MetricVector, relations: Relation[]): RuleResult[];
+//# sourceMappingURL=rule-evaluator.d.ts.map

package/dist/analysis/fitness/rule-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAEpF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAmCjD,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAsB9F;AAED,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,WAAW,EAAE,EACpB,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,QAAQ,EAAE,GACpB,UAAU,EAAE,CAUd"}

package/dist/analysis/fitness/rule-evaluator.js

@@ -0,0 +1,64 @@
+import { evaluateGimLossRule } from '../gim/gim-loss-evaluator.js';
+import { checkDependencyConstraint } from './dependency-checker.js';
+const KNOWN_METRIC_KEYS = new Set([
+    'schemaVersion',
+    'totalEntities',
+    'totalRelations',
+    'inferredRelationRatio',
+    'sccCount',
+    'maxInDegree',
+    'maxOutDegree',
+    'maxPackageSize',
+    'giniInDegree',
+    'giniPackageSize',
+    'packageCount',
+    'entityCoverageRatio',
+]);
+function compare(actual, op, threshold) {
+    switch (op) {
+        case '<':
+            return actual < threshold;
+        case '<=':
+            return actual <= threshold;
+        case '>':
+            return actual > threshold;
+        case '>=':
+            return actual >= threshold;
+        case '==':
+            return actual === threshold;
+        case '!=':
+            return actual !== threshold;
+    }
+}
+export function evaluateMetricRule(rule, vector) {
+    if (!KNOWN_METRIC_KEYS.has(rule.metric)) {
+        return {
+            rule,
+            passed: false,
+            detail: `Unknown metric: '${rule.metric}'`,
+        };
+    }
+    const raw = vector[rule.metric];
+    if (raw === null || raw === undefined) {
+        return {
+            rule,
+            passed: false,
+            detail: `Metric '${rule.metric}' is not available (did you run with --include-tests?)`,
+        };
+    }
+    const actual = raw;
+    const passed = compare(actual, rule.op, rule.value);
+    return { rule, passed, actual };
+}
+export function evaluateAllRules(rules, vector, relations) {
+    return rules.map((rule) => {
+        if (rule.type === 'no-dependency') {
+            return checkDependencyConstraint(rule, relations);
+        }
+        if (rule.type === 'gim-loss') {
+            return evaluateGimLossRule(rule, vector);
+        }
+        return evaluateMetricRule(rule, vector);
+    });
+}
+//# sourceMappingURL=rule-evaluator.js.map

package/dist/analysis/fitness/rule-evaluator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-evaluator.js","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-evaluator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAC;AAG3E,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AAEpE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAS;IACxC,eAAe;IACf,eAAe;IACf,gBAAgB;IAChB,uBAAuB;IACvB,UAAU;IACV,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,qBAAqB;CACtB,CAAC,CAAC;AAEH,SAAS,OAAO,CAAC,MAAc,EAAE,EAA6B,EAAE,SAAiB;IAC/E,QAAQ,EAAE,EAAE,CAAC;QACX,KAAK,GAAG;YACN,OAAO,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,IAAI;YACP,OAAO,MAAM,IAAI,SAAS,CAAC;QAC7B,KAAK,GAAG;YACN,OAAO,MAAM,GAAG,SAAS,CAAC;QAC5B,KAAK,IAAI;YACP,OAAO,MAAM,IAAI,SAAS,CAAC;QAC7B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,SAAS,CAAC;QAC9B,KAAK,IAAI;YACP,OAAO,MAAM,KAAK,SAAS,CAAC;IAChC,CAAC;AACH,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAyB,EAAE,MAAoB;IAChF,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACxC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,oBAAoB,IAAI,CAAC,MAAM,GAAG;SAC3C,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAI,MAA6C,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAExE,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACtC,OAAO;YACL,IAAI;YACJ,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,WAAW,IAAI,CAAC,MAAM,wDAAwD;SACvF,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,GAAa,CAAC;IAC7B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,KAAoB,EACpB,MAAoB,EACpB,SAAqB;IAErB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,EAAE,CAAC;YAClC,OAAO,yBAAyB,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,OAAO,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/analysis/fitness/rule-types.d.ts

@@ -0,0 +1,2 @@
+export type { ComparisonOp, MetricThresholdRule, DependencyConstraintRule, GimLossType, GimLossRule, FitnessRule, FitnessConfig, RuleResult, } from '../../types/fitness-rules.js';
+//# sourceMappingURL=rule-types.d.ts.map

package/dist/analysis/fitness/rule-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.d.ts","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":"AAQA,YAAY,EACV,YAAY,EACZ,mBAAmB,EACnB,wBAAwB,EACxB,WAAW,EACX,WAAW,EACX,WAAW,EACX,aAAa,EACb,UAAU,GACX,MAAM,0BAA0B,CAAC"}

package/dist/analysis/fitness/rule-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rule-types.js.map

package/dist/analysis/fitness/rule-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rule-types.js","sourceRoot":"","sources":["../../../src/analysis/fitness/rule-types.ts"],"names":[],"mappings":""}

package/dist/analysis/gim/direction-hint.d.ts

@@ -0,0 +1,18 @@
+import type { MetricSnapshot } from '../snapshot-store.js';
+export type DirectionType = 'expansion' | 'contraction' | 'stable' | 'insufficient_data';
+export type ConfidenceLevel = 'low' | 'medium';
+export interface DirectionSignal {
+    metric: string;
+    direction: 'expansion' | 'contraction' | 'neutral';
+    delta: number | null;
+    percentChange: number | null;
+}
+export interface DirectionHint {
+    direction: DirectionType;
+    confidence: ConfidenceLevel | null;
+    signals: DirectionSignal[];
+    caveat: string;
+    recommendation: string;
+}
+export declare function computeDirectionHint(snapshots: MetricSnapshot[]): DirectionHint;
+//# sourceMappingURL=direction-hint.d.ts.map

package/dist/analysis/gim/direction-hint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"direction-hint.d.ts","sourceRoot":"","sources":["../../../src/analysis/gim/direction-hint.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAGnE,MAAM,MAAM,aAAa,GAAG,WAAW,GAAG,aAAa,GAAG,QAAQ,GAAG,mBAAmB,CAAC;AACzF,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE/C,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,WAAW,GAAG,aAAa,GAAG,SAAS,CAAC;IACnD,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,aAAa,CAAC;IACzB,UAAU,EAAE,eAAe,GAAG,IAAI,CAAC;IACnC,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;CACxB;AAgCD,wBAAgB,oBAAoB,CAAC,SAAS,EAAE,cAAc,EAAE,GAAG,aAAa,CAqD/E"}

package/dist/analysis/gim/direction-hint.js

@@ -0,0 +1,76 @@
+import { diffSnapshots } from '../snapshot-diff.js';
+const EXPANSION_ON_INCREASE = new Set(['totalEntities', 'totalRelations', 'packageCount', 'sccCount', 'giniInDegree']);
+const THRESHOLD_PCT = 5;
+function signalDirection(metric, percentChange, delta) {
+    if (delta === null)
+        return 'neutral';
+    if (metric === 'sccCount') {
+        if (delta > 0)
+            return 'expansion';
+        if (delta < 0)
+            return 'contraction';
+        return 'neutral';
+    }
+    if (percentChange === null || Math.abs(percentChange) < THRESHOLD_PCT)
+        return 'neutral';
+    const increasing = delta > 0;
+    const expansionOnIncrease = EXPANSION_ON_INCREASE.has(metric);
+    if (increasing)
+        return expansionOnIncrease ? 'expansion' : 'contraction';
+    return expansionOnIncrease ? 'contraction' : 'expansion';
+}
+const RECOMMENDATION = {
+    expansion: 'System is in expansion phase. Consider scheduling contraction/refactor work to prevent structural debt from accumulating.',
+    contraction: 'System is in contraction phase. Good time to stabilize interfaces and consolidate responsibilities.',
+    stable: 'System is stable. Monitor key metrics (sccCount, giniInDegree) to catch early phase transitions.',
+    insufficient_data: 'Not enough snapshots to determine direction. Run archguard analyze to generate a second snapshot.',
+};
+export function computeDirectionHint(snapshots) {
+    const CAVEAT = 'Based on 2-point comparison only. Direction may flip between consecutive snapshots. Treat as a weak signal, not a definitive trend.';
+    if (snapshots.length < 2) {
+        return {
+            direction: 'insufficient_data',
+            confidence: null,
+            signals: [],
+            caveat: CAVEAT,
+            recommendation: RECOMMENDATION.insufficient_data,
+        };
+    }
+    const newer = snapshots[0];
+    const older = snapshots[1];
+    const diff = diffSnapshots(older, newer);
+    const trackedMetrics = ['totalEntities', 'totalRelations', 'packageCount', 'sccCount', 'giniInDegree'];
+    const signals = trackedMetrics.map((metric) => {
+        const entry = diff.entries.find((e) => e.metric === metric);
+        const dir = entry
+            ? signalDirection(metric, entry.percentChange, entry.delta)
+            : 'neutral';
+        return {
+            metric,
+            direction: dir,
+            delta: entry?.delta ?? null,
+            percentChange: entry?.percentChange ?? null,
+        };
+    });
+    const expansionCount = signals.filter((s) => s.direction === 'expansion').length;
+    const contractionCount = signals.filter((s) => s.direction === 'contraction').length;
+    let direction;
+    if (expansionCount > contractionCount && expansionCount > signals.length / 2) {
+        direction = 'expansion';
+    }
+    else if (contractionCount > expansionCount && contractionCount > signals.length / 2) {
+        direction = 'contraction';
+    }
+    else {
+        direction = 'stable';
+    }
+    const confidence = snapshots.length >= 3 ? 'medium' : 'low';
+    return {
+        direction,
+        confidence,
+        signals,
+        caveat: CAVEAT,
+        recommendation: RECOMMENDATION[direction],
+    };
+}
+//# sourceMappingURL=direction-hint.js.map

package/dist/analysis/gim/direction-hint.js.map

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

package/dist/analysis/gim/gim-loss-evaluator.d.ts

@@ -0,0 +1,14 @@
+import type { GimLossRule } from '../fitness/rule-types.js';
+import type { RuleResult } from '../fitness/rule-types.js';
+import type { MetricVector } from '../../types/metric-vector.js';
+export interface LossStatus {
+    value: number;
+    status: 'healthy' | 'warning' | 'info';
+    detail: string;
+    proxy: true;
+}
+type LossName = GimLossRule['loss'];
+export declare function evaluateGimLossRule(rule: GimLossRule, vector: MetricVector): RuleResult;
+export declare function computeAllLosses(vector: MetricVector): Record<LossName, LossStatus>;
+export {};
+//# sourceMappingURL=gim-loss-evaluator.d.ts.map

package/dist/analysis/gim/gim-loss-evaluator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gim-loss-evaluator.d.ts","sourceRoot":"","sources":["../../../src/analysis/gim/gim-loss-evaluator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kCAAkC,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,MAAM,CAAC;IACvC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,CAAC;CACb;AAED,KAAK,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;AAmCpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAiBvF;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,CAgCnF"}

package/dist/analysis/gim/gim-loss-evaluator.js

@@ -0,0 +1,80 @@
+function resolveProxy(loss, vector) {
+    switch (loss) {
+        case 'feasibility':
+            return vector.sccCount;
+        case 'consistency':
+            return vector.inferredRelationRatio;
+        case 'description-length':
+            return vector.totalEntities + vector.totalRelations;
+        case 'generation-alignment':
+            return vector.giniInDegree;
+        default:
+            return null;
+    }
+}
+function compare(actual, op, threshold) {
+    switch (op) {
+        case '<': return actual < threshold;
+        case '<=': return actual <= threshold;
+        case '>': return actual > threshold;
+        case '>=': return actual >= threshold;
+        case '==': return actual === threshold;
+        case '!=': return actual !== threshold;
+    }
+}
+const PROXY_LABELS = {
+    feasibility: 'sccCount (proxy for ℒ_F)',
+    consistency: 'inferredRelationRatio (proxy for ℒ_C)',
+    'description-length': 'totalEntities + totalRelations (proxy for ℒ_D)',
+    'generation-alignment': 'giniInDegree (proxy for ℒ_A)',
+};
+export function evaluateGimLossRule(rule, vector) {
+    const proxyValue = resolveProxy(rule.loss, vector);
+    if (proxyValue === null) {
+        return {
+            rule,
+            passed: false,
+            detail: `Unknown GIM loss type: '${rule.loss}'`,
+        };
+    }
+    const passed = compare(proxyValue, rule.op, rule.value);
+    return {
+        rule,
+        passed,
+        actual: proxyValue,
+        detail: `${PROXY_LABELS[rule.loss]} = ${proxyValue}`,
+    };
+}
+export function computeAllLosses(vector) {
+    const feasibilityVal = vector.sccCount;
+    const consistencyVal = vector.inferredRelationRatio;
+    const descLengthVal = vector.totalEntities + vector.totalRelations;
+    const alignmentVal = vector.giniInDegree;
+    return {
+        feasibility: {
+            value: feasibilityVal,
+            status: feasibilityVal === 0 ? 'healthy' : 'warning',
+            detail: `sccCount=${feasibilityVal}. Proxy for structural feasibility loss ℒ_F. Zero cycles = minimum feasibility loss.`,
+            proxy: true,
+        },
+        consistency: {
+            value: consistencyVal,
+            status: consistencyVal <= 0.3 ? 'healthy' : 'warning',
+            detail: `inferredRelationRatio=${consistencyVal.toFixed(3)}. Proxy for consistency loss ℒ_C. High ratio = many unresolved type dependencies.`,
+            proxy: true,
+        },
+        'description-length': {
+            value: descLengthVal,
+            status: 'info',
+            detail: `totalEntities(${vector.totalEntities}) + totalRelations(${vector.totalRelations}) = ${descLengthVal}. Proxy for description-length loss ℒ_D. Smaller = easier to describe.`,
+            proxy: true,
+        },
+        'generation-alignment': {
+            value: alignmentVal,
+            status: alignmentVal <= 0.5 ? 'healthy' : 'warning',
+            detail: `giniInDegree=${alignmentVal.toFixed(3)}. Proxy for generation-alignment loss ℒ_A. High gini = few nodes dominate dependency graph.`,
+            proxy: true,
+        },
+    };
+}
+//# sourceMappingURL=gim-loss-evaluator.js.map

package/dist/analysis/gim/gim-loss-evaluator.js.map

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

package/dist/analysis/gini.d.ts

@@ -0,0 +1,2 @@
+export declare function giniCoefficient(values: number[]): number;
+//# sourceMappingURL=gini.d.ts.map

package/dist/analysis/gini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.d.ts","sourceRoot":"","sources":["../../src/analysis/gini.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,CAaxD"}

package/dist/analysis/gini.js

@@ -0,0 +1,12 @@
+export function giniCoefficient(values) {
+    const n = values.length;
+    if (n === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const sum = sorted.reduce((acc, v) => acc + v, 0);
+    if (sum === 0)
+        return 0;
+    const weightedSum = sorted.reduce((acc, v, idx) => acc + (idx + 1) * v, 0);
+    return (2 * weightedSum) / (n * sum) - (n + 1) / n;
+}
+//# sourceMappingURL=gini.js.map

package/dist/analysis/gini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gini.js","sourceRoot":"","sources":["../../src/analysis/gini.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,eAAe,CAAC,MAAgB;IAC9C,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC;IACxB,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEtB,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,GAAG,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAElD,IAAI,GAAG,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAGxB,MAAM,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3E,OAAO,CAAC,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACrD,CAAC"}

package/dist/analysis/git-history/git-log-reader.d.ts

@@ -0,0 +1,24 @@
+export interface FileChange {
+    path: string;
+    added: number;
+    deleted: number;
+}
+export interface CommitRecord {
+    sha: string;
+    authorEmail: string;
+    date: string;
+    files: FileChange[];
+}
+export interface ReadGitLogOptions {
+    sinceDays: number;
+    maxCommits: number;
+    includeMerges: boolean;
+    pathFilter?: string;
+}
+export declare function readGitLog(repoRoot: string, options: ReadGitLogOptions): CommitRecord[];
+export declare function parseGitLogOutput(raw: string): CommitRecord[];
+export declare function getHeadRef(repoRoot: string): string;
+export declare function getCurrentBranch(repoRoot: string): string;
+export declare function isGitRepo(dir: string): boolean;
+export declare function getGitRoot(dir: string): string | null;
+//# sourceMappingURL=git-log-reader.d.ts.map

package/dist/analysis/git-history/git-log-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-log-reader.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-history/git-log-reader.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAMD,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,OAAO,CAAC;IAEvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAgBD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,iBAAiB,GAAG,YAAY,EAAE,CAkCvF;AAuCD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,EAAE,CA8C7D;AAUD,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAUnD;AAMD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAWzD;AAKD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAW9C;AAMD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUrD"}

package/dist/analysis/git-history/git-log-reader.js

@@ -0,0 +1,117 @@
+import { execSync } from 'child_process';
+export function readGitLog(repoRoot, options) {
+    const { sinceDays, maxCommits, includeMerges, pathFilter } = options;
+    const mergeFlag = includeMerges ? '--merges' : '--no-merges';
+    const parts = [
+        'git',
+        'log',
+        '--numstat',
+        mergeFlag,
+        `--format=COMMIT_START%n%H%n%ae%n%cd`,
+        '--date=short',
+        `--since=${sinceDays}.days.ago`,
+        `--max-count=${maxCommits}`,
+    ];
+    if (pathFilter) {
+        parts.push('--', pathFilter);
+    }
+    const cmd = parts.join(' ');
+    let rawOutput;
+    try {
+        rawOutput = execSync(cmd, {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+    }
+    catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        throw new Error(`git log failed in ${repoRoot}: ${message}`);
+    }
+    return parseGitLogOutput(rawOutput);
+}
+export function parseGitLogOutput(raw) {
+    const commits = [];
+    const blocks = raw.split(/^COMMIT_START\s*$/m).filter((b) => b.trim().length > 0);
+    for (const block of blocks) {
+        const lines = block.split('\n');
+        let i = 0;
+        while (i < lines.length && lines[i].trim() === '')
+            i++;
+        const sha = lines[i++]?.trim() ?? '';
+        if (!sha || sha.length < 7)
+            continue;
+        const authorEmail = lines[i++]?.trim() ?? '';
+        const date = lines[i++]?.trim() ?? '';
+        if (!date.match(/^\d{4}-\d{2}-\d{2}$/))
+            continue;
+        const files = [];
+        for (; i < lines.length; i++) {
+            const line = lines[i];
+            if (line.trim() === '')
+                continue;
+            const numstatMatch = line.match(/^(\d+|-)\t(\d+|-)\t(.+)$/);
+            if (numstatMatch) {
+                const added = numstatMatch[1] === '-' ? 0 : parseInt(numstatMatch[1], 10);
+                const deleted = numstatMatch[2] === '-' ? 0 : parseInt(numstatMatch[2], 10);
+                const filePath = numstatMatch[3].trim();
+                if (filePath && !filePath.includes('{')) {
+                    files.push({ path: filePath, added, deleted });
+                }
+            }
+        }
+        commits.push({ sha, authorEmail, date, files });
+    }
+    return commits;
+}
+export function getHeadRef(repoRoot) {
+    try {
+        return execSync('git rev-parse --short HEAD', {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return 'unknown';
+    }
+}
+export function getCurrentBranch(repoRoot) {
+    try {
+        const branch = execSync('git rev-parse --abbrev-ref HEAD', {
+            cwd: repoRoot,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+        return branch || 'HEAD';
+    }
+    catch {
+        return 'HEAD';
+    }
+}
+export function isGitRepo(dir) {
+    try {
+        execSync('git rev-parse --git-dir', {
+            cwd: dir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function getGitRoot(dir) {
+    try {
+        return execSync('git rev-parse --show-toplevel', {
+            cwd: dir,
+            encoding: 'utf8',
+            stdio: ['pipe', 'pipe', 'pipe'],
+        }).trim();
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=git-log-reader.js.map

package/dist/analysis/git-history/git-log-reader.js.map

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

package/dist/analysis/git-history/history-aggregator.d.ts

@@ -0,0 +1,19 @@
+import type { CommitRecord } from './git-log-reader.js';
+import type { FileHistoryMetrics, PackageHistoryMetrics, CochangeEdge, RiskFactors } from '../../types/git-history.js';
+export declare function aggregateFileMetrics(commits: CommitRecord[], depth?: number): FileHistoryMetrics[];
+export declare function aggregatePackageMetrics(fileMetrics: FileHistoryMetrics[], depth?: number): PackageHistoryMetrics[];
+export declare function buildCochangeIndex(commits: CommitRecord[], topN?: number): Map<string, CochangeEdge[]>;
+export interface RiskInput {
+    commitCount: number;
+    authorCount: number;
+    primaryOwnerShare: number;
+    lastChangedAt: string;
+    topCochangeNeighbors: CochangeEdge[];
+}
+export interface RiskNorms {
+    maxCommitCount: number;
+    maxAuthorCount: number;
+}
+export declare function computeRiskFactors(input: RiskInput, norms: RiskNorms, referenceDate?: Date): RiskFactors;
+export declare function extractPackagePath(filePath: string, depth?: number): string;
+//# sourceMappingURL=history-aggregator.d.ts.map

package/dist/analysis/git-history/history-aggregator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history-aggregator.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-history/history-aggregator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,KAAK,EACV,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EAEZ,MAAM,wBAAwB,CAAC;AA8BhC,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,YAAY,EAAE,EACvB,KAAK,GAAE,MAAU,GAChB,kBAAkB,EAAE,CA4GtB;AAYD,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,kBAAkB,EAAE,EACjC,KAAK,GAAE,MAAU,GAChB,qBAAqB,EAAE,CAsJzB;AAeD,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,YAAY,EAAE,EACvB,IAAI,GAAE,MAAW,GAChB,GAAG,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,CA+D7B;AAMD,MAAM,WAAW,SAAS;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,YAAY,EAAE,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,cAAc,EAAE,MAAM,CAAC;CACxB;AASD,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,SAAS,EAChB,aAAa,GAAE,IAAiB,GAC/B,WAAW,CA0Cb;AAaD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAI9E"}