@yalehwang/archguard 0.1.21 → 0.1.31

package/dist/analysis/git-history/history-query.js

@@ -0,0 +1,201 @@
+const RISK_WEIGHTS = {
+    churn: 0.25,
+    authorCount: 0.2,
+    ownerConcentration: 0.2,
+    cochangeBreadth: 0.15,
+    recency: 0.2,
+};
+function computeRiskScore(rf) {
+    return (rf.churn * RISK_WEIGHTS.churn +
+        rf.authorCount * RISK_WEIGHTS.authorCount +
+        rf.ownerConcentration * RISK_WEIGHTS.ownerConcentration +
+        rf.cochangeBreadth * RISK_WEIGHTS.cochangeBreadth +
+        rf.recency * RISK_WEIGHTS.recency);
+}
+function classifyRiskLevel(score) {
+    if (score < 0.25)
+        return 'low';
+    if (score < 0.5)
+        return 'medium';
+    if (score < 0.75)
+        return 'high';
+    return 'critical';
+}
+function topRiskFactor(rf) {
+    const factors = [
+        ['churn', rf.churn],
+        ['authorCount', rf.authorCount],
+        ['ownerConcentration', rf.ownerConcentration],
+        ['cochangeBreadth', rf.cochangeBreadth],
+        ['recency', rf.recency],
+    ];
+    return factors.reduce((best, cur) => (cur[1] > best[1] ? cur : best), factors[0])[0];
+}
+export class HistoryQuery {
+    data;
+    constructor(data) {
+        this.data = data;
+    }
+    getMetrics(targetType, target) {
+        const metrics = targetType === 'file'
+            ? this.data.fileMetrics.get(target)
+            : this.data.packageMetrics.get(target);
+        if (!metrics) {
+            throw new Error(`Target "${target}" (type: ${targetType}) not found in git history data. Check the target path matches analyzed data.`);
+        }
+        return metrics;
+    }
+    analyzedWindow() {
+        return {
+            sinceDays: this.data.manifest.sinceDays,
+            totalCommits: this.data.manifest.totalCommits,
+            generatedAt: this.data.manifest.generatedAt,
+        };
+    }
+    getCochange(targetType, target, topN = 10) {
+        const m = this.getMetrics(targetType, target);
+        const neighbors = [...m.topCochangeNeighbors]
+            .sort((a, b) => b.strength - a.strength)
+            .slice(0, topN);
+        return {
+            target,
+            targetType,
+            neighbors,
+            analyzedWindow: this.analyzedWindow(),
+            limitation: 'Co-change is an evolutionary signal, not proof of direct runtime or static dependency.',
+        };
+    }
+    getOwnership(targetType, target) {
+        const m = this.getMetrics(targetType, target);
+        const { commitCount, primaryOwner, primaryOwnerShare } = m;
+        let contributors;
+        let busFactor;
+        if (m.topContributors && m.topContributors.length > 0) {
+            contributors = m.topContributors.map((c) => ({
+                email: c.email,
+                commitCount: c.commitCount,
+                share: c.share,
+            }));
+            let cumulative = 0;
+            busFactor = 0;
+            for (const c of m.topContributors) {
+                cumulative += c.share;
+                busFactor++;
+                if (cumulative >= 0.5)
+                    break;
+            }
+            busFactor = Math.max(1, busFactor);
+        }
+        else {
+            const ownerCommitCount = Math.round(commitCount * primaryOwnerShare);
+            const othersCommitCount = commitCount - ownerCommitCount;
+            const othersShare = 1 - primaryOwnerShare;
+            contributors = [
+                { email: primaryOwner, commitCount: ownerCommitCount, share: primaryOwnerShare },
+            ];
+            if (primaryOwnerShare < 1.0) {
+                contributors.push({ email: 'others', commitCount: othersCommitCount, share: othersShare });
+            }
+            busFactor = primaryOwnerShare >= 0.5 ? 1 : 2;
+        }
+        const activeMaintainers = primaryOwnerShare >= 0.9 ? 1 : 2;
+        return {
+            target,
+            targetType,
+            contributors,
+            primaryOwner,
+            primaryOwnerShare,
+            activeMaintainers,
+            busFactor,
+            analyzedWindow: this.analyzedWindow(),
+        };
+    }
+    getChangeRisk(targetType, target) {
+        const m = this.getMetrics(targetType, target);
+        const rf = m.riskFactors;
+        const riskScore = computeRiskScore(rf);
+        const riskLevel = classifyRiskLevel(riskScore);
+        const currentlyExists = targetType === 'file'
+            ? (m.currentlyExists ?? true)
+            : true;
+        return {
+            target,
+            targetType,
+            riskScore,
+            riskLevel,
+            factors: { ...rf },
+            factorExplanations: {
+                churn: `Commit churn factor: ${(rf.churn * 100).toFixed(0)}% of max (log-normalized)`,
+                authorCount: `Author diversity factor: ${(rf.authorCount * 100).toFixed(0)}% of max (log-normalized)`,
+                ownerConcentration: `Owner concentration risk: ${(rf.ownerConcentration * 100).toFixed(0)}% (1 - primaryOwnerShare)`,
+                cochangeBreadth: rf.cochangeBreadth,
+                recency: `Recency factor: ${(rf.recency * 100).toFixed(0)}% (recent activity = higher risk)`,
+            },
+            currentlyExists,
+            limitation: 'Risk score is a heuristic approximation based on git history patterns.',
+        };
+    }
+    getEvidencePack(targets) {
+        const results = [];
+        const notFound = [];
+        for (const { targetType, target } of targets) {
+            try {
+                const m = this.getMetrics(targetType, target);
+                const rf = m.riskFactors;
+                const riskScore = computeRiskScore(rf);
+                const riskLevel = classifyRiskLevel(riskScore);
+                const topFactor = topRiskFactor(rf);
+                results.push({ target, targetType, riskScore, riskLevel, topFactor });
+            }
+            catch {
+                notFound.push({
+                    target,
+                    targetType,
+                    reason: `Target "${target}" (type: ${targetType}) not found in git history data.`,
+                });
+            }
+        }
+        const hotspots = [...results].sort((a, b) => b.riskScore - a.riskScore).slice(0, 3);
+        return { results, hotspots, notFound };
+    }
+    getChangeContext(targetType, target) {
+        const m = this.getMetrics(targetType, target);
+        const rf = m.riskFactors;
+        const riskScore = computeRiskScore(rf);
+        const riskLevel = classifyRiskLevel(riskScore);
+        const stalePathWarning = targetType === 'file' &&
+            m.currentlyExists === false
+            ? 'This file path no longer exists in the working tree. It may have been renamed or deleted. History reflects the old path only.'
+            : undefined;
+        return {
+            target,
+            targetType,
+            summary: {
+                commitCount: m.commitCount,
+                activeDays: m.activeDays,
+                primaryOwner: m.primaryOwner,
+                lastChangedAt: m.lastChangedAt,
+            },
+            recentChurn: {
+                addedLines: m.addedLines,
+                deletedLines: m.deletedLines,
+                commitCount: m.commitCount,
+            },
+            ownerConcentration: {
+                primaryOwner: m.primaryOwner,
+                primaryOwnerShare: m.primaryOwnerShare,
+            },
+            topCochangeNeighbors: [...m.topCochangeNeighbors]
+                .sort((a, b) => b.strength - a.strength)
+                .slice(0, 5),
+            risk: {
+                riskScore,
+                riskLevel,
+                topFactor: topRiskFactor(rf),
+            },
+            analyzedWindow: this.analyzedWindow(),
+            stalePathWarning,
+        };
+    }
+}
+//# sourceMappingURL=history-query.js.map

