@quantiya/codevibe-core 2.0.80 → 2.0.82

package/dist/local-executor/index.d.ts

@@ -55,3 +55,4 @@ export type { AtomicWriteOptions, TeamDeliveryJournalEntry, TeamDeliveryRouting,
 export { WorkspaceShadow, type ShadowEnv, type ShadowDiffFile, } from './workspace-shadow';
 export { runSnapshotMergeGate, createSnapshotTrackBundle, type SnapshotTrackBundle, } from './snapshot-merge';
 export { captureWorkspaceRootAuthority, type WorkspaceRootAuthority, } from './workspace-authority';
+export { executeSpawnSweep, encodeSpawnRecord, defaultReadProcStat, type SpawnSweepRecord, type SpawnSweepResult, type SpawnSweepOptions, type HelperProcStat, } from './spawn-sweep';

package/dist/local-executor/spawn-sweep.d.ts

@@ -0,0 +1,75 @@
+import cp from 'node:child_process';
+export interface SpawnSweepRecord {
+    version: 1;
+    bootId: string;
+    folder: string;
+    pgid?: number;
+    pid?: number;
+    sid?: number;
+    leaderStarttime?: string;
+    sandboxArgv?: readonly string[];
+}
+export interface TargetEndedInfo {
+    pid: number;
+    basis: string;
+}
+export interface BlockerInfo {
+    pid: number;
+    reason: string;
+}
+export interface SpawnSweepResult {
+    version: number;
+    cleanupAllowed: boolean;
+    ended: TargetEndedInfo[];
+    blockers: BlockerInfo[];
+    remaining: number[] | 'incomplete';
+    strandedMembers: number[];
+    recordSha256: string;
+}
+export type ProcStatOutcome = {
+    kind: 'ok';
+    ppid: number;
+    starttime: string;
+} | {
+    kind: 'gone';
+} | {
+    kind: 'error';
+    reason: string;
+};
+export interface HelperProcStat {
+    ppid: number;
+    starttime: string;
+}
+export interface SpawnSweepOptions {
+    record: SpawnSweepRecord;
+    helperBin?: string;
+    timeoutMs?: number;
+    platform?: NodeJS.Platform;
+    /** Injectable `/proc/<pid>/stat` reader for unit tests */
+    readProcStat?: (pid: number) => ProcStatOutcome;
+    /** Injectable spawner for unit tests */
+    spawnHelper?: typeof cp.spawn;
+}
+/** Reset active spawn sweeps map (for test isolation) */
+export declare function _resetActiveSpawnSweeps(): void;
+/**
+ * Encodes the spawn record to the line-delimited format specified in §6.2:
+ *  - version\t1\n
+ *  - bootId\t<36-char lowercase uuid>\n
+ *  - folder\t<hex encoded path>\n
+ *  - [pgid, pid, sid, leaderStarttime]
+ *  - [sandboxArgv\t<hex element 1>\t<hex element 2>...\n]
+ *  - end\n
+ */
+export declare function encodeSpawnRecord(rec: SpawnSweepRecord): string;
+/**
+ * Reads `/proc/<pid>/stat` to extract ppid (field 4) and starttime (field 22).
+ * Distinguishes ENOENT (gone) from read/parse error (§6.2:1738 & §16.1 case 9).
+ */
+export declare function defaultReadProcStat(pid: number): ProcStatOutcome;
+/**
+ * Invokes `codevibe-spawn-sweep` to sweep orphaned processes associated with a spawn.
+ * On Linux, runs the native musl-linked binary. On macOS, returns immediate clean result
+ * since macOS relies on Seatbelt and the POSIX process host (§11).
+ */
+export declare function executeSpawnSweep(opts: SpawnSweepOptions): Promise<SpawnSweepResult>;