supercov 0.0.43 → 0.0.45

package/docs/getting-started.md

@@ -1,68 +1,50 @@
 # Getting started
 
-Supercov turns the test suite you already have into a list of useful tests to
-write next. Run the suite once, inspect a coverage gap, add a focused test, and
-compare the result.
+Open your project in a coding agent that can run terminal commands, then paste
+this prompt:
 
-```sh
-npx supercov -- npm test
+```text supercov-prompt
+Measure code coverage with npx supercov and write one missing test.
+Only change tests. Rerun the full test suite and show me the test you
+added and the before-and-after coverage.
 ```
 
-No account, config file, import, custom reporter, or hosted service is required.
-Supercov supports JavaScript, TypeScript, Rust, Python, and Ruby today.
+Your agent can install Supercov if needed. It runs the commands and edits the
+tests; you don't need to do those steps yourself.
 
-## Before you start
+When it finishes, review the test change and coverage comparison in your
+conversation. Ask separately if you want a commit or pull request.
 
-You need:
+No account, config file, import, custom reporter, or hosted service is required.
+Supercov supports JavaScript, TypeScript, Rust, Python, and Ruby today.
 
-- macOS (arm64 or x64), Linux (arm64 or x64, glibc 2.28 or newer or musl), or
-  Windows (arm64 or x64);
-- Node.js 22 or newer;
-- a test command that already works in the repository; and
-- for Rust, the Rust 1.95 toolchain;
-- for Python, CPython 3.12 or newer with pytest or unittest;
-- for Ruby, Ruby 3.4 or newer with RSpec, Minitest, test-unit or Cucumber (3.3 measures lines, methods and simple branches only).
+## What the agent does
 
-The CLI is a native binary. `npx supercov` picks the build for your operating
-system and architecture, and nothing is compiled on install; the same binary is
-on PyPI as `supercov-cli` (`uvx --from supercov-cli supercov`) and on RubyGems
-as `supercov` (`gem install supercov`), at the same version, and the source is
-on crates.io (`cargo install supercov`). The first invocation may download
-Supercov from the registry. Supercov itself does not upload your source or
-coverage evidence to a Supercov service.
+The commands below show how the agent measures coverage and checks its work.
+You can also run them yourself if you prefer using the terminal.
 
-## 1. Run your real test command
+### 1. Run your real test command
 
-Everything after `--` is the command Supercov measures. Start with the same
-complete command you trust before merging or deploying:
+The agent runs your repository's complete test suite through Supercov:
 
-```sh
-# JavaScript or TypeScript
+```sh supercov-example
 npx supercov -- npm test
-npx supercov -- npx playwright test
-npx supercov -- pnpm test:e2e
-
-# Rust
-npx supercov -- cargo test
-npx supercov -- cargo nextest run
-
-# Python
-npx supercov -- pytest
-
-# Ruby
-npx supercov -- rspec
 ```
 
+Everything after `--` is the command Supercov measures. The agent should use
+the same complete command your project uses before merging or deploying.
+If the project has several suites, tell it which one to use.
+
 Supercov runs that command in an isolated, instrumented copy of the project.
 The command keeps its normal arguments, environment, output, and exit status.
 If one command launches several supported runners, their evidence lands in one
 run.
 
-## 2. Read the first result
+### 2. Read the first result
 
-Open the newest run:
+The agent reads the newest run:
 
-```sh
+```sh supercov-example
 npx supercov runs latest
 ```
 
@@ -76,18 +58,19 @@ An uncovered gap is a candidate for a test. A measurement limit is different:
 it means Supercov cannot honestly account for that code yet. Do not try to test
 away a measurement limit.
 
-## 3. Choose one useful gap
+### 3. Choose one useful gap
 
-Ask for a short list, then inspect one file:
+The agent asks for a short list of gaps, then inspects one file. It uses your
+project's file paths in place of the examples:
 
-```sh
+```sh supercov-example
 npx supercov runs latest gaps --limit 10
 npx supercov runs latest file app/checkout/session.ts
 ```
 
-Use the more specific queries when you need them:
+It can use more specific queries to understand the gap:
 
