supercov 3.0.2 → 3.0.4

package/docs/assertions.md

@@ -101,7 +101,7 @@ npx supercov runs latest assertions --test "closes the stream"  # what one test
 ```text
 Run run_4f2a: 93.8% asserted (2731 of 2913 executed statements)
 
-Files, most statements not asserted first: a statement is not asserted when none of the tests asked about it was judged to fail if it changed. Up to 15 of the tests that run a statement are asked, so a test never asked can still catch it.
+Files, most statements not asserted first: a statement is not asserted when none of the tests asked about it was judged to fail if it changed. Up to 18 of the tests that run a statement are asked, so a test never asked can still catch it.
  NOT ASSERTED  ASSERTED  FILE
            41   388/429  src/adapters.ts
            ...
@@ -120,7 +120,11 @@ nothing the asked tests assert depends on what the statement does. Five of the
 tests that run a statement are asked first, and up to 15 when none of those
 catches it: tests whose file quotes text the statement writes (a log line, a
 message), then tests named like the source file, then one per test file and
-describe block. A statement many tests run can still be caught by one that was
+describe block. When none of the 15 catches it, up to three more are asked, the
+ones most likely written for the statement: tests whose name shares words with
+the statement's line (`corsOrigin: a false value` for
+`return corsOrigin(origin)`), and among those the tests that ran the least
+other code. A statement many tests run can still be caught by one that was
 never asked; the statement view (`assertions <file>:<line>`) says how many were.
 
 ## Which tests check a change

package/docs/cli.md

@@ -63,8 +63,9 @@ is known about it. `--all` includes test files, generated output and anything
 outside a source root, all of which are left out by default. `--dry-run` prints
 the exact requests and contacts nothing.
 
-`quality diff` reports what declined between two assessments: which files lost
-health, which properties appeared, and which files entered or left the scope.
+`quality diff` reports what changed between two assessments: which files lost
+or gained health, each check that moved in them with its value before and after,
+and which files entered or left the scope.
 
 Assessing needs a TypeSafe AI API key in `TYPESAFE_API_KEY`; reading a saved
 assessment does not. `TYPESAFE_BASE_URL` and `TYPESAFE_DEFAULT_MODEL` use Jev

package/docs/quality.md

@@ -170,8 +170,11 @@ npx supercov quality snapshots
 npx supercov quality diff <older> <newer>
 ```
 
-Which files lost health, which gained, which properties appeared, and which
-files entered or left the scope. A file whose contents did not change is marked,
+Which files lost health and which gained, each check that fired in either
+snapshot with its value before and after (`long_method 0.93 → 0.41, no longer
+present`), and which files entered or left the scope, with what fired on the new
+ones. A refactor that extracts code shows up as an added file, and a check still
+present at a lower value shows that the change moved it. A file whose contents did not change is marked,
 so a small movement does not send you looking for an edit that was never made.
 
 ## What it costs
@@ -223,7 +226,7 @@ npx supercov quality gaps                        # only files something fired on
 npx supercov quality file src/server.ts          # one file, every check
 npx supercov quality scope                       # which files, and why
 npx supercov quality snapshots                   # saved assessments
-npx supercov quality diff <older> <newer>        # what declined
+npx supercov quality diff <older> <newer>        # what changed
 npx supercov quality patch                       # what a change introduced
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supercov",
-  "version": "3.0.2",
+  "version": "3.0.4",
   "description": "Coverage, security and code quality for coding agents",
   "keywords": [
     "coverage",
@@ -118,14 +118,14 @@
     "test:windows-tls": "node scripts/windows-tls-test.mjs"
   },
   "optionalDependencies": {
-    "@supercov/cli-darwin-arm64": "3.0.2",
-    "@supercov/cli-darwin-x64": "3.0.2",
-    "@supercov/cli-linux-arm64-gnu": "3.0.2",
-    "@supercov/cli-linux-arm64-musl": "3.0.2",
-    "@supercov/cli-linux-x64-gnu": "3.0.2",
-    "@supercov/cli-linux-x64-musl": "3.0.2",
-    "@supercov/cli-win32-arm64": "3.0.2",
-    "@supercov/cli-win32-x64": "3.0.2"
+    "@supercov/cli-darwin-arm64": "3.0.4",
+    "@supercov/cli-darwin-x64": "3.0.4",
+    "@supercov/cli-linux-arm64-gnu": "3.0.4",
+    "@supercov/cli-linux-arm64-musl": "3.0.4",
+    "@supercov/cli-linux-x64-gnu": "3.0.4",
+    "@supercov/cli-linux-x64-musl": "3.0.4",
+    "@supercov/cli-win32-arm64": "3.0.4",
+    "@supercov/cli-win32-x64": "3.0.4"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.55.0",