package/dist/analysis/git-history/history-query.js.map

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

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

@@ -0,0 +1,4 @@
+export * from './git-log-reader.js';
+export * from './history-aggregator.js';
+export * from './history-query.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/analysis/git-history/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/analysis/git-history/index.js

@@ -0,0 +1,4 @@
+export * from './git-log-reader.js';
+export * from './history-aggregator.js';
+export * from './history-query.js';
+//# sourceMappingURL=index.js.map

package/dist/analysis/git-history/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/analysis/git-history/index.ts"],"names":[],"mappings":"AAIA,cAAc,qBAAqB,CAAC;AACpC,cAAc,yBAAyB,CAAC;AACxC,cAAc,oBAAoB,CAAC"}

package/dist/analysis/metric-vector-builder.d.ts

@@ -0,0 +1,5 @@
+import type { ArchJSON } from '../types/index.js';
+import type { PackageStatEntry } from '../cli/query/query-engine.js';
+import type { MetricVector } from '../types/metric-vector.js';
+export declare function buildMetricVector(archJson: ArchJSON, packageStats: PackageStatEntry[]): MetricVector;
+//# sourceMappingURL=metric-vector-builder.d.ts.map

package/dist/analysis/metric-vector-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric-vector-builder.d.ts","sourceRoot":"","sources":["../../src/analysis/metric-vector-builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAG7D,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,gBAAgB,EAAE,GAC/B,YAAY,CAoDd"}

