agent-nuvira 3.3.7 → 3.3.9

package/dist/utils/project-env.js

@@ -0,0 +1,584 @@
+/**
+ * Project interpreter canonicalization + pre-run environment guard.
+ *
+ * WHY THIS EXISTS (the live Aukat_check failure):
+ * One chat session built a macOS app by running `python3 -m venv venv` and
+ * `pip install …` against the SYSTEM interpreter, while a project virtualenv sat
+ * in the same directory. A later rebuild therefore used an interpreter that did
+ * not have the project's own dependencies, produced an app that crashed with
+ * `ModuleNotFoundError: No module named 'PyQt6'`, and the run still reported
+ * success. The root cause was not a missing dependency — it was that NOTHING
+ * pinned "which interpreter is this project's" for the run, so each command
+ * guessed and the guesses disagreed.
+ *
+ * This module makes the guess unnecessary, deterministically and LLM-free:
+ *
+ *   1. DISCOVER — find the project's virtualenv (`.venv` preferred, then
+ *      `venv`/`env`), walking up a bounded number of parent directories.
+ *   2. PIN — remember it for the whole process (keyed by directory), so every
+ *      command in the run sees the SAME interpreter.
+ *   3. APPLY — prepend its `bin/` to PATH and set `VIRTUAL_ENV`, so a bare
+ *      `python`/`pip`/`pyinstaller` resolves to the project env.
+ *   4. GUARD — refuse the two mistakes that caused the failure: installing
+ *      Python packages into an interpreter OUTSIDE the project venv, and
+ *      building/running with an interpreter that LACKS the project's declared
+ *      dependencies.
+ *
+ * All checks are best-effort: a probe failure reports, it never breaks a run.
+ * `NUVIRA_ENV_GUARD=off` disables the refusals (the escape hatch a deployment
+ * with a deliberate system-Python setup needs).
+ */
+import { spawnSync } from 'node:child_process';
+import { existsSync, readFileSync, statSync } from 'node:fs';
+import { delimiter, dirname, join, resolve } from 'node:path';
+/** Where the project marker files that describe Python deps live. */
+const PYTHON_MANIFESTS = [
+    'requirements.txt',
+    'pyproject.toml',
+    'setup.py',
+    'setup.cfg',
+    'Pipfile',
+    'Pipfile.lock',
+    'poetry.lock',
+];
+/** Names that appear in a dependency manifest but are not distributions. */
+const NON_DISTRIBUTION_NAMES = new Set([
+    'python',
+    'python_version',
+    'python_full_version',
+    'requires-python',
+    'requires_python',
+]);
+/**
+ * Candidate virtualenv directory names, in PREFERENCE order. `.venv` first
+ * because it is the modern convention (and the one a tool should create), and
+ * a project that has drifted into two envs should converge on one.
+ */
+const VENV_DIR_NAMES = ['.venv', 'venv', 'env', '.virtualenv', 'virtualenv'];
+/** How many parent directories to search for a project venv. */
+const MAX_PARENT_SEARCH = 3;
+/** Is `dir` a Python virtualenv directory? */
+function isVenvDir(dir) {
+    try {
+        if (!existsSync(dir) || !statSync(dir).isDirectory())
+            return false;
+        // Python 3 venvs carry pyvenv.cfg; older/edge cases still have an activate script.
+        if (existsSync(join(dir, 'pyvenv.cfg')))
+            return true;
+        return (existsSync(join(dir, 'bin', 'activate')) ||
+            existsSync(join(dir, 'Scripts', 'activate.bat')));
+    }
+    catch {
+        return false;
+    }
+}
+/** The interpreter path inside a venv dir, or null when none is present. */
+function interpreterIn(dir, binDir) {
+    const candidates = binDir === 'Scripts'
+        ? [join(dir, 'Scripts', 'python.exe')]
+        : [join(dir, 'bin', 'python'), join(dir, 'bin', 'python3')];
+    for (const p of candidates) {
+        if (existsSync(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Find the project's virtualenv, starting at `startDir` and walking up a
+ * bounded number of parents (nearest wins, so a monorepo package's own env
+ * beats the repo root's).
+ */
+export function findProjectVenv(startDir) {
+    let dir;
+    try {
+        dir = resolve(startDir);
+    }
+    catch {
+        return null;
+    }
+    for (let depth = 0; depth <= MAX_PARENT_SEARCH; depth++) {
+        for (const name of VENV_DIR_NAMES) {
+            const candidate = join(dir, name);
+            if (!isVenvDir(candidate))
+                continue;
+            const binDir = existsSync(join(candidate, 'Scripts')) ? 'Scripts' : 'bin';
+            const python = interpreterIn(candidate, binDir);
+            if (python)
+                return { dir: candidate, python, binDir: join(candidate, binDir) };
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    return null;
+}
+/**
+ * The pinned interpreter per directory, for the lifetime of the process.
+ *
+ * "Pin it for the whole run" is the whole point: without this, two commands in
+ * the same turn can resolve different interpreters (which is exactly how one
+ * session created `venv` and then built with `.venv`). Keyed by the directory
+ * the command runs in, so different projects in one process stay separate.
+ */
+const PINNED = new Map();
+/** The project venv for `dir`, discovered once and reused for the run. */
+export function getPinnedProjectVenv(dir) {
+    let key;
+    try {
+        key = resolve(dir);
+    }
+    catch {
+        return null;
+    }
+    if (PINNED.has(key))
+        return PINNED.get(key) ?? null;
+    const found = findProjectVenv(key);
+    PINNED.set(key, found);
+    return found;
+}
+/** Forget pinned interpreters (tests; also after creating a venv mid-run). */
+export function clearPinnedProjectVenv() {
+    PINNED.clear();
+}
+/** Name of the venv the sandbox creates when a project has none. */
+export const SANDBOX_VENV_NAME = '.venv';
+/**
+ * Provision a project-scoped virtualenv (`C3` install sandbox).
+ *
+ * The live failure's 4th finding: a project-scoped fix mutated the machine's
+ * GLOBAL Python. Refusing such installs protects the machine but blocks the
+ * work; the better answer is to give the install a sandbox to land in. When no
+ * project venv exists, create `.venv` from the interpreter on PATH, PIN it for
+ * the run, and hand it back — so the following `pip install` populates the
+ * project env and the global interpreter is never touched.
+ *
+ * Returns null when the venv cannot be created (no base interpreter, or venv
+ * creation failed) — the caller then refuses rather than falling back to a
+ * global install.
+ */
+export function ensureProjectVenv(dir) {
+    const existing = getPinnedProjectVenv(dir);
+    if (existing)
+        return existing;
+    const base = interpreterOnPath();
+    if (!base)
+        return null;
+    let key;
+    try {
+        key = resolve(dir);
+    }
+    catch {
+        return null;
+    }
+    const venvDir = join(key, SANDBOX_VENV_NAME);
+    try {
+        const res = spawnSync(base, ['-m', 'venv', venvDir], {
+            encoding: 'utf-8',
+            timeout: 120_000,
+            windowsHide: true,
+        });
+        if (res.error || res.status !== 0)
+            return null;
+    }
+    catch {
+        return null;
+    }
+    const venv = findProjectVenv(key);
+    if (!venv || !venv.python)
+        return null;
+    PINNED.set(key, venv);
+    return venv;
+}
+/**
+ * Apply the pinned interpreter to a command's environment: prepend its `bin/`
+ * to PATH and set `VIRTUAL_ENV`, so a bare `python`/`pip`/`pyinstaller`
+ * resolves to the project env instead of whatever the shell would have found.
+ * A no-op when there is no venv (the environment is returned unchanged).
+ */
+export function applyProjectEnvironment(env, venv) {
+    if (!venv)
+        return env;
+    const current = env.PATH ?? '';
+    // A venv already on PATH is left alone; otherwise it goes first so it wins.
+    const parts = current.split(delimiter).filter(Boolean);
+    if (!parts.includes(venv.binDir))
+        parts.unshift(venv.binDir);
+    return {
+        ...env,
+        PATH: parts.join(delimiter),
+        VIRTUAL_ENV: venv.dir,
+        // A VIRTUAL_ENV without a matching interpreter can confuse sub-tools.
+        PYTHONHOME: undefined,
+    };
+}
+/**
+ * Parse the distribution names a project declares in `requirements.txt`.
+ *
+ * Deliberately narrow and text-based (no TOML/pip dependency): it keeps only
+ * the name before any version specifier or environment marker, skips flags
+ * (`-r`, `-e`, `--index-url`), comments and blank lines, and follows a `-r`
+ * include one level deep. A name it cannot read is skipped rather than
+ * guessed — the guard must never invent a requirement the project did not ask
+ * for.
+ */
+function requirementNamesFromRequirementsTxt(text) {
+    const names = [];
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        if (!line || line.startsWith('#') || line.startsWith('-'))
+            continue;
+        // `pkg[extra]==1.2 ; python_version>'3.8'` -> `pkg`
+        const match = line.match(/^([A-Za-z0-9][A-Za-z0-9._-]*)/);
+        if (match)
+            names.push(match[1]);
+    }
+    return names;
+}
+/**
+ * Distribution names declared as KEYS of one or more TOML tables, selected by
+ * a section predicate. Handles the `[tool.poetry.dependencies]` shape
+ * (`requests = "^2.31"` / `requests = { version = "…" }`) and poetry's newer
+ * `[tool.poetry.group.<name>.dependencies]` tables. A key that names the
+ * interpreter (`python`) or an environment selector is skipped — it is not a
+ * distribution the guard should demand.
+ *
+ * Text-based on purpose: the guard must not pull a TOML parser into the hot
+ * path, and an unreadable line is skipped rather than guessed.
+ */
+function requirementNamesFromTomlSections(text, isDependencySection) {
+    const names = [];
+    let inSection = false;
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        const section = line.match(/^\[([^\]]+)\]/);
+        if (section) {
+            inSection = isDependencySection(section[1].trim());
+            continue;
+        }
+        if (!inSection || !line || line.startsWith('#'))
+            continue;
+        const match = line.match(/^([A-Za-z0-9][A-Za-z0-9._-]*)\s*=/);
+        if (match && !NON_DISTRIBUTION_NAMES.has(match[1].toLowerCase()))
+            names.push(match[1]);
+    }
+    return names;
+}
+/** Is this a poetry dependency table? (`tool.poetry.dependencies`, dev, groups) */
+function isPoetryDependencySection(section) {
+    return (section === 'tool.poetry.dependencies' ||
+        section === 'tool.poetry.dev-dependencies' ||
+        /^tool\.poetry\.group\.[^.]+\.dependencies$/.test(section));
+}
+/** Is this a pipenv table? (`packages`, `dev-packages`) */
+function isPipfileDependencySection(section) {
+    return section === 'packages' || section === 'dev-packages';
+}
+/**
+ * Distribution names from a `Pipfile` (`[packages]` + `[dev-packages]`).
+ */
+function requirementNamesFromPipfile(text) {
+    const names = [];
+    let inSection = false;
+    for (const raw of text.split(/\r?\n/)) {
+        const line = raw.trim();
+        const section = line.match(/^\[([^\]]+)\]/);
+        if (section) {
+            inSection = isPipfileDependencySection(section[1].trim());
+            continue;
+        }
+        if (!inSection || !line || line.startsWith('#'))
+            continue;
+        const match = line.match(/^([A-Za-z0-9][A-Za-z0-9._-]*)\s*=/);
+        if (match && !NON_DISTRIBUTION_NAMES.has(match[1].toLowerCase()))
+            names.push(match[1]);
+    }
+    return names;
+}
+/**
+ * Distribution names from a `Pipfile.lock` (JSON): the `default` and
+ * `develop` maps. Used only as a fallback when no `Pipfile` is present.
+ */
+function requirementNamesFromPipfileLock(text) {
+    const names = [];
+    try {
+        const parsed = JSON.parse(text);
+        for (const key of ['default', 'develop']) {
+            const group = parsed[key];
+            if (group && typeof group === 'object')
+                names.push(...Object.keys(group));
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+    return names;
+}
+/**
+ * The distribution names a project declares, from `requirements.txt`, a
+ * best-effort scan of `pyproject.toml` (PEP 621 `dependencies = [ … ]` AND
+ * poetry's `[tool.poetry.dependencies]` tables), and a `Pipfile`/`Pipfile.lock`
+ * (pipenv). Returns [] when there is nothing to check — the guard then does
+ * nothing.
+ */
+export function projectRequirementNames(projectDir) {
+    const names = new Set();
+    const reqPath = join(projectDir, 'requirements.txt');
+    try {
+        if (existsSync(reqPath)) {
+            for (const n of requirementNamesFromRequirementsTxt(readFileSync(reqPath, 'utf-8'))) {
+                names.add(n);
+            }
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+    const pyproject = join(projectDir, 'pyproject.toml');
+    try {
+        if (existsSync(pyproject)) {
+            const text = readFileSync(pyproject, 'utf-8');
+            // PEP 621 / poetry 2.x: `dependencies = [ "a", "b" ]`
+            const block = text.match(/dependencies\s*=\s*\[([\s\S]*?)\]/);
+            if (block) {
+                for (const n of requirementNamesFromRequirementsTxt(block[1].replace(/["',]/g, '\n'))) {
+                    names.add(n);
+                }
+            }
+            // poetry 1.x: `[tool.poetry.dependencies]` / groups / dev-dependencies
+            for (const n of requirementNamesFromTomlSections(text, isPoetryDependencySection)) {
+                names.add(n);
+            }
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+    const pipfile = join(projectDir, 'Pipfile');
+    try {
+        if (existsSync(pipfile)) {
+            for (const n of requirementNamesFromPipfile(readFileSync(pipfile, 'utf-8')))
+                names.add(n);
+        }
+        else {
+            const lock = join(projectDir, 'Pipfile.lock');
+            if (existsSync(lock)) {
+                for (const n of requirementNamesFromPipfileLock(readFileSync(lock, 'utf-8')))
+                    names.add(n);
+            }
+        }
+    }
+    catch {
+        /* best-effort */
+    }
+    return [...names];
+}
+/** Does this directory look like it declares Python dependencies? */
+export function hasPythonManifest(dir) {
+    return PYTHON_MANIFESTS.some((m) => existsSync(join(dir, m)));
+}
+// ─── Command classification ────────────────────────────────────────────────
+/** Split a shell line into the separately-run pieces (the `&&`/`;`/`|` chain). */
+function commandSegments(command) {
+    return command
+        .toLowerCase()
+        .split(/&&|;|\|\||\n|\|/)
+        .map((s) => s.trim())
+        .filter(Boolean);
+}
+const PYTHON_TOOLCHAIN_RE = /^(?:(?:sudo|env|command|time)\s+)*(?:[\w./-]*\/)?(python3?(?:\.\d+)?|pip3?|uv|pyinstaller|pytest|py\.test|uvicorn|gunicorn|flask|django-admin|poetry|pipenv|tox)\b/;
+/**
+ * Does any segment of this command invoke the Python toolchain? (A bare
+ * `python`/`pip`/`pyinstaller`/`pytest`, or `python -m …`.)
+ */
+export function isPythonToolchainCommand(command) {
+    return commandSegments(command).some((s) => PYTHON_TOOLCHAIN_RE.test(s));
+}
+const PIP_INSTALL_RE = /^(?:(?:sudo|env|command|time)\s+)*(?:[\w./-]*\/)?(?:pip3?\s+install|python3?(?:\.\d+)?\s+-m\s+pip\s+install|uv\s+(?:pip\s+)?install|uv\s+add|poetry\s+(?:add|install)|pipenv\s+install)\b/;
+/** Does any segment of this command install Python packages? */
+export function isPythonInstallCommand(command) {
+    return commandSegments(command).some((s) => PIP_INSTALL_RE.test(s));
+}
+/**
+ * Does the command name an absolute interpreter OUTSIDE the pinned venv
+ * (e.g. `/usr/local/bin/python3 -m pip install …`)? A bare `python3` does NOT
+ * count: with the venv on PATH it resolves to the project env, which is the
+ * outcome we want.
+ */
+export function targetsForeignInterpreter(command, venv) {
+    // `--user` installs into the user site, never the project env — foreign
+    // whether or not an absolute interpreter is also named.
+    if (/(?:^|\s)--user\b/.test(command))
+        return true;
+    const abs = command.match(/(?:^|\s)(\/[\w./-]*\/?(?:python3?(?:\.\d+)?|pip3?))\b/g) ?? [];
+    if (abs.length === 0)
+        return false;
+    if (!venv)
+        return true; // an absolute interpreter with no pinned venv is foreign by definition
+    return abs.some((token) => {
+        const path = token.trim();
+        return !path.startsWith(venv.binDir) && !path.startsWith(venv.dir);
+    });
+}
+/** Install packages the project declares, inside the given interpreter. */
+const PROBE_SCRIPT = [
+    'import sys, json, importlib.metadata as md',
+    'reqs = json.loads(sys.argv[1])',
+    'missing = []',
+    'for r in reqs:',
+    '    ok = False',
+    "    for c in (r, r.replace('_','-'), r.replace('.','-')):",
+    '        try:',
+    '            md.version(c); ok = True; break',
+    '        except Exception:',
+    '            pass',
+    '    if not ok:',
+    '        missing.append(r)',
+    'print(json.dumps(missing))',
+].join('\n');
+/**
+ * Which declared distributions are NOT installed in `python`?
+ * A probe that fails to run returns [] — an unavailable interpreter is not
+ * evidence that a dependency is missing, and the guard must never refuse on a
+ * guess.
+ */
+export const defaultEnvironmentProbe = (python, names) => {
+    if (names.length === 0)
+        return [];
+    try {
+        const res = spawnSync(python, ['-c', PROBE_SCRIPT, JSON.stringify(names)], {
+            encoding: 'utf-8',
+            timeout: 8000,
+            windowsHide: true,
+        });
+        if (res.error || res.status !== 0)
+            return [];
+        const parsed = JSON.parse((res.stdout ?? '').trim() || '[]');
+        return Array.isArray(parsed) ? parsed.map(String) : [];
+    }
+    catch {
+        return [];
+    }
+};
+/** Memoize probes for the run, keyed by interpreter + the requirement set. */
+const PROBE_CACHE = new Map();
+/** The interpreter a bare `python`/`python3` would resolve to on PATH. */
+function interpreterOnPath() {
+    try {
+        const res = spawnSync(process.platform === 'win32' ? 'where' : 'which', ['python3'], {
+            encoding: 'utf-8',
+            timeout: 4000,
+            windowsHide: true,
+        });
+        if (res.status !== 0)
+            return null;
+        const first = (res.stdout ?? '').split(/\r?\n/).map((s) => s.trim()).filter(Boolean)[0];
+        return first ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Is the guard disabled by the deployment? */
+export function envGuardDisabled() {
+    const raw = (process.env.NUVIRA_ENV_GUARD ?? process.env.BUFF_ENV_GUARD ?? '').trim().toLowerCase();
+    return raw === 'off' || raw === '0' || raw === 'false' || raw === 'no';
+}
+/**
+ * Decide whether a command may run against the project's environment.
+ *
+ * Two refusals, both drawn from the live failure:
+ *   1. a Python PACKAGE INSTALL that would land outside the project venv (or
+ *      with no venv at all while the project declares dependencies);
+ *   2. a BUILD/RUN with an interpreter that is missing the project's declared
+ *      dependencies — the `PyQt6` case, caught before the build instead of
+ *      after a successful-looking bundle.
+ * Everything else proceeds, with the pinned venv applied to the environment.
+ */
+export function guardCommandEnvironment(command, cwd, options = {}) {
+    if (envGuardDisabled())
+        return { action: 'not-applicable' };
+    if (!isPythonToolchainCommand(command))
+        return { action: 'not-applicable' };
+    let venv = getPinnedProjectVenv(cwd);
+    const names = projectRequirementNames(cwd);
+    if (isPythonInstallCommand(command)) {
+        if (targetsForeignInterpreter(command, venv)) {
+            return {
+                action: 'refuse',
+                reason: 'this install names an interpreter outside the project virtualenv',
+                hint: venv
+                    ? `Install into the project env instead: \`${venv.python} -m pip install …\` (or rely on the pinned PATH, which already points at ${venv.binDir}).`
+                    : 'Create and use a project virtualenv first: `python3 -m venv .venv` then `.venv/bin/python -m pip install …` — never install project dependencies into the system interpreter.',
+            };
+        }
+        // ── C3: install sandbox ───────────────────────────────────────────────
+        // With no project venv, a `pip install` would mutate the interpreter on
+        // PATH — the machine's GLOBAL Python. Rather than merely refuse (which
+        // blocks the fix), provision a project-scoped `.venv`, PIN it, and run the
+        // install there. Only a provision failure falls back to refusal, so the
+        // global interpreter is never the target.
+        if (!venv) {
+            const provision = options.provision ?? ensureProjectVenv;
+            venv = provision(cwd);
+            if (!venv) {
+                return {
+                    action: 'refuse',
+                    reason: names.length > 0
+                        ? 'this project declares Python dependencies but has no virtualenv, and one could not be created, so the install would mutate the system interpreter'
+                        : 'this install has no project virtualenv to land in, and one could not be created, so it would mutate the system interpreter',
+                    hint: 'Create and use one yourself: `python3 -m venv .venv && .venv/bin/python -m pip install …` (this pins `.venv` for the rest of the run).',
+                };
+            }
+            return {
+                action: 'proceed',
+                venv,
+                note: `created a project venv ${venv.dir} and sandboxed the install there (the system interpreter is untouched)`,
+            };
+        }
+        return { action: 'proceed', venv, note: `installing into the project venv ${venv.dir}` };
+    }
+    // Build/run: the interpreter must actually have the project's dependencies.
+    const interpreter = venv?.python ?? interpreterOnPath();
+    if (interpreter && names.length > 0) {
+        const probe = options.probe ?? defaultEnvironmentProbe;
+        const cacheKey = `${interpreter}\u0000${names.join(',')}`;
+        let missing = PROBE_CACHE.get(cacheKey);
+        if (missing === undefined) {
+            missing = probe(interpreter, names);
+            PROBE_CACHE.set(cacheKey, missing);
+        }
+        if (missing.length > 0) {
+            const label = venv ? 'the project venv' : 'the interpreter on PATH';
+            return {
+                action: 'refuse',
+                reason: `${label} (${interpreter}) is missing ${missing.length} declared dependency(ies): ${missing.join(', ')}`,
+                hint: venv
+                    ? `Install them into the venv first: \`${venv.python} -m pip install -r requirements.txt\`, then re-run this command.`
+                    : 'Create a project venv (`python3 -m venv .venv`), install the requirements into it, then re-run.',
+            };
+        }
+    }
+    return { action: 'proceed', venv, note: venv ? `using the project venv ${venv.dir}` : undefined };
+}
+/** Forget memoized probes (tests; also after an install changes the env). */
+export function clearEnvironmentProbeCache() {
+    PROBE_CACHE.clear();
+}
+/**
+ * A one-line description of the project interpreter for the ambient project
+ * context, so the model USES the pinned env instead of re-deriving it. '' when
+ * the directory declares nothing Python.
+ */
+export function describeProjectInterpreter(dir) {
+    try {
+        const venv = getPinnedProjectVenv(dir);
+        if (!venv)
+            return hasPythonManifest(dir) ? 'python: no project venv found (create `.venv`)' : '';
+        return `python: ${venv.python} (pinned for this project)`;
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=project-env.js.map

package/dist/utils/project-env.js.map

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

package/dist/utils/shell.d.ts

@@ -59,6 +59,13 @@ export interface RunShellOptions {
     emitEvents?: boolean;
     /** Source label for emitted events (default: 'shell'). */
     source?: string;
+    /**
+     * Environment overrides merged OVER the inherited process environment
+     * (execa's default `extendEnv`). Used to apply a project's pinned virtualenv
+     * (PATH/VIRTUAL_ENV) to every subprocess the pipeline runner spawns, so a
+     * bare `python`/`pip` resolves to the project env. See project-env.ts.
+     */
+    env?: Record<string, string | undefined>;
 }
 /** Result of a `runShell` / `runShellSync` call. */
 export interface RunShellResult {

package/dist/utils/shell.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAID,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CAyEtG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAsD3F"}
+{"version":3,"file":"shell.d.ts","sourceRoot":"","sources":["../../src/utils/shell.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAQH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAErC;AAID,+CAA+C;AAC/C,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,qEAAqE;IACrE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,sEAAsE;IACtE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,gEAAgE;IAChE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uFAAuF;IACvF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,0DAA0D;IAC1D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,oDAAoD;AACpD,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,mEAAmE;IACnE,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,QAAQ,EAAE,OAAO,CAAC;IAClB,yDAAyD;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,OAAO,EAAE,MAAM,CAAC;CACjB;AAYD;;;;;GAKG;AACH,wBAAsB,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,cAAc,CAAC,CA0EtG;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,cAAc,CAuD3F"}

package/dist/utils/shell.js

@@ -83,6 +83,7 @@ export async function runShell(command, options = {}) {
             reject: false,
             signal: options.signal,
             windowsHide: true,
+            ...(options.env ? { env: options.env } : {}),
         });
         if (options.onChunk && subprocess.all) {
             subprocess.all.on('data', (chunk) => {
@@ -149,6 +150,7 @@ export function runShellSync(command, options = {}) {
             all: true,
             reject: false,
             windowsHide: true,
+            ...(options.env ? { env: options.env } : {}),
         });
         stdout = result.stdout ?? '';
         stderr = result.stderr ?? '';