supercov 0.0.9 → 0.0.12

package/README.md

@@ -18,26 +18,30 @@ npm link
 
 ## Verifying the instrumenter
 
-The coverage engine has seven independent release gates:
-
-- semantic differential fixtures execute original and instrumented programs
-  in isolated scopes and compare return values, thrown errors, and observable
-  side-effect order;
-- a deterministic generated corpus exercises 160 nested combinations of
-  short-circuiting, ternaries, coercion, and thrown expressions on every run;
-- seeded `fast-check` properties exercise another 500 generated nested
-  expressions and 300 generated control-flow executions, with shrinking and a
-  reproducible seed on failure;
-- coverage oracles assert exact decision vectors, MC/DC witnesses, and branch
+Supercov has one coverage engine, implemented in Rust. JavaScript files under
+`runtime/javascript/` are target-runtime shims for Node, browsers and test
+runners; they do not contain a second analyzer or instrumenter.
+
+The coverage engine has independent correctness gates:
+
+- Rust unit and golden tests cover transformation semantics, complete
+  obligation manifests, evidence validation, attribution, MC/DC witnesses,
+  storage, lifecycle recovery and agent JSON contracts;
+- syntax and behavior matrices execute original and instrumented modern
+  JavaScript, JSX, TypeScript and TSX under Node, Chromium, Firefox and WebKit;
+- coverage oracles assert exact decision vectors, MC/DC witnesses and branch
   alternatives independently of program behavior;
 - the same three-condition masking-MC/DC golden cases must report 100% for a
   complete witness set and 33.33% for an incomplete one under both Supercov
   and Clang/LLVM source-based MC/DC;
