@gobing-ai/ts-runtime 0.4.13 → 0.4.15

package/README.md

@@ -601,7 +601,10 @@ maxOutput, forceBuffered, an optional synchronous `onOutput({ stream, chunk,
 timestamp })` observer, and registry fields (`source`, `teamId`, `agentId`).
 `onOutput` observes live chunks while the returned `ProcessResult` retains the
 complete buffered stdout/stderr; observers must enqueue and return, and thrown
-observer errors are isolated from the child. Inject the same `ProcessRegistry` into every executor that should
+observer errors are isolated from the child. When `signal` is supplied, one-shot
+commands run in an isolated process group on Unix so abort terminates descendants
+that could otherwise retain the output pipes; Windows falls back to direct-child
+cancellation. Inject the same `ProcessRegistry` into every executor that should
 appear in one watch list; without a registry, behavior is unchanged.
 
 Cloudflare Workers do not expose process execution; check

package/dist/file-system-node.d.ts

@@ -10,12 +10,14 @@
  * variant.
  */
 import type { FileSystem } from './file-system';
+import type { RuntimePaths } from './runtime-paths';
 /**
  * Create a {@link FileSystem} backed by `node:fs`.
  *
  * @param root - Project root directory (default: walks up from `process.cwd()` looking for `bun.lock` or `package.json`).
+ * @param paths - Optional {@link RuntimePaths} anchor; `paths.cwd` seeds the project-root walk when `root` is absent. Defaults to the ambient process cwd.
  */
-export declare function createNodeFileSystem(root?: string): FileSystem;
+export declare function createNodeFileSystem(root?: string, paths?: RuntimePaths): FileSystem;
 /**
  * Find the project root by walking up from `startDir` looking for a `bun.lock`
  * or `package.json` marker. Uses `existsSync`, so it works on both Node and Bun.

package/dist/file-system-node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-system-node.d.ts","sourceRoot":"","sources":["../src/file-system-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,CA+E9D;AAWD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}
+{"version":3,"file":"file-system-node.d.ts","sourceRoot":"","sources":["../src/file-system-node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAmBH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAEpD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,UAAU,CA+EpF;AAWD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAaxD"}

package/dist/file-system-node.js

@@ -15,9 +15,10 @@ import { dirname, resolve as resolvePath } from 'node:path';
  * Create a {@link FileSystem} backed by `node:fs`.
  *
  * @param root - Project root directory (default: walks up from `process.cwd()` looking for `bun.lock` or `package.json`).
+ * @param paths - Optional {@link RuntimePaths} anchor; `paths.cwd` seeds the project-root walk when `root` is absent. Defaults to the ambient process cwd.
  */
