claude-code-infinite 1.0.19 → 1.0.21

package/dist/update-check.js

@@ -1,19 +1,29 @@
 /**
  * Startup check for a newer claude-code-infinite release on npm.
  *
- * Detect-and-tell only: ccc is Claude Code's parent process, so a silent
- * `npm -g` write mid-session is never acceptable. The result is surfaced
+ * The check only detects; installing is auto-update.ts, which acts on this
+ * result in the background where that is safe. The result is surfaced
  * inside Claude Code through the SessionStart banner (see notices.ts) — the
  * pre-launch terminal is covered by the TUI within a second, so a line printed
  * there is never read. Bounded by a short timeout and silent on every failure
  * (registry down, offline, malformed JSON, timeout) so startup is never gated
- * on the registry. `CCC_SKIP_UPDATE_CHECK=1` disables the fetch entirely.
+ * on the registry. The registry's answer is cached for a day, so most starts
+ * make no request at all. `CCC_NO_UPDATE_CHECK=1` (or the older
+ * `CCC_SKIP_UPDATE_CHECK=1`), or `"updateCheck": false` in
+ * ~/.claude-code-infinite/config.json, disables the check entirely (and
+ * with it auto-update).
  */
+import * as fs from "node:fs";
+import * as path from "node:path";
 export const PACKAGE_NAME = "claude-code-infinite";
 export const NPM_LATEST_URL = `https://registry.npmjs.org/${PACKAGE_NAME}/latest`;
+export const NO_UPDATE_CHECK_ENV = "CCC_NO_UPDATE_CHECK";
+/** The original opt-out name, still honored. */
 export const SKIP_UPDATE_CHECK_ENV = "CCC_SKIP_UPDATE_CHECK";
-export const UPGRADE_COMMAND = `npm install -g ${PACKAGE_NAME}`;
-const UPDATE_CHECK_TIMEOUT_MS = 2000;
+export const UPGRADE_COMMAND = `npm i -g ${PACKAGE_NAME}@latest`;
+export const UPDATE_CHECK_TIMEOUT_MS = 1500;
+export const UPDATE_CHECK_CACHE_TTL_MS = 24 * 60 * 60 * 1000;
+export const UPDATE_CHECK_CACHE_FILE = "update-check.json";
 // Dotted numeric core with an optional pre-release/build suffix, as npm
 // publishes it. Anything else (a tag name, an error page) is ignored.
 const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+][0-9A-Za-z.-]{0,40})?$/;
