@vibe-agent-toolkit/utils 0.2.0-rc.7 → 0.2.0-rc.8

package/dist/test-helpers.js

@@ -1,280 +1,19 @@
 import { randomBytes } from 'node:crypto';
-import nodeFs, { mkdtempSync, rmSync, symlinkSync } from 'node:fs';
+import nodeFs, { rmSync, symlinkSync } from 'node:fs';
 import fs from 'node:fs/promises';
-import { mkdirSyncReal, normalizedTmpdir, safePath, toForwardSlash } from './path-utils.js';
-/**
- * How long a scratch-dir teardown may run before it gives up and warns.
- *
- * The value only has to be comfortably *under* the hook timeout it runs in —
- * that is the whole design. Sizing a teardown budget to beat contention is
- * unprovable (see {@link removeScratchDir}); sizing it below a known constant is
- * arithmetic.
- *
- * ⚠️ **The known constant is the UNIT tier's**, which is the only tier that
- * takes vitest's 10s default (`vitest.shared.ts` declines to override it there
- * on purpose) and the tier where the flake was actually observed. The other two
- * tiers set their own, far larger: integration gets `platformTestTimeout`
- * (60s on Unix, 900s on Windows) and system gets 300s. A suite in those tiers
- * inherits this 4s default and therefore gives up 15x–225x earlier than its hook
- * would have allowed — for a heavy fixture tree that is a leaked directory and a
- * warning bought for nothing, since an abandoned removal does not stop (see
- * {@link removeScratchDir}). Such a suite should pass its own `budgetMs`, which
- * both suite helpers forward.
- */
-const SCRATCH_REMOVAL_BUDGET_MS = 4000;
-/**
- * Delete a scratch directory as *best effort* — never failing the suite that
- * created it, and never taking longer than its own budget to say so.
- *
- * ## Why this is not just `await rm(dir, { recursive: true, force: true })`
- *
- * A teardown hook that can redden a suite whose every assertion passed is a
- * defect in the harness, not a flake. `packages/lab/test/instrument.test.ts`
- * timed out here on two consecutive Windows runs with all 655 assertions
- * green — only the cleanup lost.
- *
- * The measurement is what rules out the obvious fixes: that scratch dir holds
- * 490 files / 378 KiB across 14 fixture git repos, and deletes in **59 ms**
- * idle. Against vitest's 10,000 ms unit-hook budget that is 170x of headroom,
- * and Windows blew through it anyway. No quantity of real work explains that,
- * so the cause is scheduling — contention from a fully parallel `validate`,
- * plus per-unlink antivirus on Windows — which is unbounded by nature. Hence:
- *
- * - **Raising `hookTimeout` cannot be argued.** You would be picking a number
- *   to beat an unbounded quantity, when 10s of 170x headroom already lost. It
- *   also punches a hole in the deliberate policy in `vitest.shared.ts` ("no
- *   hookTimeout override here on purpose") for every unit hook, to fix one.
- * - **`try`/`catch` around the `rm` cannot work.** A vitest hook timeout is a
- *   race decided on the *timer* side; the hook's own catch never sees it. It
- *   addresses a failure mode we did not observe and leaves the one we did.
- * - **`maxRetries` alone makes it worse.** Retries target transient
- *   `EPERM`/`EBUSY`, which fail *fast*; our failure was *slow*, and retry
- *   backoff only adds to it. Kept below as a cheap inner win, not as the fix.
- *
- * So the deadline is taken away from vitest: the removal races a timer of our
- * own, well inside the hook budget, and expiry is a warning rather than a
- * failure. The hook therefore always resolves in time, which makes it
- * *structurally* incapable of reddening a green suite on any machine at any
- * load — rather than merely unlikely to.
- *
- * The cost, stated plainly: under pathological contention the directory
- * survives in the OS temp dir, which the OS reclaims, and the warning names
- * the path. It can never surface as an unhandled rejection, because the only
- * rejection handler is installed before the race.
- *
- * ⚠️ **Abandoning the removal does not stop it, and does not free the worker.**
- * A pending libuv `fs` request is an active handle, so the `rm` runs to
- * completion regardless — measured at 2,407 ms on an 8,000-file tree after the
- * race was decided at 5 ms — and the process cannot exit until it does.
- * `timer.unref()` below unrefs the *timer*, not the removal. So what this buys
- * is bounded: the **hook** always resolves in time, which is what stops a green
- * suite going red. It does **not** shed the work, and under the contention it
- * targets the abandoned removal competes for disk with whatever runs next in
- * the same worker. That is the trade, and it is why the budget wants to be as
- * large as the tier's hook allows rather than as small as possible.
- *
- * @param dir - Directory to remove. An empty string is a no-op, so a suite
- *   whose `beforeAll` never ran can call this unconditionally.
- * @param options - Deadline and warning sink
- *
- * @example
- * ```typescript
- * afterAll(async () => {
- *   await removeScratchDir(scratch);
- * });
- * ```
- */
-export async function removeScratchDir(dir, options = {}) {
-    if (dir === '')
-        return;
-    const budgetMs = options.budgetMs ?? SCRATCH_REMOVAL_BUDGET_MS;
-    const onWarn = options.onWarn ??
-        ((message) => {
-            console.warn(message);
-        });
-    // Latches on the first outcome so a removal that finishes (or fails) after
-    // the budget expired cannot log a second time into an already-finished suite.
-    let settled = false;
-    const giveUp = (reason) => {
-        if (settled)
-            return;
-        settled = true;
-        onWarn(`scratch dir left behind at ${dir}: ${reason}`);
-    };
-    const remove = options.remove ??
-        ((target) => fs.rm(target, { recursive: true, force: true, maxRetries: 2, retryDelay: 50 }));
-    const removal = remove(dir)
-        .then(() => {
-        settled = true;
-    })
-        .catch((error) => {
-        giveUp(error instanceof Error ? error.message : String(error));
-    });
-    let timer;
-    const deadline = new Promise((resolve) => {
-        timer = setTimeout(() => {
-            giveUp(`removal did not finish within ${budgetMs}ms`);
-            resolve();
-        }, budgetMs);
-        // Never hold the process open for a teardown nobody is waiting on.
-        timer.unref();
-    });
-    await Promise.race([removal, deadline]);
-    clearTimeout(timer);
-}
-/**
- * Get isolated test output directory for current test run
- *
- * Creates a unique directory under `packages/{packageName}/.test-output/{testType}/{runId}`
- * where runId is `{timestamp}-{randomId}` to ensure isolation across parallel test runs.
- *
- * @param packageName - Name of package (e.g., 'rag-lancedb')
- * @param testType - Type of test ('unit', 'integration', 'system')
- * @param subdirs - Optional subdirectories to create within the test output directory
- * @returns Absolute path to the created directory
- *
- * @example
- * ```typescript
- * // Create isolated database directory for system tests
- * const dbPath = getTestOutputDir('rag-lancedb', 'system', 'databases', 'test-db');
- * // Result: packages/rag-lancedb/.test-output/system/20260105-143022-abc123/databases/test-db
- *
- * // Create temporary file directory for integration tests
- * const tempDir = getTestOutputDir('agent-skills', 'integration', 'temp-files');
- * // Result: packages/agent-skills/.test-output/integration/20260105-143022-def456/temp-files
- * ```
- */
-export function getTestOutputDir(packageName, testType, ...subdirs) {
-    // Generate unique run ID: timestamp + random hex
-    const timestamp = new Date().toISOString().replaceAll(/[:.]/g, '-').slice(0, 19);
-    const randomId = randomBytes(4).toString('hex');
-    const runId = `${timestamp}-${randomId}`;
-    // Find project root (assuming we're always in packages/*/test/*)
-    const projectRoot = safePath.resolve(process.cwd());
-    // Build path: packages/{packageName}/.test-output/{testType}/{runId}/{...subdirs}
-    const testOutputDir = safePath.join(projectRoot, 'packages', packageName, '.test-output', testType, runId, ...subdirs);
-    // Create directory structure and return normalized path
-    return mkdirSyncReal(testOutputDir, { recursive: true });
-}
-/**
- * Get the base test output directory for a package
- * Useful for cleanup operations that need to remove all test output
- *
- * @param packageName - Name of package (e.g., 'rag-lancedb')
- * @returns Absolute path to packages/{packageName}/.test-output
- *
- * @example
- * ```typescript
- * const baseDir = getTestOutputBase('rag-lancedb');
- * // Result: packages/rag-lancedb/.test-output
- * ```
- */
-export function getTestOutputBase(packageName) {
-    const projectRoot = safePath.resolve(process.cwd());
-    return safePath.join(projectRoot, 'packages', packageName, '.test-output');
-}
-/**
- * Per-suite temp directory pattern (async version)
- * Creates a single temp directory for the entire test suite,
- * with subdirectories for each test. This is 3-5x faster on Windows
- * than creating a new mkdtemp for each test.
- *
- * @param prefix - Prefix for the suite temp directory name
- * @param teardown - Forwarded to {@link removeScratchDir}. Raise `budgetMs` for a
- *   suite whose fixture tree is heavy or whose tier allows a longer hook than the
- *   unit tier this default is sized against — see {@link SCRATCH_REMOVAL_BUDGET_MS}.
- * @returns Suite helper with beforeAll, afterAll, beforeEach, afterEach, and getTempDir
- *
- * @example
- * ```typescript
- * const suite = setupAsyncTempDirSuite('my-test');
- *
- * describe('my tests', () => {
- *   beforeAll(suite.beforeAll);
- *   afterAll(suite.afterAll);
- *   beforeEach(suite.beforeEach);
- *
- *   it('test 1', async () => {
- *     const tempDir = suite.getTempDir();
- *     // Use tempDir...
- *   });
- * });
- * ```
- */
-export function setupAsyncTempDirSuite(prefix, teardown = {}) {
-    let suiteDir = '';
-    let tempDir = '';
-    let testCounter = 0;
-    return {
-        beforeAll: async () => {
-            suiteDir = await fs.mkdtemp(safePath.join(normalizedTmpdir(), `${prefix}-suite-`));
-        },
-        afterAll: async () => {
-            await removeScratchDir(suiteDir, teardown);
-        },
-        beforeEach: async () => {
-            testCounter++;
-            tempDir = safePath.join(suiteDir, `test-${testCounter}`);
-            // eslint-disable-next-line security/detect-non-literal-fs-filename -- tempDir is from mkdtemp
-            await fs.mkdir(tempDir, { recursive: true });
-        },
-        afterEach: async () => {
-            // Per-test cleanup handled by suite cleanup
-        },
-        getTempDir: () => tempDir,
-    };
-}
+import { syncBuiltinESMExports } from 'node:module';
+import { isFilesystemAccessError } from './errors/errno.js';
+import { normalizedTmpdir, safePath, toForwardSlash } from './path-utils.js';
+let cachedCapability;
 /**
- * Per-suite temp directory pattern (sync version)
- * Creates a single temp directory for the entire test suite,
- * with subdirectories for each test. This is 3-5x faster on Windows
- * than creating a new mkdtemp for each test.
- *
- * @param prefix - Prefix for the suite temp directory name
- * @param teardown - Forwarded to {@link removeScratchDir}. Raise `budgetMs` for a
- *   suite whose fixture tree is heavy or whose tier allows a longer hook than the
- *   unit tier this default is sized against — see {@link SCRATCH_REMOVAL_BUDGET_MS}.
- * @returns Suite helper with beforeAll, afterAll, beforeEach, afterEach, and getTempDir
- *
- * @example
- * ```typescript
- * const suite = setupSyncTempDirSuite('my-test');
- *
- * describe('my tests', () => {
- *   beforeAll(suite.beforeAll);
- *   afterAll(suite.afterAll);
- *   beforeEach(suite.beforeEach);
- *
- *   it('test 1', () => {
- *     const tempDir = suite.getTempDir();
- *     // Use tempDir...
- *   });
- * });
- * ```
+ * The errnos that mean "this host cannot create symlinks": Windows without
+ * Developer Mode or `SeCreateSymbolicLinkPrivilege` (`EPERM`), and a
+ * filesystem that has no symlinks to offer (`ENOTSUP` / `EOPNOTSUPP`).
  */
