pyfig 0.1.0 → 0.3.0

package/dist/config.js

@@ -1,39 +1,146 @@
+import { createHash } from 'node:crypto';
 import path from 'node:path';
-import envPaths from 'env-paths';
+import * as envPaths from 'env-paths';
 import semver from 'semver';
+import { resolveProjectRoot } from './project-root.js';
 export const DEFAULT_PYTHON_RANGE = '>=3.10.0 <4.0.0';
 export const DEFAULT_PIP_RANGE = '>=20.3.0';
 export const DEFAULT_MANAGED_PYTHON = '3.12';
 export const DEFAULT_UV_VERSION = '0.13.6';
+export const DEFAULT_UV_RANGE = `>=${DEFAULT_UV_VERSION} <1.0.0`;
+const DEFAULT_PROBE_TIMEOUT_MS = 10_000;
+const DEFAULT_INSTALL_TIMEOUT_MS = 10 * 60_000;
+const DEFAULT_DOWNLOAD_TIMEOUT_MS = 5 * 60_000;
+const DEFAULT_CACHE_TTL_MS = 30_000;
+// Bun's CommonJS bundler wraps an external ESM default one level deeper than
+// Node.js. Normalize that boundary once instead of leaking runtime checks into
+// configuration resolution.
+const envPathsFunction = (() => {
+    const imported = envPaths.default;
+    const implementation = typeof imported === 'function' ? imported : imported.default;
+    if (!implementation)
+        throw new TypeError('env-paths did not expose its default function.');
+    return implementation;
+})();
 export function resolveOptions(options = {}) {
-    const env = options.env ?? process.env;
+    // Snapshot the environment so callers cannot change an in-flight policy by
+    // mutating process.env or a reused options object after resolution.
+    const env = { ...(options.env ?? process.env) };
     const pythonRange = options.pythonRange ?? env['PYFIG_PYTHON_RANGE'] ?? DEFAULT_PYTHON_RANGE;
     const pipRange = options.pipRange ?? env['PYFIG_PIP_RANGE'] ?? DEFAULT_PIP_RANGE;
+    const uvRange = options.uvRange ?? env['PYFIG_UV_RANGE'] ?? DEFAULT_UV_RANGE;
     assertRange('Python', pythonRange);
     assertRange('pip', pipRange);
+    assertRange('uv', uvRange);
+    const managedPython = options.managedPython ??
+        env['PYFIG_MANAGED_PYTHON'] ?? DEFAULT_MANAGED_PYTHON;
+    const uvVersion = options.uvVersion ?? env['PYFIG_UV_VERSION'] ?? DEFAULT_UV_VERSION;
+    assertManagedPythonRequest(managedPython, pythonRange);
+    assertUvVersion(uvVersion, uvRange);
+    const probeTimeoutMs = resolveDuration('probeTimeoutMs', options.probeTimeoutMs, env['PYFIG_PROBE_TIMEOUT_MS'], DEFAULT_PROBE_TIMEOUT_MS);
+    const installTimeoutMs = resolveDuration('installTimeoutMs', options.installTimeoutMs, env['PYFIG_INSTALL_TIMEOUT_MS'], DEFAULT_INSTALL_TIMEOUT_MS);
+    const downloadTimeoutMs = resolveDuration('downloadTimeoutMs', options.downloadTimeoutMs, env['PYFIG_DOWNLOAD_TIMEOUT_MS'], DEFAULT_DOWNLOAD_TIMEOUT_MS);
+    const coordinationTimeoutMs = resolveDuration('coordinationTimeoutMs', options.coordinationTimeoutMs, env['PYFIG_COORDINATION_TIMEOUT_MS'], installTimeoutMs + downloadTimeoutMs + 60_000);
+    const cacheTtlMs = resolveDuration('cacheTtlMs', options.cacheTtlMs, env['PYFIG_CACHE_TTL_MS'], DEFAULT_CACHE_TTL_MS, true);
     const configuredHome = options.cacheDir ?? env['PYFIG_HOME'];
     const cacheDir = configuredHome
         ? path.resolve(configuredHome)
-        : envPaths('pyfig', { suffix: '' }).cache;
+        : envPathsFunction('pyfig', { suffix: '' }).cache;
+    const configuredProjectRoot = options.projectRoot ?? env['PYFIG_PROJECT_ROOT'];
+    const projectRoot = configuredProjectRoot
+        ? path.resolve(configuredProjectRoot)
+        : resolveProjectRoot();
+    const autoInstall = options.autoInstall ?? parseBoolean(env['PYFIG_AUTO_INSTALL'], true);
     return {
         python: options.python ?? env['PYFIG_PYTHON'] ?? '',
-        pip: options.pip ?? env['PYFIG_PIP'] ?? '',
         pythonRange,
         pipRange,
-        managedPython: options.managedPython ?? env['PYFIG_MANAGED_PYTHON'] ?? DEFAULT_MANAGED_PYTHON,
-        uvVersion: options.uvVersion ?? env['PYFIG_UV_VERSION'] ?? DEFAULT_UV_VERSION,
-        autoInstall: options.autoInstall ?? parseBoolean(env['PYFIG_AUTO_INSTALL'], true),
+        managedPython,
+        uvVersion,
+        uvRange,
+        requireEmbedding: options.requireEmbedding ?? parseBoolean(env['PYFIG_REQUIRE_EMBEDDING'], false),
+        requireGil: options.requireGil ?? parseBoolean(env['PYFIG_REQUIRE_GIL'], false),
+        autoInstall,
+        installPython: options.installPython ?? parseBoolean(env['PYFIG_INSTALL_PYTHON'], autoInstall),
+        installUv: options.installUv ?? parseBoolean(env['PYFIG_INSTALL_UV'], autoInstall),
+        createVirtualEnvironment: options.createVirtualEnvironment ??
+            parseBoolean(env['PYFIG_CREATE_VIRTUAL_ENVIRONMENT'], autoInstall),
         cacheDir,
-        probeTimeoutMs: options.probeTimeoutMs ?? 10_000,
-        installTimeoutMs: options.installTimeoutMs ?? 10 * 60_000,
+        projectRoot,
+        probeTimeoutMs,
+        installTimeoutMs,
+        downloadTimeoutMs,
+        coordinationTimeoutMs,
+        cacheTtlMs,
         env,
     };
 }
