universal-ast-mapper 2.0.0 → 2.0.1

package/dist/check.js

@@ -0,0 +1,112 @@
+import fs from "node:fs";
+import path from "node:path";
+import { buildReport } from "./report.js";
+export const BASELINE_FILENAME = ".ast-map.baseline.json";
+export function metricsFromReport(r) {
+    return {
+        fileCount: r.fileCount,
+        symbolCount: r.symbolCount,
+        cycles: r.cycles.count,
+        deadExports: r.dead.count,
+        sdpViolations: r.layerViolations.count,
+        veryHighComplexity: r.complexity.hotspots.filter((h) => h.complexity > 20).length,
+        maxComplexity: r.complexity.max,
+        score: r.score,
+        grade: r.grade,
+    };
+}
+function readBaseline(file) {
+    try {
+        const raw = JSON.parse(fs.readFileSync(file, "utf8"));
+        return raw.metrics ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function checkThresholds(m, t, out) {
+    const rules = [
+        ["maxCycles", "cycles", "max"],
+        ["maxDeadExports", "deadExports", "max"],
+        ["maxSdpViolations", "sdpViolations", "max"],
+        ["maxVeryHighComplexity", "veryHighComplexity", "max"],
+        ["maxComplexity", "maxComplexity", "max"],
+        ["minScore", "score", "min"],
+    ];
+    for (const [tKey, mKey, dir] of rules) {
+        const limit = t[tKey];
+        if (limit === undefined)
+            continue;
+        const actual = m[mKey];
+        const bad = dir === "max" ? actual > limit : actual < limit;
+        if (bad) {
+            out.push({
+                kind: "threshold",
+                metric: mKey,
+                limit,
+                actual,
+                message: `${mKey} is ${actual}, ${dir === "max" ? "exceeds max" : "below min"} ${limit}`,
+            });
+        }
+    }
+}
+/** Metrics where an increase vs the baseline is a regression. */
+const RATCHET_UP = [
+    "cycles",
+    "deadExports",
+    "sdpViolations",
+    "veryHighComplexity",
+];
+function checkBaseline(m, base, out) {
+    for (const key of RATCHET_UP) {
+        const was = base[key];
+        const now = m[key];
+        if (now > was) {
+            out.push({
+                kind: "regression",
+                metric: key,
+                limit: was,
+                actual: now,
+                message: `${key} regressed: ${was} → ${now} (baseline ratchet)`,
+            });
+        }
+    }
+    if (m.score < base.score) {
+        out.push({
+            kind: "regression",
+            metric: "score",
+            limit: base.score,
+            actual: m.score,
+            message: `health score regressed: ${base.score} → ${m.score}`,
+        });
+    }
+}
+export async function runQualityGate(absDir, root, opts = {}) {
+    const report = await buildReport(absDir, root);
+    const metrics = metricsFromReport(report);
+    const baselinePath = path.resolve(root, opts.baselinePath ?? BASELINE_FILENAME);
+    const baseline = readBaseline(baselinePath);
+    const failures = [];
+    if (opts.thresholds)
+        checkThresholds(metrics, opts.thresholds, failures);
+    if (baseline)
+        checkBaseline(metrics, baseline, failures);
+    let baselineUpdated = false;
+    if (opts.updateBaseline) {
+        const doc = {
+            tool: "universal-ast-mapper",
+            updatedAt: new Date().toISOString(),
+            metrics,
+        };
+        fs.writeFileSync(baselinePath, JSON.stringify(doc, null, 2) + "\n", "utf8");
+        baselineUpdated = true;
+    }
+    return {
+        passed: failures.length === 0,
+        metrics,
+        baseline,
+        baselinePath,
+        baselineUpdated,
+        failures,
+    };
+}