@yalehwang/archguard 0.1.23 → 0.1.32

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"}

package/dist/analysis/snapshot-store.js

@@ -0,0 +1,96 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { spawn } from 'node:child_process';
+const SNAPSHOTS_SUBDIR = 'snapshots';
+function snapshotsDir(outputDir) {
+    return path.join(outputDir, SNAPSHOTS_SUBDIR);
+}
+function buildFilename(snapshot) {
+    const prefix = snapshot.commitSha ?? 'unknown';
+    const ts = snapshot.timestamp.replace(/[:.]/g, '-').replace(/Z$/, 'Z');
+    return `${prefix}-${ts}.json`;
+}
+export async function saveSnapshot(outputDir, snapshot) {
+    const dir = snapshotsDir(outputDir);
+    await fs.mkdir(dir, { recursive: true });
+    const filePath = path.join(dir, buildFilename(snapshot));
+    await fs.writeJson(filePath, snapshot, { spaces: 2 });
+}
+export async function loadSnapshots(outputDir) {
+    const dir = snapshotsDir(outputDir);
+    if (!(await fs.pathExists(dir))) {
+        return [];
+    }
+    const entries = await fs.readdir(dir);
+    const jsonFiles = entries.filter((f) => f.endsWith('.json'));
+    const snapshots = [];
+    for (const file of jsonFiles) {
+        try {
+            const data = await fs.readJson(path.join(dir, file));
+            snapshots.push(data);
+        }
+        catch {
+        }
+    }
+    snapshots.sort((a, b) => {
+        const ta = new Date(a.timestamp).getTime();
+        const tb = new Date(b.timestamp).getTime();
+        return tb - ta;
+    });
+    return snapshots;
+}
+export async function pruneSnapshots(outputDir, maxCount) {
+    const dir = snapshotsDir(outputDir);
+    if (!(await fs.pathExists(dir))) {
+        return 0;
+    }
+    const entries = await fs.readdir(dir);
+    const jsonFiles = entries.filter((f) => f.endsWith('.json'));
+    if (jsonFiles.length <= maxCount) {
+        return 0;
+    }
+    const fileSnapshots = [];
+    for (const file of jsonFiles) {
+        try {
+            const data = await fs.readJson(path.join(dir, file));
+            fileSnapshots.push({
+                file,
+                timestamp: new Date(data.timestamp).getTime(),
+            });
+        }
+        catch {
+            fileSnapshots.push({ file, timestamp: 0 });
+        }
+    }
+    fileSnapshots.sort((a, b) => b.timestamp - a.timestamp);
+    const toDelete = fileSnapshots.slice(maxCount);
+    for (const { file } of toDelete) {
+        await fs.remove(path.join(dir, file));
+    }
+    return toDelete.length;
+}
+function runGitCommand(args) {
+    return new Promise((resolve) => {
+        const proc = spawn('git', args, { stdio: ['ignore', 'pipe', 'ignore'] });
+        let stdout = '';
+        proc.stdout.on('data', (chunk) => {
+            stdout += chunk.toString();
+        });
+        proc.on('close', (code) => {
+            if (code === 0 && stdout.trim()) {
+                resolve(stdout.trim());
+            }
+            else {
+                resolve(null);
+            }
+        });
+        proc.on('error', () => resolve(null));
+    });
+}
+export async function resolveCommitSha() {
+    return runGitCommand(['rev-parse', 'HEAD']);
+}
+export async function resolveBranch() {
+    return runGitCommand(['rev-parse', '--abbrev-ref', 'HEAD']);
+}
+//# sourceMappingURL=snapshot-store.js.map

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

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

package/dist/analysis/test-analyzer.d.ts

@@ -1,10 +1,13 @@
 import type { ILanguagePlugin } from '../core/interfaces/language-plugin.js';
 import type { ArchJSON } from '../types/index.js';
-import type { TestAnalysis, TestPatternConfig } from '../types/extensions.js';
+import type { TestAnalysis, TestPatternConfig } from '../types/extensions/test-analysis.js';
+import type { ProjectSemantics } from '../types/extensions/project-semantics.js';
 export interface TestAnalyzerOptions {
     workspaceRoot: string;
     patternConfig?: TestPatternConfig;
+    projectSemantics?: Partial<ProjectSemantics>;
 }
