@cruxy/cli 1.11.1 → 1.11.2

package/dist/utils/process-owner.js

@@ -0,0 +1,107 @@
+import { execFileSync } from "node:child_process";
+import { readFileSync } from "node:fs";
+/** The token when the platform lookup failed: liveness falls back to pid-only. */
+export const UNKNOWN_TOKEN = "unknown";
+/** The start-time token for `pid`, or {@link UNKNOWN_TOKEN} when unobtainable. */
+export function startToken(pid) {
+    try {
+        if (process.platform === "linux")
+            return linuxToken(pid);
+        if (process.platform === "darwin")
+            return darwinToken(pid);
+        if (process.platform === "win32")
+            return win32Token(pid);
+    }
+    catch {
+        // fall through — the platform said no; degrade to pid-only
+    }
+    return UNKNOWN_TOKEN;
+}
+/** This process's own stamp. Computed once — a process's identity never changes. */
+export function selfStamp() {
+    if (!self) {
+        self = {
+            pid: process.pid,
+            token: startToken(process.pid),
+            startedAt: new Date(Date.now() - process.uptime() * 1000).toISOString(),
+        };
+    }
+    return self;
+}
+let self;
+/** Whether a process with `pid` exists (EPERM counts: it exists, just not ours). */
+export function pidAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+/**
+ * Classify a stamp against the live process table. Order matters: `self` is
+ * decided by pid AND token, so a stamp our own pid inherited from a crashed
+ * predecessor (pid recycled onto us) still reads as stale.
+ */
+export function describeOwner(stamp) {
+    const me = selfStamp();
+    if (stamp.pid === me.pid) {
+        return stamp.token === me.token ? "self" : "stale";
+    }
+    if (!pidAlive(stamp.pid))
+        return "stale";
+    // Alive by pid. If both sides have a real token and they differ, the pid was
+    // recycled. An unknown token on either side cannot prove that, so the stamp
+    // is treated as live — the documented pid-only degradation.
+    if (stamp.token === UNKNOWN_TOKEN)
+        return "live";
+    const now = startToken(stamp.pid);
+    if (now === UNKNOWN_TOKEN)
+        return "live";
+    return now === stamp.token ? "live" : "stale";
+}
+// ── platform lookups ──────────────────────────────────────────────────────────
+function linuxToken(pid) {
+    const stat = readFileSync(`/proc/${pid}/stat`, "utf8");
+    // The comm field is parenthesised and may itself contain spaces or parens;
+    // everything after the LAST `)` is the fixed-position numeric tail, in which
+    // starttime is the 20th entry (field 22 of the whole line).
+    const tail = stat
+        .slice(stat.lastIndexOf(")") + 2)
+        .trim()
+        .split(/\s+/);
+    const starttime = tail[19];
+    if (!starttime)
+        throw new Error("unexpected /proc stat shape");
+    let boot = "";
+    try {
+        boot = readFileSync("/proc/sys/kernel/random/boot_id", "utf8").trim();
+    }
+    catch {
+        // Older kernels / locked-down containers: the token is still per-boot in
+        // practice (ticks since boot), just not provably so across reboots.
+    }
+    return `linux:${boot}:${starttime}`;
+}
+function darwinToken(pid) {
+    const out = execFileSync("ps", ["-o", "lstart=", "-p", String(pid)], {
+        encoding: "utf8",
+        stdio: ["ignore", "pipe", "ignore"],
+        timeout: 2000,
+    }).trim();
+    if (out === "")
+        throw new Error("no such process");
+    return `darwin:${out.replace(/\s+/g, " ")}`;
+}
+function win32Token(pid) {
+    const out = execFileSync("powershell", [
+        "-NoProfile",
+        "-NonInteractive",
+        "-Command",
+        `(Get-Process -Id ${pid} -ErrorAction Stop).StartTime.ToString('o')`,
+    ], { encoding: "utf8", stdio: ["ignore", "pipe", "ignore"], timeout: 5000 }).trim();
+    if (out === "")
+        throw new Error("no such process");
+    return `win32:${out}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cruxy/cli",
-  "version": "1.11.1",
+  "version": "1.11.2",
   "description": "an agentic coding CLI",
   "type": "module",
   "bin": {
@@ -32,8 +32,9 @@
     "commander": "^12.1.0",
     "fastembed": "^2.1.0",
     "picocolors": "^1.1.1",
+    "tar": "^7.5.22",
     "tinyglobby": "^0.2.10",
-    "undici": "^6.21.0",
+    "undici": "^6.28.1",
     "zod": "^3.23.8",
     "zod-to-json-schema": "^3.23.5",
     "@cruxy/sdk": "0.8.0"