@ckanner/flywheel 0.32.1 → 0.33.1

package/node_modules/dsh-subagent-codex-pro/lib/process-guardian.js

@@ -0,0 +1,156 @@
+/**
+ * Private POSIX group guardian for one Codex app-server.
+ *
+ * The caller creates this process as a group leader and establishes the IPC
+ * lifeline in the same spawn operation. Codex inherits this group, but never
+ * the IPC descriptor. An abruptly killed caller therefore closes the lifeline
+ * even if Codex is hung, before or after initialization. The guardian then
+ * terminates only its own group with a finite TERM/KILL sequence.
+ *
+ * A live caller can request a normal stop with SIGTERM/SIGINT. In that case the
+ * caller keeps ownership and confirms the group itself, so this process exits
+ * as soon as the app-server exits instead of making every normal delegation
+ * sleep the whole dispose grace. A caller death (IPC disconnect) keeps the
+ * full grace: there the guardian is the last group owner and must clean up
+ * descendants that outlive the app-server.
+ *
+ * Normal cleanup is confirmed by the surviving caller with kill(-pgid, 0).
+ * Emergency cleanup cannot write a final receipt after killing this guardian;
+ * missing app-server exit facts must remain unknown in the caller's receipt.
+ */
+import { spawn } from 'node:child_process';
+import { closeSync } from 'node:fs';
+const command = process.argv[2];
+const graceMs = Number(process.argv[3]);
+const posix = process.platform !== 'win32';
+let child;
+let stopping = false;
+let callerGone = false;
+let callerRequestedStop = false;
+let childDone = false;
+let exiting = false;
+function closeProtocolDescriptors() {
+    // Let the caller observe EOF after all app-server output has drained. Keep
+    // only our private IPC lease; Codex descendants may still hold their copies.
+    for (const fd of [0, 1, 2]) {
+        try {
+            closeSync(fd);
+        }
+        catch { /* already closed */ }
+    }
+}
+function exitAfterCallerStop() {
+    if (exiting || callerGone || !callerRequestedStop || !childDone)
+        return;
+    exiting = true;
+    // Let the exit IPC frame reach the caller. The grace timer remains armed:
+    // if the caller disappears in this window, the guardian must keep owning
+    // the group until the timer's SIGKILL instead of exiting early.
+    setImmediate(() => {
+        if (callerGone || !callerRequestedStop || !childDone) {
+            exiting = false;
+            return;
+        }
+        process.exit(0);
+    });
+}
+function beginShutdown(reason) {
+    if (reason === 'caller')
+        callerRequestedStop = true;
+    else
+        callerGone = true;
+    if (stopping) {
+        exitAfterCallerStop();
+        return;
+    }
+    stopping = true;
+    // Set the guard before signaling this group: SIGTERM also reaches us.
+    try {
+        if (posix)
+            process.kill(-process.pid, 'SIGTERM');
+        else
+            child?.kill('SIGTERM');
+    }
+    catch { /* The caller independently checks its owned group. */ }
+    if (callerRequestedStop && !callerGone && childDone) {
+        exitAfterCallerStop();
+        return;
+    }
+    setTimeout(() => {
+        try {
+            if (posix)
+                process.kill(-process.pid, 'SIGKILL');
+            else
+                child?.kill('SIGKILL');
+        }
+        finally {
+            // SIGKILL above is synchronous on POSIX; Windows has no group guarantee.
+            process.exit(1);
+        }
+    }, graceMs);
+}
+function report(message, afterSend) {
+    if (!process.connected || process.send === undefined) {
+        afterSend?.();
+        beginShutdown('disconnect');
+        return;
+    }
+    try {
+        process.send(message, (error) => {
+            if (error !== null) {
+                beginShutdown('disconnect');
+                return;
+            }
+            afterSend?.();
+        });
+    }
+    catch {
+        beginShutdown('disconnect');
+    }
+}
+// Install the handlers before starting any work. A parent can die before this
+// module starts executing; checking connected also covers that missed event.
+process.on('disconnect', () => { beginShutdown('disconnect'); });
+process.on('SIGTERM', () => { beginShutdown('caller'); });
+process.on('SIGINT', () => { beginShutdown('caller'); });
+if (command === undefined || !Number.isSafeInteger(graceMs) || graceMs < 0 || graceMs > 30_000) {
+    childDone = true;
+    report({ type: 'spawn-error', message: 'invalid private guardian arguments' });
+    beginShutdown('disconnect');
+}
+else if (!process.connected) {
+    beginShutdown('disconnect');
+}
+else {
+    const env = { ...process.env };
+    delete env.NODE_CHANNEL_FD;
+    delete env.NODE_CHANNEL_SERIALIZATION_MODE;
+    try {
+        child = spawn(command, ['app-server', '--stdio'], {
+            cwd: process.cwd(), env, stdio: ['inherit', 'inherit', 'inherit'],
+            detached: false, windowsHide: true,
+        });
+        child.once('spawn', () => { report({ type: 'started', pid: child?.pid }); });
+        child.once('error', (error) => {
+            childDone = true;
+            closeProtocolDescriptors();
+            report({ type: 'spawn-error', message: error.message }, () => { exitAfterCallerStop(); });
+        });
+        child.once('exit', (exitCode, signal) => {
+            childDone = true;
+            closeProtocolDescriptors();
+            report({ type: 'exit', exitCode, signal }, () => { exitAfterCallerStop(); });
+        });
+        // No immediate process.exit here: when the caller is alive it will request
+        // cleanup. If the caller dies, the IPC disconnect handler keeps the full
+        // grace to own and terminate descendants. A caller-requested stop exits
+        // from the exit/error callbacks above once the app-server is gone.
+    }
+    catch (error) {
+        childDone = true;
+        report({ type: 'spawn-error', message: error instanceof Error ? error.message : String(error) }, () => { exitAfterCallerStop(); });
+    }
+    if (!process.connected)
+        beginShutdown('disconnect');
+}
+//# sourceMappingURL=process-guardian.js.map

package/node_modules/dsh-subagent-codex-pro/lib/process-guardian.js.map

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