@agentvibes/guardrails 0.1.0

package/dist/metrics.js

@@ -0,0 +1,113 @@
+import { spawnSync } from "node:child_process";
+import { join } from "node:path";
+import { aggregate } from "./metricsAggregate.js";
+import { appendSnapshot, checkAgainstBaseline, GATED_KEYS, readBaseline, updateGated, writeBaseline, } from "./metricsBaseline.js";
+import { collectMetrics } from "./metricsCollect.js";
+function headCommit(cwd) {
+    const res = spawnSync("git", ["-C", cwd, "rev-parse", "HEAD"], { encoding: "utf8" });
+    if (res.status !== 0 || res.error)
+        return null;
+    return res.stdout.trim();
+}
+function printReport(metrics) {
+    const { gated, observed } = metrics;
+    console.log(`guardrails metrics — ${observed.componentCount} component(s) in ${observed.fileCount} file(s)`);
+    console.log("gated (ratchet set, lower = better):");
+    for (const key of GATED_KEYS)
+        console.log(`  ${key.padEnd(22)} ${gated[key]}`);
+    console.log("observed:");
+    console.log(`  component_loc p50/p90/max   ${observed.p50ComponentLoc}/${gated.p90ComponentLoc}/${observed.maxComponentLoc}  (${observed.pctComponentsLe80}% ≤80)`);
+    console.log(`  hooks total                 useState=${observed.hooksTotal.useState} useEffect=${observed.hooksTotal.useEffect} useMemo=${observed.hooksTotal.useMemo} useCallback=${observed.hooksTotal.useCallback} useRef=${observed.hooksTotal.useRef}`);
+    console.log(`  observer_wrapped            ${observed.observerWrappedPct}%   avg props ${observed.avgPropsCount}   max JSX depth ${observed.maxJsxDepth}`);
+    console.log(`  exhaustive_ratio            ${observed.exhaustiveRatio ?? "n/a (no match sites)"} (${observed.matchSites} match sites, ${observed.otherwiseCount} .otherwise)`);
+    console.log(`  jsx branching               ternary=${observed.ternaryInJsxCount} &&=${observed.andInJsxCount}`);
+    console.log(`  file_sloc p50               ${observed.p50FileSloc}`);
+}
+export function runMetrics(opts) {
+    if (opts.check && opts.updateBaseline) {
+        console.error("guardrails metrics: --check and --update-baseline are mutually exclusive");
+        return 2;
+    }
+    const cwd = process.cwd();
+    const baselinePath = opts.baselinePath ?? join(cwd, ".guardrails", "metrics.json");
+    const snapshotPath = join(cwd, ".guardrails", "metrics-snapshots.jsonl");
+    const targets = opts.targets.length > 0 ? opts.targets : ["."];
+    const metrics = aggregate(collectMetrics(targets));
+    const commit = headCommit(cwd);
+    if (opts.snapshot) {
+        appendSnapshot(snapshotPath, metrics.gated, metrics.observed, commit);
+    }
+    if (opts.updateBaseline) {
+        const old = readBaseline(baselinePath);
+        const result = updateGated(old?.gated, metrics.gated, opts.force);
+        writeBaseline(baselinePath, result.next, metrics.observed, commit);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                command: "metrics",
+                action: "update-baseline",
+                baselinePath,
+                ...result,
+                current: metrics.gated,
+            }, null, 2));
+            return 0;
+        }
+        console.log(old === undefined
+            ? `guardrails metrics: baseline created at ${baselinePath}`
+            : `guardrails metrics: baseline updated at ${baselinePath}${opts.force ? " (--force: set to current values)" : ""}`);
+        for (const k of result.tightened)
+            console.log(`  tightened  ${k} → ${result.next[k]}`);
+        for (const k of result.withinHysteresis) {
+            console.log(`  kept       ${k} (improved <2% — hysteresis holds the old ceiling)`);
+        }
+        for (const k of result.worse) {
+            console.log(`  kept       ${k} (current ${metrics.gated[k]} is WORSE than baseline ${result.next[k]} — not loosening without --force)`);
+        }
+        return 0;
+    }
+    if (opts.check) {
+        const baseline = readBaseline(baselinePath);
+        if (baseline === undefined) {
+            console.error(`guardrails metrics --check: no baseline at ${baselinePath} — create one with \`guardrails metrics --update-baseline\` and commit it.`);
+            return 2;
+        }
+        const regressions = checkAgainstBaseline(metrics.gated, baseline.gated);
+        if (opts.json) {
+            console.log(JSON.stringify({
+                command: "metrics",
+                action: "check",
+                baselinePath,
+                ok: regressions.length === 0,
+                regressions,
+                current: metrics.gated,
+                baseline: baseline.gated,
+            }, null, 2));
+            return regressions.length === 0 ? 0 : 1;
+        }
+        if (regressions.length === 0) {
+            console.log(`guardrails metrics --check: OK — no gated metric regressed vs ${baselinePath} (baseline commit ${baseline.commit?.slice(0, 12) ?? "unknown"})`);
+            return 0;
+        }
+        console.log("guardrails metrics --check: RATCHET VIOLATION — gated metrics regressed:");
+        for (const r of regressions) {
+            console.log(`  ${r.metric.padEnd(22)} baseline ${r.baseline} → current ${r.current}`);
+        }
+        console.log("Improve the code back under the baseline. Loosening the baseline itself requires\n`guardrails metrics --update-baseline --force` and belongs in a reviewed commit.");
+        return 1;
+    }
+    if (opts.json) {
+        console.log(JSON.stringify({
+            command: "metrics",
+            targets,
+            gated: metrics.gated,
+            observed: metrics.observed,
+            components: metrics.components,
+            files: metrics.files,
+        }, null, 2));
+        return 0;
+    }
+    printReport(metrics);
+    if (opts.snapshot)
+        console.log(`snapshot appended to ${snapshotPath}`);
+    return 0;
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/metricsAggregate.d.ts

