@vibesdotdev/host-bun 0.0.0-stage → 1.0.0-rc.3

package/dist/atlas-migrations/register-atlas-host-migrations.js

@@ -0,0 +1,148 @@
+/**
+ * Bun host registration for Atlas SQL migrations.
+ *
+ * The Atlas package declares kind `workspace/atlas-migrations`, descriptor id
+ * `workspace.atlas-migrations`. This module resolves that descriptor through
+ * the handed runtime and registers its embedded SQL with localdb. The host
+ * imports the owner schema from
+ * `@vibesdotdev/workspace-schemas/atlas/migrations` and does not import
+ * Workspace's implementation package. The module URL and SQL directory URL are
+ * location facts for the owner; this wiring does not read them.
+ */
+import { isMigrationNamespaceRegistered, localdb, migrationRegistry } from '@vibesdotdev/localdb';
+import { parseMigrationName, parseVersionFromFilename } from '@vibesdotdev/localdb/migrations/load-sql';
+import { getLogger } from '@vibesdotdev/logging';
+import { CapabilityError, isCapabilityError, settleNow, valueFreeFailure } from '@vibesdotdev/kernel';
+import { ATLAS_MIGRATIONS_ID, ATLAS_MIGRATIONS_KIND, AtlasMigrationsDescriptorSchema } from '@vibesdotdev/workspace-schemas/atlas/migrations';
+const ATLAS_NAMESPACE = 'atlas';
+const UNLOCATED_CONVENTION = '<workspace>/.vibes/atlas/<projectId>.db (per-project Atlas index)';
+export class AtlasMigrationNamespacePoisonedError extends CapabilityError {
+    evidence;
+    constructor(evidence) {
+        super('Atlas migration namespace is poisoned: the in-process atlas namespace was registered without the initial schema. ' +
+            (evidence.repairAttempted
+                ? 'Repair attempted: yes; the registry changed before the guarded replacement could apply. '
+                : 'Repair attempted: no. ') +
+            'Restart the process to rebuild the migration registry. The expected, registered and missing migration ids are in details.', 'UNAVAILABLE', {
+            reason: 'atlas-migration-namespace-poisoned',
+            details: {
+                expectedMigrationIds: evidence.expectedMigrationIds,
+                registeredMigrationIds: evidence.registeredMigrationIds,
+                missingMigrationIds: evidence.missingMigrationIds,
+                isStrictSubset: evidence.isStrictSubset,
+                repairAttempted: evidence.repairAttempted
+            }
+        });
+        this.name = 'AtlasMigrationNamespacePoisonedError';
+        this.evidence = evidence;
+    }
+}
+function malformedDescriptor() {
+    return new CapabilityError('The Atlas migrations descriptor is missing a migration list of filename and sql entries.', 'INTERNAL', {
+        reason: 'atlas-migrations-descriptor-malformed',
+        details: { kind: ATLAS_MIGRATIONS_KIND, id: ATLAS_MIGRATIONS_ID }
+    });
+}
+function declaredMigrations(runtime) {
+    if (!runtime.hasKind(ATLAS_MIGRATIONS_KIND))
+        return null;
+    const declared = runtime
+        .query(ATLAS_MIGRATIONS_KIND)
+        .descriptors()
+        .find((descriptor) => descriptor.id === ATLAS_MIGRATIONS_ID);
+    if (declared === undefined)
+        return null;
+    const parsed = AtlasMigrationsDescriptorSchema.safeParse(declared);
+    if (!parsed.success)
+        throw malformedDescriptor();
+    return parsed.data.migrations;
+}
+function migrationsFromDescriptor(entries) {
+    if (entries.length === 0) {
+        throw new CapabilityError('The Atlas migrations descriptor declared no migrations. Registering an empty set would stamp databases migrated.', 'NOT_FOUND', {
+            reason: 'atlas-migrations-not-found',
+            details: { kind: ATLAS_MIGRATIONS_KIND, id: ATLAS_MIGRATIONS_ID }
+        });
+    }
+    return entries.map(({ filename, sql }) => ({
+        version: parseVersionFromFilename(filename),
+        name: parseMigrationName(filename),
+        up: (db) => {
+            db.exec(sql);
+        }
+    }));
+}
+function unlocatedWorkspaceDatabase() {
+    return new CapabilityError(`${UNLOCATED_CONVENTION} lives under the caller's workspace, and this location query carries none.`, 'UNAVAILABLE', {
+        reason: 'workspace-location-uncarried',
+        recoveryHint: 'Read the database under the workspace root: <workspace>/.vibes/atlas/.'
+    });
+}
+function describeAtlasMigrationNamespace(runtime, expectedMigrations) {
+    const expectedMigrationIds = expectedMigrations.map(({ version, name }) => `${String(version).padStart(3, '0')}-${name}`);
+    const registeredMigrationIds = migrationRegistry.getMigrations(runtime, ATLAS_NAMESPACE).map(({ version, name }) => `${String(version).padStart(3, '0')}-${name}`);
+    const expectedMigrationIdSet = new Set(expectedMigrationIds);
+    const registeredMigrationIdSet = new Set(registeredMigrationIds);
+    const missingMigrationIds = expectedMigrationIds.filter((id) => !registeredMigrationIdSet.has(id));
+    return {
+        expectedMigrationIds,
+        registeredMigrationIds,
+        missingMigrationIds,
+        isStrictSubset: registeredMigrationIds.length < expectedMigrationIds.length &&
+            registeredMigrationIds.every((id) => expectedMigrationIdSet.has(id))
+    };
+}
+function reportRecovery(runtime, migrationCount) {
+    const logged = settleNow(() => {
+        getLogger('runtime-environment-bun.atlas-migrations', runtime).warn('Recovered a poisoned Atlas migration namespace.', { migrationCount });
+    });
+    if (logged.ok)
+        return;
+    settleNow(() => runtime.diagnostics.error('Atlas migration recovery could not be logged.', {
+        scope: 'runtime-environment-bun',
+        plugin: 'atlas-migrations',
+        error: valueFreeFailure(logged.cause)
+    }));
+}
+/**
+ * Register the declared Atlas migrations on this host.
+ *
+ * No kind, or no `workspace.atlas-migrations` descriptor, is absence: the host
+ * has nothing to register and does not refuse. Called from the Bun plugin's
+ * `onActivate`, after discovery, so a later feature plugin's descriptor is visible.
+ */
+export function registerBunAtlasMigrations(runtime) {
+    const entries = declaredMigrations(runtime);
+    if (entries === null)
+        return;
+    const migrations = migrationsFromDescriptor(entries);
+    const registration = settleNow(() => localdb.registerMigrations(runtime, ATLAS_NAMESPACE, migrations, {
+        autoReset: true,
+        location: () => {
+            throw unlocatedWorkspaceDatabase();
+        }
+    }));
+    if (registration.ok)
+        return;
+    if (!isMigrationNamespaceRegistered(registration.cause, ATLAS_NAMESPACE)) {
+        throw isCapabilityError(registration.cause)
+            ? registration.cause
+            : new CapabilityError('Atlas migration registration failed.', 'INTERNAL', {
+                reason: 'atlas-migration-registration-failed',
+                cause: valueFreeFailure(registration.cause)
+            });
+    }
+    const evidence = describeAtlasMigrationNamespace(runtime, migrations);
+    const alreadyComplete = !evidence.missingMigrationIds.includes('001-initial_schema') && !evidence.isStrictSubset;
+    if (alreadyComplete)
+        return;
+    const repaired = localdb.replaceMigrations(runtime, ATLAS_NAMESPACE, migrations, {
+        expectedRegisteredIds: evidence.registeredMigrationIds
+    });
+    if (repaired) {
+        reportRecovery(runtime, migrations.length);
+        return;
+    }
+    throw new AtlasMigrationNamespacePoisonedError({ ...evidence, repairAttempted: true });
+}
+//# sourceMappingURL=register-atlas-host-migrations.js.map