+/** Opaque identity shared by every async and sync resolution cache. */
+export function configurationFingerprint(options) {
+    const policy = [
+        normalizedPath(options.projectRoot),
+        normalizedPath(options.cacheDir),
+        options.python,
+        options.pythonRange,
+        options.pipRange,
+        options.managedPython,
+        options.uvVersion,
+        options.uvRange,
+        options.requireEmbedding,
+        options.requireGil,
+        options.autoInstall,
+        options.installPython,
+        options.installUv,
+        options.createVirtualEnvironment,
+        options.probeTimeoutMs,
+        options.installTimeoutMs,
+        options.downloadTimeoutMs,
+        options.coordinationTimeoutMs,
+        options.cacheTtlMs,
+        environmentFingerprint(options.env),
+    ];
+    return createHash('sha256').update(JSON.stringify(policy)).digest('hex');
+}
+/** Keep uv-managed Python and cache data inside pyfig's configured cache root. */
+export function uvEnvironment(options) {
+    return {
+        ...options.env,
+        UV_PYTHON_INSTALL_DIR: path.join(options.cacheDir, 'python'),
+        UV_CACHE_DIR: path.join(options.cacheDir, 'uv-cache'),
+    };
+}
 function assertRange(tool, range) {
     if (!semver.validRange(range)) {
         throw new TypeError(`Invalid ${tool} SemVer range: ${range}`);
     }
 }