-export function createNodeFileSystem(root) {
-    const projectRoot = root ?? findProjectRoot(process.cwd());
+export function createNodeFileSystem(root, paths) {
+    const projectRoot = root ?? findProjectRoot(paths?.cwd ?? process.cwd());
     return {
         getProjectRoot: () => projectRoot,
         resolve: (...segments) => resolvePath(projectRoot, ...segments),

package/dist/index.d.ts

@@ -15,6 +15,8 @@ export { createInMemoryProcessRegistry, InMemoryProcessRegistry } from './proces
 export { cloudflareWorkersFactory } from './runtime-cf';
 export type { RuntimeFactory } from './runtime-factory';
 export { _resetNodeFileSystem, nodeBunFactory } from './runtime-node-bun';
+export type { RuntimePaths } from './runtime-paths';
+export { ambientRuntimePaths } from './runtime-paths';
 export * from './schema-validation';
 export * from './types';
 export { BunPipeProcessSpawner, BunSyncProcessExecutor } from './process-executor';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,aAAa,GAChB,MAAM,MAAM,CAAC;AACd,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EACR,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,UAAU,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EACR,8BAA8B,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAE3G;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,qBAAqB,CAAC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,OAAO,EAAE,+BAA+B,EAAE,MAAM,WAAW,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AAC9E,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EACH,eAAe,EACf,eAAe,EACf,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,OAAO,EACP,aAAa,GAChB,MAAM,MAAM,CAAC;AACd,cAAc,QAAQ,CAAC;AACvB,OAAO,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACjG,YAAY,EACR,YAAY,EACZ,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,aAAa,EACb,UAAU,GACb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EACR,8BAA8B,EAC9B,gBAAgB,EAChB,qBAAqB,EACrB,wBAAwB,EACxB,sBAAsB,EACtB,sBAAsB,EACtB,sBAAsB,EACtB,eAAe,EACf,oBAAoB,GACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,6BAA6B,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAC5F,OAAO,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AACxD,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAC1E,YAAY,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,qBAAqB,CAAC;AACpC,cAAc,SAAS,CAAC;AAIxB,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AAEnF;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,sBAAsB,CAAC,CAAC;AAE3G;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/index.js

@@ -11,6 +11,7 @@ export { NodeProcessExecutor, ProcessExecutor } from './process-executor.js';
 export { createInMemoryProcessRegistry, InMemoryProcessRegistry } from './process-registry.js';
 export { cloudflareWorkersFactory } from './runtime-cf.js';
 export { _resetNodeFileSystem, nodeBunFactory } from './runtime-node-bun.js';
+export { ambientRuntimePaths } from './runtime-paths.js';
 export * from './schema-validation.js';
 export * from './types.js';
 // ── Deprecated re-exports (backward compatibility) ──────────────────────

package/dist/process-executor.d.ts

@@ -1,4 +1,5 @@
 import type { ProcessExecutionSource, ProcessRegistry } from './process-registry';
+import type { RuntimePaths } from './runtime-paths';
 /** Controls how stdout/stderr is captured: buffered in memory or streamed to the caller's terminal. */
 export type OutputPolicy = {
     mode: 'buffered';
@@ -19,6 +20,12 @@ export interface ProcessExecutorConfig {
      * Share one registry across all executors that should appear in the same watch list.
      */
     registry?: ProcessRegistry;
+    /**
+     * Optional cwd/home anchor (ADR-023 A1 / task 0042). When set, `paths.cwd` is applied to
+     * any `run` that carries no explicit per-call `cwd`. Precedence is total:
+     * explicit per-call `cwd` > injected `paths.cwd` > ambient process cwd.
+     */
+    paths?: RuntimePaths;
 }
 /** Options for spawning a child process. */
 export interface ProcessOptions {
@@ -31,7 +38,10 @@ export interface ProcessOptions {
     label?: string;
     rejectOnError?: boolean;
     forceBuffered?: boolean;
-    /** AbortSignal forwarded to execa as `cancelSignal` — aborts the child process when fired. */
+    /**
+     * AbortSignal forwarded to execa and, on Unix, to the child's isolated
+     * process group so descendants cannot outlive a cancelled one-shot run.
+     */
     signal?: AbortSignal;
     /**
      * Optional non-blocking observer for incremental stdout/stderr.

package/dist/process-executor.d.ts.map

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

package/dist/process-executor.js

@@ -24,7 +24,7 @@ export class NodeProcessExecutor {
     async runUntraced(options) {
         const args = options.args ?? [];
         const execaOptions = buildExecaOptions({
-            cwd: options.cwd,
+            cwd: options.cwd ?? this.config.paths?.cwd,
             env: options.env,
             timeout: options.timeout ?? this.config.defaultTimeout,
             maxOutput: options.maxOutput ?? this.config.defaultMaxOutput,
@@ -53,9 +53,10 @@ export class NodeProcessExecutor {
         });
         try {
             const subprocess = execa(options.command, args, execaOptions);
+            const stopGroupCancellation = observeProcessGroupCancellation(subprocess, options.signal);
             observeOutput(subprocess.stdout, 'stdout', options.onOutput);
             observeOutput(subprocess.stderr, 'stderr', options.onOutput);
-            const result = await subprocess;
+            const result = await subprocess.finally(stopGroupCancellation);
             // execa@9 Result does not expose pid — buffered runs leave pid unset.
             const processResult = {
                 command: options.command,
@@ -355,8 +356,35 @@ function buildExecaOptions(opts) {
         ...(opts.env !== undefined ? { env: opts.env } : {}),
         ...(opts.timeout !== undefined ? { timeout: opts.timeout } : {}),
         ...(opts.maxOutput !== undefined ? { maxBuffer: opts.maxOutput } : {}),
-        ...(opts.signal !== undefined ? { cancelSignal: opts.signal } : {}),
+        ...(opts.signal !== undefined
+            ? {
+                cancelSignal: opts.signal,
+                // Node's negative-pid group signal requires the child to lead
+                // a distinct process group. Windows has no equivalent.
+                ...(process.platform !== 'win32' ? { detached: true } : {}),
+            }
+            : {}),
+    };
+}
+function observeProcessGroupCancellation(subprocess, signal) {
+    const pid = subprocess.pid;
+    if (signal === undefined || process.platform === 'win32' || pid === undefined)
+        return () => { };
+    const abort = () => {
+        try {
+            process.kill(-pid, 'SIGTERM');
+        }
+        catch {
+            // The leader may already have exited through execa's cancelSignal.
+            // Fall back to the direct child without changing cancellation semantics.
+            subprocess.kill('SIGTERM');
+        }
     };
+    if (signal.aborted)
+        abort();
+    else
+        signal.addEventListener('abort', abort, { once: true });
+    return () => signal.removeEventListener('abort', abort);
 }
 function observeOutput(stream, name, observer) {
     if (!stream || !observer)

package/dist/runtime-paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Injectable cwd/home anchor consumed by runtime seams ({@link createNodeFileSystem},
+ * {@link NodeProcessExecutor}, and the JSONL importer's root resolution).
+ *
+ * Defaults to the ambient process environment via {@link ambientRuntimePaths}; inject a fake
+ * in tests or whenever a consumer must not reach for ambient cwd/home state.
+ */
+export interface RuntimePaths {
+    /** Absolute working-directory anchor. */
+    readonly cwd: string;
+    /** Absolute home-directory anchor. */
+    readonly home: string;
+}
+/**
+ * Capture the current ambient {@link RuntimePaths}: `process.cwd()` for `cwd`, and `HOME` /
+ * `USERPROFILE` for `home`. When `home` is unset (e.g. on Cloudflare Workers), falls back to
+ * `cwd` so the field stays a non-optional absolute anchor — matching the `/`-fallback philosophy
+ * of {@link getProcessCwd}: a degraded but always-absolute anchor.
+ */
+export declare function ambientRuntimePaths(): RuntimePaths;
+//# sourceMappingURL=runtime-paths.d.ts.map

package/dist/runtime-paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-paths.d.ts","sourceRoot":"","sources":["../src/runtime-paths.ts"],"names":[],"mappings":"AAOA;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB,yCAAyC;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACzB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,IAAI,YAAY,CAGlD"}

package/dist/runtime-paths.js

@@ -0,0 +1,15 @@
+// Injectable cwd/home anchor for runtime seams. Composes {@link getProcessCwd} (path.ts) and
+// {@link getHomeDir} (config.ts) so the two owning modules stay focused; this third module is the
+// single home for the injectable shape and its ambient factory (ADR-023 A1 / task 0042).
+import { getHomeDir } from './config.js';
+import { getProcessCwd } from './path.js';
+/**
+ * Capture the current ambient {@link RuntimePaths}: `process.cwd()` for `cwd`, and `HOME` /
+ * `USERPROFILE` for `home`. When `home` is unset (e.g. on Cloudflare Workers), falls back to
+ * `cwd` so the field stays a non-optional absolute anchor — matching the `/`-fallback philosophy
+ * of {@link getProcessCwd}: a degraded but always-absolute anchor.
+ */
+export function ambientRuntimePaths() {
+    const cwd = getProcessCwd();
+    return { cwd, home: getHomeDir() ?? cwd };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-runtime",
-    "version": "0.4.13",
+    "version": "0.4.15",
     "description": "@gobing-ai/ts-runtime — Runtime abstractions for Bun, Node, and Cloudflare Workers.",
     "keywords": [
         "typescript",
@@ -58,17 +58,17 @@
         "release": "echo 'Manual publish is disabled. Releases go through GitHub Actions via Trusted Publishing — push a tag: git tag @gobing-ai/ts-runtime-v<version> && git push --tags' && exit 1"
     },
     "dependencies": {
-        "@gobing-ai/ts-utils": "^0.4.13",
+        "@gobing-ai/ts-utils": "^0.4.15",
         "execa": "^9.5.0",
         "yaml": "^2.7.0",
         "zod": "^4.1.0"
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.4.13",
+        "@gobing-ai/ts-db": "^0.4.15",
         "@types/bun": "1.3.14"
     },
     "peerDependencies": {
-        "@gobing-ai/ts-db": "^0.4.13"
+        "@gobing-ai/ts-db": "^0.4.15"
     },
     "peerDependenciesMeta": {
         "@gobing-ai/ts-db": {

package/src/file-system-node.ts

@@ -28,14 +28,16 @@ import {
 import { dirname, resolve as resolvePath } from 'node:path';
 
 import type { FileSystem } from './file-system';
+import type { RuntimePaths } from './runtime-paths';
 
 /**
  * Create a {@link FileSystem} backed by `node:fs`.
  *
  * @param root - Project root directory (default: walks up from `process.cwd()` looking for `bun.lock` or `package.json`).
+ * @param paths - Optional {@link RuntimePaths} anchor; `paths.cwd` seeds the project-root walk when `root` is absent. Defaults to the ambient process cwd.
  */
-export function createNodeFileSystem(root?: string): FileSystem {
-    const projectRoot = root ?? findProjectRoot(process.cwd());
+export function createNodeFileSystem(root?: string, paths?: RuntimePaths): FileSystem {
+    const projectRoot = root ?? findProjectRoot(paths?.cwd ?? process.cwd());
 
     return {
         getProjectRoot: () => projectRoot,

package/src/index.ts

@@ -47,6 +47,8 @@ export { createInMemoryProcessRegistry, InMemoryProcessRegistry } from './proces
 export { cloudflareWorkersFactory } from './runtime-cf';
 export type { RuntimeFactory } from './runtime-factory';
 export { _resetNodeFileSystem, nodeBunFactory } from './runtime-node-bun';
+export type { RuntimePaths } from './runtime-paths';
+export { ambientRuntimePaths } from './runtime-paths';
 export * from './schema-validation';
 export * from './types';
 

package/src/process-executor.ts

@@ -1,6 +1,7 @@
 import { isatty } from 'node:tty';
 import { type Options as ExecaOptions, execa } from 'execa';
 import type { ProcessExecutionSource, ProcessRegistry } from './process-registry';
+import type { RuntimePaths } from './runtime-paths';
 
 // ── Types ────────────────────────────────────────────────────────────────
 
@@ -20,6 +21,12 @@ export interface ProcessExecutorConfig {
      * Share one registry across all executors that should appear in the same watch list.
      */
     registry?: ProcessRegistry;
+    /**
+     * Optional cwd/home anchor (ADR-023 A1 / task 0042). When set, `paths.cwd` is applied to
+     * any `run` that carries no explicit per-call `cwd`. Precedence is total:
+     * explicit per-call `cwd` > injected `paths.cwd` > ambient process cwd.
+     */
+    paths?: RuntimePaths;
 }
 
 /** Options for spawning a child process. */
@@ -33,7 +40,10 @@ export interface ProcessOptions {
     label?: string;
     rejectOnError?: boolean;
     forceBuffered?: boolean;
-    /** AbortSignal forwarded to execa as `cancelSignal` — aborts the child process when fired. */
+    /**
+     * AbortSignal forwarded to execa and, on Unix, to the child's isolated
+     * process group so descendants cannot outlive a cancelled one-shot run.
+     */
     signal?: AbortSignal;
     /**
      * Optional non-blocking observer for incremental stdout/stderr.
@@ -191,7 +201,7 @@ export class NodeProcessExecutor implements ProcessExecutor {
     private async runUntraced(options: ProcessOptions): Promise<ProcessResult> {
         const args = options.args ?? [];
         const execaOptions = buildExecaOptions({
-            cwd: options.cwd,
+            cwd: options.cwd ?? this.config.paths?.cwd,
             env: options.env,
             timeout: options.timeout ?? this.config.defaultTimeout,
             maxOutput: options.maxOutput ?? this.config.defaultMaxOutput,
@@ -221,9 +231,10 @@ export class NodeProcessExecutor implements ProcessExecutor {
 
         try {
             const subprocess = execa(options.command, args, execaOptions);
+            const stopGroupCancellation = observeProcessGroupCancellation(subprocess, options.signal);
             observeOutput(subprocess.stdout, 'stdout', options.onOutput);
             observeOutput(subprocess.stderr, 'stderr', options.onOutput);
-            const result = await subprocess;
+            const result = await subprocess.finally(stopGroupCancellation);
             // execa@9 Result does not expose pid — buffered runs leave pid unset.
             const processResult = {
                 command: options.command,
@@ -602,8 +613,35 @@ function buildExecaOptions(opts: {
         ...(opts.env !== undefined ? { env: opts.env } : {}),
         ...(opts.timeout !== undefined ? { timeout: opts.timeout } : {}),
         ...(opts.maxOutput !== undefined ? { maxBuffer: opts.maxOutput } : {}),
-        ...(opts.signal !== undefined ? { cancelSignal: opts.signal } : {}),
+        ...(opts.signal !== undefined
+            ? {
+                  cancelSignal: opts.signal,
+                  // Node's negative-pid group signal requires the child to lead
+                  // a distinct process group. Windows has no equivalent.
+                  ...(process.platform !== 'win32' ? { detached: true } : {}),
+              }
+            : {}),
+    };
+}
+
+function observeProcessGroupCancellation(
+    subprocess: { pid?: number; kill(signal?: NodeJS.Signals | number): boolean },
+    signal: AbortSignal | undefined,
+): () => void {
+    const pid = subprocess.pid;
+    if (signal === undefined || process.platform === 'win32' || pid === undefined) return () => {};
+    const abort = (): void => {
+        try {
+            process.kill(-pid, 'SIGTERM');
+        } catch {
+            // The leader may already have exited through execa's cancelSignal.
+            // Fall back to the direct child without changing cancellation semantics.
+            subprocess.kill('SIGTERM');
+        }
     };
+    if (signal.aborted) abort();
+    else signal.addEventListener('abort', abort, { once: true });
+    return () => signal.removeEventListener('abort', abort);
 }
 
 function observeOutput(

package/src/runtime-paths.ts

@@ -0,0 +1,31 @@
+// Injectable cwd/home anchor for runtime seams. Composes {@link getProcessCwd} (path.ts) and
+// {@link getHomeDir} (config.ts) so the two owning modules stay focused; this third module is the
+// single home for the injectable shape and its ambient factory (ADR-023 A1 / task 0042).
+
+import { getHomeDir } from './config';
+import { getProcessCwd } from './path';
+
+/**
+ * Injectable cwd/home anchor consumed by runtime seams ({@link createNodeFileSystem},
+ * {@link NodeProcessExecutor}, and the JSONL importer's root resolution).
+ *
+ * Defaults to the ambient process environment via {@link ambientRuntimePaths}; inject a fake
+ * in tests or whenever a consumer must not reach for ambient cwd/home state.
+ */
+export interface RuntimePaths {
+    /** Absolute working-directory anchor. */
+    readonly cwd: string;
+    /** Absolute home-directory anchor. */
+    readonly home: string;
+}
+
+/**
+ * Capture the current ambient {@link RuntimePaths}: `process.cwd()` for `cwd`, and `HOME` /
+ * `USERPROFILE` for `home`. When `home` is unset (e.g. on Cloudflare Workers), falls back to
+ * `cwd` so the field stays a non-optional absolute anchor — matching the `/`-fallback philosophy
+ * of {@link getProcessCwd}: a degraded but always-absolute anchor.
+ */
+export function ambientRuntimePaths(): RuntimePaths {
+    const cwd = getProcessCwd();
+    return { cwd, home: getHomeDir() ?? cwd };
+}