package/dist/analysis/metric-vector-builder.js

@@ -0,0 +1,47 @@
+import { giniCoefficient } from './gini.js';
+import { ExtensionAccessor } from '../core/query/extension-accessor.js';
+export function buildMetricVector(archJson, packageStats) {
+    const metrics = archJson.metrics;
+    const fileStats = metrics?.fileStats ?? [];
+    const fileInDegrees = fileStats.map((f) => f.inDegree);
+    const fileMaxInDegree = fileInDegrees.length > 0 ? Math.max(...fileInDegrees) : 0;
+    const accessor = new ExtensionAccessor(archJson);
+    const packageGraph = accessor.getAtlasLayer('package');
+    let atlasInDegrees;
+    if (packageGraph && packageGraph.nodes.length > 0) {
+        const inDegreeMap = new Map();
+        for (const node of packageGraph.nodes)
+            inDegreeMap.set(node.id, 0);
+        for (const edge of packageGraph.edges) {
+            if (edge.source !== edge.target) {
+                inDegreeMap.set(edge.target, (inDegreeMap.get(edge.target) ?? 0) + 1);
+            }
+        }
+        atlasInDegrees = [...inDegreeMap.values()];
+    }
+    const effectiveInDegrees = atlasInDegrees ?? fileInDegrees;
+    const effectiveMaxInDegree = atlasInDegrees !== undefined
+        ? atlasInDegrees.length > 0
+            ? Math.max(...atlasInDegrees)
+            : 0
+        : fileMaxInDegree;
+    const maxInDegree = atlasInDegrees !== undefined
+        ? Math.max(effectiveMaxInDegree, fileMaxInDegree)
+        : fileMaxInDegree;
+    return {
+        schemaVersion: 1,
+        totalEntities: metrics?.entityCount ?? 0,
+        totalRelations: metrics?.relationCount ?? 0,
+        inferredRelationRatio: metrics?.inferredRelationRatio ?? 0,
+        sccCount: (metrics?.cycles ?? []).length,
+        relationTypeBreakdown: metrics?.relationTypeBreakdown ?? {},
+        maxInDegree,
+        maxOutDegree: fileStats.length > 0 ? Math.max(...fileStats.map((f) => f.outDegree)) : 0,
+        maxPackageSize: packageStats.length > 0 ? Math.max(...packageStats.map((p) => p.fileCount)) : 0,
+        giniInDegree: giniCoefficient(effectiveInDegrees),
+        giniPackageSize: giniCoefficient(packageStats.map((p) => p.fileCount)),
+        packageCount: packageStats.length,
+        entityCoverageRatio: accessor.getTestAnalysis()?.metrics?.entityCoverageRatio ?? null,
+    };
+}
+//# sourceMappingURL=metric-vector-builder.js.map

package/dist/analysis/metric-vector-builder.js.map

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

package/dist/analysis/metrics-history-reader.d.ts

@@ -0,0 +1,4 @@
+import type { MetricsHistoryEntry } from '../cli/metrics-history-writer.js';
+export type { MetricsHistoryEntry };
+export declare function readHistoryEntries(outputDir: string): Promise<MetricsHistoryEntry[]>;
+//# sourceMappingURL=metrics-history-reader.d.ts.map

package/dist/analysis/metrics-history-reader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-history-reader.d.ts","sourceRoot":"","sources":["../../src/analysis/metrics-history-reader.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAE3E,YAAY,EAAE,mBAAmB,EAAE,CAAC;AAMpC,wBAAsB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAqB1F"}

package/dist/analysis/metrics-history-reader.js

@@ -0,0 +1,24 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { MetricsHistoryWriter } from '../cli/metrics-history-writer.js';
+export async function readHistoryEntries(outputDir) {
+    const filePath = path.join(outputDir, MetricsHistoryWriter.FILENAME);
+    if (!(await fs.pathExists(filePath))) {
+        return [];
+    }
+    const content = await fs.readFile(filePath, 'utf-8');
+    const lines = content
+        .trim()
+        .split('\n')
+        .filter((l) => l.trim().length > 0);
+    const entries = [];
+    for (const line of lines) {
+        try {
+            entries.push(JSON.parse(line));
+        }
+        catch {
+        }
+    }
+    return entries;
+}
+//# sourceMappingURL=metrics-history-reader.js.map

