@vibesdotdev/pm 0.0.0-stage → 1.0.0-rc.3

package/dist/helpers/process-env.d.ts

@@ -0,0 +1,72 @@
+/**
+ * PM's layers over the kernel's child environment (rc02-rc03 C15).
+ *
+ * The kernel composes the child environment (`composeChildEnv` in
+ * `@vibesdotdev/kernel`): the host set (base allowlist, the host's re-entry
+ * facts, the handed runtime's roots), then the host variables the descriptor
+ * names in `inheritEnv`, then its declared `env`. PM adds only its own layers:
+ *   1. `.env` / `.env.local` from the child's cwd, beneath the declared `env`
+ *      (host < inheritEnv < .env < declared);
+ *   2. the PATH repair: the essential system directories and the directory of
+ *      the executable running this host (the 2026-09-02 fix), from the platform
+ *      and executable identity the handed runtime's environment captured,
+ *      applied to the final PATH so no layer can drop it;
+ *   3. `PWD` from the child's cwd unless declared.
+ *
+ * Rule-1 record: the `.env` layer loads configuration outside the runtime
+ * kernel. It stays for one slice (C15); RC04 moves it (settings to the config
+ * manifest, credentials to the secrets store) with its consumers.
+ */
+import { type ChildEnvDeclaration, type ChildEnvRuntime, type RuntimeEnvironmentImplementation, type RuntimeRef } from '@vibesdotdev/kernel';
+import * as z from 'zod/v4';
+declare const EnvEntriesSchema: z.ZodRecord<z.ZodString, z.ZodString>;
+/** Variable names to their text values: one `.env` file, or the composed child environment. */
+type EnvEntries = z.infer<typeof EnvEntriesSchema>;
+/**
+ * What PM's layers read from the runtime it was handed: the kernel composer's
+ * facts, plus the executable identity its environment captured (the PATH
+ * repair's interpreter directory).
+ */
+export type PMChildEnvRuntime = ChildEnvRuntime & {
+    readonly localEnvironment: Pick<RuntimeEnvironmentImplementation, 'getPlatform' | 'hostIdentity'>;
+};
+/**
+ * A PM runtime that also answers the filesystem and path kinds: what the PATH
+ * repair's node preference and the `.env` layer read through.
+ */
+export type PMResolvedEnvRuntime = PMChildEnvRuntime & RuntimeRef;
+/** A PM child's declaration: the kernel's, plus the cwd PM's `.env` and `PWD` layers read. */
+export interface PMChildEnvDeclaration extends ChildEnvDeclaration {
+    /** The child's working directory: its `.env` files load from here, and it is the child's `PWD`. */
+    cwd?: string;
+}
+/**
+ * The kernel's host set with PM's PATH repair, without the node preference.
+ *
+ * @deprecated Synchronous callers (the daemon launch and the freshness
+ * handoff) lose the preference of an external node over Codex's bundled one;
+ * use {@link resolvePMHostEnv}.
+ */
+export declare function composePMHostEnv(runtime: PMChildEnvRuntime): Record<string, string>;
+/**
+ * The kernel's host set with PM's PATH repair: the whole environment of a PM
+ * daemon launch and of the freshness handoff.
+ */
+export declare function resolvePMHostEnv(runtime: PMResolvedEnvRuntime): Promise<Record<string, string>>;
+/**
+ * The environment of a tool PM runs for itself (`ps`, `kubectl`, `docker`):
+ * the kernel's composition (host set, the host variables the call names, its
+ * declared env) with PM's PATH repair. No `.env` layer: a tool is not a
+ * managed child of a workspace.
+ */
+export declare function resolvePMToolEnv(runtime: PMResolvedEnvRuntime, declaration?: ChildEnvDeclaration): Promise<Record<string, string>>;
+/**
+ * A managed child's whole environment: the kernel's composition (host set,
+ * `inheritEnv`, declared `env`), then PM's layers: `.env` beneath the declared
+ * keys, the PATH repair, and `PWD`.
+ */
+export declare function composePMChildEnv(runtime: PMResolvedEnvRuntime, declaration: PMChildEnvDeclaration): Promise<Record<string, string>>;
+/** (e) `.env` then `.env.local` of `workspaceDir` (recorded rule-1 violation; RC04 moves it). */
+export declare function loadWorkspaceEnv(runtime: PMResolvedEnvRuntime, workspaceDir: string): Promise<EnvEntries>;
+export {};
+//# sourceMappingURL=process-env.d.ts.map

