claude-code-infinite 1.0.20 → 1.0.21

package/dist/update-lock.js

@@ -0,0 +1,176 @@
+/**
+ * The auto-update install lock: at most one ccc installs at a time.
+ *
+ * A directory of entries, one per acquirer, each under its own random name and
+ * written whole (temp file, then rename). To acquire, write your entry, then
+ * look at everyone else's: if any other entry is live, remove yours and back
+ * off. Of two acquirers, whichever looks second sees the first, so at most one
+ * proceeds (when both look after both wrote, both back off; the next launch
+ * tries again). No process ever deletes or moves a file that a live process
+ * owns or may be creating: an entry is removed only by its owner, or by anyone
+ * once it is stale, and a stale entry's owner is gone and never writes again.
+ *
+ * Each entry has one writer at a time. The launching ccc creates it and,
+ * right after spawning the runner, records the runner's pid; the runner waits
+ * for that handoff before it writes or runs anything (auto-update-runner.ts),
+ * and from then on owns the entry, adding npm's process group while one runs.
+ * An entry is live while any process it names is alive (the launcher, the
+ * runner, or npm's group), however old: a lock is never taken from a live
+ * installer by age. A pid reused by an unrelated process can keep it held;
+ * callers treat a lock held for over UPDATE_LOCK_STALE_MS as stuck and fall
+ * back to the update hint (auto-update.ts). The runner marks its entry
+ * `spawning` before starting npm and clears it once npm's group is recorded:
+ * an entry left `spawning` by a dead runner may have an unrecorded npm
+ * running, so it stays live (fail closed) and, after an hour, the hint shows.
+ * Removing update.lock.d by hand clears it.
+ */
+import { randomUUID } from "node:crypto";
+import * as fs from "node:fs";
+import * as path from "node:path";
+/** Longer than a healthy runner lives (install timeout + kill graces + deadline). */
+export const UPDATE_LOCK_STALE_MS = 60 * 60 * 1000;
+/** An unreadable entry (never written whole) is garbage only after this. */
+export const DEAD_HOLDER_GRACE_MS = 30 * 1000;
+const ENTRY_SUFFIX = ".json";
+/**
+ * Acquire the lock: the owner token, or null when another entry is live (or
+ * changed while being judged).
+ *
+ * Each other entry is read, its named processes checked, then read again: it
+ * counts as stale only if every named process was gone and the entry is
+ * unchanged. Only named processes ever write an entry (the launcher hands
+ * over to the runner, which adds npm's group), and a process found gone
+ * before the second read cannot write after it, so an entry unchanged across
+ * the check stays dead and is safe to remove. A change (say, a handoff landing
+ * mid-check) means it may have a live owner: back off.
+ */
+export function acquireUpdateLock(lockDir, now, 
+/** Test-only: runs between the liveness checks and the second read. */
+afterLivenessCheck) {
+    const token = randomUUID();
+    if (!writeLockEntry(lockDir, { token, startedAt: now, pid: process.pid }))
+        return null;
+    const others = otherEntries(lockDir, token);
+    const allStale = others.every((entry) => entryIsStale(entry, now));
+    afterLivenessCheck?.();
+    if (!allStale || others.some((entry) => changedSince(entry))) {
+        releaseUpdateLock(lockDir, token);
+        return null;
+    }
+    for (const entry of others)
+        fs.rmSync(entry.file, { force: true });
+    return token;
+}
+/** Remove this token's entry (only its owner ever does, or anyone once stale). */
+export function releaseUpdateLock(lockDir, token) {
+    if (!/^[0-9a-f-]{36}$/.test(token))
+        return;
+    fs.rmSync(entryPath(lockDir, token), { force: true });
+}
+/**
+ * The launcher's one write after creating the entry: the runner's pid, so the
+ * entry stays live while the runner exists, even before it has run a line.
+ */
+export function setLockRunner(lockDir, token, runnerPid) {
+    const entry = readEntry(entryPath(lockDir, token))?.data;
+    if (entry?.token !== token)
+        return false;
+    return writeLockEntry(lockDir, { ...entry, runner: runnerPid });
+}
+/** When the oldest live entry was taken, or null when the lock is free. */
+export function liveLockSince(lockDir, now) {
+    const live = otherEntries(lockDir, "").filter((e) => e.data && !entryIsStale(e, now));
+    return live.length ? Math.min(...live.map((e) => e.data.startedAt)) : null;
+}
+export function entryPath(lockDir, token) {
+    return path.join(lockDir, `${token}${ENTRY_SUFFIX}`);
+}
+/** Atomic: readers see a whole entry or none. */
+function writeLockEntry(lockDir, entry) {
+    const tmp = path.join(lockDir, `.${entry.token}.${process.pid}.tmp`);
+    try {
+        fs.mkdirSync(lockDir, { recursive: true, mode: 0o700 });
+        fs.writeFileSync(tmp, JSON.stringify(entry), { mode: 0o600 });
+        fs.renameSync(tmp, entryPath(lockDir, entry.token));
+        return true;
+    }
+    catch {
+        fs.rmSync(tmp, { force: true });
+        return false;
+    }
+}
+/** True when the entry is no longer exactly what was read (gone counts as unchanged). */
+function changedSince(entry) {
+    const again = readEntry(entry.file);
+    return again !== null && (again.raw !== entry.raw || again.mtimeMs !== entry.mtimeMs);
+}
+function otherEntries(lockDir, token) {
+    let names;
+    try {
+        names = fs.readdirSync(lockDir);
+    }
+    catch {
+        return [];
+    }
+    return names
+        .filter((name) => name.endsWith(ENTRY_SUFFIX) && !name.startsWith(".") && name !== `${token}${ENTRY_SUFFIX}`)
+        .map((name) => readEntry(path.join(lockDir, name)))
+        .filter((entry) => entry !== null);
+}
+/** null when the file is gone (released meanwhile). */
+function readEntry(file) {
+    let mtimeMs;
+    let raw;
+    try {
+        mtimeMs = fs.statSync(file).mtimeMs;
+        raw = fs.readFileSync(file, "utf8");
+    }
+    catch {
+        return null;
+    }
+    return { file, data: parseEntry(raw), mtimeMs, raw };
+}
+function parseEntry(raw) {
+    try {
+        const data = JSON.parse(raw);
+        if (typeof data?.token !== "string" || typeof data.startedAt !== "number")
+            return null;
+        const int = (v) => (Number.isInteger(v) && v > 0 ? v : undefined);
+        return {
+            token: data.token,
+            startedAt: data.startedAt,
+            pid: int(data.pid),
+            runner: int(data.runner),
+            group: int(data.group),
+            ...(data.spawning === true ? { spawning: true } : {}),
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Stale only when no process it names is alive (or it was never written whole). */
+function entryIsStale(entry, now) {
+    if (entry.data === null)
+        return now - entry.mtimeMs > DEAD_HOLDER_GRACE_MS;
+    const { pid, runner, group } = entry.data;
+    if (pid !== undefined && processAlive(pid))
+        return false;
+    if (runner !== undefined && processAlive(runner))
+        return false;
+    if (group !== undefined && processAlive(-group))
+        return false;
+    // Its runner died while starting npm: npm may be running unrecorded.
+    return entry.data.spawning !== true;
+}
+/** Signal 0 to a pid (or, negative, a process group). */
+function processAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch (err) {
+        return err.code === "EPERM";
+    }
+}
+//# sourceMappingURL=update-lock.js.map

package/dist/update-lock.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-infinite",
-  "version": "1.0.20",
+  "version": "1.0.21",
   "description": "Wrapper for Claude Code CLI",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",