@@ -0,0 +1,5 @@
+import type { CollectedMetrics } from "./metricsCollect.js";
+import type { ProjectMetrics } from "./metricsTypes.js";
+/** Nearest-rank percentile over an unsorted sample; 0 for an empty sample. */
+export declare function percentile(values: number[], p: number): number;
+export declare function aggregate(collected: CollectedMetrics): ProjectMetrics;

package/dist/metricsAggregate.js

@@ -0,0 +1,78 @@
+/** Nearest-rank percentile over an unsorted sample; 0 for an empty sample. */
+export function percentile(values, p) {
+    if (values.length === 0)
+        return 0;
+    const sorted = [...values].sort((a, b) => a - b);
+    const rank = Math.max(1, Math.ceil((p / 100) * sorted.length));
+    return sorted[rank - 1] ?? 0;
+}
+const round = (n, places = 4) => {
+    const f = 10 ** places;
+    return Math.round(n * f) / f;
+};
+export function aggregate(collected) {
+    const { components, files, store, inlineMapRowCount } = collected;
+    const locs = components.map((c) => c.componentLoc);
+    const contextCosts = files.map((f) => f.contextCost);
+    const n = components.length;
+    const hooksTotal = {
+        useState: 0,
+        useEffect: 0,
+        useMemo: 0,
+        useCallback: 0,
+        useRef: 0,
+    };
+    let propsTotal = 0;
+    let observerWrapped = 0;
+    let maxJsxDepth = 0;
+    let matchSites = 0;
+    let exhaustive = 0;
+    let otherwise = 0;
+    let ternaryInJsx = 0;
+    let andInJsx = 0;
+    for (const c of components) {
+        for (const k of Object.keys(hooksTotal))
+            hooksTotal[k] += c.hooks[k];
+        propsTotal += c.propsCount;
+        if (c.observerWrapped)
+            observerWrapped += 1;
+        if (c.jsxMaxDepth > maxJsxDepth)
+            maxJsxDepth = c.jsxMaxDepth;
+        matchSites += c.branching.match;
+        exhaustive += c.branching.exhaustive;
+        otherwise += c.branching.otherwise;
+        ternaryInJsx += c.branching.ternaryInJsx;
+        andInJsx += c.branching.andInJsx;
+    }
+    const gated = {
+        p90ComponentLoc: percentile(locs, 90),
+        useStateDensity: n === 0 ? 0 : round(hooksTotal.useState / n),
+        inlineMapRowCount,
+        p90ContextCost: percentile(contextCosts, 90),
+        runInActionCount: store.runInActionCount,
+        asyncInStore: store.asyncInStore,
+        newMapInStore: store.newMapInStore,
+        reactionsTotal: store.reactionsTotal,
+        loadingBooleanShapes: store.loadingBooleanShapes,
+    };
+    const observed = {
+        componentCount: n,
+        fileCount: files.length,
+        p50ComponentLoc: percentile(locs, 50),
+        maxComponentLoc: locs.length === 0 ? 0 : Math.max(...locs),
+        pctComponentsLe80: n === 0 ? 100 : round((100 * locs.filter((l) => l <= 80).length) / n, 1),
+        observerWrappedPct: n === 0 ? 0 : round((100 * observerWrapped) / n, 1),
+        hooksTotal,
+        avgPropsCount: n === 0 ? 0 : round(propsTotal / n),
+        maxJsxDepth,
+        exhaustiveRatio: matchSites === 0 ? null : round(exhaustive / matchSites),
+        matchSites,
+        otherwiseCount: otherwise,
+        ternaryInJsxCount: ternaryInJsx,
+        andInJsxCount: andInJsx,
+        p50FileSloc: percentile(files.map((f) => f.fileSloc), 50),
+        p90ContextCostObserved: percentile(contextCosts, 90),
+    };
+    return { gated, observed, components, files };
+}
+//# sourceMappingURL=metricsAggregate.js.map

