@gobing-ai/ts-runtime 0.5.3 → 0.5.5

package/README.md

@@ -641,6 +641,13 @@ The `ProcessExecutor` const (value alias for `NodeProcessExecutor`), `BunSyncPro
 and `BunPipeProcessSpawner` are kept as deprecated backward-compatible wrappers. Prefer
 `NodeProcessExecutor` or `nodeBunFactory.createProcessExecutor()` in new code.
 
+**Deprecation status (task 0087 R7):** sync callers now default to the non-deprecated
+`NodeSyncProcessExecutor` (node `spawnSync`) — `identity.ts` was migrated off the
+`BunSyncProcessExecutor` default. `BunSyncProcessExecutor` and `BunPipeProcessSpawner`
+remain exported-deprecated and are deleted in the next major version. The process-group
+containment machinery lives in `src/process-group.ts` (extracted from
+`process-executor.ts`, task 0087 R8 — pure move, no behavior change).
+
 ### SpanContext (for telemetry)
 
 ```ts

package/dist/index.d.ts

@@ -19,12 +19,9 @@ export type { RuntimePaths } from './runtime-paths';
 export { ambientRuntimePaths } from './runtime-paths';
 export * from './schema-validation';
 export * from './types';
-export { BunPipeProcessSpawner, BunSyncProcessExecutor } from './process-executor';
-/**
- * @deprecated Use {@link ProcessExecutor} directly for async execution.
- * Use `Bun.spawnSync` or `child_process.spawnSync` for sync.
- */
-export type SyncProcessExecutor = InstanceType<typeof import('./process-executor').BunSyncProcessExecutor>;
+/** Sync executor shape (task 0087 R7) — satisfied by NodeSyncProcessExecutor (preferred) and the deprecated BunSyncProcessExecutor. */
+export type { SyncProcessExecutor } from './process-executor';
+export { BunPipeProcessSpawner, BunSyncProcessExecutor, NodeSyncProcessExecutor } from './process-executor';
 /**
  * @deprecated Use {@link ProcessExecutor.runStreaming} instead.
  */

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,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"}
+{"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,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,uIAAuI;AACvI,YAAY,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,YAAY,CAAC,cAAc,oBAAoB,EAAE,qBAAqB,CAAC,CAAC"}

package/dist/index.js

@@ -14,5 +14,4 @@ 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) ──────────────────────
-export { BunPipeProcessSpawner, BunSyncProcessExecutor } from './process-executor.js';
+export { BunPipeProcessSpawner, BunSyncProcessExecutor, NodeSyncProcessExecutor } from './process-executor.js';

package/dist/process-executor.d.ts

@@ -270,7 +270,24 @@ export declare const ProcessExecutor: typeof NodeProcessExecutor;
  * Synchronous process execution is no longer recommended from ts-runtime.
  * This class is kept for backward compatibility.
  */