package/dist/atlas-migrations/register-atlas-host-migrations.js.map

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

package/dist/buffered-capture.d.ts

@@ -0,0 +1,4 @@
+/** Explicit Bun-only capability, composed by the executable environment owner. */
+import type { BufferedCaptureBackend } from '@vibesdotdev/execution-local';
+export declare function createBunBufferedCaptureBackend(): BufferedCaptureBackend;
+//# sourceMappingURL=buffered-capture.d.ts.map

package/dist/buffered-capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-capture.d.ts","sourceRoot":"","sources":["../src/buffered-capture.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AAE3E,wBAAgB,+BAA+B,IAAI,sBAAsB,CAExE"}

package/dist/buffered-capture.impl.bun.d.ts

@@ -0,0 +1,18 @@
+import { rm } from 'node:fs/promises';
+import { type BufferedCaptureRequest } from '@vibesdotdev/execution-local';
+export declare function executeBunCapture(input: BufferedCaptureRequest, removeCapture?: typeof rm): Promise<{
+    exitCode: null;
+    stdout: string;
+    stderr: string;
+    timedOut: boolean;
+    aborted: boolean;
+    durationMs: number;
+} | {
+    exitCode: number | null;
+    stdout: string;
+    stderr: string;
+    timedOut: false;
+    aborted: false;
+    durationMs: number;
+}>;
+//# sourceMappingURL=buffered-capture.impl.bun.d.ts.map