package/dist/metricsAggregate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metricsAggregate.js","sourceRoot":"","sources":["../src/metricsAggregate.ts"],"names":[],"mappings":"AAGA,8EAA8E;AAC9E,MAAM,UAAU,UAAU,CAAC,MAAgB,EAAE,CAAS;IACpD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;IAC/D,OAAO,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,KAAK,GAAG,CAAC,CAAS,EAAE,MAAM,GAAG,CAAC,EAAU,EAAE;IAC9C,MAAM,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC;IACvB,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AAC/B,CAAC,CAAC;AAEF,MAAM,UAAU,SAAS,CAAC,SAA2B;IACnD,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,KAAK,EAAE,iBAAiB,EAAE,GAAG,SAAS,CAAC;IAClE,MAAM,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;IACrD,MAAM,CAAC,GAAG,UAAU,CAAC,MAAM,CAAC;IAE5B,MAAM,UAAU,GAAe;QAC7B,QAAQ,EAAE,CAAC;QACX,SAAS,EAAE,CAAC;QACZ,OAAO,EAAE,CAAC;QACV,WAAW,EAAE,CAAC;QACd,MAAM,EAAE,CAAC;KACV,CAAC;IACF,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,eAAe,GAAG,CAAC,CAAC;IACxB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,UAAU,GAAG,CAAC,CAAC;IACnB,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,KAAK,MAAM,CAAC,IAAI,UAAU,EAAE,CAAC;QAC3B,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAyB;YAAE,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QAC7F,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC;QAC3B,IAAI,CAAC,CAAC,eAAe;YAAE,eAAe,IAAI,CAAC,CAAC;QAC5C,IAAI,CAAC,CAAC,WAAW,GAAG,WAAW;YAAE,WAAW,GAAG,CAAC,CAAC,WAAW,CAAC;QAC7D,UAAU,IAAI,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC;QAChC,UAAU,IAAI,CAAC,CAAC,SAAS,CAAC,UAAU,CAAC;QACrC,SAAS,IAAI,CAAC,CAAC,SAAS,CAAC,SAAS,CAAC;QACnC,YAAY,IAAI,CAAC,CAAC,SAAS,CAAC,YAAY,CAAC;QACzC,QAAQ,IAAI,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;IACnC,CAAC;IAED,MAAM,KAAK,GAAiB;QAC1B,eAAe,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,eAAe,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,QAAQ,GAAG,CAAC,CAAC;QAC7D,iBAAiB;QACjB,cAAc,EAAE,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;QAC5C,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;QACxC,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,cAAc,EAAE,KAAK,CAAC,cAAc;QACpC,oBAAoB,EAAE,KAAK,CAAC,oBAAoB;KACjD,CAAC;IAEF,MAAM,QAAQ,GAAoB;QAChC,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,KAAK,CAAC,MAAM;QACvB,eAAe,EAAE,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC;QACrC,eAAe,EAAE,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;QAC1D,iBAAiB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC3F,kBAAkB,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,eAAe,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvE,UAAU;QACV,aAAa,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC;QAClD,WAAW;QACX,eAAe,EAAE,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,GAAG,UAAU,CAAC;QACzE,UAAU;QACV,cAAc,EAAE,SAAS;QACzB,iBAAiB,EAAE,YAAY;QAC/B,aAAa,EAAE,QAAQ;QACvB,WAAW,EAAE,UAAU,CACrB,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAC5B,EAAE,CACH;QACD,sBAAsB,EAAE,UAAU,CAAC,YAAY,EAAE,EAAE,CAAC;KACrD,CAAC;IAEF,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;AAChD,CAAC"}