+function assertUvVersion(version, range) {
+    if (!semver.valid(version)) {
+        throw new TypeError(`Invalid exact uv version: ${version}`);
+    }
+    if (!semver.satisfies(version, range)) {
+        throw new TypeError(`Pinned uv ${version} does not satisfy supported range ${range}.`);
+    }
+}
+function assertManagedPythonRequest(request, pythonRange) {
+    if (!request || /[\\/\0\r\n]/u.test(request) || request.includes('..')) {
+        throw new TypeError(`Invalid managed Python request: ${request}`);
+    }
+    if (/^\d+\.\d+(?:\.\d+)?$/u.test(request)) {
+        const normalized = request.split('.').length === 2 ? `${request}.0` : request;
+        if (!semver.satisfies(normalized, pythonRange)) {
+            throw new TypeError(`Managed Python ${request} cannot satisfy configured range ${pythonRange}.`);
+        }
+    }
+}
+function resolveDuration(name, explicit, environment, fallback, allowZero = false) {
+    const value = explicit ?? (environment === undefined ? fallback : Number(environment));
+    const minimum = allowZero ? 0 : 1;
+    if (!Number.isSafeInteger(value) || value < minimum) {
+        throw new TypeError(`${name} must be ${allowZero ? 'a non-negative' : 'a positive'} integer.`);
+    }
+    return value;
+}
 function parseBoolean(value, fallback) {
     if (value === undefined)
         return fallback;
@@ -43,4 +150,18 @@ function parseBoolean(value, fallback) {
         return false;
     throw new TypeError(`Invalid boolean value: ${value}`);
 }
+function environmentFingerprint(env) {
+    const entries = Object.entries(env)
+        .filter((entry) => entry[1] !== undefined)
+        .map(([key, value]) => [
+        process.platform === 'win32' ? key.toUpperCase() : key,
+        value,
+    ])
+        .sort(([left], [right]) => left.localeCompare(right));
+    return createHash('sha256').update(JSON.stringify(entries)).digest('hex');
+}
+function normalizedPath(value) {
+    const resolved = path.resolve(value);
+    return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
+}
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,WAAW,CAAC;AACjC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,CAAC,MAAM,oBAAoB,GAAG,iBAAiB,CAAC;AACtD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC;AAC5C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,QAAQ,CAAC;AA8B3C,MAAM,UAAU,cAAc,CAAC,OAAO,GAAiB,EAAE;IACvD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACvC,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,GAAG,CAAC,oBAAoB,CAAC,IAAI,oBAAoB,CAAC;IAC7F,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,iBAAiB,CAAC,IAAI,iBAAiB,CAAC;IACjF,WAAW,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACnC,WAAW,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAE7B,MAAM,cAAc,GAAG,OAAO,CAAC,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,cAAc;QAC7B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC;QAC9B,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC;IAE5C,OAAO;QACL,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE;QACnD,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,IAAI,EAAE;QAC1C,WAAW;QACX,QAAQ;QACR,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,GAAG,CAAC,sBAAsB,CAAC,IAAI,sBAAsB;QAC7F,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,CAAC,kBAAkB,CAAC,IAAI,kBAAkB;QAC7E,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,YAAY,CAAC,GAAG,CAAC,oBAAoB,CAAC,EAAE,IAAI,CAAC;QACjF,QAAQ;QACR,cAAc,EAAE,OAAO,CAAC,cAAc,IAAI,MAAM;QAChD,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,EAAE,GAAG,MAAM;QACzD,GAAG;KACJ,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,KAAa;IAC9C,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,SAAS,CAAC,WAAW,IAAI,kBAAkB,KAAK,EAAE,CAAC,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAS,YAAY,CAAC,KAAyB,EAAE,QAAiB;IAChE,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,QAAQ,CAAC;IACzC,IAAI,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACnD,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,MAAM,IAAI,SAAS,CAAC,0BAA0B,KAAK,EAAE,CAAC,CAAC;AACzD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/coordination.d.ts

@@ -0,0 +1,25 @@
+export interface ResourceLockOptions {
+    /** Stable logical identity shared by every caller of the protected resource. */
+    key: string;
+    /** Existing directory used by the portable cross-process lease. */
+    target: string;
+    timeoutMs: number;
+    env: NodeJS.ProcessEnv;
+}
+export interface ProvisioningLockOptions<T> extends ResourceLockOptions {
+    check: () => Promise<T | null>;
+    mutate: (signal: AbortSignal) => Promise<T>;
+}
+/**
+ * Apply check-lock-check around an idempotent provisioning mutation. The lock
+ * stack is ordered identically everywhere to prevent lock-order inversions.
+ */
+export declare function withProvisioningLock<T>(options: ProvisioningLockOptions<T>): Promise<T>;
+/**
+ * Serialize a resource in the current realm, across supported Node workers,
+ * through native flock when present, and finally through a portable file lease.
+ */
+export declare function withResourceLock<T>(options: ResourceLockOptions, operation: (signal: AbortSignal) => Promise<T>): Promise<T>;
+/** Create a canonical lock target below a configured cache directory. */
+export declare function cacheLockTarget(cacheDirectory: string, name: string): string;
+//# sourceMappingURL=coordination.d.ts.map

package/dist/coordination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination.d.ts","sourceRoot":"","sources":["../src/coordination.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,mBAAmB;IAClC,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CACxB;AAED,MAAM,WAAW,uBAAuB,CAAC,CAAC,CAAE,SAAQ,mBAAmB;IACrE,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC/B,MAAM,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;CAC7C;AAWD;;;GAGG;AACH,wBAAsB,oBAAoB,CAAC,CAAC,EAC1C,OAAO,EAAE,uBAAuB,CAAC,CAAC,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CAQZ;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,EACtC,OAAO,EAAE,mBAAmB,EAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,CAAC,CAAC,GAC7C,OAAO,CAAC,CAAC,CAAC,CAMZ;AAuKD,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5E"}

package/dist/coordination.js

@@ -0,0 +1,187 @@
+import { createHash } from 'node:crypto';
+import { spawn } from 'node:child_process';
+import { mkdir } from 'node:fs/promises';
+import path from 'node:path';
+import * as workerThreads from 'node:worker_threads';
+import lockfile from 'proper-lockfile';
+import { resolveExecutable } from './process.js';
+const realmMutexTails = new Map();
+const flockLookups = new Map();
+const FLOCK_READY = 'PYFIG_FLOCK_READY';
+const FLOCK_HOLDER = [
+    `process.stdout.write('${FLOCK_READY}\\n')`,
+    'process.stdin.resume()',
+    'process.stdin.once("end",()=>process.exit(0))',
+].join(';');
+/**
+ * Apply check-lock-check around an idempotent provisioning mutation. The lock
+ * stack is ordered identically everywhere to prevent lock-order inversions.
+ */
+export async function withProvisioningLock(options) {
+    const existing = await options.check();
+    if (existing !== null)
+        return existing;
+    return withResourceLock(options, async (signal) => {
+        const rechecked = await options.check();
+        return rechecked ?? options.mutate(signal);
+    });
+}
+/**
+ * Serialize a resource in the current realm, across supported Node workers,
+ * through native flock when present, and finally through a portable file lease.
+ */
+export async function withResourceLock(options, operation) {
+    await mkdir(options.target, { recursive: true });
+    return withRealmMutex(options.key, () => withWorkerLock(options, () => withNativeFlock(options, () => withPortableLease(options, operation))));
+}
+async function withRealmMutex(key, operation) {
+    const previous = realmMutexTails.get(key) ?? Promise.resolve();
+    let releaseGate;
+    const gate = new Promise((resolve) => {
+        releaseGate = resolve;
+    });
+    const tail = previous.catch(() => undefined).then(() => gate);
+    realmMutexTails.set(key, tail);
+    await previous.catch(() => undefined);
+    try {
+        return await operation();
+    }
+    finally {
+        releaseGate();
+        if (realmMutexTails.get(key) === tail)
+            realmMutexTails.delete(key);
+    }
+}
+async function withWorkerLock(options, operation) {
+    const manager = workerThreads.locks;
+    if (!manager?.request)
+        return operation();
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(new Error(`Timed out waiting for worker lock ${options.key}.`)), options.timeoutMs);
+    let entered = false;
+    try {
+        return await manager.request(workerLockName(options.key), { mode: 'exclusive', signal: controller.signal }, async () => {
+            entered = true;
+            return operation();
+        });
+    }
+    catch (error) {
+        // Worker locks are an optimization on runtimes that expose the experimental
+        // API. The portable lease remains authoritative when acquisition is absent.
+        if (entered)
+            throw error;
+        return operation();
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+async function withNativeFlock(options, operation) {
+    if (process.platform === 'win32')
+        return operation();
+    // Coordination helpers belong to the host runtime, not the child discovery
+    // environment, which callers may intentionally strip of Python and uv paths.
+    const executable = await findFlock(process.env);
+    if (!executable)
+        return operation();
+    const child = await acquireFlock(executable, `${options.target}.flock`, options.timeoutMs);
+    if (!child)
+        return operation();
+    try {
+        return await operation();
+    }
+    finally {
+        await releaseFlock(child);
+    }
+}
+async function findFlock(env) {
+    const lookupKey = `${env['PATH'] ?? ''}\0${env['PATHEXT'] ?? ''}`;
+    let lookup = flockLookups.get(lookupKey);
+    if (!lookup) {
+        lookup = resolveExecutable('flock', env);
+        flockLookups.set(lookupKey, lookup);
+    }
+    return lookup;
+}
+async function acquireFlock(executable, lockPath, timeoutMs) {
+    const waitSeconds = Math.max(1, Math.ceil(Math.min(timeoutMs, 30_000) / 1000));
+    const child = spawn(executable, ['-x', '-w', String(waitSeconds), lockPath, process.execPath, '-e', FLOCK_HOLDER], { stdio: ['pipe', 'pipe', 'pipe'], windowsHide: true });
+    child.stderr.resume();
+    let output = '';
+    const acquired = await new Promise((resolve) => {
+        let settled = false;
+        const finish = (value) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            resolve(value);
+        };
+        const timer = setTimeout(() => finish(false), Math.min(timeoutMs, 30_000) + 5_000);
+        child.once('error', () => finish(false));
+        child.once('exit', () => finish(false));
+        child.stdout.setEncoding('utf8');
+        child.stdout.on('data', (chunk) => {
+            output += chunk;
+            if (output.includes(FLOCK_READY))
+                finish(true);
+        });
+    });
+    if (acquired)
+        return child;
+    child.kill();
+    return null;
+}
+async function releaseFlock(child) {
+    if (child.exitCode !== null)
+        return;
+    child.stdin.end();
+    await new Promise((resolve) => {
+        const timer = setTimeout(() => {
+            child.kill();
+            resolve();
+        }, 5_000);
+        child.once('exit', () => {
+            clearTimeout(timer);
+            resolve();
+        });
+    });
+}
+async function withPortableLease(options, operation) {
+    const controller = new AbortController();
+    let compromised = null;
+    const retryIntervalMs = 500;
+    const release = await lockfile.lock(options.target, {
+        realpath: true,
+        stale: 120_000,
+        update: 15_000,
+        retries: {
+            retries: Math.ceil(options.timeoutMs / retryIntervalMs),
+            factor: 1,
+            minTimeout: retryIntervalMs,
+            maxTimeout: retryIntervalMs,
+        },
+        onCompromised: (error) => {
+            compromised = error;
+            controller.abort(error);
+        },
+    });
+    try {
+        const result = await operation(controller.signal);
+        if (compromised)
+            throw compromised;
+        return result;
+    }
+    finally {
+        controller.abort();
+        await release();
+    }
+}
+function workerLockName(key) {
+    return `pyfig:${createHash('sha256').update(key).digest('hex')}`;
+}
+/** Create a canonical lock target below a configured cache directory. */
+export function cacheLockTarget(cacheDirectory, name) {
+    return path.join(cacheDirectory, 'locks', name);
+}
+//# sourceMappingURL=coordination.js.map

package/dist/coordination.js.map

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

package/dist/index.d.ts

@@ -1,7 +1,11 @@
-export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_VERSION, resolveOptions, } from './config.js';
-export type { PyfigOptions, ResolvedPyfigOptions } from './config.js';
-export { findPip, findPython, findUv, probePython, probeUv } from './probes.js';
-export type { PackageManagerInfo, PythonInfo, UvInfo } from './probes.js';
-export { ensureEnvironment, ensurePip, ensurePython } from './provision.js';
+export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_RANGE, DEFAULT_UV_VERSION, } from './config.js';
+export type { PyfigOptions } from './config.js';
+export { createPyfig } from './client.js';
+export type { PyfigClient } from './client.js';
+export { resolveProjectRoot } from './project-root.js';
+export type { PackageManagerInfo, PythonEmbeddingInfo, PythonInfo, UvInfo, } from './probes.js';
+export { ensureEnvironment, ensureUv, ensureVirtualEnvironment, } from './provision.js';
 export type { PythonEnvironment } from './provision.js';