-```sh
+```sh supercov-example
 npx supercov runs latest decision app/checkout/session.ts:64
 npx supercov runs latest line app/checkout/session.ts:64
 ```
@@ -96,40 +79,45 @@ npx supercov runs latest line app/checkout/session.ts:64
 outcomes and MC/DC witnesses. `line` shows the obligations and tests associated
 with one source line.
 
-## 4. Add a test and prove the gain
+### 4. Add a test and prove the gain
 
-Write one focused test with a meaningful assertion. Then rerun the same complete
-command and compare the two runs:
+The agent writes one focused test with a meaningful assertion. It then reruns
+the same complete command and compares the two runs:
 
-```sh
+```sh supercov-example
 npx supercov -- npm test
 npx supercov diff <previous-run-id> latest
 ```
 
-For Rust, rerun the same `cargo test` or `cargo nextest run` command used for the
-baseline. A useful change leaves the suite passing and shows the expected gain
-without an unexplained loss elsewhere.
+A useful change leaves the suite passing and shows the expected gain without
+an unexplained loss elsewhere. Review what the new test actually checks, not
+just the percentage.
 
-## Give the loop to a coding agent
+For a recorded example and prompts for longer runs, see
+[Agent workflow](agent-loop.md).
 
-Paste this into any coding agent that can run terminal commands:
+## Environment requirements
 
-```text
-Use `npx supercov` to improve coverage. Only write tests. Keep going while
-useful gaps remain.
+These requirements apply wherever the agent runs commands: your machine,
+a container, or a remote workspace. The agent can check them and tell you
+if anything is missing.
 
-Run the repository's complete test command through Supercov. Use
-`npx supercov runs latest gaps --limit 5` to choose one useful target. Inspect
-the target, write one focused test with meaningful assertions, rerun the same
-complete suite, and verify the gain with
-`npx supercov diff <previous-run-id> latest`.
-
-Never weaken assertions or change application code to make coverage easier.
-Stop when no useful gap remains or Supercov reports a measurement limit instead
-of an ordinary gap.
-```
+- macOS (arm64 or x64), Linux (arm64 or x64, glibc 2.28 or newer or musl), or
+  Windows (arm64 or x64);
+- Node.js 22 or newer when using the npm package;
+- a working test command, including its dependencies, environment variables,
+  and any local services;
+- for Rust, the Rust 1.95 toolchain;
+- for Python, CPython 3.12 or newer with pytest or unittest;
+- for Ruby, Ruby 3.4 or newer with RSpec, Minitest, test-unit or Cucumber (3.3 measures lines, methods and simple branches only).
 
-Replace `npm test` with the repository's real complete test command when needed.
+The CLI is a native binary. `npx supercov` picks the build for your operating
+system and architecture, and nothing is compiled on install; the same binary is
+on PyPI as `supercov-cli` (`uvx --from supercov-cli supercov`) and on RubyGems
+as `supercov` (`gem install supercov`), at the same version, and the source is
+on crates.io (`cargo install supercov`). The first invocation may download
+Supercov from the registry. Supercov itself does not upload your source or
+coverage evidence to a Supercov service.
 
 ## Files and cleanup
 
@@ -138,7 +126,7 @@ workspace for instrumented builds. These files are local and ignored by Git.
 Supercov does not rewrite your source, tests, imports, runner configuration,
 dependencies, or ordinary build output.
 
-```sh
+```sh supercov
 npx supercov clean --dry-run   # preview what would be removed
 npx supercov clean --keep 20   # keep the 20 newest runs
 npx supercov clean             # remove all runs and the build cache

package/docs/performance.md

@@ -6,7 +6,7 @@ the isolated build when the relevant inputs have not changed.
 
 ## See where the time went
 
-```sh
+```sh supercov
 npx supercov runs latest
 ```
 
@@ -42,7 +42,7 @@ possible mismatch triggers a fresh build rather than risking stale coverage.
 
 A narrow test command can shorten the inner loop:
 
-```sh
+```sh supercov
 npx supercov -- npx vitest run app/checkout/session.test.ts
 ```
 
@@ -54,7 +54,7 @@ baseline.
 
 Compare the original and wrapped command under similar cache conditions:
 