package/dist/buffered-capture.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-capture.impl.bun.d.ts","sourceRoot":"","sources":["../src/buffered-capture.impl.bun.ts"],"names":[],"mappings":"AAIA,OAAO,EAAsC,EAAE,EAAa,MAAM,kBAAkB,CAAC;AAErF,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,8BAA8B,CAAC;AAWtC,wBAAsB,iBAAiB,CAAC,KAAK,EAAE,sBAAsB,EAAE,aAAa,GAAE,OAAO,EAAO;;;;;;;;;;;;;;GAiHnG"}

package/dist/buffered-capture.impl.bun.js

@@ -0,0 +1,148 @@
+/** Explicit Bun composition capability; ordinary buffered execution only. */
+import { spawn, file } from 'bun';
+import { CapabilityError } from '@vibesdotdev/kernel';
+import { ExecuteOptionsSchema } from '@vibesdotdev/kernel/execution';
+import { mkdir, mkdtemp, readFile, realpath, rm, writeFile } from 'node:fs/promises';
+import { isAbsolute, join } from 'node:path';
+import { attempt, EXECUTION_FAILURE_MESSAGE, ErrnoCauseSchema, executionError, hasErrno } from '@vibesdotdev/execution-local';
+/** A typed refusal that retains only the errno category of the native cause. */
+function executionFailure(reason, errno) {
+    return new CapabilityError(EXECUTION_FAILURE_MESSAGE, 'UNAVAILABLE', {
+        reason, retryable: false, details: errno === undefined ? undefined : { errno }
+    });
+}
+export async function executeBunCapture(input, removeCapture = rm) {
+    const request = { ...input, args: [...input.args], env: { ...input.env } };
+    const encoding = ExecuteOptionsSchema.shape.stdoutEncoding.safeParse(request.stdoutEncoding);
+    if (!encoding.success)
+        throw new CapabilityError('The stdout encoding must be utf8 or base64.', 'INVALID_INPUT', {
+            reason: 'execution-stdout-encoding-invalid', retryable: false
+        });
+    const start = request.lifecycle.now();
+    if (request.platform !== 'darwin')
+        throw executionError('execution-buffered-capture-platform-unavailable');
+    if (!isAbsolute(request.tempDir) || !isAbsolute(request.cwd) || !isAbsolute(request.command)) {
+        throw executionError('execution-buffered-capture-invalid');
+    }
+    let timedOut = false;
+    let aborted = request.signal?.aborted ?? false;
+    let child;
+    let directory;
+    let disarmDeadline;
+    let terminationFailure;
+    let stage = 'prepare';
+    let primaryStage;
+    // The exit race below owns a termination failure, including an immediate abort.
+    let reportTermination;
+    const terminationFailed = new Promise(resolve => {
+        reportTermination = failure => resolve({ failure });
+    });
+    const elapsed = () => Math.round(request.lifecycle.now() - start);
+    const stopped = () => ({ exitCode: null, stdout: '', stderr: aborted ? 'Process execution aborted by signal' : '', timedOut, aborted, durationMs: elapsed() });
+    const terminate = () => {
+        const target = child;
+        if (!target)
+            return;
+        // detached:true below creates this group; never target an inherited group.
+        const killed = attempt(() => { if (request.killTree)
+            process.kill(-target.pid, 'SIGKILL');
+        else
+            target.kill('SIGKILL'); });
+        if ('failure' in killed && !hasErrno(killed.failure, 'ESRCH')) {
+            terminationFailure = executionError('execution-buffered-capture-cleanup-failed', killed.failure);
+            reportTermination(terminationFailure);
+        }
+    };
+    const abort = () => { aborted = true; terminate(); };
+    const capture = async () => {
+        try {
+            if (aborted)
+                return stopped();
+            await mkdir(request.tempDir, { recursive: true });
+            const base = await realpath(request.tempDir);
+            directory = await mkdtemp(join(base, 'execution-capture-'));
+            const stdoutPath = join(directory, 'stdout');
+            const stderrPath = join(directory, 'stderr');
+            const stdinPath = join(directory, 'stdin');
+            if (request.stdin !== undefined)
+                await writeFile(stdinPath, request.stdin, { flag: 'wx' });
+            const remaining = request.timeoutMs === undefined || request.timeoutMs === 0 ? undefined : request.timeoutMs - (request.lifecycle.now() - start);
+            aborted = request.signal?.aborted ?? false;
+            timedOut = remaining !== undefined && remaining <= 0;
+            if (aborted || timedOut)
+                return stopped();
+            stage = 'launch';
+            const launched = attempt(() => spawn([request.command, ...request.args], {
+                cwd: request.cwd, env: request.env, detached: request.killTree === true,
+                stdin: request.stdin === undefined ? 'ignore' : file(stdinPath),
+                stdout: file(stdoutPath), stderr: file(stderrPath)
+            }));
+            if ('failure' in launched)
+                throw executionError('execution-buffered-capture-launch-failed', launched.failure);
+            child = launched.value;
+            request.signal?.addEventListener('abort', abort, { once: true });
+            if (request.signal?.aborted)
+                abort();
+            if (remaining !== undefined)
+                disarmDeadline = request.lifecycle.timeout(() => { timedOut = true; terminate(); }, remaining);
+            stage = 'wait';
+            const winner = await Promise.race([child.exited.then(exitCode => ({ exitCode })), terminationFailed]);
+            if (terminationFailure)
+                throw terminationFailure;
+            if ('failure' in winner)
+                throw winner.failure;
+            const code = winner.exitCode;
+            stage = 'capture';
+            const [stdoutBytes, capturedStderr] = await Promise.all([readFile(stdoutPath), readFile(stderrPath, 'utf8')]);
+            const stdout = stdoutBytes.toString(encoding.data ?? 'utf8');
+            const stderr = aborted ? (capturedStderr ? `${capturedStderr}\nProcess execution aborted by signal` : 'Process execution aborted by signal') : capturedStderr;
+            return { exitCode: aborted ? null : code, stdout, stderr, timedOut, aborted, durationMs: elapsed() };
+        }
+        catch (error) {
+            primaryStage = stage;
+            if (error instanceof CapabilityError)
+                throw error;
+            throw executionFailure('execution-buffered-capture-failed', ErrnoCauseSchema.safeParse(error).data);
+        }
+    };
+    // Releases what the capture owns; reports whether cleanup could not be confirmed.
+    const release = async () => {
+        disarmDeadline?.();
+        request.signal?.removeEventListener('abort', abort);
+        let unconfirmed = terminationFailure !== undefined;
+        if (child && child.exitCode === null) {
+            terminate();
+            unconfirmed ||= terminationFailure !== undefined;
+            if (!unconfirmed) {
+                const [exited] = await Promise.allSettled([child.exited]);
+                unconfirmed = exited.status === 'rejected';
+            }
+            else {
+                // Retain cleanup failure without leaving a rejected exit promise unobserved.
+                void Promise.allSettled([child.exited]).then(([exited]) => {
+                    if (exited.status === 'rejected')
+                        request.diagnostics?.warn?.('child-exit-rejected', {
+                            reason: exited.reason instanceof Error ? exited.reason.message : String(exited.reason)
+                        });
+                });
+            }
+        }
+        // A failed termination leaves its owned files for recovery, not false cleanup.
+        if (directory && !unconfirmed) {
+            const [removed] = await Promise.allSettled([removeCapture(directory, { recursive: true })]);
+            unconfirmed = removed.status === 'rejected';
+        }
+        return unconfirmed;
+    };
+    const [primary] = await Promise.allSettled([capture()]);
+    // An unconfirmed cleanup outranks both the result and the primary failure.
+    if (await release())
+        throw new CapabilityError('Buffered capture cleanup could not be confirmed.', 'UNAVAILABLE', {
+            reason: 'execution-buffered-capture-cleanup-failed', retryable: false,
+            details: { cleanup: 'failed', primaryStage: primaryStage ?? 'completed' }
+        });
+    if (primary.status === 'rejected')
+        throw primary.reason;
+    return primary.value;
+}
+//# sourceMappingURL=buffered-capture.impl.bun.js.map