+export { pipSpawn, pipSpawnSync, pythonSpawn, pythonSpawnSync, uvSpawn, uvSpawnSync, } from './runners.js';
+export { clearPyfigCaches } from './state.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACtE,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAChF,YAAY,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC5E,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,UAAU,EACV,MAAM,GACP,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,eAAe,EACf,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -1,4 +1,7 @@
-export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_VERSION, resolveOptions, } from './config.js';
-export { findPip, findPython, findUv, probePython, probeUv } from './probes.js';
-export { ensureEnvironment, ensurePip, ensurePython } from './provision.js';
+export { DEFAULT_MANAGED_PYTHON, DEFAULT_PIP_RANGE, DEFAULT_PYTHON_RANGE, DEFAULT_UV_RANGE, DEFAULT_UV_VERSION, } from './config.js';
+export { createPyfig } from './client.js';
+export { resolveProjectRoot } from './project-root.js';
+export { ensureEnvironment, ensureUv, ensureVirtualEnvironment, } from './provision.js';
+export { pipSpawn, pipSpawnSync, pythonSpawn, pythonSpawnSync, uvSpawn, uvSpawnSync, } from './runners.js';
+export { clearPyfigCaches } from './state.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEhF,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,EACtB,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAOvD,OAAO,EACL,iBAAiB,EACjB,QAAQ,EACR,wBAAwB,GACzB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACL,QAAQ,EACR,YAAY,EACZ,WAAW,EACX,eAAe,EACf,OAAO,EACP,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/package-target.d.ts