-export declare class BunSyncProcessExecutor {
+export declare class BunSyncProcessExecutor implements SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
+}
+/**
+ * Sync process execution surface shared by the sync executors (task 0087 R7).
+ * Not deprecated — the deprecated part is the Bun-specific default, not the shape.
+ */
+export interface SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
+}
+/**
+ * Sync executor on `node:child_process.spawnSync` — the non-deprecated default
+ * for sync callers (task 0087 R7). Contract-compatible with
+ * {@link BunSyncProcessExecutor} for success and non-zero exits. One deliberate
+ * divergence: a spawn failure (e.g. missing binary) maps to exitCode 1 instead of
+ * throwing, so `getGitContextSync`-style probes see a plain non-zero exit.
+ */
+export declare class NodeSyncProcessExecutor implements SyncProcessExecutor {
     runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"process-executor.d.ts","sourceRoot":"","sources":["../src/process-executor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzG,sGAAsG;AACtG,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnF,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAS/C,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACvF;AAED,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG;IACxB,iBAAiB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD,gBAAgB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACvB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AAmBlD,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjE,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC7C,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC;CAC1D;AAID;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,GAAE,qBAA0B;IAI9C;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAI5C,WAAW;IA8HzB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;YA6DxC,KAAK;IAKnB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,gBAAgB;CAG3B;AAkHD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,4BAAsB,CAAC;AAInD;;;;GAIG;AACH,qBAAa,sBAAsB;IAC/B,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,aAAa;CA2BnE;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;CAWlD"}
+{"version":3,"file":"process-executor.d.ts","sourceRoot":"","sources":["../src/process-executor.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,sBAAsB,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAClF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAIpD;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,YAAY,GAAG;IAAE,IAAI,EAAE,UAAU,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEzG,sGAAsG;AACtG,MAAM,WAAW,qBAAqB;IAClC;;;OAGG;IACH,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B;;;;OAIG;IACH,KAAK,CAAC,EAAE,YAAY,CAAC;CACxB;AAED,4CAA4C;AAC5C,MAAM,WAAW,cAAc;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAChD;;;;;;;;OAQG;IACH,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC;;;;OAIG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,kDAAkD;AAClD,MAAM,WAAW,kBAAkB;IAC/B,QAAQ,CAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACrC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC9B;AAED;;;;GAIG;AACH,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEnF,+FAA+F;AAC/F,MAAM,WAAW,aAAa;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB;;;;OAIG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,sFAAsF;AACtF,MAAM,MAAM,iBAAiB,GAAG,cAAc,CAAC;AAS/C,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,iBAAiB,CAAC;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,6CAA6C;IAC7C,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC;CAC1C;AAED,uEAAuE;AACvE,MAAM,WAAW,gBAAgB;IAC7B,IAAI,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACvF;AAED,yFAAyF;AACzF,MAAM,MAAM,aAAa,GAAG;IACxB,iBAAiB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;IACxD,gBAAgB,EAAE,CAAC,MAAM,EAAE,kBAAkB,KAAK,IAAI,CAAC;CAC1D,CAAC;AAEF,kFAAkF;AAClF,MAAM,WAAW,UAAU;IACvB,UAAU,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED,+DAA+D;AAC/D,MAAM,WAAW,kBAAkB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B;;;;OAIG;IACH,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,MAAM,CAAC,EAAE,sBAAsB,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,iDAAiD;AACjD,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC;AAmBlD,6EAA6E;AAC7E,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAEjE,6FAA6F;AAC7F,MAAM,WAAW,WAAW;IACxB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IACxC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;IAC7C,QAAQ,IAAI,IAAI,CAAC;IACjB,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,IAAI,CAAC;CACtC;AAID;;;;;;;;GAQG;AACH,MAAM,WAAW,eAAe;IAC5B;;;OAGG;IACH,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;IAErD;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAAC;CAC1D;AAID;;;;;;;GAOG;AACH,qBAAa,mBAAoB,YAAW,eAAe;IACvD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAwB;gBAEnC,MAAM,GAAE,qBAA0B;IAI9C;;;OAGG;IACG,GAAG,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC;YAI5C,WAAW;IA8HzB;;;;;OAKG;IACH,YAAY,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;YA8DxC,KAAK;IAKnB,OAAO,CAAC,aAAa;IAwBrB,OAAO,CAAC,gBAAgB;IAQxB,OAAO,CAAC,oBAAoB;IAuB5B,OAAO,CAAC,gBAAgB;CAG3B;AAkHD;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,4BAAsB,CAAC;AAInD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,mBAAmB;IAC9D,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,aAAa;CA2BnE;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAChC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,aAAa,CAAC;CACpE;AAED;;;;;;GAMG;AACH,qBAAa,uBAAwB,YAAW,mBAAmB;IAC/D,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,GAAG,aAAa;CAyBnE;AAED;;;GAGG;AACH,qBAAa,qBAAqB;IAC9B,KAAK,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW;CAWlD"}

package/dist/process-executor.js

@@ -1,6 +1,8 @@
+import { spawnSync } from 'node:child_process';
 import { isatty } from 'node:tty';
 import { execa } from 'execa';
 import { getProcessEnv } from './config.js';
+import { ownProcessGroupLifecycle, resolveDeadline, resolveKillGraceMs, } from './process-group.js';
 function processEventSeverity(reason, exitCode) {
     if (reason === 'error')
         return 'error';
@@ -168,7 +170,8 @@ export class NodeProcessExecutor {
      */
     runStreaming(options) {
         const args = options.args ?? [];
-        void this.config.tracer?.traceAsync('process.runStreaming', async () => undefined).catch(() => undefined);
+        // Task 0086 R14: no lifetime span here — the empty fire-and-forget span
+        // carried no data and confused span consumers. Registry + events cover it.
         const startedAt = Date.now();
         const startedIso = new Date(startedAt).toISOString();
         // Begin registry before spawn so failed spawns still appear (then complete as error).
@@ -391,6 +394,36 @@ export class BunSyncProcessExecutor {
         };
     }
 }
+/**
+ * Sync executor on `node:child_process.spawnSync` — the non-deprecated default
+ * for sync callers (task 0087 R7). Contract-compatible with
+ * {@link BunSyncProcessExecutor} for success and non-zero exits. One deliberate
+ * divergence: a spawn failure (e.g. missing binary) maps to exitCode 1 instead of
+ * throwing, so `getGitContextSync`-style probes see a plain non-zero exit.
+ */
+export class NodeSyncProcessExecutor {
+    runSync(options) {
+        const args = options.args ?? [];
+        const startedAt = Date.now();
+        const result = spawnSync(options.command, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+        });
+        const exitCode = result.status ?? 1;
+        if (options.rejectOnError === true && exitCode !== 0) {
+            throw new Error(`${options.command} ${args.join(' ')} failed with exit code ${exitCode}: ${stripFinalNewline(asString(result.stderr))}`);
+        }
+        return {
+            command: options.command,
+            args,
+            exitCode,
+            stdout: stripFinalNewline(asString(result.stdout)),
+            stderr: stripFinalNewline(asString(result.stderr)),
+            durationMs: Date.now() - startedAt,
+        };
+    }
+}
 /**
  * @deprecated Use {@link ProcessExecutor.runStreaming} instead.
  * This class is kept for backward compatibility.
@@ -435,137 +468,6 @@ function buildExecaOptions(opts) {
     };
 }
 // ── Deadline and process-group containment ───────────────────────────
-/**
- * Largest delay accepted by native timers; anything larger would overflow onto an
- * immediate timer, so deadline/grace values beyond it are rejected before spawn.
- */
-const MAX_TIMEOUT_MS = 2_147_483_647;
-/** Default grace between the owned group SIGTERM and the SIGKILL escalation. */
-const DEFAULT_KILL_GRACE_MS = 5000;
-/** Poll cadence while waiting for an owned process group to empty. */
-const GROUP_POLL_INTERVAL_MS = 25;
-/** Bounded patience after group SIGKILL before giving up on unkillable (D-state) members. */
-const GROUP_KILL_PATIENCE_MS = 2000;
-/**
- * Resolve the effective deadline: omitted inherits the executor default (which may itself
- * be unlimited), explicit `null` is unlimited and overrides any finite default, and a
- * finite value must be a positive integer within the native timer range. Invalid values
- * are rejected before spawn — never clamped and never overflowed onto a timer.
- */
-function resolveDeadline(optionTimeout, defaultTimeout) {
-    if (optionTimeout === null)
-        return null;
-    const candidate = optionTimeout === undefined ? defaultTimeout : optionTimeout;
-    if (candidate === undefined || candidate === null)
-        return candidate;
-    if (!Number.isInteger(candidate) || candidate <= 0 || candidate > MAX_TIMEOUT_MS) {
-        throw new TypeError(`Process timeout must be a positive integer within the native timer range (1-${MAX_TIMEOUT_MS} ms), got ${String(candidate)}`);
-    }
-    return candidate;
-}
-/**
- * Resolve the SIGTERM→SIGKILL escalation grace: omitted uses {@link DEFAULT_KILL_GRACE_MS},
- * `0` escalates immediately, and anything outside the native timer range is rejected.
- */
-function resolveKillGraceMs(optionGraceMs) {
-    if (optionGraceMs === undefined)
-        return DEFAULT_KILL_GRACE_MS;
-    if (!Number.isInteger(optionGraceMs) || optionGraceMs < 0 || optionGraceMs > MAX_TIMEOUT_MS) {
-        throw new TypeError(`Process killGraceMs must be a non-negative integer within the native timer range (0-${MAX_TIMEOUT_MS} ms), got ${String(optionGraceMs)}`);
-    }
-    return optionGraceMs;
-}
-/** Whether any member of the owned process group is still alive (signal 0 probe on `-pid`). */
-function groupExists(pid) {
-    try {
-        process.kill(-pid, 0);
-        return true;
-    }
-    catch (error) {
-        // EPERM means the group exists but is not signallable from here.
-        return error.code === 'EPERM';
-    }
-}
-/** Signal the owned process group; `false` when the group is already gone (ESRCH). */
-function signalGroup(pid, signal) {
-    try {
-        process.kill(-pid, signal);
-        return true;
-    }
-    catch {
-        return false;
-    }
-}
-async function waitForGroupExit(pid, budgetMs) {
-    const giveUpAt = Date.now() + budgetMs;
-    while (groupExists(pid)) {
-        if (Date.now() >= giveUpAt)
-            return false;
-        await new Promise((resolve) => setTimeout(resolve, GROUP_POLL_INTERVAL_MS));
-    }
-    return true;
-}
-/**
- * The one termination sequence for an owned Unix process group: group SIGTERM, wait the
- * grace for the whole group to empty, then group SIGKILL and a bounded settle wait.
- * Group liveness — not direct-child exit — decides completion, so escalation is never
- * cancelled because the leader exited first while descendants retain pipes or locks.
- * Resolves `true` only when a group signal was actually delivered.
- */
-async function reapProcessGroup(pid, graceMs) {
-    if (!signalGroup(pid, 'SIGTERM'))
-        return false;
-    if (await waitForGroupExit(pid, graceMs))
-        return true;
-    signalGroup(pid, 'SIGKILL');
-    await waitForGroupExit(pid, GROUP_KILL_PATIENCE_MS);
-    return true;
-}
-/**
- * Own one detached child's process group on Unix. A deadline timer and the caller's abort
- * signal both feed a single termination path — group SIGTERM, grace, SIGKILL — and after a
- * natural leader exit surviving owned descendants are reaped with the same sequence, so
- * completion cannot leak group members holding inherited pipes or database write locks.
- */
-function ownProcessGroupLifecycle(ownership) {
-    const { pid, graceMs } = ownership;
-    let trigger;
-    let termination;
-    let timer;
-    const initiate = (reason) => {
-        if (trigger !== undefined)
-            return;
-        trigger = reason;
-        termination = reapProcessGroup(pid, graceMs);
-    };
-    if (ownership.deadlineMs !== undefined) {
-        timer = setTimeout(() => initiate('timeout'), ownership.deadlineMs);
-    }
-    const onAbort = () => initiate('cancelled');
-    if (ownership.signal !== undefined) {
-        if (ownership.signal.aborted)
-            onAbort();
-        else
-            ownership.signal.addEventListener('abort', onAbort, { once: true });
-    }
-    return {
-        finish: async () => {
-            if (trigger === undefined) {
-                // Natural completion: reap stragglers (no-op when the group is already empty).
-                await reapProcessGroup(pid, graceMs);
-                return undefined;
-            }
-            // An undeliverable trigger (group already gone — the child finished first)
-            // yields undefined so the outcome falls back to the natural classification.
-            return (await termination) ? trigger : undefined;
-        },
-        stop: () => {
-            if (timer !== undefined)
-                clearTimeout(timer);
-            ownership.signal?.removeEventListener('abort', onAbort);
-        },
-    };
-}
 /** Classify an execa rejection on paths where the executor did not own the termination. */
 function classifyFailedCompletion(error) {
     if (error.timedOut === true)
@@ -580,17 +482,25 @@ function classifyFailedCompletion(error) {
 function observeOutput(stream, name, observer) {
     if (!stream || !observer)
         return;
-    stream.on('data', (chunk) => {
+    // Task 0086 R13: one decoder per stream with `stream: true` keeps multi-byte
+    // UTF-8 sequences intact across chunk boundaries; a fresh decoder per chunk
+    // would split them into U+FFFD replacement characters.
+    const decoder = new TextDecoder();
+    const emit = (chunk) => {
         try {
-            observer({
-                stream: name,
-                chunk: asString(chunk),
-                timestamp: new Date().toISOString(),
-            });
+            observer({ stream: name, chunk, timestamp: new Date().toISOString() });
         }
         catch {
             // Observability is best-effort and must never interrupt child I/O.
         }
+    };
+    stream.on('data', (chunk) => {
+        emit(typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true }));
+    });
+    stream.on('end', () => {
+        const tail = decoder.decode();
+        if (tail.length > 0)
+            emit(tail);
     });
 }
 function asString(value) {

package/dist/process-group.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Executor-owned process-group containment (task 0087 R8): deadline resolution,
+ * group liveness probes, SIGTERM→SIGKILL escalation, and reap lifecycle for
+ * process groups spawned by NodeProcessExecutor. Extracted from
+ * process-executor.ts as a pure move — no behavior change.
+ */
+import type { ProcessOutcome } from './process-executor';
+/**
+ * Resolve the effective deadline: omitted inherits the executor default (which may itself
+ * be unlimited), explicit `null` is unlimited and overrides any finite default, and a
+ * finite value must be a positive integer within the native timer range. Invalid values
+ * are rejected before spawn — never clamped and never overflowed onto a timer.
+ */
+export declare function resolveDeadline(optionTimeout: number | null | undefined, defaultTimeout: number | null | undefined): number | null | undefined;
+/**
+ * Resolve the SIGTERM→SIGKILL escalation grace: omitted uses {@link DEFAULT_KILL_GRACE_MS},
+ * `0` escalates immediately, and anything outside the native timer range is rejected.
+ */
+export declare function resolveKillGraceMs(optionGraceMs: number | undefined): number;
+/** Handle for the executor-owned termination of one spawned process group. */
+export interface ProcessGroupOwnership {
+    /**
+     * Settle the run's termination: resolve the outcome delivered by the executor's own
+     * path (deadline `timeout` or external `cancelled`) after the escalation completed, or
+     * reap surviving owned descendants after a natural leader exit (outcome stays `exit`).
+     * Call exactly once, after the execa promise has settled; bounded, never hangs.
+     */
+    finish(): Promise<ProcessOutcome | undefined>;
+    /** Release the deadline timer and abort listener once the execa promise has settled. */
+    stop(): void;
+}
+/**
+ * Own one detached child's process group on Unix. A deadline timer and the caller's abort
+ * signal both feed a single termination path — group SIGTERM, grace, SIGKILL — and after a
+ * natural leader exit surviving owned descendants are reaped with the same sequence, so
+ * completion cannot leak group members holding inherited pipes or database write locks.
+ */
+export declare function ownProcessGroupLifecycle(ownership: {
+    pid: number;
+    deadlineMs: number | undefined;
+    signal: AbortSignal | undefined;
+    graceMs: number;
+}): ProcessGroupOwnership;
+//# sourceMappingURL=process-group.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"process-group.d.ts","sourceRoot":"","sources":["../src/process-group.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAiBzD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACxC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC1C,MAAM,GAAG,IAAI,GAAG,SAAS,CAU3B;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAQ5E;AA+CD,8EAA8E;AAC9E,MAAM,WAAW,qBAAqB;IAClC;;;;;OAKG;IACH,MAAM,IAAI,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC9C,wFAAwF;IACxF,IAAI,IAAI,IAAI,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,SAAS,EAAE;IAChD,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,EAAE,WAAW,GAAG,SAAS,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACnB,GAAG,qBAAqB,CAqCxB"}

package/dist/process-group.js

@@ -0,0 +1,137 @@
+/**
+ * Executor-owned process-group containment (task 0087 R8): deadline resolution,
+ * group liveness probes, SIGTERM→SIGKILL escalation, and reap lifecycle for
+ * process groups spawned by NodeProcessExecutor. Extracted from
+ * process-executor.ts as a pure move — no behavior change.
+ */
+/**
+ * Largest delay accepted by native timers; anything larger would overflow onto an
+ * immediate timer, so deadline/grace values beyond it are rejected before spawn.
+ */
+const MAX_TIMEOUT_MS = 2_147_483_647;
+/** Default grace between the owned group SIGTERM and the SIGKILL escalation. */
+const DEFAULT_KILL_GRACE_MS = 5000;
+/** Poll cadence while waiting for an owned process group to empty. */
+const GROUP_POLL_INTERVAL_MS = 25;
+/** Bounded patience after group SIGKILL before giving up on unkillable (D-state) members. */
+const GROUP_KILL_PATIENCE_MS = 2000;
+/**
+ * Resolve the effective deadline: omitted inherits the executor default (which may itself
+ * be unlimited), explicit `null` is unlimited and overrides any finite default, and a
+ * finite value must be a positive integer within the native timer range. Invalid values
+ * are rejected before spawn — never clamped and never overflowed onto a timer.
+ */
+export function resolveDeadline(optionTimeout, defaultTimeout) {
+    if (optionTimeout === null)
+        return null;
+    const candidate = optionTimeout === undefined ? defaultTimeout : optionTimeout;
+    if (candidate === undefined || candidate === null)
+        return candidate;
+    if (!Number.isInteger(candidate) || candidate <= 0 || candidate > MAX_TIMEOUT_MS) {
+        throw new TypeError(`Process timeout must be a positive integer within the native timer range (1-${MAX_TIMEOUT_MS} ms), got ${String(candidate)}`);
+    }
+    return candidate;
+}
+/**
+ * Resolve the SIGTERM→SIGKILL escalation grace: omitted uses {@link DEFAULT_KILL_GRACE_MS},
+ * `0` escalates immediately, and anything outside the native timer range is rejected.
+ */
+export function resolveKillGraceMs(optionGraceMs) {
+    if (optionGraceMs === undefined)
+        return DEFAULT_KILL_GRACE_MS;
+    if (!Number.isInteger(optionGraceMs) || optionGraceMs < 0 || optionGraceMs > MAX_TIMEOUT_MS) {
+        throw new TypeError(`Process killGraceMs must be a non-negative integer within the native timer range (0-${MAX_TIMEOUT_MS} ms), got ${String(optionGraceMs)}`);
+    }
+    return optionGraceMs;
+}
+/** Whether any member of the owned process group is still alive (signal 0 probe on `-pid`). */
+function groupExists(pid) {
+    try {
+        process.kill(-pid, 0);
+        return true;
+    }
+    catch (error) {
+        // EPERM means the group exists but is not signallable from here.
+        return error.code === 'EPERM';
+    }
+}
+/** Signal the owned process group; `false` when the group is already gone (ESRCH). */
+function signalGroup(pid, signal) {
+    try {
+        process.kill(-pid, signal);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForGroupExit(pid, budgetMs) {
+    const giveUpAt = Date.now() + budgetMs;
+    while (groupExists(pid)) {
+        if (Date.now() >= giveUpAt)
+            return false;
+        await new Promise((resolve) => setTimeout(resolve, GROUP_POLL_INTERVAL_MS));
+    }
+    return true;
+}
+/**
+ * The one termination sequence for an owned Unix process group: group SIGTERM, wait the
+ * grace for the whole group to empty, then group SIGKILL and a bounded settle wait.
+ * Group liveness — not direct-child exit — decides completion, so escalation is never
+ * cancelled because the leader exited first while descendants retain pipes or locks.
+ * Resolves `true` only when a group signal was actually delivered.
+ */
+async function reapProcessGroup(pid, graceMs) {
+    if (!signalGroup(pid, 'SIGTERM'))
+        return false;
+    if (await waitForGroupExit(pid, graceMs))
+        return true;
+    signalGroup(pid, 'SIGKILL');
+    await waitForGroupExit(pid, GROUP_KILL_PATIENCE_MS);
+    return true;
+}
+/**
+ * Own one detached child's process group on Unix. A deadline timer and the caller's abort
+ * signal both feed a single termination path — group SIGTERM, grace, SIGKILL — and after a
+ * natural leader exit surviving owned descendants are reaped with the same sequence, so
+ * completion cannot leak group members holding inherited pipes or database write locks.
+ */
+export function ownProcessGroupLifecycle(ownership) {
+    const { pid, graceMs } = ownership;
+    let trigger;
+    let termination;
+    let timer;
+    const initiate = (reason) => {
+        if (trigger !== undefined)
+            return;
+        trigger = reason;
+        termination = reapProcessGroup(pid, graceMs);
+    };
+    if (ownership.deadlineMs !== undefined) {
+        timer = setTimeout(() => initiate('timeout'), ownership.deadlineMs);
+    }
+    const onAbort = () => initiate('cancelled');
+    if (ownership.signal !== undefined) {
+        if (ownership.signal.aborted)
+            onAbort();
+        else
+            ownership.signal.addEventListener('abort', onAbort, { once: true });
+    }
+    return {
+        finish: async () => {
+            if (trigger === undefined) {
+                // Natural completion: reap stragglers (no-op when the group is already empty).
+                await reapProcessGroup(pid, graceMs);
+                return undefined;
+            }
+            // An undeliverable trigger (group already gone — the child finished first)
+            // yields undefined so the outcome falls back to the natural classification.
+            return (await termination) ? trigger : undefined;
+        },
+        stop: () => {
+            if (timer !== undefined)
+                clearTimeout(timer);
+            ownership.signal?.removeEventListener('abort', onAbort);
+        },
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@gobing-ai/ts-runtime",
-    "version": "0.5.3",
+    "version": "0.5.5",
     "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.5.3",
+        "@gobing-ai/ts-utils": "^0.5.5",
         "execa": "^9.5.0",
         "yaml": "^2.7.0",
         "zod": "^4.1.0"
     },
     "devDependencies": {
-        "@gobing-ai/ts-db": "^0.5.3",
+        "@gobing-ai/ts-db": "^0.5.5",
         "@types/bun": "1.3.14"
     },
     "peerDependencies": {
-        "@gobing-ai/ts-db": "^0.5.3"
+        "@gobing-ai/ts-db": "^0.5.5"
     },
     "peerDependenciesMeta": {
         "@gobing-ai/ts-db": {

package/src/index.ts

@@ -55,13 +55,9 @@ export * from './types';
 
 // ── Deprecated re-exports (backward compatibility) ──────────────────────
 
-export { BunPipeProcessSpawner, BunSyncProcessExecutor } from './process-executor';
-
-/**
- * @deprecated Use {@link ProcessExecutor} directly for async execution.
- * Use `Bun.spawnSync` or `child_process.spawnSync` for sync.
- */
-export type SyncProcessExecutor = InstanceType<typeof import('./process-executor').BunSyncProcessExecutor>;
+/** Sync executor shape (task 0087 R7) — satisfied by NodeSyncProcessExecutor (preferred) and the deprecated BunSyncProcessExecutor. */
+export type { SyncProcessExecutor } from './process-executor';
+export { BunPipeProcessSpawner, BunSyncProcessExecutor, NodeSyncProcessExecutor } from './process-executor';
 
 /**
  * @deprecated Use {@link ProcessExecutor.runStreaming} instead.

package/src/process-executor.ts

@@ -1,6 +1,13 @@
+import { spawnSync } from 'node:child_process';
 import { isatty } from 'node:tty';
 import { type Options as ExecaOptions, execa } from 'execa';
 import { getProcessEnv } from './config';
+import {
+    ownProcessGroupLifecycle,
+    type ProcessGroupOwnership,
+    resolveDeadline,
+    resolveKillGraceMs,
+} from './process-group';
 import type { ProcessExecutionSource, ProcessRegistry } from './process-registry';
 import type { RuntimePaths } from './runtime-paths';
 
@@ -428,7 +435,8 @@ export class NodeProcessExecutor implements ProcessExecutor {
      */
     runStreaming(options: PipeProcessOptions): PipeProcess {
         const args = options.args ?? [];
-        void this.config.tracer?.traceAsync('process.runStreaming', async () => undefined).catch(() => undefined);
+        // Task 0086 R14: no lifetime span here — the empty fire-and-forget span
+        // carried no data and confused span consumers. Registry + events cover it.
         const startedAt = Date.now();
         const startedIso = new Date(startedAt).toISOString();
         // Begin registry before spawn so failed spawns still appear (then complete as error).
@@ -680,7 +688,7 @@ export const ProcessExecutor = NodeProcessExecutor;
  * Synchronous process execution is no longer recommended from ts-runtime.
  * This class is kept for backward compatibility.
  */
-export class BunSyncProcessExecutor {
+export class BunSyncProcessExecutor implements SyncProcessExecutor {
     runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult {
         const args = options.args ?? [];
         const startedAt = Date.now();
@@ -710,6 +718,49 @@ export class BunSyncProcessExecutor {
     }
 }
 
+/**
+ * Sync process execution surface shared by the sync executors (task 0087 R7).
+ * Not deprecated — the deprecated part is the Bun-specific default, not the shape.
+ */
+export interface SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult;
+}
+
+/**
+ * Sync executor on `node:child_process.spawnSync` — the non-deprecated default
+ * for sync callers (task 0087 R7). Contract-compatible with
+ * {@link BunSyncProcessExecutor} for success and non-zero exits. One deliberate
+ * divergence: a spawn failure (e.g. missing binary) maps to exitCode 1 instead of
+ * throwing, so `getGitContextSync`-style probes see a plain non-zero exit.
+ */
+export class NodeSyncProcessExecutor implements SyncProcessExecutor {
+    runSync(options: Omit<ProcessOptions, 'timeout'>): ProcessResult {
+        const args = options.args ?? [];
+        const startedAt = Date.now();
+        const result = spawnSync(options.command, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            ...(options.cwd !== undefined ? { cwd: options.cwd } : {}),
+            ...(options.env !== undefined ? { env: options.env } : {}),
+        });
+        const exitCode = result.status ?? 1;
+        if (options.rejectOnError === true && exitCode !== 0) {
+            throw new Error(
+                `${options.command} ${args.join(' ')} failed with exit code ${exitCode}: ${stripFinalNewline(
+                    asString(result.stderr),
+                )}`,
+            );
+        }
+        return {
+            command: options.command,
+            args,
+            exitCode,
+            stdout: stripFinalNewline(asString(result.stdout)),
+            stderr: stripFinalNewline(asString(result.stderr)),
+            durationMs: Date.now() - startedAt,
+        };
+    }
+}
+
 /**
  * @deprecated Use {@link ProcessExecutor.runStreaming} instead.
  * This class is kept for backward compatibility.
@@ -769,165 +820,6 @@ function buildExecaOptions(opts: {
 }
 
 // ── Deadline and process-group containment ───────────────────────────
-
-/**
- * Largest delay accepted by native timers; anything larger would overflow onto an
- * immediate timer, so deadline/grace values beyond it are rejected before spawn.
- */
-const MAX_TIMEOUT_MS = 2_147_483_647;
-
-/** Default grace between the owned group SIGTERM and the SIGKILL escalation. */
-const DEFAULT_KILL_GRACE_MS = 5000;
-
-/** Poll cadence while waiting for an owned process group to empty. */
-const GROUP_POLL_INTERVAL_MS = 25;
-
-/** Bounded patience after group SIGKILL before giving up on unkillable (D-state) members. */
-const GROUP_KILL_PATIENCE_MS = 2000;
-
-/**
- * Resolve the effective deadline: omitted inherits the executor default (which may itself
- * be unlimited), explicit `null` is unlimited and overrides any finite default, and a
- * finite value must be a positive integer within the native timer range. Invalid values
- * are rejected before spawn — never clamped and never overflowed onto a timer.
- */
-function resolveDeadline(
-    optionTimeout: number | null | undefined,
-    defaultTimeout: number | null | undefined,
-): number | null | undefined {
-    if (optionTimeout === null) return null;
-    const candidate = optionTimeout === undefined ? defaultTimeout : optionTimeout;
-    if (candidate === undefined || candidate === null) return candidate;
-    if (!Number.isInteger(candidate) || candidate <= 0 || candidate > MAX_TIMEOUT_MS) {
-        throw new TypeError(
-            `Process timeout must be a positive integer within the native timer range (1-${MAX_TIMEOUT_MS} ms), got ${String(candidate)}`,
-        );
-    }
-    return candidate;
-}
-
-/**
- * Resolve the SIGTERM→SIGKILL escalation grace: omitted uses {@link DEFAULT_KILL_GRACE_MS},
- * `0` escalates immediately, and anything outside the native timer range is rejected.
- */
-function resolveKillGraceMs(optionGraceMs: number | undefined): number {
-    if (optionGraceMs === undefined) return DEFAULT_KILL_GRACE_MS;
-    if (!Number.isInteger(optionGraceMs) || optionGraceMs < 0 || optionGraceMs > MAX_TIMEOUT_MS) {
-        throw new TypeError(
-            `Process killGraceMs must be a non-negative integer within the native timer range (0-${MAX_TIMEOUT_MS} ms), got ${String(optionGraceMs)}`,
-        );
-    }
-    return optionGraceMs;
-}
-
-/** Whether any member of the owned process group is still alive (signal 0 probe on `-pid`). */
-function groupExists(pid: number): boolean {
-    try {
-        process.kill(-pid, 0);
-        return true;
-    } catch (error) {
-        // EPERM means the group exists but is not signallable from here.
-        return (error as NodeJS.ErrnoException).code === 'EPERM';
-    }
-}
-
-/** Signal the owned process group; `false` when the group is already gone (ESRCH). */
-function signalGroup(pid: number, signal: NodeJS.Signals | number): boolean {
-    try {
-        process.kill(-pid, signal);
-        return true;
-    } catch {
-        return false;
-    }
-}
-
-async function waitForGroupExit(pid: number, budgetMs: number): Promise<boolean> {
-    const giveUpAt = Date.now() + budgetMs;
-    while (groupExists(pid)) {
-        if (Date.now() >= giveUpAt) return false;
-        await new Promise<void>((resolve) => setTimeout(resolve, GROUP_POLL_INTERVAL_MS));
-    }
-    return true;
-}
-
-/**
- * The one termination sequence for an owned Unix process group: group SIGTERM, wait the
- * grace for the whole group to empty, then group SIGKILL and a bounded settle wait.
- * Group liveness — not direct-child exit — decides completion, so escalation is never
- * cancelled because the leader exited first while descendants retain pipes or locks.
- * Resolves `true` only when a group signal was actually delivered.
- */
-async function reapProcessGroup(pid: number, graceMs: number): Promise<boolean> {
-    if (!signalGroup(pid, 'SIGTERM')) return false;
-    if (await waitForGroupExit(pid, graceMs)) return true;
-    signalGroup(pid, 'SIGKILL');
-    await waitForGroupExit(pid, GROUP_KILL_PATIENCE_MS);
-    return true;
-}
-
-/** Handle for the executor-owned termination of one spawned process group. */
-interface ProcessGroupOwnership {
-    /**
-     * Settle the run's termination: resolve the outcome delivered by the executor's own
-     * path (deadline `timeout` or external `cancelled`) after the escalation completed, or
-     * reap surviving owned descendants after a natural leader exit (outcome stays `exit`).
-     * Call exactly once, after the execa promise has settled; bounded, never hangs.
-     */
-    finish(): Promise<ProcessOutcome | undefined>;
-    /** Release the deadline timer and abort listener once the execa promise has settled. */
-    stop(): void;
-}
-
-/**
- * Own one detached child's process group on Unix. A deadline timer and the caller's abort
- * signal both feed a single termination path — group SIGTERM, grace, SIGKILL — and after a
- * natural leader exit surviving owned descendants are reaped with the same sequence, so
- * completion cannot leak group members holding inherited pipes or database write locks.
- */
-function ownProcessGroupLifecycle(ownership: {
-    pid: number;
-    deadlineMs: number | undefined;
-    signal: AbortSignal | undefined;
-    graceMs: number;
-}): ProcessGroupOwnership {
-    const { pid, graceMs } = ownership;
-    let trigger: 'timeout' | 'cancelled' | undefined;
-    let termination: Promise<boolean> | undefined;
-    let timer: ReturnType<typeof setTimeout> | undefined;
-
-    const initiate = (reason: 'timeout' | 'cancelled'): void => {
-        if (trigger !== undefined) return;
-        trigger = reason;
-        termination = reapProcessGroup(pid, graceMs);
-    };
-
-    if (ownership.deadlineMs !== undefined) {
-        timer = setTimeout(() => initiate('timeout'), ownership.deadlineMs);
-    }
-    const onAbort = (): void => initiate('cancelled');
-    if (ownership.signal !== undefined) {
-        if (ownership.signal.aborted) onAbort();
-        else ownership.signal.addEventListener('abort', onAbort, { once: true });
-    }
-
-    return {
-        finish: async () => {
-            if (trigger === undefined) {
-                // Natural completion: reap stragglers (no-op when the group is already empty).
-                await reapProcessGroup(pid, graceMs);
-                return undefined;
-            }
-            // An undeliverable trigger (group already gone — the child finished first)
-            // yields undefined so the outcome falls back to the natural classification.
-            return (await termination) ? trigger : undefined;
-        },
-        stop: () => {
-            if (timer !== undefined) clearTimeout(timer);
-            ownership.signal?.removeEventListener('abort', onAbort);
-        },
-    };
-}
-
 /** Classify an execa rejection on paths where the executor did not own the termination. */
 function classifyFailedCompletion(error: {
     timedOut?: boolean;
@@ -950,16 +842,23 @@ function observeOutput(
     observer: ProcessOptions['onOutput'],
 ): void {
     if (!stream || !observer) return;
-    stream.on('data', (chunk: string | Uint8Array) => {
+    // Task 0086 R13: one decoder per stream with `stream: true` keeps multi-byte
+    // UTF-8 sequences intact across chunk boundaries; a fresh decoder per chunk
+    // would split them into U+FFFD replacement characters.
+    const decoder = new TextDecoder();
+    const emit = (chunk: string) => {
         try {
-            observer({
-                stream: name,
-                chunk: asString(chunk),
-                timestamp: new Date().toISOString(),
-            });
+            observer({ stream: name, chunk, timestamp: new Date().toISOString() });
         } catch {
             // Observability is best-effort and must never interrupt child I/O.
         }
+    };
+    stream.on('data', (chunk: string | Uint8Array) => {
+        emit(typeof chunk === 'string' ? chunk : decoder.decode(chunk, { stream: true }));
+    });
+    stream.on('end', () => {
+        const tail = decoder.decode();
+        if (tail.length > 0) emit(tail);
     });
 }
 

package/src/process-group.ts

@@ -0,0 +1,166 @@
+/**
+ * Executor-owned process-group containment (task 0087 R8): deadline resolution,
+ * group liveness probes, SIGTERM→SIGKILL escalation, and reap lifecycle for
+ * process groups spawned by NodeProcessExecutor. Extracted from
+ * process-executor.ts as a pure move — no behavior change.
+ */
+
+import type { ProcessOutcome } from './process-executor';
+
+/**
+ * Largest delay accepted by native timers; anything larger would overflow onto an
+ * immediate timer, so deadline/grace values beyond it are rejected before spawn.
+ */
+const MAX_TIMEOUT_MS = 2_147_483_647;
+
+/** Default grace between the owned group SIGTERM and the SIGKILL escalation. */
+const DEFAULT_KILL_GRACE_MS = 5000;
+
+/** Poll cadence while waiting for an owned process group to empty. */
+const GROUP_POLL_INTERVAL_MS = 25;
+
+/** Bounded patience after group SIGKILL before giving up on unkillable (D-state) members. */
+const GROUP_KILL_PATIENCE_MS = 2000;
+
+/**
+ * Resolve the effective deadline: omitted inherits the executor default (which may itself
+ * be unlimited), explicit `null` is unlimited and overrides any finite default, and a
+ * finite value must be a positive integer within the native timer range. Invalid values
+ * are rejected before spawn — never clamped and never overflowed onto a timer.
+ */
+export function resolveDeadline(
+    optionTimeout: number | null | undefined,
+    defaultTimeout: number | null | undefined,
+): number | null | undefined {
+    if (optionTimeout === null) return null;
+    const candidate = optionTimeout === undefined ? defaultTimeout : optionTimeout;
+    if (candidate === undefined || candidate === null) return candidate;
+    if (!Number.isInteger(candidate) || candidate <= 0 || candidate > MAX_TIMEOUT_MS) {
+        throw new TypeError(
+            `Process timeout must be a positive integer within the native timer range (1-${MAX_TIMEOUT_MS} ms), got ${String(candidate)}`,
+        );
+    }
+    return candidate;
+}
+
+/**
+ * Resolve the SIGTERM→SIGKILL escalation grace: omitted uses {@link DEFAULT_KILL_GRACE_MS},
+ * `0` escalates immediately, and anything outside the native timer range is rejected.
+ */
+export function resolveKillGraceMs(optionGraceMs: number | undefined): number {
+    if (optionGraceMs === undefined) return DEFAULT_KILL_GRACE_MS;
+    if (!Number.isInteger(optionGraceMs) || optionGraceMs < 0 || optionGraceMs > MAX_TIMEOUT_MS) {
+        throw new TypeError(
+            `Process killGraceMs must be a non-negative integer within the native timer range (0-${MAX_TIMEOUT_MS} ms), got ${String(optionGraceMs)}`,
+        );
+    }
+    return optionGraceMs;
+}
+
+/** Whether any member of the owned process group is still alive (signal 0 probe on `-pid`). */
+function groupExists(pid: number): boolean {
+    try {
+        process.kill(-pid, 0);
+        return true;
+    } catch (error) {
+        // EPERM means the group exists but is not signallable from here.
+        return (error as NodeJS.ErrnoException).code === 'EPERM';
+    }
+}
+
+/** Signal the owned process group; `false` when the group is already gone (ESRCH). */
+function signalGroup(pid: number, signal: NodeJS.Signals | number): boolean {
+    try {
+        process.kill(-pid, signal);
+        return true;
+    } catch {
+        return false;
+    }
+}
+
+async function waitForGroupExit(pid: number, budgetMs: number): Promise<boolean> {
+    const giveUpAt = Date.now() + budgetMs;
+    while (groupExists(pid)) {
+        if (Date.now() >= giveUpAt) return false;
+        await new Promise<void>((resolve) => setTimeout(resolve, GROUP_POLL_INTERVAL_MS));
+    }
+    return true;
+}
+
+/**
+ * The one termination sequence for an owned Unix process group: group SIGTERM, wait the
+ * grace for the whole group to empty, then group SIGKILL and a bounded settle wait.
+ * Group liveness — not direct-child exit — decides completion, so escalation is never
+ * cancelled because the leader exited first while descendants retain pipes or locks.
+ * Resolves `true` only when a group signal was actually delivered.
+ */
+async function reapProcessGroup(pid: number, graceMs: number): Promise<boolean> {
+    if (!signalGroup(pid, 'SIGTERM')) return false;
+    if (await waitForGroupExit(pid, graceMs)) return true;
+    signalGroup(pid, 'SIGKILL');
+    await waitForGroupExit(pid, GROUP_KILL_PATIENCE_MS);
+    return true;
+}
+
+/** Handle for the executor-owned termination of one spawned process group. */
+export interface ProcessGroupOwnership {
+    /**
+     * Settle the run's termination: resolve the outcome delivered by the executor's own
+     * path (deadline `timeout` or external `cancelled`) after the escalation completed, or
+     * reap surviving owned descendants after a natural leader exit (outcome stays `exit`).
+     * Call exactly once, after the execa promise has settled; bounded, never hangs.
+     */
+    finish(): Promise<ProcessOutcome | undefined>;
+    /** Release the deadline timer and abort listener once the execa promise has settled. */
+    stop(): void;
+}
+
+/**
+ * Own one detached child's process group on Unix. A deadline timer and the caller's abort
+ * signal both feed a single termination path — group SIGTERM, grace, SIGKILL — and after a
+ * natural leader exit surviving owned descendants are reaped with the same sequence, so
+ * completion cannot leak group members holding inherited pipes or database write locks.
+ */
+export function ownProcessGroupLifecycle(ownership: {
+    pid: number;
+    deadlineMs: number | undefined;
+    signal: AbortSignal | undefined;
+    graceMs: number;
+}): ProcessGroupOwnership {
+    const { pid, graceMs } = ownership;
+    let trigger: 'timeout' | 'cancelled' | undefined;
+    let termination: Promise<boolean> | undefined;
+    let timer: ReturnType<typeof setTimeout> | undefined;
+
+    const initiate = (reason: 'timeout' | 'cancelled'): void => {
+        if (trigger !== undefined) return;
+        trigger = reason;
+        termination = reapProcessGroup(pid, graceMs);
+    };
+
+    if (ownership.deadlineMs !== undefined) {
+        timer = setTimeout(() => initiate('timeout'), ownership.deadlineMs);
+    }
+    const onAbort = (): void => initiate('cancelled');
+    if (ownership.signal !== undefined) {
+        if (ownership.signal.aborted) onAbort();
+        else ownership.signal.addEventListener('abort', onAbort, { once: true });
+    }
+
+    return {
+        finish: async () => {
+            if (trigger === undefined) {
+                // Natural completion: reap stragglers (no-op when the group is already empty).
+                await reapProcessGroup(pid, graceMs);
+                return undefined;
+            }
+            // An undeliverable trigger (group already gone — the child finished first)
+            // yields undefined so the outcome falls back to the natural classification.
+            return (await termination) ? trigger : undefined;
+        },
+        stop: () => {
+            if (timer !== undefined) clearTimeout(timer);
+            ownership.signal?.removeEventListener('abort', onAbort);
+        },
+    };
+}