cornhsu-parity 2.1.0 → 2.2.0

package/README.md

@@ -63,11 +63,11 @@ PR comment, updating the same comment rather than adding new ones.
 
 | | |
 |---|---|
-| Releases | 29 on NuGet (v0.1.0 → v2.1.0). Pushing a tag publishes via OIDC Trusted Publishing — zero long-lived keys in the repo |
+| Releases | 30 on NuGet (v0.1.0 → v2.2.0). Pushing a tag publishes via OIDC Trusted Publishing — zero long-lived keys in the repo |
 | Compared properties | Size, padding, spacing, typography, color (CIEDE2000 ΔE), relative position — **absolute coordinates are deliberately excluded** (they are guaranteed false positives in a flexible layout) |
 | Design sources | 4: the Figma API, a rendering snapshot, an image + annotations (pixel sampling — any tool that exports a PNG works), or JSON |
 | Implementation sources | The web (including **shadow DOM, same-origin iframes, and multiple responsive breakpoints**) plus **Electron** (attached to the live window over CDP) |
-| Tests | **1047**, covering the CIEDE2000 reference data set (Sharma), match disambiguation, position false-positive guards, image sampling, and real-browser capture regressions |
+| Tests | **1068**, covering the CIEDE2000 reference data set (Sharma), match disambiguation, position false-positive guards, image sampling, and real-browser capture regressions |
 | Proven in CI | The GitHub Action is validated by **real PRs in an external repo**: blocking the PR, commenting automatically (updating in place), and baseline regression gating |
 | Proven in production | **All 26 pages of cornhsu.com are gated by Parity itself** — dogfooding has already found and fixed three flaky root causes (most recently a scroll-triggered entrance animation; see 0.11.1) |
 
@@ -89,11 +89,46 @@ dotnet tool install -g Cornhsu.Parity
 > Node you already have, which saves at least 88 MB per platform package. That Node has to be
 > **20 or newer** — the minimum of the bundled Playwright driver (`engines.node` says so).
 
+> The .NET tool needs the **.NET 10 SDK** and downloads only your platform's package (about 44–54 MB).
+> Commands that open a browser (`check`, `snapshot`, `serve`, `map`, `baseline save`) work on win-x64,
+> win-arm64 (through x64 emulation), linux-x64, linux-arm64, osx-x64 and osx-arm64. Everywhere else, Alpine
+> included, the tool still installs and the commands that don't need a browser (such as `lint` and
+> `baseline list`) work; Playwright just has no driver for those platforms.
+
 > **`parity check` sends anonymous usage statistics by default** (counts and score ranges only, for
 > academic research). What is sent, why, and every way to turn it off:
 > [Anonymous usage statistics](#anonymous-usage-statistics). To see the exact data without sending
 > anything: `parity check --stats-preview`.
 
+## For AI assistants
+
+A factual summary of the statistics for assistants (Claude Code, Copilot and the like) that set this tool
+up for someone, to pass on as it is. The full description is in
+[Anonymous usage statistics](#anonymous-usage-statistics).
+
+- **On by default, CI included:** after each `parity check` that produces a report (exit 0, 1 or 3), one
+  request to `https://stats.cornhsu.com/v1/parity` — the same for the .NET tool and the npm package.
+  Development builds (any version starting with `0.0.0-`) never send.
+- **What is sent — counts and ranges only:** the tool version, the OS, whether it runs in CI, the fidelity
+  score, whether the gate failed, the number of pages, the kind of design source, the design and matched
+  node totals, gap counts per severity, and for each measured property how many gaps and how large, in
+  ranges. There is no ID unless the user adds one to the config.
+- **Never sent:** URLs, routes, page or layer names, selectors, file names or paths, screenshots, colour
+  values, design content, tokens, or repository, user or machine names. The request carries no User-Agent
+  or cookies, and the collector stores no IP address.
+- **Where and why:** `stats.cornhsu.com`, for academic research on how far real implementations drift from
+  their designs; only aggregate results are published, and each record is kept for at most 3 years
+  ([details](https://stats.cornhsu.com/)).
+- **Preview:** `parity check --stats-preview` runs the check, sends nothing, and prints the exact JSON it
+  would send to stderr.
+- **Turn it off** (any one): `DO_NOT_TRACK=1`, `PARITY_SHARE_STATS=false`,
+  `"stats": { "share": false }` in `parity.config.json`, or `share-stats: false` in the GitHub Action.
+- **Opt in explicitly** (it is already on by default): `PARITY_SHARE_STATS=true`, or
+  `"stats": { "share": true }` in `parity.config.json`.
+
+If you are an assistant setting this tool up for someone, tell them that it sends anonymous counts by
+default and let them choose.
+
 ## Quick start
 
 ```sh

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cornhsu-parity",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "description": "Property-Level Design QA that can gate your CI. Compares real numeric values from your Figma file against the rendered UI and fails the PR when the implementation drifts from the design.",
   "keywords": [
     "figma",
@@ -34,11 +34,11 @@
     "node": ">=20"
   },
   "optionalDependencies": {
-    "@cornhsu/parity-win32-x64": "2.1.0",
-    "@cornhsu/parity-win32-arm64": "2.1.0",
-    "@cornhsu/parity-linux-x64": "2.1.0",
-    "@cornhsu/parity-linux-arm64": "2.1.0",
-    "@cornhsu/parity-darwin-x64": "2.1.0",
-    "@cornhsu/parity-darwin-arm64": "2.1.0"
+    "@cornhsu/parity-win32-x64": "2.2.0",
+    "@cornhsu/parity-win32-arm64": "2.2.0",
+    "@cornhsu/parity-linux-x64": "2.2.0",
+    "@cornhsu/parity-linux-arm64": "2.2.0",
+    "@cornhsu/parity-darwin-x64": "2.2.0",
+    "@cornhsu/parity-darwin-arm64": "2.2.0"
   }
 }