package/dist/metricsBaseline.d.ts

@@ -0,0 +1,21 @@
+import type { Baseline, GatedMetrics, ObservedMetrics } from "./metricsTypes.js";
+export declare const HYSTERESIS = 0.02;
+export declare const GATED_KEYS: (keyof GatedMetrics)[];
+export interface Regression {
+    metric: keyof GatedMetrics;
+    baseline: number;
+    current: number;
+}
+export declare function readBaseline(path: string): Baseline | undefined;
+export declare function checkAgainstBaseline(current: GatedMetrics, baseline: GatedMetrics): Regression[];
+export interface UpdateResult {
+    next: GatedMetrics;
+    tightened: (keyof GatedMetrics)[];
+    /** improved, but by less than the hysteresis — kept the old ceiling */
+    withinHysteresis: (keyof GatedMetrics)[];
+    /** currently worse than baseline — kept the old ceiling (no silent loosening) */
+    worse: (keyof GatedMetrics)[];
+}
+export declare function updateGated(old: GatedMetrics | undefined, current: GatedMetrics, force: boolean): UpdateResult;
+export declare function writeBaseline(path: string, gated: GatedMetrics, observed: ObservedMetrics, commit: string | null): void;
+export declare function appendSnapshot(path: string, gated: GatedMetrics, observed: ObservedMetrics, commit: string | null): void;

package/dist/metricsBaseline.js