+export declare function mergeProjectSemanticsIntoPatternConfig(patternConfig?: TestPatternConfig, projectSemantics?: Partial<ProjectSemantics>): TestPatternConfig | undefined;
 export declare class TestAnalyzer {
     private mapper;
     private issueDetector;

package/dist/analysis/test-analyzer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"test-analyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/test-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,YAAY,EAAgB,iBAAiB,EAAe,MAAM,uBAAuB,CAAC;AAKxG,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,iBAAiB,CAAC;CACnC;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAA2B;IAE1C,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC;YAmBV,iBAAiB;YAgDjB,aAAa;YAeb,mBAAmB;IAoBjC,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,wBAAwB;IA4DhC,OAAO,CAAC,cAAc;CAiDvB"}
+{"version":3,"file":"test-analyzer.d.ts","sourceRoot":"","sources":["../../src/analysis/test-analyzer.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAe,MAAM,sCAAsC,CAAC;AACzF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EACV,YAAY,EAEZ,iBAAiB,EAElB,MAAM,qCAAqC,CAAC;AAE7C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAIhF,MAAM,WAAW,mBAAmB;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,iBAAiB,CAAC;IAClC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAMD,wBAAgB,sCAAsC,CACpD,aAAa,CAAC,EAAE,iBAAiB,EACjC,gBAAgB,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GAC3C,iBAAiB,GAAG,SAAS,CA6B/B;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAA4B;IAC1C,OAAO,CAAC,aAAa,CAA2B;IAE1C,OAAO,CACX,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,YAAY,CAAC;YA2BV,iBAAiB;YAgEjB,aAAa;YAeb,mBAAmB;IAoBjC,OAAO,CAAC,kBAAkB;IA6C1B,OAAO,CAAC,wBAAwB;IA0EhC,OAAO,CAAC,cAAc;CAiDvB"}

package/dist/analysis/test-analyzer.js

@@ -1,16 +1,44 @@
 import path from 'path';
 import { promises as fs } from 'fs';
 import { globby } from 'globby';
-import { TEST_ANALYSIS_VERSION } from '../types/extensions.js';
+import { TEST_ANALYSIS_VERSION } from '../types/extensions/test-analysis.js';
 import { TestCoverageMapper } from './test-coverage-mapper.js';
 import { TestIssueDetector } from './test-issue-detector.js';
+function uniqueStrings(values) {
+    return [...new Set(values)];
+}
+export function mergeProjectSemanticsIntoPatternConfig(patternConfig, projectSemantics) {
+    const additionalTestPatterns = projectSemantics?.additionalTestPatterns ?? [];
+    const semanticAssertionRegexes = projectSemantics?.customAssertionPatterns ?? [];
+    const shouldInjectCustomRegexes = (patternConfig?.assertionPatterns?.length ?? 0) === 0 &&
+        (patternConfig?.customAssertionRegexes?.length ?? 0) === 0;
+    const testFileGlobs = uniqueStrings([
+        ...(patternConfig?.testFileGlobs ?? []),
+        ...additionalTestPatterns,
+    ]);
+    if (!patternConfig &&
+        testFileGlobs.length === 0 &&
+        (!shouldInjectCustomRegexes || semanticAssertionRegexes.length === 0)) {
+        return undefined;
+    }
+    return {
+        ...patternConfig,
+        testFileGlobs: testFileGlobs.length > 0 ? testFileGlobs : patternConfig?.testFileGlobs,
+        customAssertionRegexes: shouldInjectCustomRegexes
+            ? semanticAssertionRegexes.length > 0
+                ? uniqueStrings(semanticAssertionRegexes)
+                : patternConfig?.customAssertionRegexes
+            : patternConfig?.customAssertionRegexes,
+    };
+}
 export class TestAnalyzer {
     mapper = new TestCoverageMapper();
     issueDetector = new TestIssueDetector();
     async analyze(archJson, plugin, options) {
-        const { workspaceRoot, patternConfig } = options;
-        const testFilePaths = await this.discoverTestFiles(workspaceRoot, plugin, patternConfig);
-        const rawFiles = await this.collectRawTestFiles(testFilePaths, plugin, patternConfig);
+        const { workspaceRoot, patternConfig, projectSemantics } = options;
+        const effectivePatternConfig = mergeProjectSemanticsIntoPatternConfig(patternConfig, projectSemantics);
+        const testFilePaths = await this.discoverTestFiles(workspaceRoot, plugin, effectivePatternConfig);
+        const rawFiles = await this.collectRawTestFiles(testFilePaths, plugin, effectivePatternConfig);
         const testFiles = this.buildTestFileInfos(rawFiles, archJson, workspaceRoot);
         const coverageMap = this.mapper.buildCoverageMap(testFiles, archJson, workspaceRoot);
         const issues = this.issueDetector.detect(testFiles, coverageMap);
@@ -25,11 +53,15 @@ export class TestAnalyzer {
         };
     }
     async discoverTestFiles(workspaceRoot, plugin, patternConfig) {
+        const extraMatches = patternConfig?.testFileGlobs && patternConfig.testFileGlobs.length > 0
+            ? await globby(patternConfig.testFileGlobs.map((globPattern) => `${workspaceRoot}/${globPattern}`), { onlyFiles: true, absolute: true })
+            : [];
         if (plugin.metadata.fileExtensions.includes('.go')) {
-            return globby(`${workspaceRoot}/**/*_test.go`, { onlyFiles: true, absolute: true });
-        }
-        if (patternConfig?.testFileGlobs && patternConfig.testFileGlobs.length > 0) {
-            return globby(patternConfig.testFileGlobs.map((g) => `${workspaceRoot}/${g}`), { onlyFiles: true, absolute: true });
+            const defaultMatches = await globby(`${workspaceRoot}/**/*_test.go`, {
+                onlyFiles: true,
+                absolute: true,
+            });
+            return uniqueStrings([...defaultMatches, ...extraMatches]);
         }
         if (plugin.metadata.fileExtensions.includes('.java')) {
             const allJavaFiles = await globby(`${workspaceRoot}/**/*.java`, {
@@ -38,23 +70,36 @@ export class TestAnalyzer {
                 ignore: ['**/target/**', '**/build/**', '**/node_modules/**'],
             });
             if (plugin.isTestFile) {
-                return allJavaFiles.filter((f) => plugin.isTestFile(f, patternConfig));
+                return uniqueStrings([
+                    ...allJavaFiles.filter((f) => plugin.isTestFile(f, patternConfig)),
+                    ...extraMatches,
+                ]);
             }
-            return allJavaFiles;
+            return uniqueStrings([...allJavaFiles, ...extraMatches]);
         }
         const candidateDirs = await this.inferTestDirs(workspaceRoot);
         const allFiles = [];
         for (const dir of candidateDirs) {
-            const files = await globby(`${dir}/**/*`, { onlyFiles: true, absolute: true });
+            const files = await globby(`${dir}/**/*`, {
+                onlyFiles: true,
+                absolute: true,
+                ignore: ['**/node_modules/**'],
+            });
             allFiles.push(...files);
         }
         if (plugin.isTestFile) {
-            return allFiles.filter((f) => plugin.isTestFile(f, patternConfig));
+            return uniqueStrings([
+                ...allFiles.filter((f) => plugin.isTestFile(f, patternConfig)),
+                ...extraMatches,
+            ]);
         }
-        return allFiles.filter((f) => /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(f) || /_test\.(go|ts)$/.test(f));
+        return uniqueStrings([
+            ...allFiles.filter((f) => /\.(test|spec)\.(ts|tsx|js|jsx)$/.test(f) || /_test\.(go|ts)$/.test(f)),
+            ...extraMatches,
+        ]);
     }
     async inferTestDirs(workspaceRoot) {
-        const candidates = ['tests', '__tests__', 'test', 'spec', 'src'];
+        const candidates = ['tests', '__tests__', 'test', 'spec', 'autotest', 'src'];
         const results = [];
         for (const c of candidates) {
             const p = path.join(workspaceRoot, c);
@@ -126,6 +171,14 @@ export class TestAnalyzer {
                 relSrc = srcFile;
             }
             for (const entity of archJson.entities) {
+                if (entity.id === relSrc) {
+                    result.push(entity.id);
+                    continue;
+                }
+                if (!relSrc.includes('/') && relSrc.includes('.') && entity.id.startsWith(relSrc + '.')) {
+                    result.push(entity.id);
+                    continue;
+                }
                 const entityFile = entity.sourceLocation?.file;
                 if (!entityFile)
                     continue;