supercov 4.20.3 → 4.21.0

package/docs/cli.md

@@ -926,6 +926,7 @@ terminal or offline environment after the package has been downloaded.
 | `SUPERCOV_RUN_ID` | Set by Supercov, not by you: in every process a measured command starts, the run's id, so a test or harness can tell it is measured |
 | `SUPERCOV_RUN_ID_FILE` | A file to write the recorded run's id to, for a script to query that run rather than `latest` |
 | `SUPERCOV_KEEP_WORKSPACE` | Set to `1` to leave the instrumented copy of the project in `.supercov/workspaces/` after the run, to inspect what the command ran |
+| `SUPERCOV_COMMAND_TIMEOUT_MS` | Stop the test command after this many milliseconds: what is still running is asked to stop, then made to five seconds later, what ran is recorded, and Supercov exits `124`. No deadline by default |
 
 Examples:
 
@@ -941,6 +942,7 @@ SUPERCOV_TEST_KIND=e2e npx supercov -- npx playwright test
 | `0` | The command or query succeeded |
 | Wrapped command's code | The test command failed and Supercov preserved its status |
 | `127`, `126` | The test command could not start: no such program, or one that may not be run, as a shell reports it |
+| `124` | The test command ran past `SUPERCOV_COMMAND_TIMEOUT_MS` and was stopped |
 | `1` | A valid measurement failed a policy you set, such as a coverage floor |
 | `2` | Supercov could not complete the request, or the evidence cannot answer it |
 

package/package.json

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

package/runtime/javascript/register.mjs

@@ -944,10 +944,40 @@ if (supportDirectory) {
     };
     syncBuiltinESMExports();
 }
+// A file a test asked for by its path that Node did not find in the copy:
+// the copy leaves out build output, and a test that loads `../dist/x.js` an
+// earlier build made fails as a missing module. Noted where
+// SUPERCOV_MISSING_LOADS names, here for `require` and in the loader for
+// `import`, so the run can say which file the copy lacks and why.
+const missingFile = process.env.SUPERCOV_MISSING_LOADS;
+if (missingFile) {
+    const copyRoot = process.env.SUPERCOV_PROJECT_ROOT;
+    const resolveFilename = Module._resolveFilename;
+    Module._resolveFilename = function supercovNotedResolve(request, parent, ...rest) {
+        try {
+            return resolveFilename.call(this, request, parent, ...rest);
+        }
+        catch (error) {
+            if (error?.code === "MODULE_NOT_FOUND" && copyRoot && /^(?:\.{1,2}[\\/]|[\\/])/.test(request)) {
+                try {
+                    const file = resolve(parent?.filename ? dirname(parent.filename) : process.cwd(), request);
+                    const inside = file.startsWith(copyRoot + sep) ? file.slice(copyRoot.length + 1) : undefined;
+                    if (inside && !inside.startsWith(`.supercov${sep}`) && !inside.split(sep).includes("node_modules"))
+                        fs.appendFileSync(missingFile, `${JSON.stringify({ missing: file })}\n`);
+                }
+                catch {
+                    // Not noted: the run says nothing of it, as before.
+                }
+            }
+            throw error;
+        }
+    };
+}
 register(new URL("./resolve-loader.mjs", import.meta.url), {
     data: {
         typescriptRequireHook: typeof typescriptHandler === "function" && typescriptHandler.name !== "loadTS",
         supportFile,
+        missingFile,
     },
 });
 if (process.env.SUPERCOV_DEBUG === "1") {

package/runtime/javascript/resolve-loader.mjs

@@ -58,9 +58,27 @@ function noteLoaded(url) {
         // Not recorded: the file counts for every test, as before.
     }
 }
+// Where this process notes a file a test asked for by its path and Node did
+// not find, in the copy: a file the copy left out, build output above all,
+// fails a test as a missing module, and Supercov can say why (`register.mjs`
+// names it, and does the same for `require`).
+let missingFile;
+function noteMissing(specifier, parentURL) {
+    if (!missingFile || !/^(?:\.{1,2}\/|\/|file:)/.test(specifier))
+        return;
+    try {
+        const file = fileURLToPath(new URL(specifier, parentURL ?? pathToFileURL(`${process.cwd()}/`)));
+        if (projectFile(file))
+            appendFileSync(missingFile, `${JSON.stringify({ missing: file })}\n`);
+    }
+    catch {
+        // Not noted: the run says nothing of it, as before.
+    }
+}
 export function initialize(data) {
     typescriptRequireHook = data?.typescriptRequireHook === true;
     supportFile = typeof data?.supportFile === "string" ? data.supportFile : undefined;
+    missingFile = typeof data?.missingFile === "string" ? data.missingFile : undefined;
 }
 const packageTypes = new Map();
 function packageType(directory) {
@@ -141,7 +159,14 @@ export async function resolve(specifier, context, nextResolve) {
         }
         return nextResolve(REPLACEMENT, context);
     }
-    return throughRequireHook(await nextResolve(specifier, context));
+    try {
+        return throughRequireHook(await nextResolve(specifier, context));
+    }
+    catch (error) {
+        if (error?.code === "ERR_MODULE_NOT_FOUND")
+            noteMissing(specifier, context.parentURL);
+        throw error;
+    }
 }
 
 // Node's own test coverage filters files by `--test-coverage-include` and