@@ -0,0 +1,88 @@
+import { appendFileSync, existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+// Ratchet mechanics (D7). Direction for every gated metric is LOWER = BETTER.
+// `--check` always RECOMPUTES the facts and compares against the committed
+// baseline file — it never believes the file's own numbers. Tightening happens
+// only through `--update-baseline`, and only when a metric improved by more
+// than the hysteresis (~2%), so a noise-level fluctuation cannot latch an
+// accidental ceiling; `--force` overrides in both directions (loosening a
+// baseline is a reviewed decision visible in the diff, not something the tool
+// does on its own).
+export const HYSTERESIS = 0.02;
+const EPS = 1e-9;
+export const GATED_KEYS = [
+    "p90ComponentLoc",
+    "useStateDensity",
+    "inlineMapRowCount",
+    "p90ContextCost",
+    "runInActionCount",
+    "asyncInStore",
+    "newMapInStore",
+    "reactionsTotal",
+    "loadingBooleanShapes",
+];
+export function readBaseline(path) {
+    if (!existsSync(path))
+        return undefined;
+    const parsed = JSON.parse(readFileSync(path, "utf8"));
+    if (parsed.version !== 1 || typeof parsed.gated !== "object") {
+        throw new Error(`baseline at ${path} has an unrecognised shape — regenerate with --update-baseline --force`);
+    }
+    return parsed;
+}
+export function checkAgainstBaseline(current, baseline) {
+    const regressions = [];
+    for (const key of GATED_KEYS) {
+        const base = baseline[key] ?? 0;
+        const cur = current[key];
+        if (cur > base + EPS + Math.abs(base) * EPS) {
+            regressions.push({ metric: key, baseline: base, current: cur });
+        }
+    }
+    return regressions;
+}
+export function updateGated(old, current, force) {
+    if (old === undefined || force) {
+        return {
+            next: { ...current },
+            tightened: force ? [] : GATED_KEYS,
+            withinHysteresis: [],
+            worse: [],
+        };
+    }
+    const next = { ...old };
+    const tightened = [];
+    const withinHysteresis = [];
+    const worse = [];
+    for (const key of GATED_KEYS) {
+        const base = old[key] ?? 0;
+        const cur = current[key];
+        if (cur < base * (1 - HYSTERESIS) - EPS) {
+            next[key] = cur;
+            tightened.push(key);
+        }
+        else if (cur > base + EPS) {
+            worse.push(key);
+        }
+        else if (cur < base - EPS) {
+            withinHysteresis.push(key);
+        }
+    }
+    return { next, tightened, withinHysteresis, worse };
+}
+export function writeBaseline(path, gated, observed, commit) {
+    const baseline = {
+        version: 1,
+        updatedAt: new Date().toISOString(),
+        commit,
+        gated,
+        observed,
+    };
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, `${JSON.stringify(baseline, null, 2)}\n`);
+}
+export function appendSnapshot(path, gated, observed, commit) {
+    mkdirSync(dirname(path), { recursive: true });
+    appendFileSync(path, `${JSON.stringify({ timestamp: new Date().toISOString(), commit, gated, observed })}\n`);
+}
+//# sourceMappingURL=metricsBaseline.js.map

package/dist/metricsBaseline.js.map

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

package/dist/metricsCollect.d.ts

@@ -0,0 +1,8 @@
+import type { ComponentMetrics, FileMetrics, StoreMetrics } from "./metricsTypes.js";
+export interface CollectedMetrics {
+    components: ComponentMetrics[];
+    files: FileMetrics[];
+    store: StoreMetrics;
+    inlineMapRowCount: number;
+}
+export declare function collectMetrics(targets: string[]): CollectedMetrics;

package/dist/metricsCollect.js

