--- title: "@henryqw/pi-process" seo: description: "Bounded UTF-8 child-process execution for Pi packages." ---

Run one argv-only child process with bounded UTF-8 output, cancellation, and a timeout. ## Install ```bash npm install @henryqw/pi-process ``` ## Use ```ts import { spawnBounded } from "@henryqw/pi-process"; const result = await spawnBounded("git", ["status"], { cwd: process.cwd() }); if (result.code !== 0 || result.killed) throw new Error(result.stderr); ``` `spawnBounded` accepts an optional UTF-8 string on stdin. It strictly decodes stdout and stderr. The default timeout is 30 seconds, and each output stream is limited to 64 KiB. Set `stdoutTailBytes` to retain a UTF-8-safe tail instead of applying the stdout limit. On POSIX systems, cancellation and timeout terminate the child process group. Invalid command, argument, and working-directory values fail before a child starts. ## API | Surface | Type | Purpose | | --- | --- | --- | | `spawnBounded` | function | Run one bounded argv-only child process. | | `Exec` | type | Describe the executor call signature. | | `ExecOptions` | type | Configure cwd, cancellation, timeout, limits, and string stdin. | | `ExecResult` | type | Return stdout, stderr, exit code, kill state, and tail truncation. |