-- release CI shards the pinned TC39 Test262 corpus across 16 workers, runs the
-  official Test262 harness on original and instrumented sources, and rejects
-  any scenario that passes originally but fails after transformation; and
-- checked performance budgets cover transform latency, transactional workspace
-  preparation, output expansion, and runtime probe overhead.
+- the pinned TC39 Test262 corpus runs through the official harness before and
+  after instrumentation and rejects any originally passing scenario that
+  changes behavior;
+- black-box fixtures exercise node:test, Vitest, Playwright, opaque remote
+  execution, Vite, Next, Webpack, esbuild, SWC and TypeScript compilation; and
+- checked performance and filesystem gates cover transform latency,
+  transactional workspace preparation, output expansion, signal handling,
+  crash recovery and runtime probe overhead.
 
 ```sh
 npm test
@@ -62,7 +66,7 @@ default with `TEST262_DIR=/path/to/test262` or `--test262 <path>`.
 The differential suite includes getters, proxies, optional calls and `this`,
 computed logical assignments, defaults, `try`/`catch`/`finally`, iterator
 closing, switch fallthrough, labeled loops, async functions, and generators.
-The compatibility workflow additionally runs Node 22/24/25, Playwright
+The manually dispatched compatibility workflow additionally runs Node 22/24/25, Playwright
 1.55/current, Vite 5/current, Vitest 2/current, Chromium, Firefox, WebKit, and
 modern JavaScript/JSX/TypeScript/TSX syntax fixtures. Filesystem publication,
 symlink, copy fallback, ENOSPC, failed rename, and forced-termination recovery
@@ -191,7 +195,7 @@ producing a plausible but invalid aggregate.
 For a JavaScript or TypeScript project, the CLI:
 
 1. refreshes a stable isolated source namespace under
-   `.supercov/cache/instrumented-workspace/<project>/`, links the existing
+   `supercov/workspace/<project>/`, links the existing
    dependency tree, and creates generated runner configuration and build output
    only there; file data uses copy-on-write reflinks where the filesystem
    supports them, and falls back to copying where it does not; the stable path
@@ -210,7 +214,7 @@ For a JavaScript or TypeScript project, the CLI:
    and CommonJS projects use the same disposable direct path;
 4. runs the exact command following `--`, propagating coverage through every
    Node child process it launches. Generated adapters provide exact test,
-   worker, retry, and outcome scopes for Playwright, Vitest, Jest, and
+   worker, retry, and outcome scopes for Playwright, Vitest, and
    `node:test` without changing test imports or configs;
 5. attributes source hits and decision vectors to individual tests where an
    exact adapter is active,
@@ -223,8 +227,10 @@ For a JavaScript or TypeScript project, the CLI:
    ordinary application build is never read as an input, overwritten, or
    rebuilt afterward.
 
-Only `.supercov/` is modified in the user's checkout. A per-project lock
-rejects overlapping runs before either can build. Run state is durably written
+Only the Supercov-owned `.supercov/` run store and marker-protected
+`supercov/workspace/` cache are modified in the user's checkout. A user-created
+`supercov/` directory without Supercov's ownership marker is never treated as
+storage. A per-project lock rejects overlapping runs before either can build. Run state is durably written
 through preparing/building/testing/publishing phases; SIGINT, SIGTERM,
 and SIGHUP are forwarded to the entire child process group. If the process is
 killed without a cleanup opportunity, the next invocation marks the dead PID's
@@ -268,8 +274,7 @@ strategy trade-offs, and a measured real-suite reference.
 
 The automatic exact-attribution adapters support standard Playwright suites
 (ESM and CommonJS specs in arbitrary project directories), project-owned
-Playwright fixture packages, Vitest, Jest—including concurrent and
-parameterized tests—and `node:test`. A single command can collect several
+Playwright fixture packages, Vitest and `node:test`. A single command can collect several
 runners into one run. Unsupported runners such as AVA or Mocha still receive
 aggregate first-party structural coverage through inherited process
 instrumentation, but their hits remain background/unattributed rather than

package/bin/native.js

@@ -0,0 +1,87 @@
+import { existsSync, readFileSync, statSync } from "node:fs";
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const root = fileURLToPath(new URL("..", import.meta.url));
+const mainPackage = JSON.parse(
+  readFileSync(new URL("../package.json", import.meta.url), "utf8"),
+);
+
+const packages = new Map([
+  ["darwin-arm64", ["@supercov/cli-darwin-arm64", "supercov"]],
+  ["darwin-x64", ["@supercov/cli-darwin-x64", "supercov"]],
+  ["linux-arm64-gnu", ["@supercov/cli-linux-arm64-gnu", "supercov"]],
+  ["linux-x64-gnu", ["@supercov/cli-linux-x64-gnu", "supercov"]],
+  ["linux-arm64-musl", ["@supercov/cli-linux-arm64-musl", "supercov"]],
+  ["linux-x64-musl", ["@supercov/cli-linux-x64-musl", "supercov"]],
+  ["win32-arm64", ["@supercov/cli-win32-arm64", "supercov.exe"]],
+  ["win32-x64", ["@supercov/cli-win32-x64", "supercov.exe"]],
+]);
+
+function linuxLibc() {
+  const report = process.report?.getReport?.();
+  return report?.header?.glibcVersionRuntime ? "gnu" : "musl";
+}
+
+export function nativePackageFor(
+  platform = process.platform,
+  arch = process.arch,
+  libc = platform === "linux" ? linuxLibc() : undefined,
+) {
+  const key = [platform, arch, ...(libc ? [libc] : [])].join("-");
+  const selected = packages.get(key);
+  if (!selected) {
+    throw new Error(
+      `no native Supercov binary is published for platform=${platform} arch=${arch}${libc ? ` libc=${libc}` : ""}`,
+    );
+  }
+  return { packageName: selected[0], executable: selected[1] };
+}
+
+function checkedExecutable(path, source) {
+  if (!existsSync(path) || !statSync(path).isFile()) {
+    throw new Error(`${source} does not contain a regular Supercov executable at ${path}`);
+  }
+  return path;
+}
+
+export function resolveNativeBinary({ allowLocalDevelopment = true } = {}) {
+  if (process.env.SUPERCOV_RUST_BINARY) {
+    const override = resolve(process.env.SUPERCOV_RUST_BINARY);
+    return checkedExecutable(override, "SUPERCOV_RUST_BINARY");
+  }
+
+  const { packageName, executable } = nativePackageFor();
+  try {
+    const packagePath = require.resolve(`${packageName}/package.json`);
+    const platformPackage = JSON.parse(readFileSync(packagePath, "utf8"));
+    if (platformPackage.name !== packageName) {
+      throw new Error(
+        `resolved ${packageName} but its manifest declares ${String(platformPackage.name)}`,
+      );
+    }
+    if (platformPackage.version !== mainPackage.version) {
+      throw new Error(
+        `native package version mismatch: supercov is ${mainPackage.version} but ${packageName} is ${String(platformPackage.version)}`,
+      );
+    }
+    return checkedExecutable(
+      resolve(dirname(packagePath), "bin", executable),
+      packageName,
+    );
+  } catch (error) {
+    if (!(error && typeof error === "object" && "code" in error && error.code === "MODULE_NOT_FOUND")) {
+      throw error;
+    }
+  }
+
+  const local = resolve(root, "target", "debug", executable);
+  if (allowLocalDevelopment && existsSync(resolve(root, "Cargo.toml")) && existsSync(local)) {
+    return checkedExecutable(local, "local Rust development build");
+  }
+  throw new Error(
+    `the optional native package ${packageName}@${mainPackage.version} is missing; reinstall supercov with optional dependencies enabled`,
+  );
+}

package/bin/supercov.js

@@ -1,12 +1,18 @@
 #!/usr/bin/env node
 
 import { spawn } from "node:child_process";
-import { fileURLToPath } from "node:url";
+import { resolveNativeBinary } from "./native.js";
 
-const cli = fileURLToPath(new URL("../dist/cli.js", import.meta.url));
+let rustBinary;
+try {
+  rustBinary = resolveNativeBinary();
+} catch (error) {
+  console.error(`[supercov] ${error instanceof Error ? error.message : String(error)}`);
+  process.exit(1);
+}
 const child = spawn(
-  process.execPath,
-  [cli, ...process.argv.slice(2)],
+  rustBinary,
+  process.argv.slice(2),
   {
     stdio: "inherit",
     env: process.env,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "supercov",
-  "version": "0.0.9",
+  "version": "0.0.12",
   "description": "Zero-edit, runner-aware coverage completeness for JavaScript test suites",
   "license": "MIT",
   "repository": {
@@ -14,7 +14,7 @@
   "type": "module",
   "files": [
     "bin",
-    "dist",
+    "runtime/javascript",
     "docs",
     "README.md"
   ],
@@ -28,32 +28,47 @@
     "access": "public"
   },
   "exports": {
-    "./playwright": "./dist/playwright.js",
-    "./register": "./dist/register.mjs",
-    "./vite": "./dist/vitePlugin.js",
-    "./vitest": "./dist/vitest.js"
+    "./playwright": "./runtime/javascript/playwright.js",
+    "./register": "./runtime/javascript/register.mjs",
+    "./vitest": "./runtime/javascript/vitest.js"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && node scripts/build-runtime.mjs",
-    "test": "node --test --test-concurrency=4 tests/unit/*.test.ts",
-    "test:types": "tsc --noEmit",
-    "test:fixture": "npm run build && npm --prefix tests/fixtures/generic-playwright run test:coverage && node scripts/opaque-runner-integration.mjs && node scripts/opaque-esm-integration.mjs && node scripts/node-test-integration.mjs && node scripts/jest-integration.mjs && node scripts/generic-build-integration.mjs && node scripts/next-integration.mjs && node scripts/distributed-merge-integration.mjs && node scripts/agent-query-eval.mjs",
-    "test:packed-npx": "node scripts/packed-npx-integration.mjs",
-    "test:isolation": "npm run build && node scripts/isolation-integration.mjs",
-    "test:filesystem": "npm run build && node --test --test-concurrency=1 tests/unit/atomic.test.ts tests/unit/evidenceArchive.test.ts tests/unit/workspace.test.ts && node scripts/workspace-crash-integration.mjs",
+    "build": "cargo build -p supercov",
+    "sync:rust-assets": "node scripts/sync-rust-package-assets.mjs",
+    "test:rust-assets": "node scripts/sync-rust-package-assets.mjs --check",
+    "test": "cargo test --workspace",
+    "test:runtime": "node --test tests/runtime/*.test.mjs",
+    "test:fixture": "cargo build -p supercov && node scripts/rust-fixture-matrix.mjs",
+    "test:packed-npx": "cargo build --release -p supercov && node scripts/packed-npx-integration.mjs",
+    "test:isolation": "cargo build -p supercov && node scripts/isolation-integration.mjs",
+    "test:filesystem": "cargo test --workspace && cargo build -p supercov && node scripts/workspace-crash-integration.mjs",
+    "test:watchdog": "cargo build -p supercov && node scripts/watchdog-integration.mjs",
+    "test:engine-contract": "cargo build -p supercov && node scripts/engine-contract.mjs",
+    "test:agent": "cargo build -p supercov && node scripts/agent-query-eval.mjs",
+    "test:engine": "cargo fmt --all -- --check && cargo clippy --workspace --all-targets -- -D warnings && cargo test --workspace && cargo build -p supercov && npm run test:runtime && npm run test:rust-assets && node scripts/rust-process-supervision.mjs && node scripts/rust-direct-node-integration.mjs && node scripts/rust-public-run-integration.mjs && node scripts/rust-embedded-runtime-integration.mjs && node scripts/rust-direct-vitest-integration.mjs && node scripts/rust-direct-playwright-integration.mjs && node scripts/rust-generic-esbuild-integration.mjs && node scripts/rust-generic-tsc-integration.mjs && node scripts/rust-generic-build-matrix.mjs && node scripts/rust-vite-playwright-integration.mjs",
+    "test:platform": "cargo test --workspace && cargo build -p supercov && node scripts/rust-process-supervision.mjs && node scripts/workspace-crash-integration.mjs",
+    "test:native-package": "cargo build --release -p supercov && node scripts/native-package-integration.mjs && node scripts/native-release-set-integration.mjs",
+    "test:pypi-wheel": "node scripts/pypi-wheel-integration.mjs",
+    "test:pypi-registry": "node scripts/pypi-registry-integration.mjs",
+    "build:rubygem": "cargo build --release -p supercov && node scripts/build-rubygem.mjs",
+    "test:rubygem": "node scripts/rubygem-integration.mjs",
+    "test:rubygem-registry": "node scripts/rubygem-registry-integration.mjs",
+    "test:syntax": "cargo build -p supercov && node scripts/rust-syntax-matrix.mjs",
     "test:clang-mcdc": "node scripts/clang-mcdc-oracle.mjs",
-    "test:test262": "npm run build && node scripts/test262-equivalence.mjs",
-    "benchmark:check": "npm run build && node scripts/benchmark.mjs",
-    "check": "npm run test && npm run test:types",
-    "release:check": "npm run check && npm run build && node scripts/isolation-integration.mjs && npm run test:packed-npx && npm run test:clang-mcdc && node scripts/benchmark.mjs",
-    "prepack": "npm run build",
+    "test:test262": "cargo build --release -p supercov && node scripts/test262-equivalence.mjs",
+    "benchmark:check": "cargo build --release -p supercov && node scripts/rust-transform-benchmark.mjs",
+    "check": "cargo fmt --all -- --check && cargo clippy --workspace --all-targets -- -D warnings && npm run test && npm run test:runtime && npm run test:rust-assets && node scripts/package-preflight.mjs",
+    "release:check": "npm run check && npm run test:engine && npm run test:fixture && npm run test:watchdog && npm run test:engine-contract && npm run test:agent && npm run test:packed-npx && npm run test:clang-mcdc && npm run benchmark:check",
+    "prepack": "node scripts/package-preflight.mjs",
     "prepublishOnly": "npm run release:check"
   },
-  "dependencies": {
-    "@babel/generator": "^8.0.0",
-    "@babel/parser": "^8.0.4",
-    "@babel/traverse": "^8.0.4",
-    "@babel/types": "^8.0.4"
+  "optionalDependencies": {
+    "@supercov/cli-darwin-arm64": "0.0.12",
+    "@supercov/cli-darwin-x64": "0.0.12",
+    "@supercov/cli-linux-arm64-gnu": "0.0.12",
+    "@supercov/cli-linux-arm64-musl": "0.0.12",
+    "@supercov/cli-linux-x64-gnu": "0.0.12",
+    "@supercov/cli-linux-x64-musl": "0.0.12"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.55.0",
@@ -76,8 +91,7 @@
     "@swc/core": "^1.16.1",
     "@types/node": "^24.0.0",
     "esbuild": "^0.28.2",
-    "fast-check": "^4.9.0",
-    "jest": "^30.4.2",
+    "expect": "30.4.1",
     "next": "^16.3.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",

package/{dist → runtime/javascript}/atomic.js

@@ -44,4 +44,3 @@ export function atomicRenameSync(source, destination) {
     renameSync(source, destination);
     fsyncDirectory(dirname(destination));
 }
-//# sourceMappingURL=atomic.js.map

package/{dist → runtime/javascript}/launchSupervisor.js

@@ -465,6 +465,9 @@ function injectChildEnvironment(method, args) {
     const existingEnvironment = options.env && typeof options.env === "object"
         ? options.env
         : undefined;
+    if (existingEnvironment?.["SUPERCOV_INTERNAL_ENGINE"] === "1" ||
+        existingEnvironment?.["SUPERCOV_INTERNAL_INSTRUMENTER"] === "1")
+        return args;
     const environment = existingEnvironment
         ? { ...existingEnvironment, ...inherited }
         : { ...process.env, ...inherited };
@@ -519,4 +522,3 @@ export function installLaunchSupervisor() {
         entrypoint: process.argv[1],
     });
 }
-//# sourceMappingURL=launchSupervisor.js.map

package/{dist → runtime/javascript}/nodeAssert.js

@@ -27,4 +27,3 @@ export const rejects = adapter.rejects;
 export const strict = strictAdapter;
 export const strictEqual = adapter.strictEqual;
 export const throws = adapter.throws;
-//# sourceMappingURL=nodeAssert.js.map

package/{dist → runtime/javascript}/nodeAssertAdapter.js

@@ -91,4 +91,3 @@ export function setStrictAssertAdapter(adapter, strict) {
         writable: true,
     });
 }
-//# sourceMappingURL=nodeAssertAdapter.js.map

package/{dist → runtime/javascript}/nodeAssertStrict.js

@@ -25,4 +25,3 @@ export const rejects = adapter.rejects;
 export const strict = adapter;
 export const strictEqual = adapter.strictEqual;
 export const throws = adapter.throws;
-//# sourceMappingURL=nodeAssertStrict.js.map

package/{dist → runtime/javascript}/nodeTest.js

@@ -25,6 +25,12 @@ function wrappedRegistration(original) {
             runner: "node:test",
             name: testName(args, callback),
             ...location,
+            // Source-map producers disagree about whether a call expression maps to
+            // its first token or the first token on its source line. The line and
+            // dynamic test name are stable across ahead-of-run and build-tool
+            // transforms; the mapped column is not. Canonicalize it so the same test
+            // keeps one identity when esbuild, Babel, SWC, or TypeScript rewrites it.
+            ...(location.line === undefined ? {} : { column: 1 }),
         };
         const scope = runnerExecutionScope(identity);
         const options = testOptions(args, index);
@@ -39,8 +45,11 @@ function wrappedRegistration(original) {
                 ? "skipped"
                 : "passed";
             const contextProxy = new Proxy(context, {
-                get(target, property, receiver) {
-                    const value = Reflect.get(target, property, receiver);
+                get(target, property) {
+                    // Read with the real context as receiver: TestContext accessors
+                    // (t.assert, t.mock, ...) touch private fields that only exist on
+                    // the target, never on the proxy.
+                    const value = Reflect.get(target, property, target);
                     if ((property === "skip" || property === "todo") && typeof value === "function") {
                         return (...callArgs) => {
                             status = "skipped";
@@ -57,8 +66,8 @@ function wrappedRegistration(original) {
                 if (emitted)
                     return;
                 emitted = true;
-                flushBufferedServerEvidence(scope);
-                writeRunnerEvidence(identity, nextStatus, scope, evidenceDirectory, takeNodeAssertionPhases(scope));
+                const flushedServerEvidence = flushBufferedServerEvidence(scope);
+                writeRunnerEvidence(identity, nextStatus, scope, evidenceDirectory, takeNodeAssertionPhases(scope), flushedServerEvidence);
             };
             try {
                 if (callback.length >= 2) {
@@ -124,4 +133,3 @@ export const snapshot = native.snapshot;
 export const run = native.run;
 export const assert = native.assert;
 export default test;
-//# sourceMappingURL=nodeTest.js.map