package/dist/analysis/metrics-history-reader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics-history-reader.js","sourceRoot":"","sources":["../../src/analysis/metrics-history-reader.ts"],"names":[],"mappings":"AAKA,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AASvE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,SAAiB;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,oBAAoB,CAAC,QAAQ,CAAC,CAAC;IACrE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QACrC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACrD,MAAM,KAAK,GAAG,OAAO;SAClB,IAAI,EAAE;SACN,KAAK,CAAC,IAAI,CAAC;SACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEtC,MAAM,OAAO,GAA0B,EAAE,CAAC;IAC1C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAwB,CAAC,CAAC;QACxD,CAAC;QAAC,MAAM,CAAC;QAET,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { CycleInfo, Relation } from '../types/index.js';
+export interface PackageMetricsEntry {
+    packageName: string;
+    fanIn: number;
+    fanOut: number;
+    cycleCount: number;
+    cyclesWith: string[];
+}
+export declare function extractPackageName(entityId: string): string;
+export declare function computePackageFanMetricsFromRelations(relations: readonly Relation[], packageNames: Set<string>): {
+    fanIn: Map<string, number>;
+    fanOut: Map<string, number>;
+};
+export declare function computeCycleMetrics(cycles: CycleInfo[], packageNames: Set<string>): Map<string, {
+    cycleCount: number;
+    cyclesWith: string[];
+}>;
+//# sourceMappingURL=package-metrics-analysis.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"package-metrics-analysis.d.ts","sourceRoot":"","sources":["../../src/analysis/package-metrics-analysis.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,EAAE,CAAC;CACtB;AASD,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAY3D;AAUD,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,SAAS,QAAQ,EAAE,EAC9B,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB;IAAE,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CA0B7D;AAUD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EAAE,EACnB,YAAY,EAAE,GAAG,CAAC,MAAM,CAAC,GACxB,GAAG,CAAC,MAAM,EAAE;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAgC3D"}

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