@@ -0,0 +1,12 @@
+import type { PackageManagerInfo, PythonInfo } from './probes.js';
+/** Reject package-manager arguments that can escape the selected repository venv. */
+export declare function assertSafePackageArguments(args: readonly string[]): void;
+/** Build a package-manager environment whose target cannot be inherited or configured elsewhere. */
+export declare function packageManagerEnvironment(env: NodeJS.ProcessEnv, packageManager: PackageManagerInfo): NodeJS.ProcessEnv;
+/** Apply the same strict target policy to a direct `uv pip` invocation. */
+export declare function uvPipEnvironment(env: NodeJS.ProcessEnv, python: PythonInfo): NodeJS.ProcessEnv;
+/** Package installation and removal must use uv so its target-environment lock is authoritative. */
+export declare function assertMutationUsesUv(packageManager: PackageManagerInfo, args: readonly string[]): void;
+export declare function isPackageMutation(args: readonly string[]): boolean;
+export declare function isUvPipCommand(args: readonly string[]): boolean;
+//# sourceMappingURL=package-target.d.ts.map

package/dist/package-target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-target.d.ts","sourceRoot":"","sources":["../src/package-target.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAkClE,qFAAqF;AACrF,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI,CAgBxE;AAED,oGAAoG;AACpG,wBAAgB,yBAAyB,CACvC,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,cAAc,EAAE,kBAAkB,GACjC,MAAM,CAAC,UAAU,CAmBnB;AAED,2EAA2E;AAC3E,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,MAAM,EAAE,UAAU,GACjB,MAAM,CAAC,UAAU,CAanB;AAED,oGAAoG;AACpG,wBAAgB,oBAAoB,CAClC,cAAc,EAAE,kBAAkB,EAClC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,IAAI,CAON;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAGlE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAI/D"}

