styleproof 3.12.0 → 3.14.0

package/CHANGELOG.md

@@ -7,6 +7,33 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [3.14.0] - 2026-07-05
+
+### Added
+
+- **The GitHub Action hard-gates on unacknowledged navigable removals, out of the box.**
+  A removed route / tab / menu-item — a feature going unreachable — is categorically not a
+  restyle, so it must not be waved through by the review-gate's "approve all changes" box.
+  The Action now reads the diff's machine-readable inventory verdict (3.13.0) and, as a
+  final step in **both** certify and review-gate modes, fails when
+  `inventory.unacknowledged > 0`, naming each removed affordance — unless the removal is
+  recorded (with a reason) in `styleproof.inventory.json`. Style diffs are unaffected
+  (they stay report-only / sign-off). On by default; set `"gateInventoryRemovals": false`
+  in `styleproof.config.json` to opt out. Covered by a new `action-dogfood` removal
+  scenario (base offers `/a` + `/b`, head drops `/b` → the Action fails).
+
+## [3.13.0] - 2026-07-05
+
+### Added
+
+- **`styleproof-diff --json` now carries the inventory verdict.** The structured output
+  gained an `inventory` field alongside `coverage` and `determinism` — so all three
+  source-of-truth axes are machine-readable, matching the report's certification block.
+  Shape: `{ removed, added, unacknowledged, staleAcknowledgements }` (arrays of keys),
+  or `null` when no capture carried inventory. Previously the inventory removals were
+  printed to stdout but absent from `--json`, forcing a CI that wanted to hard-gate on a
+  dropped nav item to grep human prose. Now it can read `inventory.unacknowledged.length`.
+
 ## [3.12.0] - 2026-07-05
 
 ### Changed

package/bin/styleproof-diff.mjs

@@ -306,7 +306,26 @@ const determinismFails = printDeterminismVerdict(determinismVerdict);
 if (jsonOut)
   fs.writeFileSync(
     jsonOut,
-    JSON.stringify({ counts, surfaces, compared, coverage: coverageVerdict, determinism: determinismVerdict }, null, 2),
+    JSON.stringify(
+      {
+        counts,
+        surfaces,
+        compared,
+        coverage: coverageVerdict,
+        determinism: determinismVerdict,
+        // The inventory verdict, machine-readable — parallel to coverage/determinism and
+        // to the report's certification block. `null` when no capture carried inventory.
+        // `unacknowledged` is the gating set: a CI can hard-fail on `unacknowledged.length`.
+        inventory: inventoryAudit && {
+          removed: inventoryAudit.delta.removed.map((i) => i.key),
+          added: inventoryAudit.delta.added.map((i) => i.key),
+          unacknowledged: inventoryAudit.unexplained.map((i) => i.key),
+          staleAcknowledgements: inventoryAudit.staleAllowances,
+        },
+      },
+      null,
+      2,
+    ),
   );
 
 const total = counts.dom + counts.style + counts.state;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "styleproof",
-  "version": "3.12.0",
+  "version": "3.14.0",
   "description": "Catch every CSS change before it ships — review PRs and certify refactors by the browser's computed styles, not pixels. Works with any styling system.",
   "keywords": [
     "playwright",