styleproof 3.12.0 → 3.13.0

package/CHANGELOG.md

@@ -7,6 +7,18 @@ this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## [Unreleased]
 
+## [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.13.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",