package/dist/package-target.js

@@ -0,0 +1,97 @@
+import os from 'node:os';
+import { activateVirtualEnvironment } from './virtual-environment.js';
+const TARGET_CHANGING_OPTIONS = new Set([
+    '--config-file',
+    '--prefix',
+    '--python',
+    '--root',
+    '--system',
+    '--target',
+    '--user',
+]);
+const TARGET_CHANGING_SHORT_OPTIONS = new Set(['-p', '-t']);
+const TARGET_ENVIRONMENT_VARIABLES = new Set([
+    'CONDA_PREFIX',
+    'PIP_CONFIG_FILE',
+    'PIP_PREFIX',
+    'PIP_PYTHON',
+    'PIP_ROOT',
+    'PIP_TARGET',
+    'PIP_USER',
+    'PYTHONHOME',
+    'PYTHONUSERBASE',
+    'UV_CONFIG_FILE',
+    'UV_PROJECT_ENVIRONMENT',
+    'UV_PREFIX',
+    'UV_PYTHON',
+    'UV_ROOT',
+    'UV_SYSTEM_PYTHON',
+    'UV_TARGET',
+]);
+/** Reject package-manager arguments that can escape the selected repository venv. */
+export function assertSafePackageArguments(args) {
+    for (const argument of args) {
+        if (argument === '--')
+            break;
+        const [name] = argument.split('=', 1);
+        if (name && TARGET_CHANGING_OPTIONS.has(name)) {
+            throw new Error(`${name} is not allowed because Pyfig package commands are pinned to the repository .venv.`);
+        }
+        const shortName = argument.slice(0, 2);
+        if (TARGET_CHANGING_SHORT_OPTIONS.has(shortName)) {
+            throw new Error(`${shortName} is not allowed because Pyfig package commands are pinned to the repository .venv.`);
+        }
+    }
+}
+/** Build a package-manager environment whose target cannot be inherited or configured elsewhere. */
+export function packageManagerEnvironment(env, packageManager) {
+    const active = sanitizedTargetEnvironment(env);
+    const activated = activateVirtualEnvironment(active, packageManager.virtualEnvironment, packageManager.pythonExecutable);
+    return packageManager.kind === 'uv'
+        ? {
+            ...activated,
+            UV_NO_CONFIG: '1',
+            UV_PYTHON: packageManager.pythonExecutable,
+        }
+        : {
+            ...activated,
+            PIP_CONFIG_FILE: os.devNull,
+            PIP_REQUIRE_VIRTUALENV: '1',
+            PYTHONNOUSERSITE: '1',
+        };
+}
+/** Apply the same strict target policy to a direct `uv pip` invocation. */
+export function uvPipEnvironment(env, python) {
+    if (!python.virtualEnvironment) {
+        throw new Error('uv pip commands require the repository virtual environment.');
+    }
+    return {
+        ...activateVirtualEnvironment(sanitizedTargetEnvironment(env), python.virtualEnvironment, python.executable),
+        UV_NO_CONFIG: '1',
+        UV_PYTHON: python.executable,
+    };
+}
+/** Package installation and removal must use uv so its target-environment lock is authoritative. */
+export function assertMutationUsesUv(packageManager, args) {
+    if (packageManager.kind === 'pip' && isPackageMutation(args)) {
+        throw new Error('Package mutation requires uv so the repository environment is locked across processes. ' +
+            'Enable uv installation or use a read-only pip command.');
+    }
+}
+export function isPackageMutation(args) {
+    return args.some((argument) => argument === 'install' || argument === 'sync' || argument === 'uninstall');
+}
+export function isUvPipCommand(args) {
+    const separator = args.indexOf('--');
+    const commandArguments = separator === -1 ? args : args.slice(0, separator);
+    return commandArguments.includes('pip');
+}
+function sanitizedTargetEnvironment(env) {
+    const sanitized = { ...env };
+    for (const key of Object.keys(sanitized)) {
+        if (TARGET_ENVIRONMENT_VARIABLES.has(key.toUpperCase()))
+            delete sanitized[key];
+    }
+    return sanitized;
+}
+//# sourceMappingURL=package-target.js.map