package/dist/helpers/process-env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-env.d.ts","sourceRoot":"","sources":["../../src/helpers/process-env.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAIN,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,gCAAgC,EACrC,KAAK,UAAU,EACf,MAAM,qBAAqB,CAAC;AAE7B,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAK5B,QAAA,MAAM,gBAAgB,uCAAmC,CAAC;AAC1D,+FAA+F;AAC/F,KAAK,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAGnD;;;;GAIG;AACH,MAAM,MAAM,iBAAiB,GAAG,eAAe,GAAG;IACjD,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,gCAAgC,EAAE,aAAa,GAAG,cAAc,CAAC,CAAC;CAClG,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,iBAAiB,GAAG,UAAU,CAAC;AAiBlE,8FAA8F;AAC9F,MAAM,WAAW,qBAAsB,SAAQ,mBAAmB;IACjE,mGAAmG;IACnG,GAAG,CAAC,EAAE,MAAM,CAAC;CACb;AA+HD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAInF;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIrG;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACrC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,GAAE,mBAAwB,GACnC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAIjC;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACtC,OAAO,EAAE,oBAAoB,EAC7B,WAAW,EAAE,qBAAqB,GAChC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAejC;AAyDD,iGAAiG;AACjG,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAQ/G"}

package/dist/helpers/process-env.js