-```sh
+```sh supercov
 /usr/bin/time -p npm test
 /usr/bin/time -p npx supercov -- npm test
 ```
@@ -73,7 +73,7 @@ than stored as a full report for every filter.
 The isolated workspace may be larger because it can contain an instrumented
 build cache. Supercov does not delete history in the background.
 
-```sh
+```sh supercov
 npx supercov clean --dry-run
 npx supercov clean --keep 20
 npx supercov clean

package/docs/troubleshooting.md

@@ -3,7 +3,7 @@
 Start with the run summary. It usually tells you whether the problem is the test
 command, source discovery, runner attribution, or a measurement boundary.
 
-```sh
+```sh supercov
 npx supercov runs latest
 npx supercov runs latest scope
 npx supercov runs latest runners
@@ -28,13 +28,13 @@ would for another npm package.
 Run the same command from the repository root. If first-party code lives in an
 unusual directory, declare the source roots explicitly:
 
-```sh
+```sh supercov
 SUPERCOV_SOURCE_ROOTS=src,app npx supercov -- npm test
 ```
 
 Then inspect what Supercov included and excluded:
 
-```sh
+```sh supercov
 npx supercov runs latest scope
 ```
 
@@ -45,7 +45,7 @@ warning. The goal is an honest boundary around code the repository owns.
 
 First check runner and source scope:
 
-```sh
+```sh supercov
 npx supercov runs latest runners
 npx supercov runs latest scope
 npx supercov runs latest gaps
@@ -67,7 +67,7 @@ file that cannot be compiled with them is measured through Ruby's `Coverage`
 module alone rather than failing the run. To put a file on that path
 deliberately, name a fragment of its path:
 
-```sh
+```sh supercov
 SUPERCOV_RUBY_SKIP_PROBES=app/models/order.rb npx supercov -- bundle exec rspec
 ```
 
@@ -82,7 +82,7 @@ workspace after relevant source, tests, dependencies, configuration, or
 toolchain inputs change. Rerun the same complete command to create a current
 baseline:
 
-```sh
+```sh supercov
 npx supercov -- npm test
 ```
 
@@ -133,7 +133,7 @@ mode still match.
 
 Inspect the recorded phases with:
 
-```sh
+```sh supercov
 npx supercov runs latest
 ```
 
@@ -143,7 +143,7 @@ See [Speed and storage](performance.md) for practical ways to shorten a loop.
 
 Preview cleanup, then choose how much history to keep:
 
-```sh
+```sh supercov
 npx supercov clean --dry-run
 npx supercov clean --keep 20
 npx supercov clean

package/docs/verification.md

@@ -16,7 +16,7 @@ Before merging, check three things:
 3. **The test protects behavior.** It should make a meaningful assertion without
    weakening existing assertions or changing application code for the metric.
 
