create-principles-disciple 1.145.20 → 1.145.21

package/pd-cli/dist/commands/worker-drain.js

@@ -0,0 +1,51 @@
+/** Private Companion IPC. Stops between cycles; never interrupts an active cycle. */
+export function createWorkerDrain() {
+    let stopped = false;
+    let wake;
+    const stop = () => { stopped = true; wake?.(); };
+    const onMessage = (value) => {
+        if (value !== null && typeof value === 'object'
+            && Object.hasOwn(value, 'type') && Reflect.get(value, 'type') === 'pd.worker.drain.v1')
+            stop();
+    };
+    process.on('SIGINT', stop);
+    process.on('SIGTERM', stop);
+    // Other hosts (including test runners) also use Node IPC; they do not opt
+    // into Companion's private lifecycle protocol.
+    const managedIpc = process.env.PD_COMPANION_WORKER_IPC === '1';
+    if (managedIpc && process.send !== undefined) {
+        process.on('message', onMessage);
+        const reportUnavailable = () => { console.error('[PD:Worker] drain IPC unavailable; safely restart Companion after the current cycle.'); };
+        try {
+            process.send({ type: 'pd.worker.drain-ready.v1' }, (error) => { if (error !== null)
+                reportUnavailable(); });
+        }
+        catch {
+            reportUnavailable();
+        }
+    }
+    return {
+        get stopped() { return stopped; },
+        async wait(interval) {
+            if (stopped)
+                return;
+            await new Promise((resolve) => {
+                let timer;
+                const done = () => { clearTimeout(timer); wake = undefined; resolve(); };
+                timer = setTimeout(done, interval);
+                wake = done;
+                if (stopped)
+                    done();
+            });
+        },
+        dispose() {
+            process.off('SIGINT', stop);
+            process.off('SIGTERM', stop);
+            process.off('message', onMessage);
+            // An open IPC channel must not keep a drained CLI alive.
+            if (managedIpc && process.send !== undefined && process.connected)
+                process.disconnect?.();
+        },
+    };
+}
+//# sourceMappingURL=worker-drain.js.map

package/pd-cli/dist/commands/worker-drain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker-drain.js","sourceRoot":"","sources":["../../src/commands/worker-drain.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,IAA8B,CAAC;IACnC,MAAM,IAAI,GAAG,GAAS,EAAE,GAAG,OAAO,GAAG,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;IACvD,MAAM,SAAS,GAAG,CAAC,KAAc,EAAQ,EAAE;QACzC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;eAC1C,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,oBAAoB;YAAE,IAAI,EAAE,CAAC;IACnG,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC3B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5B,0EAA0E;IAC1E,+CAA+C;IAC/C,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,GAAG,CAAC;IAC/D,IAAI,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACjC,MAAM,iBAAiB,GAAG,GAAS,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,sFAAsF,CAAC,CAAC,CAAC,CAAC,CAAC;QACjJ,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,0BAA0B,EAAE,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,KAAK,KAAK,IAAI;gBAAE,iBAAiB,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9G,CAAC;QAAC,MAAM,CAAC;YAAC,iBAAiB,EAAE,CAAC;QAAC,CAAC;IAClC,CAAC;IACD,OAAO;QACL,IAAI,OAAO,KAAc,OAAO,OAAO,CAAC,CAAC,CAAC;QAC1C,KAAK,CAAC,IAAI,CAAC,QAAgB;YACzB,IAAI,OAAO;gBAAE,OAAO;YACpB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,IAAI,KAAoC,CAAC;gBACzC,MAAM,IAAI,GAAG,GAAS,EAAE,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC;gBAC/E,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;gBACnC,IAAI,GAAG,IAAI,CAAC;gBACZ,IAAI,OAAO;oBAAE,IAAI,EAAE,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;YAC5B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YAC7B,OAAO,CAAC,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;YAClC,yDAAyD;YACzD,IAAI,UAAU,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,SAAS;gBAAE,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;QAC5F,CAAC;KACF,CAAC;AACJ,CAAC"}

package/pd-cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@principles/pd-cli",
-  "version": "1.158.7",
+  "version": "1.159.0",
   "description": "PD CLI — Pain recording, sample management, and governance tasks for Principles Disciple",
   "type": "module",
   "bin": {