node-or-bun 0.0.0-stage → 0.2.1

package/CHANGELOG.md

@@ -0,0 +1,38 @@
+# Changelog
+
+## 0.2.1 - 2026-10-18
+
+- Preserve bounded, successfully decoded stdout/stderr on
+  `ProcessRuntimeError.output` so consumers can classify late observed exits
+  without losing captured content. The nullable pair is copied, frozen and
+  non-enumerable; error messages and ordinary error JSON do not include it.
+- Keep first-cause settlement and capture/decode failure facts unchanged.
+- See the [0.2.1 migration note](https://github.com/agent-teams-ai/process-runtime/blob/main/docs/migration-0.2.0-to-0.2.1.md).
+
+## 0.2.0 - 2026-10-18
+
+- Breaking: after a timeout or cancellation, late exit codes and decode
+  failures no longer settle the result; they are reported in
+  `ProcessRuntimeError.facts`. See the [migration
+  guide](https://github.com/agent-teams-ai/process-runtime/blob/main/docs/migration-0.1-to-0.2.md).
+- Rename the package to `node-or-bun` while preserving `.`, `/node`, `/bun`,
+  and `/testing`.
+- Apply the fixed facts-outside lifecycle and cancellation semantics to the
+  native Node.js and Bun adapters.
+- Preserve classifier facts and bounded-output guarantees without exposing a
+  recursive runtime-error array.
+- Rewrite synthetic cancellation conformance and document observable cleanup
+  guarantees and explicit limitations.
+- Add the 0.1-to-0.2 migration guide.
+- Remove the empty `dependencies` key; there are zero production dependencies.
+  No dependency on Engineering Foundation is added (repository policy); the
+  section 3.4 consumer-profile gap stays recorded in `docs/plan-scope.md`.
+
+## 0.1.0 - 2026-10-14
+
+- Add the neutral process contract and `createProcessExecutor`.
+- Add explicit Node.js and Bun native adapters.
+- Add shared conformance coverage for capture, cancellation, timeout, cleanup,
+  invalid output, and bounded stream behavior.
+- Add typed build, package qualification, and reviewed-main GitHub OIDC release
+  workflow preparation.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agent Teams
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,119 @@
-# Temporary Holding Version
+# node-or-bun
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Runtime-agnostic process execution.
+
+## Quickstart
+
+There is NO autodetect: choose the runtime adapter explicitly.
+
+```ts
+// Node.js
+import { createProcessExecutor } from "node-or-bun";
+import { createNodeProcessAdapter } from "node-or-bun/node";
+
+const run = createProcessExecutor(createNodeProcessAdapter());
+const result = await run.run({
+  command: process.execPath,
+  args: ["-e", "process.stdout.write('hello')"],
+  cwd: process.cwd(),
+});
+```
+
+```ts
+// Bun
+import { createProcessExecutor } from "node-or-bun";
+import { createBunProcessAdapter } from "node-or-bun/bun";
+
+const run = createProcessExecutor(createBunProcessAdapter());
+const result = await run.run({
+  command: process.execPath,
+  args: ["-e", "process.stdout.write('hello')"],
+  cwd: process.cwd(),
+});
+```
+
+The package keeps its 0.1.0 subpaths and adds none:
+
+- `node-or-bun` exposes the runtime-neutral contract and executor.
+- `node-or-bun/node` uses `node:child_process.spawn`.
+- `node-or-bun/bun` uses `Bun.spawn`.
+- `node-or-bun/testing` exposes the shared conformance suite.
+
+## Observable guarantees
+
+- **Bounded memory:** stdout and stderr are independently retained up to 4 MiB.
+  Overflow returns `output-limit`; bytes after the bound are discarded.
+- **Cleanup before settlement:** a resolved result or rejection is produced only
+  after direct-child cleanup and capture settlement have completed or produced
+  an honest `cleanup` failure.
+- **Unfinished capture is an error:** capture is allowed 1,000 ms to reach
+  natural EOF, then native close is requested and allowed a further 1,000 ms.
+  Forced close after the EOF deadline is a `cleanup` error with incomplete
+  custody retained.
+- **Partial setup is held:** after synchronous spawn/retain, observation or
+  capture setup failure runs owned cleanup and capture close before `launch`
+  rejects.
+- **Direct-child cleanup only:** default cleanup sends TERM to the direct child,
+  waits 1,000 ms, sends KILL, and waits a further 1,000 ms. It does not promise
+  cleanup of a detached `setsid` child or an arbitrary descendant tree.
+- **Fixed facts-outside arbitration:** cleanup failure outranks all other
+  outcomes. Otherwise the first initiating timeout, cancellation,
+  capture/overflow error, or observation error wins. Otherwise normal exit
+  returns its observed `Exit`; numeric nonzero remains a result fact, while
+  strict malformed UTF-8 returns `invalid-output`.
+
+Errors expose neutral classifier facts without a recursive error array:
+initiating cause, whether completion was requested before exit observation,
+the observed `Exit`, late capture/decode failure codes, bounded-output status,
+and incomplete-custody status. Error messages do not include argv, environment,
+or captured output. The library never logs captured output automatically.
+
+`ProcessRuntimeError.output` retains `{ stdout, stderr }` after both bounded
+captures settle and decode successfully. It is `null` before capture, while a
+capture remains unsettled, or if either strict UTF-8 decode fails. Capture
+failures can leave bounded prefixes; inspect the error code and late failure
+facts before treating output as complete. The pair is copied and frozen, and
+the property is non-enumerable so ordinary error JSON/spread omits it. Explicit
+access or serialization of `error.output` still exposes captured content.
+
+## What is not there
+
+- No runtime autodetect and no hidden adapter selection.
+- No stdin, PTY, event stream, supervisor, retry, command DSL, service
+  registry, Electron API, or product policy.
+- No promise of POSIX process groups, Windows Job Objects, wrapper protocols,
+  or tree cleanup. A Foundation Host owns those containment boundaries and may
+  pair them with the native Node/Bun hooks.
+- No promise for detached children created with `setsid`.
+- No Execa backend. The accepted N decision keeps production dependencies
+  empty and uses the existing native Node and Bun adapters.
+- No automatic output logging or implicit diagnostic dump.
+
+## Development and CI evidence
+
+The pinned tools are Node.js 26.11.1, Bun 1.4.3, and TypeScript 7.0.2. The
+runtime contract remains Node.js `^24.18.0 || ^26.0.0` and Bun `>=1.4.3`.
+
+```sh
+npm install
+npm run typecheck
+npm run test
+npm run pack
+npm run qualify
+```
+
+This change-set executed typecheck, Node/Bun conformance, Node-under-Bun, pack,
+and installed-consumer qualification locally on Linux only. The library CI
+workflow executed the same steps on macOS, Ubuntu, and Windows runners plus a
+Node 24.18.0 conformance run; those runs completed green on merge commit
+`e6fbf257f4` (workflow runs `39112568940` and `39113096124`). Native Windows
+wrapper/Job behavior and the Foundation job matrix are Foundation-side pending
+items and are not claimed here.
+
+See [the process contract](https://github.com/agent-teams-ai/process-runtime/blob/main/docs/process-contract.md),
+[the 0.1-to-0.2 migration
+guide](https://github.com/agent-teams-ai/process-runtime/blob/main/docs/migration-0.1-to-0.2.md),
+and [the bounded scope
+record](https://github.com/agent-teams-ai/process-runtime/blob/main/docs/plan-scope.md).
+The `docs/` directory is not part of the published package, so these links
+point at the repository copy.

package/dist/adapters/bun.d.ts

@@ -0,0 +1,12 @@
+import type { CompletionCause, Launch, ProcessAdapter } from "../contract.js";
+type BunChild = Bun.Subprocess<"ignore", "pipe", "pipe">;
+export type BunRetain = (child: BunChild) => void;
+export type BunAcquireHook = (request: Launch, retain: BunRetain) => void;
+export type BunCleanupHook = (child: BunChild, cause: CompletionCause) => Promise<void>;
+export type BunProcessAdapterOptions = {
+    readonly acquire?: BunAcquireHook;
+    readonly cleanup?: BunCleanupHook;
+};
+export declare const createBunProcessAdapter: (options?: BunProcessAdapterOptions) => ProcessAdapter;
+export {};
+//# sourceMappingURL=bun.d.ts.map

package/dist/adapters/bun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bun.d.ts","sourceRoot":"","sources":["../../src/adapters/bun.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAQ,MAAM,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAWpG,KAAK,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AAEzD,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAClD,MAAM,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,KAAK,IAAI,CAAC;AAC1E,MAAM,MAAM,cAAc,GAAG,CAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAExF,MAAM,MAAM,wBAAwB,GAAG;IACrC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,OAAO,CAAC,EAAE,cAAc,CAAC;CACnC,CAAC;AAgMF,eAAO,MAAM,uBAAuB,aACzB,wBAAwB,KAChC,cA+EF,CAAC"}

package/dist/adapters/bun.js

@@ -0,0 +1,263 @@
+import { PROCESS_CLEANUP_STEP_MS } from "../contract.js";
+import { ProcessRuntimeError, processError } from "../errors.js";
+import { rejectedReasons, settleOperation, settleWithin, withCause, } from "../internal/settlement.js";
+import { cleanupDirectChild } from "../internal/termination.js";
+const signalName = (signal) => {
+    if (signal === null)
+        return null;
+    return typeof signal === "string" ? signal : String(signal);
+};
+const observeExit = (child) => {
+    let terminal = false;
+    let terminalResolve;
+    const terminalProof = new Promise((resolve) => {
+        terminalResolve = resolve;
+    });
+    let settle;
+    let reject;
+    const exited = new Promise((resolve, rejectPromise) => {
+        settle = resolve;
+        reject = rejectPromise;
+    });
+    void exited.catch(() => undefined);
+    void child.exited.then(() => {
+        if (terminal)
+            return;
+        terminal = true;
+        terminalResolve();
+        settle({
+            exitCode: child.exitCode,
+            signal: signalName(child.signalCode),
+        });
+    }, (error) => {
+        // Bun documents `exited` as resolving when the process exits; a rejection
+        // is an observation error and is not accepted as terminal proof.
+        reject(processError("launch", "child process observation failed", error));
+    });
+    return {
+        exited,
+        isTerminal: () => terminal,
+        waitForTerminal: (timeoutMs) => {
+            let timer;
+            const timeout = new Promise((resolve) => {
+                timer = setTimeout(() => resolve(false), timeoutMs);
+            });
+            const settled = terminalProof.then(() => true);
+            return Promise.race([settled, timeout]).finally(() => {
+                if (timer !== undefined)
+                    clearTimeout(timer);
+            });
+        },
+    };
+};
+const defaultCleanup = (child, cause, observation) => cleanupDirectChild({
+    cause,
+    isTerminal: observation.isTerminal,
+    waitForTerminal: observation.waitForTerminal,
+    terminate: (signal) => {
+        child.kill(signal);
+    },
+});
+const captureStream = (native) => {
+    const reader = native.getReader();
+    let closed = false;
+    let released = false;
+    let iteratorUsed = false;
+    let closePromise;
+    const release = () => {
+        if (released)
+            return;
+        reader.releaseLock();
+        released = true;
+    };
+    const close = () => {
+        closePromise ??= (async () => {
+            if (closed && released)
+                return;
+            closed = true;
+            // Cancellation must run while this reader is still attached. Release is
+            // attempted immediately and again after cancellation settles.
+            const cancellation = settleOperation(() => reader.cancel());
+            const firstRelease = settleOperation(release);
+            const cancellationSettlement = await cancellation;
+            const releases = [await firstRelease, await settleOperation(release)];
+            const failures = rejectedReasons([
+                cancellationSettlement,
+                ...releases,
+            ]);
+            if (failures.length === 1)
+                throw failures[0];
+            if (failures.length > 1) {
+                throw new AggregateError(failures, "native reader closure failed");
+            }
+        })();
+        return closePromise;
+    };
+    return {
+        stream: {
+            [Symbol.asyncIterator]() {
+                if (iteratorUsed) {
+                    throw processError("stream", "capture stream has one consumer");
+                }
+                iteratorUsed = true;
+                return {
+                    async next() {
+                        if (closed)
+                            return { done: true, value: undefined };
+                        try {
+                            const result = await reader.read();
+                            if (result.done) {
+                                closed = true;
+                                release();
+                                return { done: true, value: undefined };
+                            }
+                            return { done: false, value: result.value };
+                        }
+                        catch (error) {
+                            if (closed)
+                                return { done: true, value: undefined };
+                            throw error;
+                        }
+                    },
+                    async return() {
+                        // Do not replace an abnormal read cause with a later close error.
+                        // The executor observes this same idempotent close after cleanup.
+                        void close().catch(() => undefined);
+                        return { done: true, value: undefined };
+                    },
+                };
+            },
+        },
+        close,
+    };
+};
+const createRunning = (child, observation, cleanupHook, captureOwners) => {
+    if (!(child.stdout instanceof ReadableStream) || !(child.stderr instanceof ReadableStream)) {
+        throw processError("launch", "capture stream was unavailable");
+    }
+    const stdout = captureStream(child.stdout);
+    captureOwners.push(stdout);
+    const stderr = captureStream(child.stderr);
+    captureOwners.push(stderr);
+    let cleanupPromise;
+    let closePromise;
+    return {
+        stdout: stdout.stream,
+        stderr: stderr.stream,
+        exited: observation.exited,
+        cleanup: (cause) => {
+            cleanupPromise ??= (async () => {
+                await cleanupHook(child, cause);
+            })();
+            return cleanupPromise;
+        },
+        closeCapture: () => {
+            closePromise ??= Promise.all([stdout.close(), stderr.close()]).then(() => undefined);
+            return closePromise;
+        },
+    };
+};
+const defaultAcquire = (request, retain) => {
+    const environment = request.environment === undefined
+        ? Object.fromEntries(Object.entries(process.env).filter((entry) => entry[1] !== undefined))
+        : { ...request.environment };
+    const child = Bun.spawn([request.command, ...request.args], {
+        cwd: request.cwd,
+        env: environment,
+        stdio: ["ignore", "pipe", "pipe"],
+    });
+    retain(child);
+};
+export const createBunProcessAdapter = (options = {}) => {
+    const hasAcquire = options.acquire !== undefined;
+    const hasCleanup = options.cleanup !== undefined;
+    if (hasAcquire !== hasCleanup) {
+        throw processError("invalid-input", "acquire and cleanup hooks must be provided together");
+    }
+    const acquire = options.acquire ?? defaultAcquire;
+    const customCleanup = options.cleanup;
+    return {
+        launch: async (request) => {
+            let retainedChild;
+            let retainCount = 0;
+            let observation;
+            const captureOwners = [];
+            const retain = (child) => {
+                retainCount += 1;
+                if (retainCount !== 1 || !(child instanceof Object)) {
+                    throw processError("invalid-input", "retain must be called exactly once with one child");
+                }
+                retainedChild = child;
+                observation = observeExit(child);
+            };
+            const rollback = async (cause) => {
+                const child = retainedChild;
+                if (child === undefined) {
+                    throw processError("launch", "process setup failed", cause);
+                }
+                const observed = observation ?? observeExit(child);
+                const cleanupSettlement = await settleOperation(() => (customCleanup ?? ((target, cause) => defaultCleanup(target, cause, observed)))(child, "failed"));
+                const closeSettlement = await settleOperation(() => closeBunCaptureWithin(child, captureOwners));
+                const failures = rejectedReasons([
+                    cleanupSettlement,
+                    closeSettlement,
+                ]);
+                if (failures.length > 0) {
+                    const cleanupCause = failures.length === 1
+                        ? failures[0]
+                        : new AggregateError(failures, "cleanup and capture closure both failed");
+                    throw withCause(new ProcessRuntimeError("cleanup", "process setup cleanup failed", {
+                        cause: cleanupCause,
+                        initiatingError: cause,
+                        incompleteCustody: true,
+                    }), cleanupCause);
+                }
+                throw processError("launch", "process setup failed", cause);
+            };
+            try {
+                acquire(request, retain);
+            }
+            catch (cause) {
+                return rollback(cause);
+            }
+            if (retainedChild === undefined || observation === undefined) {
+                return rollback(new Error("acquire did not retain one child"));
+            }
+            let running;
+            try {
+                const observed = observation ?? observeExit(retainedChild);
+                running = createRunning(retainedChild, observed, customCleanup ?? ((child, cause) => defaultCleanup(child, cause, observed)), captureOwners);
+                return running;
+            }
+            catch (cause) {
+                return rollback(cause);
+            }
+        },
+    };
+};
+const closeBunCapture = async (child, captureOwners = []) => {
+    const operations = captureOwners.map((capture) => () => capture.close());
+    for (const stream of [child.stdout, child.stderr]) {
+        if (!(stream instanceof ReadableStream) || stream.locked)
+            continue;
+        operations.push(async () => {
+            await stream.cancel();
+        });
+    }
+    const settled = await Promise.all(operations.map((operation) => settleWithin(operation, PROCESS_CLEANUP_STEP_MS)));
+    const failures = settled.flatMap((settlement) => {
+        if (settlement.status === "rejected")
+            return [settlement.reason];
+        if (settlement.status === "timeout") {
+            return [processError("cleanup", "native capture close or reader settlement timed out")];
+        }
+        return [];
+    });
+    if (failures.length > 0) {
+        throw failures.length === 1 ? failures[0] : new AggregateError(failures, "native capture closure failed");
+    }
+};
+const closeBunCaptureWithin = async (child, captureOwners = []) => {
+    await closeBunCapture(child, captureOwners);
+};
+//# sourceMappingURL=bun.js.map

package/dist/adapters/bun.js.map

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

package/dist/adapters/node.d.ts

@@ -0,0 +1,11 @@
+import { type ChildProcess } from "node:child_process";
+import type { CompletionCause, Launch, ProcessAdapter } from "../contract.js";
+export type NodeRetain = (child: ChildProcess) => void;
+export type NodeAcquireHook = (request: Launch, retain: NodeRetain) => void;
+export type NodeCleanupHook = (child: ChildProcess, cause: CompletionCause) => Promise<void>;
+export type NodeProcessAdapterOptions = {
+    readonly acquire?: NodeAcquireHook;
+    readonly cleanup?: NodeCleanupHook;
+};
+export declare const createNodeProcessAdapter: (options?: NodeProcessAdapterOptions) => ProcessAdapter;
+//# sourceMappingURL=node.d.ts.map

package/dist/adapters/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/adapters/node.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAE9D,OAAO,KAAK,EAAE,eAAe,EAAQ,MAAM,EAAE,cAAc,EAAkB,MAAM,gBAAgB,CAAC;AAUpG,MAAM,MAAM,UAAU,GAAG,CAAC,KAAK,EAAE,YAAY,KAAK,IAAI,CAAC;AACvD,MAAM,MAAM,eAAe,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC;AAC5E,MAAM,MAAM,eAAe,GAAG,CAAC,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;AAE7F,MAAM,MAAM,yBAAyB,GAAG;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CACpC,CAAC;AA0KF,eAAO,MAAM,wBAAwB,aAC1B,yBAAyB,KACjC,cA4FF,CAAC"}