package/dist/package-target.js.map

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

package/dist/probes.d.ts

@@ -2,11 +2,28 @@ import type { ResolvedPyfigOptions } from './config.js';
 import { type CommandSpec } from './process.js';
 export interface PythonInfo {
     executable: string;
+    baseExecutable: string;
     version: string;
     major: number;
     minor: number;
     patch: number;
+    releaseLevel: string;
+    implementation: string;
+    architecture: string;
+    pointerBits: number;
     prefix: string;
+    basePrefix: string;
+    virtualEnvironment: string | null;
+    gilDisabled: boolean;
+    embedding: PythonEmbeddingInfo | null;
+}
+export interface PythonEmbeddingInfo {
+    includeDirectory: string;
+    headerPath: string;
+    libraryPath: string;
+    libraryDirectory: string;
+    libraryName: string;
+    libraryKind: 'import' | 'shared' | 'static';
 }
 export interface PackageManagerInfo {
     kind: 'pip' | 'uv';
@@ -14,14 +31,24 @@ export interface PackageManagerInfo {
     prefixArgs: string[];
     version: string;
     pythonExecutable: string;
+    virtualEnvironment: string;
 }
 export interface UvInfo {
     executable: string;
     version: string;
 }
 export declare function findPython(options: ResolvedPyfigOptions): Promise<PythonInfo | null>;
+export declare function pythonSatisfiesRequirements(python: PythonInfo, options: Pick<ResolvedPyfigOptions, 'pythonRange' | 'requireEmbedding' | 'requireGil'>): boolean;
 export declare function probePython(candidate: CommandSpec, options: ResolvedPyfigOptions): Promise<PythonInfo | null>;
 export declare function findPip(python: PythonInfo, options: ResolvedPyfigOptions): Promise<PackageManagerInfo | null>;
+export interface PipVersionDetails {
+    version: string;
+    location: string;
+    pythonMajor: number;
+    pythonMinor: number;
+}
+export declare function parsePipVersionOutput(output: string): PipVersionDetails | null;
+export declare function pipBelongsToPython(pip: PipVersionDetails, python: PythonInfo): boolean;
 export declare function findUv(options: ResolvedPyfigOptions): Promise<UvInfo | null>;
 export declare function probeUv(executable: string, options: ResolvedPyfigOptions): UvInfo | null;
 //# sourceMappingURL=probes.d.ts.map