@@ -22,12 +32,36 @@ const VERSION_RE = /^v?(\d+)\.(\d+)\.(\d+)(?:[-+][0-9A-Za-z.-]{0,40})?$/;
  * of `currentVersion`, else null. Never rejects.
  */
 export async function checkForUpdate(opts) {
-    const env = opts.env ?? process.env;
-    if (env[SKIP_UPDATE_CHECK_ENV] === "1")
+    if (!updateCheckEnabled(opts.env ?? process.env, opts.config ?? {}))
         return null;
     const current = parseVersion(opts.currentVersion);
     if (current === null)
         return null;
+    const latestRaw = await latestVersion(opts);
+    const latest = latestRaw === null ? null : parseReleaseVersion(latestRaw);
+    if (latest === null || compareVersions(latest, current) <= 0)
+        return null;
+    return { latest: latestRaw, current: opts.currentVersion };
+}
+/** False when the user opted out by env (either name) or config. */
+export function updateCheckEnabled(env, config) {
+    if (env[NO_UPDATE_CHECK_ENV] === "1" || env[SKIP_UPDATE_CHECK_ENV] === "1")
+        return false;
+    return config.updateCheck !== false;
+}
+/** The registry's `latest`, from a fresh cache or a bounded fetch; null on any failure. */
+async function latestVersion(opts) {
+    const now = (opts.now ?? Date.now)();
+    const cached = opts.cacheFile ? readCache(opts.cacheFile) : null;
+    const age = cached ? now - cached.checkedAt : -1;
+    if (cached && age >= 0 && age < UPDATE_CHECK_CACHE_TTL_MS)
+        return cached.latest;
+    const latest = await fetchLatestVersion(opts);
+    if (latest !== null && opts.cacheFile)
+        writeCache(opts.cacheFile, { checkedAt: now, latest });
+    return latest;
+}
+async function fetchLatestVersion(opts) {
     try {
         const fetchImpl = opts.fetchImpl ?? fetch;
         const res = await fetchImpl(opts.url ?? NPM_LATEST_URL, {
@@ -37,11 +71,8 @@ export async function checkForUpdate(opts) {
         if (!res.ok)
             return null;
         const body = (await res.json());
-        const latestRaw = typeof body?.version === "string" ? body.version : "";
-        const latest = parseVersion(latestRaw);
-        if (latest === null || compareVersions(latest, current) <= 0)
-            return null;
-        return { latest: latestRaw, current: opts.currentVersion };
+        const version = typeof body?.version === "string" ? body.version : "";
+        return parseVersion(version) === null ? null : version;
     }
     catch {
         // Registry unreachable, timed out, or answered with something that is
@@ -49,6 +80,42 @@ export async function checkForUpdate(opts) {
         return null;
     }
 }
+function readCache(file) {
+    try {
+        const data = JSON.parse(fs.readFileSync(file, "utf8"));
+        if (typeof data?.checkedAt !== "number" || typeof data.latest !== "string")
+            return null;
+        if (parseVersion(data.latest) === null)
+            return null;
+        return { checkedAt: data.checkedAt, latest: data.latest };
+    }
+    catch {
+        return null;
+    }
+}
+/** Best effort and atomic: a failed write only means the next start fetches again. */
+function writeCache(file, cache) {
+    const tmp = `${file}.${process.pid}.tmp`;
+    try {
+        fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+        fs.writeFileSync(tmp, JSON.stringify(cache), { mode: 0o600 });
+        fs.renameSync(tmp, file);
+    }
+    catch {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch {
+            // Nothing more to clean up.
+        }
+    }
+}
+/** A release version only: prereleases (`1.2.3-beta.1`) are never offered. */
+function parseReleaseVersion(version) {
+    if (/^v?\d+\.\d+\.\d+-/.test(version.trim()))
+        return null;
+    return parseVersion(version);
+}
 /** Parse `1.2.3` (optionally `v`-prefixed / suffixed) into numeric parts. */
 export function parseVersion(version) {
     const match = VERSION_RE.exec(version.trim());

package/dist/update-check.js.map

@@ -1 +1 @@
-{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,MAAM,YAAY,GAAG,sBAAsB,CAAC;AACnD,MAAM,CAAC,MAAM,cAAc,GAAG,8BAA8B,YAAY,SAAS,CAAC;AAClF,MAAM,CAAC,MAAM,qBAAqB,GAAG,uBAAuB,CAAC;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,kBAAkB,YAAY,EAAE,CAAC;AAChE,MAAM,uBAAuB,GAAG,IAAI,CAAC;AAErC,wEAAwE;AACxE,sEAAsE;AACtE,MAAM,UAAU,GAAG,qDAAqD,CAAC;AAiBzE;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,IAAwB;IAExB,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,IAAI,GAAG,CAAC,qBAAqB,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAClD,IAAI,OAAO,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAClC,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QAC1C,MAAM,GAAG,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,IAAI,cAAc,EAAE;YACtD,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE;YACvC,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,IAAI,uBAAuB,CAAC;SACvE,CAAC,CAAC;QACH,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,OAAO,IAAI,CAAC;QACzB,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAA0B,CAAC;QACzD,MAAM,SAAS,GAAG,OAAO,IAAI,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACxE,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,IAAI,IAAI,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QAC1E,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,sEAAsE;QACtE,iEAAiE;QACjE,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,OAAe;IAC1C,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAChE,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAC7B,CAA2B,EAC3B,CAA2B;IAE3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC"}
+{"version":3,"file":"update-check.js","sourceRoot":"","sources":["../src/update-check.ts"],"names":[],"mappings":"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"}

package/dist/update-lock.d.ts

@@ -0,0 +1,68 @@
+/**
+ * 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.
+ */
+/** Longer than a healthy runner lives (install timeout + kill graces + deadline). */
+export declare const UPDATE_LOCK_STALE_MS: number;
+/** An unreadable entry (never written whole) is garbage only after this. */
+export declare const DEAD_HOLDER_GRACE_MS: number;
+export interface LockEntry {
+    token: string;
+    startedAt: number;
+    /** The launching ccc (or the runner, once it owns the entry). */
+    pid?: number;
+    /** The runner, recorded by the launcher right after spawning it. */
+    runner?: number;
+    /** The npm process group the runner started, while it may be alive. */
+    group?: number;
+    /** Set by the runner just before starting npm, cleared once `group` is recorded. */
+    spawning?: boolean;
+}
+/**
+ * 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 declare function acquireUpdateLock(lockDir: string, now: number, 
+/** Test-only: runs between the liveness checks and the second read. */
+afterLivenessCheck?: () => void): string | null;
+/** Remove this token's entry (only its owner ever does, or anyone once stale). */
+export declare function releaseUpdateLock(lockDir: string, token: string): void;
+/**
+ * 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 declare function setLockRunner(lockDir: string, token: string, runnerPid: number): boolean;
+/** When the oldest live entry was taken, or null when the lock is free. */
+export declare function liveLockSince(lockDir: string, now: number): number | null;
+export declare function entryPath(lockDir: string, token: string): string;
+//# sourceMappingURL=update-lock.d.ts.map

package/dist/update-lock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update-lock.d.ts","sourceRoot":"","sources":["../src/update-lock.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,qFAAqF;AACrF,eAAO,MAAM,oBAAoB,QAAiB,CAAC;AACnD,4EAA4E;AAC5E,eAAO,MAAM,oBAAoB,QAAY,CAAC;AAG9C,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oFAAoF;IACpF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,GAAG,EAAE,MAAM;AACX,uEAAuE;AACvE,kBAAkB,CAAC,EAAE,MAAM,IAAI,GAC9B,MAAM,GAAG,IAAI,CAYf;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAGtE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAIxF;AAED,2EAA2E;AAC3E,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGzE;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhE"}

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":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC,qFAAqF;AACrF,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AACnD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,EAAE,GAAG,IAAI,CAAC;AAC9C,MAAM,YAAY,GAAG,OAAO,CAAC;AAe7B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAAe,EACf,GAAW;AACX,uEAAuE;AACvE,kBAA+B;IAE/B,MAAM,KAAK,GAAG,UAAU,EAAE,CAAC;IAC3B,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,CAAC;QAAE,OAAO,IAAI,CAAC;IACvF,MAAM,MAAM,GAAG,YAAY,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IACnE,kBAAkB,EAAE,EAAE,CAAC;IACvB,IAAI,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;QAC7D,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM;QAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,kFAAkF;AAClF,MAAM,UAAU,iBAAiB,CAAC,OAAe,EAAE,KAAa;IAC9D,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO;IAC3C,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,KAAa,EAAE,SAAiB;IAC7E,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;IACzD,IAAI,KAAK,EAAE,KAAK,KAAK,KAAK;QAAE,OAAO,KAAK,CAAC;IACzC,OAAO,cAAc,CAAC,OAAO,EAAE,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;AAClE,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,aAAa,CAAC,OAAe,EAAE,GAAW;IACxD,MAAM,IAAI,GAAG,YAAY,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACtF,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAC9E,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,OAAe,EAAE,KAAa;IACtD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,KAAK,GAAG,YAAY,EAAE,CAAC,CAAC;AACvD,CAAC;AAED,iDAAiD;AACjD,SAAS,cAAc,CAAC,OAAe,EAAE,KAAgB;IACvD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,KAAK,CAAC,KAAK,IAAI,OAAO,CAAC,GAAG,MAAM,CAAC,CAAC;IACrE,IAAI,CAAC;QACH,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QACxD,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9D,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,SAAS,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAChC,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAUD,yFAAyF;AACzF,SAAS,YAAY,CAAC,KAAgB;IACpC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,KAAK,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,OAAO,CAAC,CAAC;AACxF,CAAC;AAED,SAAS,YAAY,CAAC,OAAe,EAAE,KAAa;IAClD,IAAI,KAAe,CAAC;IACpB,IAAI,CAAC;QACH,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,OAAO,KAAK;SACT,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,GAAG,KAAK,GAAG,YAAY,EAAE,CAAC;SAC5G,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,KAAK,EAAsB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC;AAC3D,CAAC;AAED,uDAAuD;AACvD,SAAS,SAAS,CAAC,IAAY;IAC7B,IAAI,OAAe,CAAC;IACpB,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QACH,OAAO,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC;QACpC,GAAG,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;AACvD,CAAC;AAED,SAAS,UAAU,CAAC,GAAW;IAC7B,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,OAAO,IAAI,EAAE,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvF,MAAM,GAAG,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,IAAK,CAAY,GAAG,CAAC,CAAC,CAAC,CAAE,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QACnG,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;YAClB,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;YACxB,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC;YACtB,GAAG,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACtD,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,SAAS,YAAY,CAAC,KAAgB,EAAE,GAAW;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI;QAAE,OAAO,GAAG,GAAG,KAAK,CAAC,OAAO,GAAG,oBAAoB,CAAC;IAC3E,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC;IAC1C,IAAI,GAAG,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,MAAM,KAAK,SAAS,IAAI,YAAY,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/D,IAAI,KAAK,KAAK,SAAS,IAAI,YAAY,CAAC,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9D,qEAAqE;IACrE,OAAO,KAAK,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,CAAC;AACtC,CAAC;AAED,yDAAyD;AACzD,SAAS,YAAY,CAAC,GAAW;IAC/B,IAAI,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAQ,GAA6B,CAAC,IAAI,KAAK,OAAO,CAAC;IACzD,CAAC;AACH,CAAC"}

package/package.json

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