-export function setupSyncTempDirSuite(prefix, teardown = {}) {
-    let suiteDir = '';
-    let tempDir = '';
-    let testCounter = 0;
-    return {
-        beforeAll: () => {
-            suiteDir = mkdtempSync(safePath.join(normalizedTmpdir(), `${prefix}-suite-`));
-        },
-        afterAll: async () => {
-            await removeScratchDir(suiteDir, teardown);
-        },
-        beforeEach: () => {
-            testCounter++;
-            tempDir = safePath.join(suiteDir, `test-${testCounter}`);
-            mkdirSyncReal(tempDir);
-        },
-        afterEach: () => {
-            // Per-test cleanup handled by suite cleanup
-        },
-        getTempDir: () => tempDir,
-    };
+const SYMLINK_UNSUPPORTED_ERRNOS = new Set(['EPERM', 'ENOTSUP', 'EOPNOTSUPP']);
+function isSymlinkUnsupported(error) {
+    return error instanceof Error && 'code' in error && typeof error.code === 'string' && SYMLINK_UNSUPPORTED_ERRNOS.has(error.code);
 }
-let cachedCapability;
 /**
  * Whether this PROCESS can create symlinks — probed once and memoized.
  *
@@ -282,11 +21,17 @@ let cachedCapability;
  * `SeCreateSymbolicLinkPrivilege`. That privilege lives on the process's
  * security token, not on any one directory: it cannot change between calls
  * within a single run, so probing it once and reusing the result is a
- * memoization, not a shortcut that risks a stale answer. (An exotic
- * filesystem that itself refuses symlinks — some network shares, some FAT
- * variants — is a real exception this does not model; every fixture in this
- * repo creates its roots under {@link normalizedTmpdir}, so it never arises
- * here.)
+ * memoization, not a shortcut that risks a stale answer. (A filesystem that
+ * itself has no symlinks — some network shares, some FAT variants — answers
+ * `ENOTSUP` and is read as the same "no"; every fixture in this repo creates
+ * its roots under {@link normalizedTmpdir}, so it never arises here.)
+ *
+ * Because the answer is memoized for the whole process, what reads as "no"
+ * matters more than usual: a `null` here silently `skip()`s every symlink test
+ * for the rest of the run. So ONLY {@link SYMLINK_UNSUPPORTED_ERRNOS} is a
+ * no. A tmpdir that is unwritable or missing, or a bug, is not an answer about
+ * symlinks at all and stays loud rather than becoming a process-wide skip for
+ * a reason nothing reported.
  *
  * Fixtures that depend on symlinks must ask rather than assume — and, having
  * asked, must SAY they skipped. A symlink case that silently no-ops reads as
@@ -300,23 +45,26 @@ export function symlinkCapability() {
     if (cachedCapability === undefined) {
         const probe = safePath.join(normalizedTmpdir(), `.vat-symlink-probe-${randomBytes(4).toString('hex')}`);
         try {
-            // eslint-disable-next-line security/detect-non-literal-fs-filename -- fixed tmp dir plus a random basename generated here
             symlinkSync('.', probe);
             cachedCapability = {};
         }
-        catch {
+        catch (error) {
+            if (!isSymlinkUnsupported(error))
+                throw error;
             cachedCapability = null;
         }
         if (cachedCapability !== null) {
             // Best-effort: the capability answer comes from creation succeeding, not
             // from cleanup — a probe left behind by a failed rmSync (e.g. a transient
             // lock on the freshly-created reparse point) must not flip a real "yes"
-            // into a memoized, process-wide "no".
+            // into a memoized, process-wide "no". Only the filesystem refusing the
+            // delete is that case; a bug is not, and stays loud.
             try {
                 rmSync(probe, { force: true });
             }
-            catch {
-                // Leftover probe file; harmless, and not this function's concern.
+            catch (error) {
+                if (!isFilesystemAccessError(error))
+                    throw error;
             }
         }
     }
@@ -335,7 +83,6 @@ export function symlinkCapability() {
  * @param type - Windows-only link-type hint (`'file'` \| `'dir'` \| `'junction'`); ignored on POSIX
  */
 export function createSymlink(_cap, target, path, type) {
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- caller-supplied path; the capability parameter is what proves this call site is sanctioned
     symlinkSync(target, path, type);
 }
 /**
@@ -348,7 +95,6 @@ export function createSymlink(_cap, target, path, type) {
  * @param type - Windows-only link-type hint (`'file'` \| `'dir'` \| `'junction'`); ignored on POSIX
  */
 export async function createSymlinkAsync(_cap, target, path, type) {
-    // eslint-disable-next-line security/detect-non-literal-fs-filename -- caller-supplied path; the capability parameter is what proves this call site is sanctioned
     await fs.symlink(target, path, type);
 }
 /**
@@ -427,39 +173,88 @@ export function detachGitEnv() {
     };
 }
 /**
- * Run `body` with `fs.readdirSync` of exactly `directory` throwing an error
- * carrying errno `code`. Every other directory lists for real, so what a walk
- * under test meets is ONE refused listing inside an otherwise ordinary tree —
- * a walk that gave up entirely would pass a test where everything was refused.
- *
- * A patch rather than a `chmod`, for the reason the promise-API twin in
- * `resources/test/helpers/refused-listing.ts` gives: `chmod` reaches one errno
- * (`EACCES`), only where POSIX modes bind, and not as root. The mapping under
- * test is "anything that is not an absence errno", and `EMFILE` / `ENFILE` /
- * `ELOOP` are just as reachable in ordinary operation. This one lives in the
- * shipped helpers because the sync crawler has consumers in three packages that
- * each need to refuse a listing, and the duplication gate refuses three copies.
- *
- * @param directory - Absolute path of the one directory to refuse
- * @param code - The errno to reject with
- * @param body - Runs while the refusal is in force; may be async
- * @returns Whatever `body` returned
+ * The errno-shaped error a refused `fs` call throws: a message, the `code`,
+ * and the `syscall`, exactly as Node shapes one.
  */
-export async function withReaddirSyncRefused(directory, code, body) {
-    const original = nodeFs.readdirSync;
-    const refused = toForwardSlash(directory);
-    const patched = ((target, ...rest) => {
-        if (toForwardSlash(String(target)) === refused) {
-            throw Object.assign(new Error(`${code}: refused, scandir '${String(target)}'`), { code });
-        }
+export function errnoError(code, syscall, target) {
+    return Object.assign(new Error(`${code}: refused, ${syscall} '${target}'`), { code, syscall });
+}
+/**
+ * Assign `fn` over `module[method]` and republish the builtin's ESM bindings.
+ *
+ * Assigning on the CJS object alone reaches ONLY a `import fs from 'node:fs'`
+ * caller — a named or namespace import reads the builtin's ESM bindings, which
+ * Node snapshots at import time. `syncBuiltinESMExports()` after each
+ * assignment republishes the patch (and the restore) to every import style;
+ * measured under vitest: without it, a spy on a named-import caller attached
+ * and counted zero, which reads exactly like "this function performs no I/O".
+ */
+function republish(module, method, fn) {
+    module[method] = fn;
+    syncBuiltinESMExports();
+}
+/**
+ * Make `fs[method]` throw `code` for exactly `targetPath` until the returned
+ * restore is called; every other path, and every other method, stays real.
+ *
+ * A patch rather than a `chmod`: `chmod` reaches one errno (`EACCES`), only
+ * where POSIX modes bind, and not as root — and the property under test is
+ * "any refusal that is not an absence", so `EACCES`, `ELOOP`, `EMFILE` must all
+ * be reachable. What a walk under test meets is ONE refused call inside an
+ * otherwise ordinary tree; a walk that gave up entirely would pass a test where
+ * everything was refused.
+ *
+ * Lives in the shipped helpers because consumers in five packages each need to
+ * refuse a call, and the duplication gate refuses five copies.
+ */
+export function refuseSyncFs(method, targetPath, code) {
+    const original = nodeFs[method];
+    const refused = toForwardSlash(targetPath);
+    republish(nodeFs, method, (target, ...rest) => {
+        if (toForwardSlash(String(target)) === refused)
+            throw errnoError(code, method, String(target));
+        return original(target, ...rest);
+    });
+    return () => republish(nodeFs, method, original);
+}
+/**
+ * `fs/promises[method]` rejects with `code` for exactly `targetPath` until the
+ * returned restore is called; every other path, and every other method, is real.
+ */
+export function refuseAsyncFs(method, targetPath, code) {
+    const original = fs[method].bind(fs);
+    const refused = toForwardSlash(targetPath);
+    republish(fs, method, async (target, ...rest) => {
+        if (toForwardSlash(String(target)) === refused)
+            throw errnoError(code, method, String(target));
         return original(target, ...rest);
     });
-    nodeFs.readdirSync = patched;
+    return () => republish(fs, method, original);
+}
+/**
+ * Run `body` while `fs[method]` throws `code` for exactly `targetPath`; the
+ * patch is lifted however `body` exits. See {@link refuseSyncFs}.
+ */
+export async function withSyncFsRefused(method, targetPath, code, body) {
+    const restore = refuseSyncFs(method, targetPath, code);
     try {
         return await body();
     }
     finally {
-        nodeFs.readdirSync = original;
+        restore();
     }
 }
+/**
+ * Run `body` with `fs.readdirSync` of exactly `directory` throwing an error
+ * carrying errno `code`. The listing case of {@link withSyncFsRefused}, named
+ * because refusing a LISTING is the question the crawler's consumers ask.
+ *
+ * @param directory - Absolute path of the one directory to refuse
+ * @param code - The errno to reject with
+ * @param body - Runs while the refusal is in force; may be async
+ * @returns Whatever `body` returned
+ */
+export async function withReaddirSyncRefused(directory, code, body) {
+    return withSyncFsRefused('readdirSync', directory, code, body);
+}
 //# sourceMappingURL=test-helpers.js.map

package/dist/test-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"test-helpers.js","sourceRoot":"","sources":["../src/test-helpers.ts"],"names":[],"mappings":"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"}

package/dist/testing/executables.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Absolute paths for the executables test fixtures spawn.
+ *
+ * A test that spawns `'git'` or `'node'` by bare name asks the OS to search
+ * `PATH`, and a writable directory on `PATH` turns that into a place to plant
+ * a binary (the class SonarCloud's S4036 flags). Fixtures resolve the binary
+ * ONCE, here, to an absolute path and spawn that: `node` is the process that
+ * is running the test (`process.execPath`, the only node whose version the
+ * test can vouch for), and `git` is found by walking `PATH`.
+ *
+ * Why a second `PATH` walk beside `safe-exec.ts`'s `which`: `which` resolves
+ * in-process too, but it is a third-party package, and the `./testing` subpath
+ * is pinned dependency-free (`subpath-purity.test.ts`) — an adopter's test
+ * suite pulls nothing in. This walk answers the same question under that
+ * constraint: the first REGULAR FILE on `PATH` named `name` (with a `PATHEXT`
+ * extension on Windows) that the process may execute.
+ */
+/** The `node` running this test, absolute. */
+export declare const NODE_EXECUTABLE: string;
+/** The names to try in one `PATH` directory: `PATHEXT` variants on Windows, the bare name elsewhere. */
+export declare function executableCandidates(name: string, platform: NodeJS.Platform, pathext: string | undefined): string[];
+/**
+ * The first executable named `name` on `PATH`, absolute.
+ *
+ * @throws {Error} when nothing on `PATH` is executable under that name — a
+ *   fixture that needs `git` and has none should fail at the first spawn with
+ *   the reason, not with the OS's `ENOENT` for a bare word.
+ */
+export declare function resolveExecutable(name: string): string;
+/** `git`, absolute, resolved on first use and cached for the process. */
+export declare function gitExecutable(): string;
+//# sourceMappingURL=executables.d.ts.map

package/dist/testing/executables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"executables.d.ts","sourceRoot":"","sources":["../../src/testing/executables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAQH,8CAA8C;AAC9C,eAAO,MAAM,eAAe,EAAE,MAAyB,CAAC;AAExD,wGAAwG;AACxG,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,EAAE,CAInH;AAcD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUtD;AAID,yEAAyE;AACzE,wBAAgB,aAAa,IAAI,MAAM,CAGtC"}

package/dist/testing/executables.js

@@ -0,0 +1,70 @@
+/**
+ * Absolute paths for the executables test fixtures spawn.
+ *
+ * A test that spawns `'git'` or `'node'` by bare name asks the OS to search
+ * `PATH`, and a writable directory on `PATH` turns that into a place to plant
+ * a binary (the class SonarCloud's S4036 flags). Fixtures resolve the binary
+ * ONCE, here, to an absolute path and spawn that: `node` is the process that
+ * is running the test (`process.execPath`, the only node whose version the
+ * test can vouch for), and `git` is found by walking `PATH`.
+ *
+ * Why a second `PATH` walk beside `safe-exec.ts`'s `which`: `which` resolves
+ * in-process too, but it is a third-party package, and the `./testing` subpath
+ * is pinned dependency-free (`subpath-purity.test.ts`) — an adopter's test
+ * suite pulls nothing in. This walk answers the same question under that
+ * constraint: the first REGULAR FILE on `PATH` named `name` (with a `PATHEXT`
+ * extension on Windows) that the process may execute.
+ */
+import { accessSync, constants, statSync } from 'node:fs';
+import { delimiter } from 'node:path';
+import { isFilesystemAccessError } from '../errors/errno.js';
+import { safePath } from '../path-core.js';
+/** The `node` running this test, absolute. */
+export const NODE_EXECUTABLE = process.execPath;
+/** The names to try in one `PATH` directory: `PATHEXT` variants on Windows, the bare name elsewhere. */
+export function executableCandidates(name, platform, pathext) {
+    if (platform !== 'win32')
+        return [name];
+    const extensions = (pathext ?? '.EXE;.CMD;.BAT;.COM').split(';').filter((ext) => ext !== '');
+    return [...extensions.map((ext) => `${name}${ext}`), name];
+}
+/** Is `full` a regular file the process may execute? A directory named `git` passes `X_OK` (search permission) and is not one. */
+function isExecutableFile(full) {
+    try {
+        accessSync(full, constants.X_OK);
+        return statSync(full).isFile();
+    }
+    catch (error) {
+        // Absent or not executable here: the next directory on PATH may have it.
+        if (isFilesystemAccessError(error))
+            return false;
+        throw error;
+    }
+}
+/**
+ * The first executable named `name` on `PATH`, absolute.
+ *
+ * @throws {Error} when nothing on `PATH` is executable under that name — a
+ *   fixture that needs `git` and has none should fail at the first spawn with
+ *   the reason, not with the OS's `ENOENT` for a bare word.
+ */
+export function resolveExecutable(name) {
+    const candidates = executableCandidates(name, process.platform, process.env['PATHEXT']);
+    for (const dir of (process.env['PATH'] ?? '').split(delimiter)) {
+        if (dir === '')
+            continue;
+        for (const candidate of candidates) {
+            const full = safePath.join(dir, candidate);
+            if (isExecutableFile(full))
+                return full;
+        }
+    }
+    throw new Error(`No executable named "${name}" on PATH (${process.env['PATH'] ?? '<unset>'})`);
+}
+let resolvedGit;
+/** `git`, absolute, resolved on first use and cached for the process. */
+export function gitExecutable() {
+    resolvedGit ??= resolveExecutable('git');
+    return resolvedGit;
+}
+//# sourceMappingURL=executables.js.map

package/dist/testing/executables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"executables.js","sourceRoot":"","sources":["../../src/testing/executables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAEtC,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAE3C,8CAA8C;AAC9C,MAAM,CAAC,MAAM,eAAe,GAAW,OAAO,CAAC,QAAQ,CAAC;AAExD,wGAAwG;AACxG,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,QAAyB,EAAE,OAA2B;IACvG,IAAI,QAAQ,KAAK,OAAO;QAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,CAAC,OAAO,IAAI,qBAAqB,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,CAAC;IAC7F,OAAO,CAAC,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;AAC7D,CAAC;AAED,kIAAkI;AAClI,SAAS,gBAAgB,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,UAAU,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACjC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,IAAI,uBAAuB,CAAC,KAAK,CAAC;YAAE,OAAO,KAAK,CAAC;QACjD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,MAAM,UAAU,GAAG,oBAAoB,CAAC,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC;IACxF,KAAK,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QACzB,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;YACnC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAC3C,IAAI,gBAAgB,CAAC,IAAI,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,cAAc,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,SAAS,GAAG,CAAC,CAAC;AACjG,CAAC;AAED,IAAI,WAA+B,CAAC;AAEpC,yEAAyE;AACzE,MAAM,UAAU,aAAa;IAC3B,WAAW,KAAK,iBAAiB,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,WAAW,CAAC;AACrB,CAAC"}