package/dist/buffered-capture.impl.bun.js.map

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

package/dist/buffered-capture.js

@@ -0,0 +1,5 @@
+import { executeBunCapture } from "./buffered-capture.impl.bun.js";
+export function createBunBufferedCaptureBackend() {
+    return { execute: executeBunCapture };
+}
+//# sourceMappingURL=buffered-capture.js.map

package/dist/buffered-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffered-capture.js","sourceRoot":"","sources":["../src/buffered-capture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,MAAM,UAAU,+BAA+B;IAC9C,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;AACvC,CAAC"}

package/dist/bun-environment.impl.bun.d.ts

@@ -0,0 +1,231 @@
+/**
+ * Bun Runtime Environment Implementation
+ *
+ * Captures environment at construction and provides Bun-specific
+ * implementations for scope, env access, and module loading (credentials are the
+ * host's `secrets/store`, read through `runtime.resolveCredential`).
+ */
+import type { RuntimeExecutableFreshness, RuntimeGraphFreshness } from '@vibesdotdev/kernel/schemas/registry';
+import { type GraphIdentity } from './services/graph-freshness.impl.bun.ts';
+import { type HostExecutableIdentity } from './services/executable-identity.impl.bun.ts';
+import { type BunArgv, type SelfSpawnSource } from './services/self-spawn.impl.bun.ts';
+import { type BunHostDeclaration, type BunHostFacts } from './host-channel.impl.bun.ts';
+import { type EnvironmentIdentity, type RuntimeEnvironmentImplementation, type RuntimeInvocationStore, type RuntimeLoaderImplementation, type RuntimeScope, type RuntimeSystemResources, type RuntimeLaunchIdentity, type RuntimeTerminalFacts, type RuntimeUserEnvironmentHost, type WorkspaceBinding } from '@vibesdotdev/kernel';
+import type { RuntimePath } from '@vibesdotdev/paths';
+import { type BunEnvironmentOptions } from './schemas/environment.ts';
+export type { BunEnvironmentOptions, BunPathSelection, BunScopeDeclaration, BunScopeHostFacts, BunSystemResourceReading } from './schemas/environment.ts';
+export type { BunHostDeclaration, BunHostFacts };
+export declare class BunEnvironment implements RuntimeEnvironmentImplementation {
+    readonly resources: Readonly<{
+        classifier: {
+            classifyExecutable: (facts: import("@vibesdotdev/execution-local").ExecutableClassificationFacts) => HostExecutableIdentity;
+            executableIdentityFrom: (env: import("@vibesdotdev/execution-local").HostEnvSnapshot) => HostExecutableIdentity;
+            executableIdentity: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => HostExecutableIdentity;
+            hostModulesOnDisk: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            isStandaloneExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            hostEntryPath: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => string | null;
+            resetForTest: () => void;
+        };
+        executable: {
+            isCompiledExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            processStartedAtMs: () => number;
+            statExecutable: (path: string) => import("@vibesdotdev/execution-local").ExecutableFileStat | null;
+            executableHostFactsOf: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => import("@vibesdotdev/execution-local").ExecutableHostFacts;
+            describeExecutable: (path: string, host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            captureExecutableIdentity: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            getCapturedExecutableIdentity: () => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            judgeExecutableReplaced: (loaded: import("@vibesdotdev/execution-local").ExecutableFileStat, current: import("@vibesdotdev/execution-local").ExecutableFileStat, processStartMs: number) => boolean;
+            checkExecutableFreshness: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableFreshness;
+            executableReplacedSince: (path: string, processStartMs: number) => import("@vibesdotdev/execution-local").ExecutableReplacedSince;
+            resetForTest: () => void;
+        };
+        outputPlane: {
+            install: (options: import("@vibesdotdev/kernel").RuntimeStdioTrackOptions) => void;
+            isInstalled: () => boolean;
+            uninstall: () => void;
+            setFormatter: (next: import("@vibesdotdev/execution-local").RuntimeOutputPlaneFormatter) => void;
+            formatConsoleArgs: (args: readonly unknown[]) => string;
+            flush: () => Promise<void>;
+        };
+        writeOutput(channel: "stdout" | "stderr", text: string): void;
+        readonly fatal: {
+            subscribe: (listener: import("@vibesdotdev/kernel").RuntimeFatalListener) => () => void;
+            subscriberCount: () => number;
+        };
+        setFormatter(next: import("@vibesdotdev/execution-local").RuntimeOutputPlaneFormatter): void;
+        retain(): () => Promise<void>;
+        streams(): import("@vibesdotdev/kernel").RuntimeStdioStreams;
+        dispose(): Promise<void>;
+    }>;
+    readonly httpFetch: (input: Request | string | URL, init?: RequestInit, options?: {
+        rejectUnauthorized?: boolean;
+    }) => Promise<Response>;
+    createInvocationStore(): RuntimeInvocationStore;
+    /** The declared resolution root R, or null when this host declared none. */
+    readonly hostRoot: string | null;
+    /**
+     * The host protocol pass set (rc05 §2.4 M2): a shim-launched host passes
+     * the shim's custody keys to its children; any other Bun host publishes
+     * none. Declared here by the host owner; the runtime validates it at
+     * registration and callers never extend it.
+     */
+    readonly hostProtocolEnv: readonly string[];
+    /** This host's executable identity, classified once from its own capture, with how it reached R. */
+    hostIdentity(): HostExecutableIdentity & {
+        readonly hostScope: string | null;
+        readonly hostRootCustody: boolean;
+    };
+    /**
+     * The host facts this environment captured once: R, the entry, self-spawn
+     * and the rest of the shim channel (null on a non-shim host), `user.home`
+     * and the bound workspace.
+     */
+    hostFacts(): BunHostFacts;
+    /**
+     * The OS account's home from the account database, captured at construction;
+     * throws `account-home-unavailable` when the host could not read it.
+     */
+    accountHome(): string;
+    /** The argv this process was launched with, captured once. */
+    argv(): readonly string[];
+    /** The terminal this host was launched on, as its launching shell published it (captured once). */
+    terminal(): RuntimeTerminalFacts;
+    /** The process manager's launch stamp this host captured, or null. */
+    managedProcessId(): string | null;
+    /** The identity the launching harness declared for this shell, captured once. */
+    launchIdentity(): RuntimeLaunchIdentity;
+    /** The shim's channel version, else the version this host declared, else null. */
+    hostVersion(): string | null;
+    /** The workspace this host was bound to at construction, or null. `runtime/workspace-path` reads it. */
+    workspaceBinding(): WorkspaceBinding | null;
+    /** The CLI re-entry argv this host declared, or null. */
+    selfSpawnArgv(): string[] | null;
+    /** The self-spawn source this host declared, or null. */
+    selfSpawnSource(): SelfSpawnSource | null;
+    /** The argv that runs Bun itself from this host. */
+    scriptRuntimeArgv(): BunArgv;
+    graphIdentity(root?: string): {
+        root: string;
+        lockPath: string | null;
+        digest: string | null;
+        mtimeMs: number | null;
+        size: number | null;
+        capturedAt: string;
+    } | null;
+    /** This physical host's graph at construction; current disk probes never rewrite it. */
+    loadedGraphIdentity(): Readonly<GraphIdentity> | null;
+    /**
+     * Whether the executable this process runs was replaced on disk after it
+     * started (executable-identity). Pinned at construction — the earliest
+     * point a Bun host has a runtime — so a late probe cannot mis-pin a
+     * replaced file; the start-time rule inside the nerve covers the rest.
+     */
+    executableFreshness(): RuntimeExecutableFreshness;
+    /**
+     * Whether the module graph under this process's resolution root was replaced
+     * after it was imported (graph-freshness). The sibling nerve: under a thin
+     * host the executable is recompiled very rarely and `vibes update` moves the
+     * plugins instead, so a body judged by the executable alone reports green
+     * while serving code nobody has on disk.
+     */
+    graphFreshness(): RuntimeGraphFreshness;
+    readonly id: string;
+    readonly description: string;
+    readonly identity: EnvironmentIdentity;
+    readonly scope: RuntimeScope;
+    readonly loader: RuntimeLoaderImplementation;
+    readonly userEnvironment: RuntimeUserEnvironmentHost;
+    readonly runtimePath: RuntimePath;
+    /** Captured at construction; explicit workspace authority never mutates launch cwd. */
+    private readonly _cwd;
+    private readonly _argv;
+    private readonly _envSnapshot;
+    private readonly _hostFacts;
+    private readonly _platform;
+    private readonly _declaredVersion;
+    private readonly _arch;
+    private readonly _hostname;
+    private readonly _uid;
+    private readonly _hostIdentity;
+    private readonly _accountHome;
+    private readonly _loadedGraph;
+    private readonly _systemResources;
+    private readonly _monotonicNow;
+    monotonicNow(): number;
+    getWallClockMs(): number;
+    systemResources(): RuntimeSystemResources;
+    constructor(options: BunEnvironmentOptions, resources?: Readonly<{
+        classifier: {
+            classifyExecutable: (facts: import("@vibesdotdev/execution-local").ExecutableClassificationFacts) => HostExecutableIdentity;
+            executableIdentityFrom: (env: import("@vibesdotdev/execution-local").HostEnvSnapshot) => HostExecutableIdentity;
+            executableIdentity: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => HostExecutableIdentity;
+            hostModulesOnDisk: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            isStandaloneExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            hostEntryPath: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => string | null;
+            resetForTest: () => void;
+        };
+        executable: {
+            isCompiledExecutable: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => boolean;
+            processStartedAtMs: () => number;
+            statExecutable: (path: string) => import("@vibesdotdev/execution-local").ExecutableFileStat | null;
+            executableHostFactsOf: (runtime: import("@vibesdotdev/execution-local").HostIdentityRuntime) => import("@vibesdotdev/execution-local").ExecutableHostFacts;
+            describeExecutable: (path: string, host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            captureExecutableIdentity: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            getCapturedExecutableIdentity: () => import("@vibesdotdev/execution-local").ExecutableIdentity | null;
+            judgeExecutableReplaced: (loaded: import("@vibesdotdev/execution-local").ExecutableFileStat, current: import("@vibesdotdev/execution-local").ExecutableFileStat, processStartMs: number) => boolean;
+            checkExecutableFreshness: (host: import("@vibesdotdev/execution-local").ExecutableHostFacts) => import("@vibesdotdev/execution-local").ExecutableFreshness;
+            executableReplacedSince: (path: string, processStartMs: number) => import("@vibesdotdev/execution-local").ExecutableReplacedSince;
+            resetForTest: () => void;
+        };
+        outputPlane: {
+            install: (options: import("@vibesdotdev/kernel").RuntimeStdioTrackOptions) => void;
+            isInstalled: () => boolean;
+            uninstall: () => void;
+            setFormatter: (next: import("@vibesdotdev/execution-local").RuntimeOutputPlaneFormatter) => void;
+            formatConsoleArgs: (args: readonly unknown[]) => string;
+            flush: () => Promise<void>;
+        };
+        writeOutput(channel: "stdout" | "stderr", text: string): void;
+        readonly fatal: {
+            subscribe: (listener: import("@vibesdotdev/kernel").RuntimeFatalListener) => () => void;
+            subscriberCount: () => number;
+        };
+        setFormatter(next: import("@vibesdotdev/execution-local").RuntimeOutputPlaneFormatter): void;
+        retain(): () => Promise<void>;
+        streams(): import("@vibesdotdev/kernel").RuntimeStdioStreams;
+        dispose(): Promise<void>;
+    }>, capture?: {
+        readonly env: Readonly<Record<string, string>>;
+        readonly cwd: string;
+    });
+    private childEnvComposer;
+    /**
+     * Bind the composer for this environment's own children (the Windows user
+     * environment's PowerShell): the kernel's host set of the runtime that
+     * registered it. `installBunEnvironment` binds it once the runtime exists.
+     */
+    bindChildEnv(compose: () => Record<string, string>): void;
+    private childEnv;
+    /** Bun owns cwd; universal Runtime consumers receive it through this contract. */
+    getCwd(): string;
+    /** Capture environment variables once, at construction. The only process.env read. */
+    private _captureEnv;
+    /**
+     * Get environment variable from captured snapshot.
+     * No direct process.env access.
+     */
+    getEnv(key: string): string | undefined;
+    getPlatform(): string;
+    /** The process's CPU architecture (`process.arch` spelling), captured once. */
+    getArch(): string;
+    /** The host machine's hostname, captured once. */
+    getHostname(): string;
+    /** Non-internal IPv4 and IPv6 addresses of this host. */
+    getLanAddresses(): readonly string[];
+    /** The account identity captured at host construction, never the invocation actor. */
+    getUid(): number;
+    getEnvSnapshot(): {
+        [x: string]: string;
+    };
+}
+//# sourceMappingURL=bun-environment.impl.bun.d.ts.map

package/dist/bun-environment.impl.bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun-environment.impl.bun.d.ts","sourceRoot":"","sources":["../src/bun-environment.impl.bun.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EACX,0BAA0B,EAC1B,qBAAqB,EACrB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAGN,KAAK,aAAa,EAClB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EACN,KAAK,sBAAsB,EAC3B,MAAM,4CAA4C,CAAC;AACpD,OAAO,EAEN,KAAK,OAAO,EACZ,KAAK,eAAe,EACpB,MAAM,mCAAmC,CAAC;AAE3C,OAAO,EAAiG,KAAK,kBAAkB,EAAE,KAAK,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAGvL,OAAO,EASN,KAAK,mBAAmB,EACxB,KAAK,gCAAgC,EAErC,KAAK,sBAAsB,EAC3B,KAAK,2BAA2B,EAChC,KAAK,YAAY,EACjB,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,KAAK,gBAAgB,EACrB,MAAM,qBAAqB,CAAC;AAK7B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAItD,OAAO,EAAkB,KAAK,qBAAqB,EAAwD,MAAM,0BAA0B,CAAC;AAE5I,YAAY,EAAE,qBAAqB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAmC1J,YAAY,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC;AAGjD,qBAAa,cAAe,YAAW,gCAAgC;IAwJ1B,QAAQ,CAAC,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAvJ9D,QAAQ,CAAC,SAAS;0BA+S+B,CAAC;4BA/ShB;IAElC,qBAAqB,IAAI,sBAAsB;IAI/C,4EAA4E;IAC5E,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAEjC;;;;;OAKG;IACH,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAE5C,oGAAoG;IACpG,YAAY,IAAI,sBAAsB,GAAG;QAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAA;KAAE;IAIjH;;;;OAIG;IACH,SAAS,IAAI,YAAY;IAIzB;;;OAGG;IACH,WAAW,IAAI,MAAM;IAIrB,8DAA8D;IAC9D,IAAI,IAAI,SAAS,MAAM,EAAE;IAIzB,mGAAmG;IACnG,QAAQ,IAAI,oBAAoB;IAIhC,sEAAsE;IACtE,gBAAgB,IAAI,MAAM,GAAG,IAAI;IAIjC,iFAAiF;IACjF,cAAc,IAAI,qBAAqB;IAIvC,kFAAkF;IAClF,WAAW,IAAI,MAAM,GAAG,IAAI;IAI5B,wGAAwG;IACxG,gBAAgB,IAAI,gBAAgB,GAAG,IAAI;IAI3C,yDAAyD;IACzD,aAAa,IAAI,MAAM,EAAE,GAAG,IAAI;IAKhC,yDAAyD;IACzD,eAAe,IAAI,eAAe,GAAG,IAAI;IAIzC,oDAAoD;IACpD,iBAAiB,IAAI,OAAO;IAI5B,aAAa,CAAC,IAAI,CAAC,EAAE,MAAM;;;;;;;;IAK3B,wFAAwF;IACxF,mBAAmB,IAAI,QAAQ,CAAC,aAAa,CAAC,GAAG,IAAI;IAGrD;;;;;OAKG;IACH,mBAAmB,IAAI,0BAA0B;IAIjD;;;;;;OAMG;IACH,cAAc,IAAI,qBAAqB;IAIvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,eAAe,EAAE,0BAA0B,CAAC;IAErD,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,uFAAuF;IACvF,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAS;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoB;IAC1C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmC;IAChE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAe;IAC1C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkB;IAC5C,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAgB;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAqB;IAC1C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAoG;IAClI,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAClD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAuB;IACpD,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAyB;IAC1D,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAe;IAE7C,YAAY,IAAI,MAAM;IAItB,cAAc,IAAI,MAAM;IAIxB,eAAe,IAAI,sBAAsB;gBAI7B,OAAO,EAAE,qBAAqB,EAAW,SAAS;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAA2B,EAAE,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;QAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE;IAqH7K,OAAO,CAAC,gBAAgB,CAA+C;IAEvE;;;;OAIG;IACH,YAAY,CAAC,OAAO,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIzD,OAAO,CAAC,QAAQ;IAShB,kFAAkF;IAClF,MAAM,IAAI,MAAM;IAIhB,sFAAsF;IACtF,OAAO,CAAC,WAAW;IAQnB;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAIvC,WAAW,IAAI,MAAM;IAIrB,+EAA+E;IAC/E,OAAO,IAAI,MAAM;IAIjB,kDAAkD;IAClD,WAAW,IAAI,MAAM;IAIrB,yDAAyD;IACzD,eAAe,IAAI,SAAS,MAAM,EAAE;IAIpC,sFAAsF;IACtF,MAAM,IAAI,MAAM;IAOhB,cAAc;;;CAGd"}