@@ -0,0 +1,265 @@
+/**
+ * PM's layers over the kernel's child environment (rc02-rc03 C15).
+ *
+ * The kernel composes the child environment (`composeChildEnv` in
+ * `@vibesdotdev/kernel`): the host set (base allowlist, the host's re-entry
+ * facts, the handed runtime's roots), then the host variables the descriptor
+ * names in `inheritEnv`, then its declared `env`. PM adds only its own layers:
+ *   1. `.env` / `.env.local` from the child's cwd, beneath the declared `env`
+ *      (host < inheritEnv < .env < declared);
+ *   2. the PATH repair: the essential system directories and the directory of
+ *      the executable running this host (the 2026-09-02 fix), from the platform
+ *      and executable identity the handed runtime's environment captured,
+ *      applied to the final PATH so no layer can drop it;
+ *   3. `PWD` from the child's cwd unless declared.
+ *
+ * Rule-1 record: the `.env` layer loads configuration outside the runtime
+ * kernel. It stays for one slice (C15); RC04 moves it (settings to the config
+ * manifest, credentials to the secrets store) with its consumers.
+ */
+import { CapabilityError, composeChildEnv, composeHostEnv } from '@vibesdotdev/kernel';
+import { getRuntimePath } from '@vibesdotdev/paths';
+import * as z from 'zod/v4';
+import { preferExternalNodePath } from "./node-path.js";
+import { pmFileSystem, readTextFileIfPresent } from "./runtime-files.js";
+const ENV_FILES = ['.env', '.env.local'];
+const EnvEntriesSchema = z.record(z.string(), z.string());
+const ENV_KEY_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
+/**
+ * The key under which `env` holds `name`, by the host platform's key policy
+ * (the kernel composer's: case-insensitive on win32), so a PM layer replaces a
+ * variable in whatever spelling the composer produced and never adds a second.
+ */
+function keyFor(env, name, platform) {
+    if (platform !== 'win32')
+        return name;
+    const upper = name.toUpperCase();
+    return Object.keys(env).find((key) => key.toUpperCase() === upper) ?? name;
+}
+function sameVariable(a, b, platform) {
+    return platform === 'win32' ? a.toUpperCase() === b.toUpperCase() : a === b;
+}
+function hostPathFacts(runtime) {
+    const platform = runtime.localEnvironment.getPlatform?.();
+    const execPath = runtime.localEnvironment.hostIdentity?.()?.execPath;
+    if (!platform || !execPath) {
+        throw new CapabilityError('A PM child PATH needs the host platform and executable, and this host environment declares ' +
+            (!platform ? 'no platform.' : 'no executable identity.'), 'UNAVAILABLE', { reason: !platform ? 'host-platform-undeclared' : 'host-identity-undeclared', retryable: false });
+    }
+    return { platform, execPath };
+}
+/**
+ * Essential system PATH directories, appended when missing so a daemon started
+ * from a stripped PATH (a GUI launcher, launchd, an IDE) still finds `bun`,
+ * `docker` and friends. The directory of the executable running this host
+ * always leads the appended set (the 2026-09-02 incident: a preBuild hook's
+ * `posix_spawn 'bun'` ENOENT killed the daemon and every managed process).
+ */
+function essentialPathDirs(host, env, runningInterpreterDir) {
+    const windows = host.platform === 'win32';
+    if (windows) {
+        const sysRoot = env.SystemRoot || 'C:\\Windows';
+        const progFiles = env.ProgramFiles || 'C:\\Program Files';
+        const progFilesX86 = env['ProgramFiles(x86)'] || 'C:\\Program Files (x86)';
+        const localAppData = env.LOCALAPPDATA || '';
+        const userProfile = env.USERPROFILE || env.HOME || '';
+        return [
+            runningInterpreterDir,
+            `${sysRoot}\\System32`,
+            `${sysRoot}`,
+            `${sysRoot}\\System32\\Wbem`,
+            `${sysRoot}\\System32\\WindowsPowerShell\\v1.0`,
+            `${progFiles}\\Git\\cmd`,
+            `${progFiles}\\Git\\usr\\bin`,
+            `${progFiles}\\Git\\bin`,
+            `${progFilesX86}\\Git\\cmd`,
+            `${progFilesX86}\\Git\\usr\\bin`,
+            `${progFilesX86}\\Git\\bin`,
+            `${progFiles}\\Docker\\Docker\\resources\\bin`,
+            `${progFiles}\\Docker\\Docker\\resources`,
+            ...(localAppData
+                ? [
+                    `${localAppData}\\Microsoft\\WindowsApps`,
+                    `${localAppData}\\Programs\\Git\\cmd`,
+                    `${localAppData}\\Programs\\Git\\usr\\bin`,
+                    `${localAppData}\\Programs\\Git\\bin`
+                ]
+                : []),
+            ...(userProfile
+                ? [`${userProfile}\\.bun\\bin`, `${userProfile}\\.cargo\\bin`, `${userProfile}\\scoop\\shims`]
+                : []),
+            `${progFiles}\\nodejs`,
+            `${progFilesX86}\\nodejs`
+        ];
+    }
+    const dirs = [runningInterpreterDir, '/usr/local/bin', '/usr/bin', '/bin', '/usr/sbin', '/sbin'];
+    if (host.platform === 'darwin')
+        dirs.push('/opt/homebrew/bin', '/opt/homebrew/sbin');
+    else
+        dirs.push('/snap/bin', '/home/linuxbrew/.linuxbrew/bin');
+    // User toolchains install here by default and are often the only place these binaries live.
+    const home = env.HOME;
+    if (home)
+        dirs.push(`${home}/.bun/bin`, `${home}/.deno/bin`, `${home}/.cargo/bin`);
+    return dirs;
+}
+/** The child's PATH with every essential directory appended when missing; its own entries keep precedence. */
+function appendEssentialDirs(host, env, interpreterDir) {
+    const pathKey = keyFor(env, 'PATH', host.platform);
+    const windows = host.platform === 'win32';
+    const sep = windows ? ';' : ':';
+    const parts = (env[pathKey] || '').split(sep).filter(Boolean);
+    const seen = new Set(windows ? parts.map((part) => part.toLowerCase()) : parts);
+    for (const dir of essentialPathDirs(host, env, interpreterDir)) {
+        const key = windows ? dir.toLowerCase() : dir;
+        if (!seen.has(key)) {
+            parts.push(dir);
+            seen.add(key);
+        }
+    }
+    return parts.join(sep);
+}
+/** The child's PATH repaired, and a node preferred over Codex's bundled one, through the handed runtime's filesystem and paths. */
+async function repairPath(runtime, env) {
+    const host = hostPathFacts(runtime);
+    const path = await getRuntimePath(runtime);
+    const repaired = appendEssentialDirs(host, env, path.dirname(host.execPath));
+    return preferExternalNodePath(runtime, repaired, { platform: host.platform, home: env.HOME });
+}
+/** The directory of `execPath` under the declared platform's separators (a pure string fact). */
+function parentDirectory(platform, execPath) {
+    const last = platform === 'win32' ? Math.max(execPath.lastIndexOf('\\'), execPath.lastIndexOf('/')) : execPath.lastIndexOf('/');
+    if (last < 0)
+        return '.';
+    if (last === 0)
+        return execPath.slice(0, 1);
+    if (platform === 'win32' && last === 2 && execPath[1] === ':')
+        return execPath.slice(0, 3);
+    return execPath.slice(0, last);
+}
+/**
+ * The PATH repair without the node preference, which needs the runtime's
+ * filesystem and so is asynchronous. Kept for the synchronous
+ * {@link composePMHostEnv} callers until they switch to {@link resolvePMHostEnv}.
+ */
+function repairPathWithoutNodePreference(runtime, env) {
+    const host = hostPathFacts(runtime);
+    return appendEssentialDirs(host, env, parentDirectory(host.platform, host.execPath));
+}
+/**
+ * The kernel's host set with PM's PATH repair, without the node preference.
+ *
+ * @deprecated Synchronous callers (the daemon launch and the freshness
+ * handoff) lose the preference of an external node over Codex's bundled one;
+ * use {@link resolvePMHostEnv}.
+ */
+export function composePMHostEnv(runtime) {
+    const env = composeHostEnv(runtime);
+    env[keyFor(env, 'PATH', hostPathFacts(runtime).platform)] = repairPathWithoutNodePreference(runtime, env);
+    return env;
+}
+/**
+ * The kernel's host set with PM's PATH repair: the whole environment of a PM
+ * daemon launch and of the freshness handoff.
+ */
+export async function resolvePMHostEnv(runtime) {
+    const env = composeHostEnv(runtime);
+    env[keyFor(env, 'PATH', hostPathFacts(runtime).platform)] = await repairPath(runtime, env);
+    return env;
+}
+/**
+ * The environment of a tool PM runs for itself (`ps`, `kubectl`, `docker`):
+ * the kernel's composition (host set, the host variables the call names, its
+ * declared env) with PM's PATH repair. No `.env` layer: a tool is not a
+ * managed child of a workspace.
+ */
+export async function resolvePMToolEnv(runtime, declaration = {}) {
+    const env = composeChildEnv(runtime, { env: declaration.env, inheritEnv: declaration.inheritEnv });
+    env[keyFor(env, 'PATH', hostPathFacts(runtime).platform)] = await repairPath(runtime, env);
+    return env;
+}
+/**
+ * A managed child's whole environment: the kernel's composition (host set,
+ * `inheritEnv`, declared `env`), then PM's layers: `.env` beneath the declared
+ * keys, the PATH repair, and `PWD`.
+ */
+export async function composePMChildEnv(runtime, declaration) {
+    const { platform } = hostPathFacts(runtime);
+    const env = composeChildEnv(runtime, { env: declaration.env, inheritEnv: declaration.inheritEnv });
+    const declared = Object.entries(declaration.env ?? {})
+        .filter(([, value]) => value !== undefined)
+        .map(([key]) => key);
+    const isDeclared = (name) => declared.some((key) => sameVariable(key, name, platform));
+    if (declaration.cwd) {
+        for (const [key, value] of Object.entries(await loadWorkspaceEnv(runtime, declaration.cwd))) {
+            if (!isDeclared(key))
+                env[keyFor(env, key, platform)] = value;
+        }
+    }
+    env[keyFor(env, 'PATH', platform)] = await repairPath(runtime, env);
+    if (declaration.cwd && !isDeclared('PWD'))
+        env[keyFor(env, 'PWD', platform)] = declaration.cwd;
+    return env;
+}
+function parseEnvValue(rawValue) {
+    const value = rawValue.trim();
+    if (value.length === 0)
+        return '';
+    if (value.startsWith('"') && value.endsWith('"')) {
+        return value
+            .slice(1, -1)
+            .replace(/\\n/g, '\n')
+            .replace(/\\r/g, '\r')
+            .replace(/\\t/g, '\t')
+            .replace(/\\"/g, '"')
+            .replace(/\\\\/g, '\\');
+    }
+    if (value.startsWith("'") && value.endsWith("'")) {
+        return value.slice(1, -1);
+    }
+    const commentIndex = value.search(/\s+#/);
+    if (commentIndex === -1)
+        return value;
+    return value.slice(0, commentIndex).trimEnd();
+}
+function parseEnvLine(line) {
+    const trimmedLine = line.trim();
+    if (trimmedLine.length === 0 || trimmedLine.startsWith('#'))
+        return null;
+    const withoutExport = trimmedLine.startsWith('export ')
+        ? trimmedLine.slice('export '.length).trimStart()
+        : trimmedLine;
+    const separatorIndex = withoutExport.indexOf('=');
+    if (separatorIndex <= 0)
+        return null;
+    const key = withoutExport.slice(0, separatorIndex).trim();
+    if (!ENV_KEY_PATTERN.test(key))
+        return null;
+    const rawValue = withoutExport.slice(separatorIndex + 1);
+    return [key, parseEnvValue(rawValue)];
+}
+function parseEnvContent(content) {
+    const parsed = {};
+    for (const line of content.split(/\r?\n/)) {
+        const entry = parseEnvLine(line);
+        if (entry)
+            parsed[entry[0]] = entry[1];
+    }
+    return parsed;
+}
+/** One `.env` file's entries; a missing file is empty, and any other read failure propagates. */
+async function loadEnvFile(files, filePath) {
+    const content = await readTextFileIfPresent(files, filePath);
+    return content === undefined ? {} : parseEnvContent(content);
+}
+/** (e) `.env` then `.env.local` of `workspaceDir` (recorded rule-1 violation; RC04 moves it). */
+export async function loadWorkspaceEnv(runtime, workspaceDir) {
+    const files = await pmFileSystem(runtime);
+    const path = await getRuntimePath(runtime);
+    let env = {};
+    for (const envFile of ENV_FILES) {
+        env = { ...env, ...(await loadEnvFile(files, path.join(workspaceDir, envFile))) };
+    }
+    return env;
+}
+//# sourceMappingURL=process-env.js.map

package/dist/helpers/process-env.js.map

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

package/dist/helpers/process-watch.d.ts

@@ -0,0 +1,7 @@
+import { type RuntimePath } from '@vibesdotdev/paths';
+/** Directory names ignored by both local and runtime-selected process watches. */
+export declare const DEFAULT_PROCESS_WATCH_IGNORE: string[];
+export declare function processWatchBaseDir(path: RuntimePath, pattern: string, cwd: string): string;
+/** Preserve PM's extension matching and segment-aware directory exclusions. */
+export declare function matchesProcessWatch(filename: string, pattern: string, ignores: readonly string[]): boolean;
+//# sourceMappingURL=process-watch.d.ts.map

package/dist/helpers/process-watch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-watch.d.ts","sourceRoot":"","sources":["../../src/helpers/process-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAE7E,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,UAGxC,CAAC;AAEF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3F;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAO1G"}

package/dist/helpers/process-watch.js

@@ -0,0 +1,27 @@
+import { PROJECT_STATE_DIRNAME } from '@vibesdotdev/paths';
+/** Directory names ignored by both local and runtime-selected process watches. */
+export const DEFAULT_PROCESS_WATCH_IGNORE = [
+    'node_modules', '.git', PROJECT_STATE_DIRNAME, '.svelte-kit', 'dist', 'build',
+    'coverage', 'zig-cache', 'zig-out', '.zig-cache'
+];
+export function processWatchBaseDir(path, pattern, cwd) {
+    const segments = [];
+    for (const segment of pattern.split('/')) {
+        if (segment.includes('*') || segment.includes('?') || segment.includes('['))
+            break;
+        segments.push(segment);
+    }
+    return path.join(cwd, segments.length ? segments.join('/') : '.');
+}
+/** Preserve PM's extension matching and segment-aware directory exclusions. */
+export function matchesProcessWatch(filename, pattern, ignores) {
+    const segments = filename.split(/[\\/]+/);
+    if (ignores.some(ignore => segments.includes(ignore)))
+        return false;
+    const extension = pattern.match(/\*(\.[a-zA-Z0-9]+)$/)?.[1];
+    if (extension)
+        return filename.endsWith(extension);
+    const patternExtension = pattern.split('.').pop();
+    return !patternExtension || patternExtension.includes('*') || filename.endsWith(`.${patternExtension}`);
+}
+//# sourceMappingURL=process-watch.js.map

package/dist/helpers/process-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-watch.js","sourceRoot":"","sources":["../../src/helpers/process-watch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAoB,MAAM,oBAAoB,CAAC;AAE7E,kFAAkF;AAClF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC3C,cAAc,EAAE,MAAM,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO;IAC7E,UAAU,EAAE,WAAW,EAAE,SAAS,EAAE,YAAY;CAChD,CAAC;AAEF,MAAM,UAAU,mBAAmB,CAAC,IAAiB,EAAE,OAAe,EAAE,GAAW;IAClF,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1C,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,MAAM;QACnF,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CAAC,QAAgB,EAAE,OAAe,EAAE,OAA0B;IAChG,MAAM,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC1C,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACpE,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,qBAAqB,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,SAAS;QAAE,OAAO,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC;IAClD,OAAO,CAAC,gBAAgB,IAAI,gBAAgB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,IAAI,gBAAgB,EAAE,CAAC,CAAC;AACzG,CAAC"}

package/dist/helpers/rlimits.d.ts

@@ -0,0 +1,10 @@
+import type { HostServicesRuntime } from '../utils/process-tree.ts';
+export declare const RECOMMENDED_NOFILE = 65536;
+export declare const MIN_ACCEPTABLE_NOFILE = 8192;
+/**
+ * The host's open-file limit. Null only when the host has none to report
+ * (win32); a probe that cannot run throws typed, and callers decide.
+ */
+export declare function readFileDescriptorLimit(runtime: HostServicesRuntime): Promise<number | null>;
+export declare function fileDescriptorLimitRemediation(current: number): string;
+//# sourceMappingURL=rlimits.d.ts.map

package/dist/helpers/rlimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlimits.d.ts","sourceRoot":"","sources":["../../src/helpers/rlimits.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,eAAO,MAAM,kBAAkB,QAAQ,CAAC;AACxC,eAAO,MAAM,qBAAqB,OAAO,CAAC;AAC1C;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAElG;AACD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEtE"}

package/dist/helpers/rlimits.js

@@ -0,0 +1,14 @@
+import { getRuntimeProcessService } from '@vibesdotdev/kernel/process';
+export const RECOMMENDED_NOFILE = 65536;
+export const MIN_ACCEPTABLE_NOFILE = 8192;
+/**
+ * The host's open-file limit. Null only when the host has none to report
+ * (win32); a probe that cannot run throws typed, and callers decide.
+ */
+export async function readFileDescriptorLimit(runtime) {
+    return (await getRuntimeProcessService(runtime)).fileDescriptorLimit();
+}
+export function fileDescriptorLimitRemediation(current) {
+    return `File descriptor limit is ${current}; recommended ${RECOMMENDED_NOFILE}. Restart through vibes pm daemon restart to apply the host's child resource budget.`;
+}
+//# sourceMappingURL=rlimits.js.map

package/dist/helpers/rlimits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rlimits.js","sourceRoot":"","sources":["../../src/helpers/rlimits.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,wBAAwB,EAAE,MAAM,6BAA6B,CAAC;AACvE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,CAAC;AACxC,MAAM,CAAC,MAAM,qBAAqB,GAAG,IAAI,CAAC;AAC1C;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,OAA4B;IACzE,OAAO,CAAC,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,mBAAmB,EAAE,CAAC;AACxE,CAAC;AACD,MAAM,UAAU,8BAA8B,CAAC,OAAe;IAC7D,OAAO,4BAA4B,OAAO,iBAAiB,kBAAkB,sFAAsF,CAAC;AACrK,CAAC"}

package/dist/helpers/runtime-files.d.ts

@@ -0,0 +1,42 @@
+import { type RuntimeRef } from '@vibesdotdev/kernel';
+import type { FileSystemAdapterInterface } from '@vibesdotdev/filesystem/interfaces/adapter';
+import type { FileSystemStat } from '@vibesdotdev/filesystem/schemas/adapter-descriptor';
+export type PMFileSystem = FileSystemAdapterInterface;
+/** The host filesystem adapter the runtime resolves for its scope. */
+export declare function pmFileSystem(runtime: RuntimeRef): Promise<PMFileSystem>;
+/** The file's text. */
+export declare function readTextFile(files: PMFileSystem, path: string): Promise<string>;
+/** The file's bytes. */
+export declare function readBytesFile(files: PMFileSystem, path: string): Promise<Uint8Array>;
+/** The file's text, or `undefined` when the file does not exist; any other failure propagates. */
+export declare function readTextFileIfPresent(files: PMFileSystem, path: string): Promise<string | undefined>;
+/** The file's bytes, or `undefined` when the file does not exist; any other failure propagates. */
+export declare function readBytesFileIfPresent(files: PMFileSystem, path: string): Promise<Uint8Array | undefined>;
+/** The byte size of the file, or `undefined` when it does not exist; any other failure propagates. */
+export declare function statSizeIfPresent(files: PMFileSystem, path: string): Promise<number | undefined>;
+/**
+ * Bytes `[from, to)` of a file through the filesystem kind's ranged read, in
+ * slices no larger than one ranged read allows, so only the asked-for range is
+ * ever held. A file that shrank under the read answers what is still there.
+ */
+export declare function readByteRange(files: PMFileSystem, path: string, from: number, to: number): Promise<Uint8Array>;
+/**
+ * Where `path` resolves through the filesystem kind's `realpath`: the canonical
+ * form of its deepest existing ancestor (`resolved`) and the names below it
+ * that do not exist (`absent`, as written). A symbolic link loop is
+ * `INVALID_INPUT pm-symlink-loop`; any other failure propagates, an adapter
+ * without `realpath` refusing typed.
+ */
+export declare function resolveExistingPrefix(files: PMFileSystem, path: string): Promise<{
+    resolved: string;
+    absent: string[];
+}>;
+/**
+ * What `path` is after following symbolic links (a link to a directory is a
+ * directory), or `undefined` when nothing is there: a missing path, a parent
+ * that is not a directory, or a link to nothing. Any other failure propagates.
+ */
+export declare function statFollowingLinks(files: PMFileSystem, path: string): Promise<FileSystemStat | undefined>;
+/** The entry names of a directory in sorted order, or `undefined` when it does not exist; any other failure propagates. */
+export declare function listNamesIfPresent(files: PMFileSystem, directory: string): Promise<string[] | undefined>;
+//# sourceMappingURL=runtime-files.d.ts.map

package/dist/helpers/runtime-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-files.d.ts","sourceRoot":"","sources":["../../src/helpers/runtime-files.ts"],"names":[],"mappings":"AAOA,OAAO,EAA2D,KAAK,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAI/G,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,4CAA4C,CAAC;AAC7F,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oDAAoD,CAAC;AAKzF,MAAM,MAAM,YAAY,GAAG,0BAA0B,CAAC;AAEtD,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,OAAO,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC,CAEvE;AAKD,uBAAuB;AACvB,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAErF;AAED,wBAAwB;AACxB,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAE1F;AAED,kGAAkG;AAClG,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ1G;AAED,mGAAmG;AACnG,wBAAsB,sBAAsB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,SAAS,CAAC,CAK/G;AAED,sGAAsG;AACtG,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAKtG;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAmBpH;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CAoB9H;AAKD;;;;GAIG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAmB/G;AAED,2HAA2H;AAC3H,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,CAK9G"}

package/dist/helpers/runtime-files.js

@@ -0,0 +1,155 @@
+/**
+ * PM's reads of the host filesystem, through the handed runtime's
+ * `filesystem/adapter` kind (the unbound host adapter: PM's files are host
+ * facts at absolute paths, never workspace-relative content). Only a file that
+ * is not there (`ENOENT`) is absence; every other failure propagates.
+ */
+import * as z from 'zod/v4';
+import { CapabilityError, CaughtFailureSchema, isCapabilityError } from '@vibesdotdev/kernel';
+import { resolveFileSystemAdapter } from '@vibesdotdev/filesystem/client/resolve-adapter';
+import { readFileRangeChecked, realpathChecked } from '@vibesdotdev/filesystem/core';
+import { FILESYSTEM_READ_RANGE_MAX_BYTES } from '@vibesdotdev/filesystem/schemas/operations';
+import { attempt } from "../utils/attempt.js";
+import { hasErrnoCode } from "../utils/errno-failure.js";
+import { hasErrno, rethrowFailure } from "./failure.js";
+/** The host filesystem adapter the runtime resolves for its scope. */
+export function pmFileSystem(runtime) {
+    return resolveFileSystemAdapter(runtime, { binding: false });
+}
+const TextSchema = z.string();
+const BytesSchema = z.instanceof(Uint8Array);
+/** The file's text. */
+export async function readTextFile(files, path) {
+    return TextSchema.parse(await files.readFile(path, 'utf-8'));
+}
+/** The file's bytes. */
+export async function readBytesFile(files, path) {
+    return BytesSchema.parse(await files.readFile(path));
+}
+/** The file's text, or `undefined` when the file does not exist; any other failure propagates. */
+export async function readTextFileIfPresent(files, path) {
+    try {
+        return await readTextFile(files, path);
+    }
+    catch (error) {
+        const failure = CaughtFailureSchema.parse(error);
+        if (hasErrnoCode(failure) && failure.code === 'ENOENT')
+            return undefined;
+        throw error;
+    }
+}
+/** The file's bytes, or `undefined` when the file does not exist; any other failure propagates. */
+export async function readBytesFileIfPresent(files, path) {
+    const read = await attempt(() => readBytesFile(files, path));
+    if (read.ok)
+        return read.value;
+    if (hasErrno(read.failure, 'ENOENT'))
+        return undefined;
+    return rethrowFailure(read.failure);
+}
+/** The byte size of the file, or `undefined` when it does not exist; any other failure propagates. */
+export async function statSizeIfPresent(files, path) {
+    const read = await attempt(() => files.stat(path));
+    if (read.ok)
+        return read.value.size;
+    if (hasErrno(read.failure, 'ENOENT'))
+        return undefined;
+    return rethrowFailure(read.failure);
+}
+/**
+ * Bytes `[from, to)` of a file through the filesystem kind's ranged read, in
+ * slices no larger than one ranged read allows, so only the asked-for range is
+ * ever held. A file that shrank under the read answers what is still there.
+ */
+export async function readByteRange(files, path, from, to) {
+    const parts = [];
+    let offset = from;
+    while (offset < to) {
+        const chunk = await readFileRangeChecked(files, path, {
+            offset,
+            length: Math.min(FILESYSTEM_READ_RANGE_MAX_BYTES, to - offset)
+        });
+        if (chunk.length === 0)
+            break;
+        parts.push(chunk);
+        offset += chunk.length;
+    }
+    const bytes = new Uint8Array(parts.reduce((total, part) => total + part.length, 0));
+    let at = 0;
+    for (const part of parts) {
+        bytes.set(part, at);
+        at += part.length;
+    }
+    return bytes;
+}
+/**
+ * Where `path` resolves through the filesystem kind's `realpath`: the canonical
+ * form of its deepest existing ancestor (`resolved`) and the names below it
+ * that do not exist (`absent`, as written). A symbolic link loop is
+ * `INVALID_INPUT pm-symlink-loop`; any other failure propagates, an adapter
+ * without `realpath` refusing typed.
+ */
+export async function resolveExistingPrefix(files, path) {
+    let existing = files.resolve(path);
+    const absent = [];
+    for (;;) {
+        const real = await attempt(() => realpathChecked(files, existing));
+        if (real.ok)
+            return { resolved: real.value, absent };
+        if (isCapabilityError(real.failure) && real.failure.details?.errno === 'ELOOP') {
+            throw new CapabilityError(`Too many levels of symbolic links at '${path}'.`, 'INVALID_INPUT', {
+                reason: 'pm-symlink-loop',
+                retryable: false,
+                details: { path }
+            });
+        }
+        // A path that is not there (or whose parent is not a directory) is absence, as far as it goes.
+        if (!isCapabilityError(real.failure) || real.failure.code !== 'NOT_FOUND')
+            return rethrowFailure(real.failure);
+        const parent = files.dirname(existing);
+        if (parent === existing)
+            return { resolved: existing, absent };
+        absent.unshift(files.basename(existing));
+        existing = parent;
+    }
+}
+/** The most symbolic links one path is followed through before it is refused as a loop. */
+const MAX_LINK_HOPS = 40;
+/**
+ * What `path` is after following symbolic links (a link to a directory is a
+ * directory), or `undefined` when nothing is there: a missing path, a parent
+ * that is not a directory, or a link to nothing. Any other failure propagates.
+ */
+export async function statFollowingLinks(files, path) {
+    let current = path;
+    for (let hop = 0; hop < MAX_LINK_HOPS; hop += 1) {
+        if (!(await files.exists(current)))
+            return undefined;
+        const read = await attempt(() => files.stat(current));
+        if (!read.ok) {
+            // Removed between the existence check and the read: absent.
+            if (hasErrno(read.failure, 'ENOENT'))
+                return undefined;
+            return rethrowFailure(read.failure);
+        }
+        const stat = read.value;
+        if (stat.kind !== 'symlink' || stat.symlinkTarget === undefined)
+            return stat;
+        current = files.resolve(files.dirname(current), stat.symlinkTarget);
+    }
+    throw new CapabilityError(`Too many levels of symbolic links at '${path}'.`, 'INVALID_INPUT', {
+        reason: 'pm-symlink-loop',
+        retryable: false,
+        details: { path }
+    });
+}
+/** The entry names of a directory in sorted order, or `undefined` when it does not exist; any other failure propagates. */
+export async function listNamesIfPresent(files, directory) {
+    const listed = await attempt(() => files.list(directory));
+    if (listed.ok)
+        return listed.value.map((entry) => entry.name).sort();
+    if (hasErrno(listed.failure, 'ENOENT'))
+        return undefined;
+    return rethrowFailure(listed.failure);
+}
+//# sourceMappingURL=runtime-files.js.map