@@ -0,0 +1,295 @@
+import { spawnSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+import ts from "typescript";
+import { scan } from "./astGrep.js";
+import { collectFiles } from "./fileWalk.js";
+import { rulesConfig, structureConfig } from "./packagePaths.js";
+import { classifyLines, codeLinesInRange } from "./sourceLines.js";
+// Production code only — same exclusions the vault audit used (§1: "тесты/
+// showcase исключены"), so numbers stay comparable to the audit baselines.
+const EXCLUDED_FILE = /\.(test|spec|stories)\.[jt]sx?$|__tests__|\/showcase\/|\.d\.ts$/;
+const HOOK_NAMES = ["useState", "useEffect", "useMemo", "useCallback", "useRef"];
+// Async-progress flag names. Deliberately NOT every boolean (sidebarVisible,
+// dialogOpen are legitimate UI state) — only the loading-machine flags that a
+// Resource<T>/QueryState union should own.
+const PROGRESS_FLAG = /^(is)?\w*([lL]oading|[pP]ending|[fF]etching|[sS]aving|[bB]usy|[rR]efreshing|[sS]canning|[eE]xporting|[iI]mporting|[sS]yncing|[sS]ubmitting|[pP]rocessing|[gG]enerating|[bB]uilding|[cC]onnecting)$/;
+/**
+ * Metrics describe the PROJECT — its tracked source — so gitignored files
+ * (generated code, local build output) are dropped. Without this the numbers
+ * depend on which machine ran them: a fresh CI checkout has no generated
+ * files, a dev tree does, and the p90s disagree (observed: p90ContextCost
+ * 20 locally vs 21 in CI on the same commit). The ast-grep-backed counters
+ * were already deterministic — ast-grep honors .gitignore natively.
+ */
+function dropGitignored(files) {
+    if (files.length === 0)
+        return files;
+    const res = spawnSync("git", ["check-ignore", "--stdin"], {
+        input: files.join("\n"),
+        encoding: "utf8",
+        maxBuffer: 64 * 1024 * 1024,
+    });
+    // Outside a repo (or git missing) there is no ignore standard to apply.
+    if (res.error || res.status === null || res.status > 1)
+        return files;
+    const ignored = new Set(res.stdout.split("\n").filter((l) => l !== ""));
+    return files.filter((f) => !ignored.has(f));
+}
+function parse(file, text) {
+    const kind = file.endsWith(".tsx") || file.endsWith(".jsx") ? ts.ScriptKind.TSX : ts.ScriptKind.TS;
+    return ts.createSourceFile(file, text, ts.ScriptTarget.Latest, true, kind);
+}
+function lineOf(sf, node) {
+    return sf.getLineAndCharacterOfPosition(node.getStart(sf)).line + 1;
+}
+function calleeName(node) {
+    if (ts.isIdentifier(node.expression))
+        return node.expression.text;
+    if (ts.isPropertyAccessExpression(node.expression))
+        return node.expression.name.text;
+    return undefined;
+}
+/** Unwrap `observer(fn)`, `memo(observer(fn))` … down to the function itself. */
+function componentFunction(node) {
+    if (ts.isFunctionDeclaration(node) || ts.isArrowFunction(node) || ts.isFunctionExpression(node)) {
+        return node;
+    }
+    if (ts.isCallExpression(node) && node.arguments.length > 0) {
+        const first = node.arguments[0];
+        if (first !== undefined)
+            return componentFunction(first);
+    }
+    return undefined;
+}
+function isObserverWrapped(node) {
+    if (!ts.isCallExpression(node))
+        return false;
+    if (calleeName(node) === "observer")
+        return true;
+    const first = node.arguments[0];
+    return first !== undefined && isObserverWrapped(first);
+}
+function propsCountOf(fn) {
+    const param = fn?.parameters[0];
+    if (param === undefined || !ts.isObjectBindingPattern(param.name))
+        return 0;
+    return param.name.elements.length;
+}
+function walkComponent(root) {
+    const hooks = { useState: 0, useEffect: 0, useMemo: 0, useCallback: 0, useRef: 0 };
+    const branching = {
+        match: 0,
+        exhaustive: 0,
+        otherwise: 0,
+        ternaryInJsx: 0,
+        andInJsx: 0,
+    };
+    let jsxMaxDepth = 0;
+    const visit = (node, jsxDepth, inJsxExpr) => {
+        let depth = jsxDepth;
+        let inExpr = inJsxExpr;
+        if (ts.isJsxElement(node) || ts.isJsxSelfClosingElement(node) || ts.isJsxFragment(node)) {
+            depth += 1;
+            if (depth > jsxMaxDepth)
+                jsxMaxDepth = depth;
+            inExpr = false;
+        }
+        else if (ts.isJsxExpression(node)) {
+            inExpr = true;
+        }
+        if (ts.isCallExpression(node)) {
+            const name = calleeName(node);
+            if (name !== undefined) {
+                for (const h of HOOK_NAMES) {
+                    if (name === h)
+                        hooks[h] += 1;
+                }
+                if (name === "match" && ts.isIdentifier(node.expression))
+                    branching.match += 1;
+                if (name === "exhaustive" && ts.isPropertyAccessExpression(node.expression)) {
+                    branching.exhaustive += 1;
+                }
+                if (name === "otherwise" && ts.isPropertyAccessExpression(node.expression)) {
+                    branching.otherwise += 1;
+                }
+            }
+        }
+        if (ts.isConditionalExpression(node) && inExpr)
+            branching.ternaryInJsx += 1;
+        if (ts.isBinaryExpression(node) &&
+            node.operatorToken.kind === ts.SyntaxKind.AmpersandAmpersandToken &&
+            inExpr) {
+            branching.andInJsx += 1;
+        }
+        node.forEachChild((child) => visit(child, depth, inExpr));
+    };
+    visit(root, 0, false);
+    return { hooks, branching, jsxMaxDepth };
+}
+/** Find the declaration node for a component-decl marker match (by name, then line). */
+function declNodeFor(sf, name, line) {
+    let byName;
+    let byLine;
+    const consider = (node, declName) => {
+        if (declName !== name)
+            return;
+        byName ??= node;
+        if (lineOf(sf, node) === line)
+            byLine ??= node;
+    };
+    for (const stmt of sf.statements) {
+        if (ts.isFunctionDeclaration(stmt))
+            consider(stmt, stmt.name?.text);
+        if (ts.isVariableStatement(stmt)) {
+            for (const d of stmt.declarationList.declarations) {
+                if (ts.isIdentifier(d.name))
+                    consider(d, d.name.text);
+            }
+        }
+    }
+    return byLine ?? byName;
+}
+function fileImportedIdentifiers(sf) {
+    let count = 0;
+    for (const stmt of sf.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        const clause = stmt.importClause;
+        if (clause === undefined)
+            continue;
+        if (clause.name !== undefined)
+            count += 1;
+        const bindings = clause.namedBindings;
+        if (bindings === undefined)
+            continue;
+        if (ts.isNamespaceImport(bindings))
+            count += 1;
+        else
+            count += bindings.elements.length;
+    }
+    return count;
+}
+function importLineSet(sf) {
+    const lines = new Set();
+    for (const stmt of sf.statements) {
+        if (!ts.isImportDeclaration(stmt))
+            continue;
+        const start = sf.getLineAndCharacterOfPosition(stmt.getStart(sf)).line;
+        const end = sf.getLineAndCharacterOfPosition(stmt.getEnd()).line;
+        for (let l = start; l <= end; l++)
+            lines.add(l + 1);
+    }
+    return lines;
+}
+// runInAction / async-method / new-Map counters moved to the canon rule ids
+// (store-no-runinaction, store-async-method, store-new-map) — see
+// collectMetrics. Only what no rule covers yet stays as a direct AST count.
+function collectStoreMetrics(sf, store) {
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const name = calleeName(node);
+            // No canon rule counts reactions yet — direct AST count until one lands.
+            if ((name === "reaction" || name === "autorun") && ts.isIdentifier(node.expression)) {
+                store.reactionsTotal += 1;
+            }
+        }
+        // A boolean-shaped async-progress DECLARATION (`loading: boolean`,
+        // `uploading = false`) — the §14 antipattern Resource<T>/QueryState
+        // replaces. Declarations, not write sites: the number of flags measures
+        // the state design; counting every `this.loading = …` would just scale
+        // with method count.
+        if ((ts.isPropertySignature(node) || ts.isPropertyDeclaration(node)) &&
+            ts.isIdentifier(node.name) &&
+            PROGRESS_FLAG.test(node.name.text) &&
+            (node.type?.kind === ts.SyntaxKind.BooleanKeyword ||
+                (ts.isPropertyDeclaration(node) &&
+                    node.type === undefined &&
+                    node.initializer !== undefined &&
+                    (node.initializer.kind === ts.SyntaxKind.TrueKeyword ||
+                        node.initializer.kind === ts.SyntaxKind.FalseKeyword)))) {
+            store.loadingBooleanShapes += 1;
+        }
+        node.forEachChild(visit);
+    };
+    visit(sf);
+}
+export function collectMetrics(targets) {
+    const allFiles = dropGitignored(collectFiles(targets, [".ts", ".tsx", ".jsx"]).filter((f) => !EXCLUDED_FILE.test(f)));
+    // Component spans come from the same ast-grep marker rule the structure
+    // check uses — one definition of "a component" across the whole toolkit.
+    const decls = scan(structureConfig, targets).filter((r) => r.ruleId === "component-decl" && !EXCLUDED_FILE.test(r.file));
+    const declsByFile = new Map();
+    for (const d of decls) {
+        const list = declsByFile.get(d.file) ?? [];
+        list.push(d);
+        declsByFile.set(d.file, list);
+    }
+    // One scan of the full rule canon feeds every rule-backed counter. The store
+    // counters use the canon rules' definition of "a store" (a class calling
+    // make(Auto)Observable) rather than a name or path heuristic — the metric
+    // counts exactly what verify gates.
+    const ruleRows = scan(rulesConfig, targets).filter((r) => !EXCLUDED_FILE.test(r.file));
+    const ruleCount = (...ids) => ruleRows.filter((r) => ids.includes(r.ruleId)).length;
+    const inlineMapRowCount = ruleCount("inline-map-row");
+    const components = [];
+    const files = [];
+    const store = {
+        runInActionCount: ruleCount("store-no-runinaction", "store-no-runinaction-tsx"),
+        asyncInStore: ruleCount("store-async-method", "store-async-method-tsx"),
+        newMapInStore: ruleCount("store-new-map", "store-new-map-tsx"),
+        reactionsTotal: 0,
+        loadingBooleanShapes: 0,
+    };
+    for (const file of allFiles) {
+        let text;
+        try {
+            text = readFileSync(file, "utf8");
+        }
+        catch {
+            continue;
+        }
+        const sf = parse(file, text);
+        const kinds = classifyLines(text);
+        const importLines = importLineSet(sf);
+        let fileSloc = 0;
+        kinds.forEach((k, i) => {
+            if (k === "code" && !importLines.has(i + 1))
+                fileSloc += 1;
+        });
+        collectStoreMetrics(sf, store);
+        const fileDecls = declsByFile.get(file) ?? [];
+        let filePropsTotal = 0;
+        for (const decl of fileDecls) {
+            const name = decl.metaText("N") ?? "?";
+            const node = declNodeFor(sf, name, decl.startLine);
+            if (node === undefined)
+                continue;
+            const target = ts.isVariableDeclaration(node) ? (node.initializer ?? node) : node;
+            const fn = componentFunction(target);
+            const props = propsCountOf(fn);
+            filePropsTotal += props;
+            const { hooks, branching, jsxMaxDepth } = walkComponent(target);
+            components.push({
+                file,
+                name,
+                line: decl.startLine,
+                componentLoc: codeLinesInRange(kinds, decl.startLine, decl.startLine + decl.spanLines - 1),
+                hooks,
+                propsCount: props,
+                observerWrapped: isObserverWrapped(target),
+                jsxMaxDepth,
+                branching,
+            });
+        }
+        const importedIdentifiers = fileImportedIdentifiers(sf);
+        files.push({
+            file,
+            fileSloc,
+            componentsPerFile: fileDecls.length,
+            importedIdentifiers,
+            contextCost: importedIdentifiers + filePropsTotal,
+        });
+    }
+    return { components, files, store, inlineMapRowCount };
+}
+//# sourceMappingURL=metricsCollect.js.map