fix(verify): rewrite counted baselines only when a count was lowered (#10669)

* fix(verify): rewrite counted baselines only when a count was lowered

* test(verify): own the baseline write decision in a tested helper

scripts/verify/architecture-guards.mjs

@@ -3,7 +3,10 @@ import { existsSync } from "node:fs";
 import { readFile, readdir, writeFile } from "node:fs/promises";
 import { join, relative, sep } from "node:path";
 import { fileURLToPath } from "node:url";
-import { compareCountedBaseline } from "./counted-baseline.mjs";
+import {
+  compareCountedBaseline,
+  recordLoweredBaseline,
+} from "./counted-baseline.mjs";
 
 // Architecture guards for the strict-identity / best-effort-inference split.
 // - Composite dedup keys must not NUL-join variable-length or free-form
@@ -205,10 +208,7 @@ const checkCounted = (label, key, selected, pattern, owners) => {
     failures.push(
       `${label}; new copies are not allowed:\n${lines(compared.grown)}`,
     );
-  if (compared.baseline !== (baselines[key] ?? {})) {
-    baselines[key] = compared.baseline;
-    baselinesShrunk = true;
-  }
+  if (recordLoweredBaseline(baselines, key, compared)) baselinesShrunk = true;
   if (compared.stale.length > 0)
     failures.push(
       `${label}; copies were removed, so lower the baseline with \`node scripts/verify/architecture-guards.mjs --shrink-baselines\`:\n${lines(compared.stale)}`,

scripts/verify/counted-baseline.d.mts

@@ -14,4 +14,16 @@ export function compareCountedBaseline(
   readonly grown: CountedBaselineDifference[];
   readonly stale: CountedBaselineDifference[];
   readonly baseline: Record<string, number>;
+  /** True only when `shrink` lowered or removed a recorded count. */
+  readonly lowered: boolean;
 };
+
+/** Record a lowered baseline under `key`; true when the map changed. */
+export function recordLoweredBaseline(
+  baselines: Record<string, Record<string, number>>,
+  key: string,
+  compared: {
+    readonly baseline: Record<string, number>;
+    readonly lowered: boolean;
+  },
+): boolean;

scripts/verify/counted-baseline.mjs

@@ -2,7 +2,8 @@
  * Compare observed per-file counts with a counted baseline. A file may not
  * exceed its recorded count. A count below the baseline is stale; with
  * `shrink`, the returned baseline lowers it (and drops zero entries) but never
- * raises any count.
+ * raises any count; `lowered` says whether it did, so callers rewrite a
+ * baseline only when it changed.
  */
 export const compareCountedBaseline = (counts, baseline, shrink) => {
   const grown = [];
@@ -15,10 +16,23 @@ export const compareCountedBaseline = (counts, baseline, shrink) => {
     const count = counts.get(path) ?? 0;
     if (count < allowed) stale.push({ path, count, allowed });
   }
-  if (!shrink || stale.length === 0) return { grown, stale, baseline };
-  const lowered = { ...baseline };
+  if (!shrink || stale.length === 0)
+    return { grown, stale, baseline, lowered: false };
+  const shrunk = { ...baseline };
   for (const { path, count } of stale)
-    if (count === 0) delete lowered[path];
-    else lowered[path] = count;
-  return { grown, stale: [], baseline: lowered };
+    if (count === 0) delete shrunk[path];
+    else shrunk[path] = count;
+  return { grown, stale: [], baseline: shrunk, lowered: true };
+};
+
+/**
+ * Record a comparison's lowered baseline under `key` in the full baseline
+ * map. Returns whether the map changed, so the caller rewrites the file only
+ * then. A key whose last count was removed is deleted rather than kept empty.
+ */
+export const recordLoweredBaseline = (baselines, key, compared) => {
+  if (!compared.lowered) return false;
+  if (Object.keys(compared.baseline).length === 0) delete baselines[key];
+  else baselines[key] = compared.baseline;
+  return true;
 };