@@ -0,0 +1,59 @@
+export function extractPackageName(entityId) {
+    const slashIdx = entityId.lastIndexOf('/');
+    if (slashIdx > 0) {
+        return entityId.slice(0, slashIdx);
+    }
+    const dotIdx = entityId.lastIndexOf('.');
+    if (dotIdx > 0) {
+        return entityId.slice(0, dotIdx);
+    }
+    return entityId;
+}
+export function computePackageFanMetricsFromRelations(relations, packageNames) {
+    const fanIn = new Map();
+    const fanOut = new Map();
+    for (const pkg of packageNames) {
+        fanIn.set(pkg, 0);
+        fanOut.set(pkg, 0);
+    }
+    for (const relation of relations) {
+        const srcPkg = extractPackageName(relation.source);
+        const tgtPkg = extractPackageName(relation.target);
+        if (srcPkg === tgtPkg)
+            continue;
+        if (packageNames.has(srcPkg)) {
+            fanOut.set(srcPkg, (fanOut.get(srcPkg) ?? 0) + 1);
+        }
+        if (packageNames.has(tgtPkg)) {
+            fanIn.set(tgtPkg, (fanIn.get(tgtPkg) ?? 0) + 1);
+        }
+    }
+    return { fanIn, fanOut };
+}
+export function computeCycleMetrics(cycles, packageNames) {
+    const result = new Map(Array.from(packageNames).map((pkg) => [pkg, { cycleCount: 0, cyclesWith: [] }]));
+    for (const cycle of cycles) {
+        const pkgsInCycle = new Set();
+        for (const memberId of cycle.members) {
+            const pkg = extractPackageName(memberId);
+            if (packageNames.has(pkg)) {
+                pkgsInCycle.add(pkg);
+            }
+        }
+        if (pkgsInCycle.size === 0)
+            continue;
+        for (const pkg of pkgsInCycle) {
+            const entry = result.get(pkg);
+            entry.cycleCount += 1;
+            const existingSet = new Set(entry.cyclesWith);
+            for (const name of cycle.memberNames) {
+                if (!existingSet.has(name)) {
+                    entry.cyclesWith.push(name);
+                    existingSet.add(name);
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=package-metrics-analysis.js.map

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

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

package/dist/analysis/project-semantics-loader.d.ts

@@ -0,0 +1,3 @@
+import { type ProjectSemanticsInput } from '../types/extensions/project-semantics.js';
+export declare function loadProjectSemanticsSidecar(workDir: string): Promise<ProjectSemanticsInput | undefined>;
+//# sourceMappingURL=project-semantics-loader.d.ts.map

package/dist/analysis/project-semantics-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-semantics-loader.d.ts","sourceRoot":"","sources":["../../src/analysis/project-semantics-loader.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,yCAAyC,CAAC;AAIjD,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CAmB5C"}

package/dist/analysis/project-semantics-loader.js

@@ -0,0 +1,25 @@
+import path from 'node:path';
+import { promises as fs } from 'node:fs';
+import { ProjectSemanticsInputSchema, } from '../types/extensions/project-semantics.js';
+const PROJECT_SEMANTICS_FILE_NAME = 'project-semantics.json';
+export async function loadProjectSemanticsSidecar(workDir) {
+    const filePath = path.join(workDir, PROJECT_SEMANTICS_FILE_NAME);
+    try {
+        const raw = await fs.readFile(filePath, 'utf8');
+        const parsed = ProjectSemanticsInputSchema.safeParse(JSON.parse(raw));
+        if (!parsed.success) {
+            const issues = parsed.error.issues
+                .map((issue) => `  - ${issue.path.join('.')}: ${issue.message}`)
+                .join('\n');
+            throw new Error(`Invalid ${PROJECT_SEMANTICS_FILE_NAME}:\n${issues}`);
+        }
+        return parsed.data;
+    }
+    catch (error) {
+        if (error?.code === 'ENOENT') {
+            return undefined;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=project-semantics-loader.js.map

package/dist/analysis/project-semantics-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-semantics-loader.js","sourceRoot":"","sources":["../../src/analysis/project-semantics-loader.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EACL,2BAA2B,GAE5B,MAAM,yCAAyC,CAAC;AAEjD,MAAM,2BAA2B,GAAG,wBAAwB,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAC/C,OAAe;IAEf,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,2BAA2B,CAAC,CAAC;IAEjE,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,2BAA2B,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC,CAAC;QACjF,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM;iBAC/B,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC;iBAC/D,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,KAAK,CAAC,WAAW,2BAA2B,MAAM,MAAM,EAAE,CAAC,CAAC;QACxE,CAAC;QACD,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAK,KAA+B,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YACxD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/analysis/snapshot-diff.d.ts

@@ -0,0 +1,19 @@
+import type { MetricSnapshot } from './snapshot-store.js';
+export interface MetricDiffEntry {
+    metric: string;
+    from: number | null;
+    to: number | null;
+    delta: number | null;
+    percentChange: number | null;
+}
+export interface MetricDiffResult {
+    fromCommit: string | null;
+    toCommit: string | null;
+    fromTimestamp: string;
+    toTimestamp: string;
+    schemaVersionMismatch: boolean;
+    entries: MetricDiffEntry[];
+    warnings: string[];
+}
+export declare function diffSnapshots(from: MetricSnapshot, to: MetricSnapshot): MetricDiffResult;
+//# sourceMappingURL=snapshot-diff.d.ts.map

package/dist/analysis/snapshot-diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-diff.d.ts","sourceRoot":"","sources":["../../src/analysis/snapshot-diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,OAAO,CAAC;IAC/B,OAAO,EAAE,eAAe,EAAE,CAAC;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAgBD,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,cAAc,GAAG,gBAAgB,CAiDxF"}

package/dist/analysis/snapshot-diff.js

@@ -0,0 +1,54 @@
+const NUMERIC_FIELDS = [
+    'totalEntities',
+    'totalRelations',
+    'inferredRelationRatio',
+    'sccCount',
+    'maxInDegree',
+    'maxOutDegree',
+    'maxPackageSize',
+    'giniInDegree',
+    'giniPackageSize',
+    'packageCount',
+    'entityCoverageRatio',
+];
+export function diffSnapshots(from, to) {
+    const warnings = [];
+    const schemaVersionMismatch = from.metricVector.schemaVersion !== to.metricVector.schemaVersion;
+    if (schemaVersionMismatch) {
+        warnings.push(`Schema version mismatch: from=${from.metricVector.schemaVersion}, to=${to.metricVector.schemaVersion}. Comparison may be unreliable.`);
+    }
+    const entries = NUMERIC_FIELDS.map((field) => {
+        const fromVal = from.metricVector[field] ?? null;
+        const toVal = to.metricVector[field] ?? null;
+        const fromNum = fromVal !== null && fromVal !== undefined ? fromVal : null;
+        const toNum = toVal !== null && toVal !== undefined ? toVal : null;
+        let delta = null;
+        let percentChange = null;
+        if (fromNum !== null && toNum !== null) {
+            delta = toNum - fromNum;
+            if (fromNum === 0) {
+                percentChange = null;
+            }
+            else {
+                percentChange = (delta / fromNum) * 100;
+            }
+        }
+        return {
+            metric: field,
+            from: fromNum,
+            to: toNum,
+            delta,
+            percentChange,
+        };
+    });
+    return {
+        fromCommit: from.commitSha,
+        toCommit: to.commitSha,
+        fromTimestamp: from.timestamp,
+        toTimestamp: to.timestamp,
+        schemaVersionMismatch,
+        entries,
+        warnings,
+    };
+}
+//# sourceMappingURL=snapshot-diff.js.map

package/dist/analysis/snapshot-diff.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-diff.js","sourceRoot":"","sources":["../../src/analysis/snapshot-diff.ts"],"names":[],"mappings":"AAoBA,MAAM,cAAc,GAA0B;IAC5C,eAAe;IACf,gBAAgB;IAChB,uBAAuB;IACvB,UAAU;IACV,aAAa;IACb,cAAc;IACd,gBAAgB;IAChB,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,qBAAqB;CACtB,CAAC;AAEF,MAAM,UAAU,aAAa,CAAC,IAAoB,EAAE,EAAkB;IACpE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,qBAAqB,GAAG,IAAI,CAAC,YAAY,CAAC,aAAa,KAAK,EAAE,CAAC,YAAY,CAAC,aAAa,CAAC;IAEhG,IAAI,qBAAqB,EAAE,CAAC;QAC1B,QAAQ,CAAC,IAAI,CACX,iCAAiC,IAAI,CAAC,YAAY,CAAC,aAAa,QAAQ,EAAE,CAAC,YAAY,CAAC,aAAa,iCAAiC,CACvI,CAAC;IACJ,CAAC;IAED,MAAM,OAAO,GAAsB,cAAc,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC9D,MAAM,OAAO,GACV,IAAI,CAAC,YAAqE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAC7F,MAAM,KAAK,GACR,EAAE,CAAC,YAAqE,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC;QAE3F,MAAM,OAAO,GAAG,OAAO,KAAK,IAAI,IAAI,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3E,MAAM,KAAK,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;QAEnE,IAAI,KAAK,GAAkB,IAAI,CAAC;QAChC,IAAI,aAAa,GAAkB,IAAI,CAAC;QAExC,IAAI,OAAO,KAAK,IAAI,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;YACvC,KAAK,GAAG,KAAK,GAAG,OAAO,CAAC;YACxB,IAAI,OAAO,KAAK,CAAC,EAAE,CAAC;gBAClB,aAAa,GAAG,IAAI,CAAC;YACvB,CAAC;iBAAM,CAAC;gBACN,aAAa,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,GAAG,CAAC;YAC1C,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,OAAO;YACb,EAAE,EAAE,KAAK;YACT,KAAK;YACL,aAAa;SACd,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,UAAU,EAAE,IAAI,CAAC,SAAS;QAC1B,QAAQ,EAAE,EAAE,CAAC,SAAS;QACtB,aAAa,EAAE,IAAI,CAAC,SAAS;QAC7B,WAAW,EAAE,EAAE,CAAC,SAAS;QACzB,qBAAqB;QACrB,OAAO;QACP,QAAQ;KACT,CAAC;AACJ,CAAC"}

package/dist/analysis/snapshot-store.d.ts

@@ -0,0 +1,15 @@
+import type { MetricVector } from '../types/metric-vector.js';
+export interface MetricSnapshot {
+    schemaVersion: number;
+    commitSha: string | null;
+    branch: string | null;
+    timestamp: string;
+    archguardVersion: string;
+    metricVector: MetricVector;
+}
+export declare function saveSnapshot(outputDir: string, snapshot: MetricSnapshot): Promise<void>;
+export declare function loadSnapshots(outputDir: string): Promise<MetricSnapshot[]>;
+export declare function pruneSnapshots(outputDir: string, maxCount: number): Promise<number>;
+export declare function resolveCommitSha(): Promise<string | null>;
+export declare function resolveBranch(): Promise<string | null>;
+//# sourceMappingURL=snapshot-store.d.ts.map

package/dist/analysis/snapshot-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-store.d.ts","sourceRoot":"","sources":["../../src/analysis/snapshot-store.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,YAAY,CAAC;CAC5B;AAeD,wBAAsB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAK7F;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CA4BhF;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAsCzF;AAoBD,wBAAsB,gBAAgB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE/D;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAE5D"}