-```sh
+```sh supercov
 npx supercov diff <baseline-run> <new-run>
 npx supercov runs <new-run> test "new test name"
 ```
@@ -34,7 +34,7 @@ Supercov separates four states:
 - **stale** — the run is valid history but no longer describes the current
   workspace.
 
-```sh
+```sh supercov
 npx supercov runs latest
 npx supercov runs latest scope
 npx supercov runs latest gaps

package/docs/workspace-isolation.md

@@ -74,7 +74,7 @@ staging state. Completed runs remain immutable.
 
 Preview cleanup before removing anything:
 
-```sh
+```sh supercov
 npx supercov clean --dry-run
 npx supercov clean --keep 20
 npx supercov clean

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "supercov",
-  "version": "0.0.43",
-  "description": "Coverage for coding agents and software factories 🌙",
+  "version": "0.0.45",
+  "description": "Coverage for coding agents and software factories \ud83c\udf19",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -15,20 +15,21 @@
   "files": [
     "bin",
     "runtime/javascript",
-    "docs",
-    "analyzers/typescript/bin",
-    "analyzers/typescript/dist/analyze.js",
-    "analyzers/typescript/dist/archive.js",
-    "analyzers/typescript/dist/compiler.js",
-    "analyzers/typescript/dist/frontend.js",
-    "analyzers/typescript/dist/native-frontend.js",
-    "analyzers/typescript/dist/pragmas.js",
-    "analyzers/typescript/dist/types.js",
-    "analyzers/typescript/dist/build-identity.json",
-    "analyzers/typescript/src",
-    "analyzers/typescript/package.json",
-    "analyzers/typescript/tsconfig.json",
-    "analyzers/typescript/README.md",
+    "docs/getting-started.md",
+    "docs/agent-loop.md",
+    "docs/assertions.md",
+    "docs/assertion-evidence.md",
+    "docs/assertion-maps.md",
+    "docs/assertion-agent.md",
+    "docs/troubleshooting.md",
+    "docs/cli.md",
+    "docs/coverage-model.md",
+    "docs/evidence.md",
+    "docs/supported-suites.md",
+    "docs/verification.md",
+    "docs/performance.md",
+    "docs/workspace-isolation.md",
+    "schemas",
     "README.md"
   ],
   "engines": {
@@ -47,7 +48,6 @@
   },
   "scripts": {
     "build": "cargo build -p supercov",
-    "build:asserted-typescript": "npm --prefix analyzers/typescript run build",
     "sync:rust-assets": "node scripts/sync-rust-package-assets.mjs",
     "test:rust-assets": "node scripts/sync-rust-package-assets.mjs --check",
     "check:rustc-backend-spike": "(cd spikes/rustc-backend && RUSTC_BOOTSTRAP=1 RUSTUP_TOOLCHAIN=1.95.0 cargo fmt --check && RUSTC_BOOTSTRAP=1 RUSTUP_TOOLCHAIN=1.95.0 cargo clippy --all-targets -- -D warnings)",
@@ -55,11 +55,8 @@
     "test:rust-compiler-spikes": "cargo build -p supercov && node scripts/rust-libtest-companion-spike.mjs && node scripts/rust-async-attribution-spike.mjs && node scripts/rust-subprocess-attribution-spike.mjs && node scripts/rust-custom-harness-spike.mjs && node scripts/rust-libtest-builder-lifecycle-spike.mjs",
     "test": "cargo test --workspace",
     "test:runtime": "node --test tests/runtime/*.test.mjs",
-    "test:asserted-typescript": "npm --prefix analyzers/typescript test",
-    "test:asserted-integration": "cargo build -p supercov && npm --prefix analyzers/typescript run build && SUPERCOV_ASSERTED_INTEGRATION=1 node --test analyzers/typescript/tests/archive.integration.test.mjs",
-    "test:asserted-package": "cargo build -p supercov && npm run build:asserted-typescript && node scripts/asserted-packed-integration.mjs",
     "test:fixture": "cargo build -p supercov && node scripts/rust-fixture-matrix.mjs",
-    "test:packed-npx": "cargo build --release -p supercov && npm run build:asserted-typescript && node scripts/packed-npx-integration.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",
@@ -67,7 +64,7 @@
     "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-jest-integration.mjs && node scripts/rust-direct-playwright-integration.mjs && node scripts/rust-custom-browser-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 && npm run build:asserted-typescript && node scripts/native-package-integration.mjs && node scripts/native-release-set-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",
@@ -78,28 +75,31 @@
     "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",
     "benchmark:python-monitoring": "cargo build -p supercov && node scripts/python-monitoring-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 && npm run test:asserted-typescript && npm run test:asserted-integration && npm run test:asserted-package && node scripts/package-preflight.mjs && node scripts/verify-binstall-metadata.mjs --offline",
+    "check": "cargo fmt --all -- --check && cargo clippy --workspace --all-targets -- -D warnings && npm run test && npm run test:runtime && npm run test:rust-assets && npm run test:assertion-maps && node scripts/package-preflight.mjs && node scripts/verify-binstall-metadata.mjs --offline",
     "release:check": "cargo clean && node scripts/sweep-target.mjs && 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:child-attribution && npm run test:host-loader && npm run test:python-monitoring && npm run test:ruby-coverage && npm run test:rust-public-cargo && npm run test:packed-npx && npm run test:clang-mcdc && npm run benchmark:check",
     "release:bump": "node scripts/bump-version.mjs",
     "sweep": "node scripts/sweep-target.mjs",
     "oracle:rust": "cargo build --release -p supercov && node scripts/rust-coverage-oracle.mjs",
-    "prepack": "npm run build:asserted-typescript && node scripts/package-preflight.mjs",
+    "prepack": "node scripts/package-preflight.mjs",
     "prepublishOnly": "npm run release:check",
     "test:child-attribution": "cargo build -p supercov && node scripts/rust-child-attribution-integration.mjs",
     "test:host-loader": "cargo build -p supercov && node scripts/rust-host-loader-integration.mjs",
     "test:python-monitoring": "cargo build -p supercov && node scripts/python-monitoring-integration.mjs",
     "test:ruby-coverage": "cargo build -p supercov && node scripts/ruby-coverage-integration.mjs",
-    "test:rust-public-cargo": "cargo build -p supercov && node scripts/rust-public-cargo-integration.mjs"
+    "test:rust-public-cargo": "cargo build -p supercov && node scripts/rust-public-cargo-integration.mjs",
+    "test:assertion-maps": "cargo build -p supercov && node scripts/assertion-map-schema.mjs --check && node scripts/assertion-map-integration.mjs && node scripts/assertion-map-js-integration.mjs",
+    "test:assertion-maps:js": "cargo build -p supercov && node scripts/assertion-map-schema.mjs --check && node scripts/assertion-map-js-integration.mjs",
+    "sync:assertion-schema": "cargo build -p supercov && node scripts/assertion-map-schema.mjs"
   },
   "optionalDependencies": {
-    "@supercov/cli-darwin-arm64": "0.0.43",
-    "@supercov/cli-darwin-x64": "0.0.43",
-    "@supercov/cli-linux-arm64-gnu": "0.0.43",
-    "@supercov/cli-linux-arm64-musl": "0.0.43",
-    "@supercov/cli-linux-x64-gnu": "0.0.43",
-    "@supercov/cli-linux-x64-musl": "0.0.43",
-    "@supercov/cli-win32-arm64": "0.0.43",
-    "@supercov/cli-win32-x64": "0.0.43"
+    "@supercov/cli-darwin-arm64": "0.0.45",
+    "@supercov/cli-darwin-x64": "0.0.45",
+    "@supercov/cli-linux-arm64-gnu": "0.0.45",
+    "@supercov/cli-linux-arm64-musl": "0.0.45",
+    "@supercov/cli-linux-x64-gnu": "0.0.45",
+    "@supercov/cli-linux-x64-musl": "0.0.45",
+    "@supercov/cli-win32-arm64": "0.0.45",
+    "@supercov/cli-win32-x64": "0.0.45"
   },
   "peerDependencies": {
     "@playwright/test": ">=1.55.0",
@@ -123,6 +123,7 @@
     "@types/node": "^24.0.0",
     "esbuild": "^0.28.2",
     "expect": "30.4.1",
+    "jest": "30.5.1",
     "next": "^16.3.2",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",

package/runtime/javascript/nodeAssertAdapter.mjs

@@ -1,4 +1,6 @@
 import { withNodeAssertionPhase } from "./runtime.mjs";
+import { relative, sep } from "node:path";
+import { fileURLToPath } from "node:url";
 const ASSERTION_METHODS = new Set([
     "deepEqual",
     "deepStrictEqual",
@@ -19,18 +21,40 @@ const ASSERTION_METHODS = new Set([
     "strictEqual",
     "throws",
 ]);
-function assertionSource() {
-    const lines = new Error().stack?.split("\n").slice(2) ?? [];
-    const entry = lines.find((line) => !/(?:nodeAssert|nodeAssertion|runtime)\.[cm]?[jt]s/.test(line) &&
-        !line.includes("node:internal"));
-    if (!entry)
+function assertionSource(boundary) {
+    // Omit our own frames by function identity, not basename: a user's helper
+    // may itself be called runtime.mjs or nodeAssertAdapter.mjs. Never search
+    // deeper for a plausible-looking caller when the immediate frame is opaque.
+    // A loader may have transformed this file without composing source maps.
+    // Qualify stack coordinates so they cannot masquerade as the original
+    // source positions emitted by lexical probes and used for oracle matching.
+    try {
+        const error = {};
+        Error.captureStackTrace(error, boundary);
+        if (typeof error.stack !== "string")
+            return undefined;
+        const entry = error.stack.split("\n")[1]?.trim();
+        const match = entry && /(?:^at (?:async )?| \()((?:file:\/\/\/|\/|[A-Za-z]:[\\/]).*):(\d+):(\d+)\)?$/.exec(entry);
+        if (!match)
+            return undefined;
+        const file = match[1].startsWith("file:") ? fileURLToPath(match[1]) : match[1];
+        const roots = [process.env.SUPERCOV_PROJECT_ROOT, process.env.SUPERCOV_SOURCE_PROJECT_ROOT, process.cwd()].filter(Boolean);
+        for (const root of roots) {
+            const path = relative(root, file);
+            if (path !== ".." && !path.startsWith(`..${sep}`) && !/^(?:[A-Za-z]:|[\\/])/.test(path))
+                return `runtime-stack:${path.split(sep).join("/")}:${match[2]}:${match[3]}`;
+        }
+        return `runtime-stack:${file.split(sep).join("/")}:${match[2]}:${match[3]}`;
+    }
+    catch {
+        // Custom stack formatters must not change the user's assertion outcome.
         return undefined;
-    return entry.trim().replace(/^at\s+/, "");
+    }
 }
 function wrapAssertion(original, operation) {
     return new Proxy(original, {
-        apply(target, thisArgument, argumentsList) {
-            return withNodeAssertionPhase(operation, assertionSource(), () => Reflect.apply(target, thisArgument, argumentsList));
+        apply: function assertionApply(target, thisArgument, argumentsList) {
+            return withNodeAssertionPhase(operation, () => assertionSource(assertionApply), () => Reflect.apply(target, thisArgument, argumentsList));
         },
     });
 }

package/runtime/javascript/nodeTest.mjs

@@ -2,7 +2,7 @@ import * as native from "node:test";
 import { fileURLToPath } from "node:url";
 import vm from "node:vm";
 import { beginBufferedServerEvidence, flushBufferedServerEvidence, takeNodeAssertionPhases, withCoverageCarrier, } from "./runtime.mjs";
-import { callerLocation, runnerExecutionScope, writeRunnerEvidence, } from "./runnerEvidence.mjs";
+import { callerLocation, runnerExecutionScope, runnerTestId, writeRunnerEvidence, } from "./runnerEvidence.mjs";
 function callbackIndex(args) {
     for (let index = args.length - 1; index >= 0; index -= 1)
         if (typeof args[index] === "function")
@@ -86,16 +86,18 @@ function restoreUserError(error, depth = 0) {
     }
     return error;
 }
-function wrappedRegistration(original) {
+const registrationCounts = new Map();
+function wrappedRegistration(original, parentTestId) {
     const wrapped = function supercovNodeTest(...args) {
         const index = callbackIndex(args);
         if (index < 0)
             return Reflect.apply(original, this, args);
         const callback = args[index];
-        const location = callerLocation(/(?:nodeTest|runnerEvidence)\.[cm]?[jt]s/);
+        const location = callerLocation(supercovNodeTest);
         const identity = {
             runner: "node:test",
             name: testName(args, callback),
+            ...(parentTestId ? { parentTestId } : {}),
             ...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
@@ -104,6 +106,12 @@ function wrappedRegistration(original) {
             // keeps one identity when esbuild, Babel, SWC, or TypeScript rewrites it.
             ...(location.line === undefined ? {} : { column: 1 }),
         };
+        // Allocate at registration, never callback completion: concurrent tests
+        // can finish in any order. Count each source/name within its parent.
+        const registrationKey = runnerTestId(identity);
+        const registrationOrdinal = registrationCounts.get(registrationKey) ?? 0;
+        registrationCounts.set(registrationKey, registrationOrdinal + 1);
+        identity.registrationOrdinal = registrationOrdinal;
         const scope = runnerExecutionScope(identity);
         const options = testOptions(args, index);
         const evidenceDirectory = process.env["SUPERCOV_EVIDENCE_DIR"];
@@ -129,7 +137,7 @@ function wrappedRegistration(original) {
                         };
                     }
                     if (property === "test" && typeof value === "function")
-                        return wrappedRegistration(value.bind(target));
+                        return wrappedRegistration(value.bind(target), scope.testId);
                     return typeof value === "function" ? value.bind(target) : value;
                 },
             });
@@ -192,7 +200,7 @@ function wrappedRegistration(original) {
             Object.defineProperty(wrapped, property, {
                 configurable: true,
                 enumerable: true,
-                value: wrappedRegistration(member),
+                value: wrappedRegistration(member, parentTestId),
             });
     }
     return wrapped;