@wbern/cc-ping 1.4.0 → 1.5.1

package/README.md

@@ -154,6 +154,7 @@ The daemon is smart about what it pings:
 - **Detects system sleep** — if the machine wakes from sleep and a ping cycle is overdue, the daemon notices and factors the delay into notifications
 - **Singleton enforcement** — only one daemon runs at a time, verified by PID and process name
 - **Graceful shutdown** — `daemon stop` writes a sentinel file and waits up to 60s for a clean exit before force-killing
+- **Auto-restart on upgrade** — after upgrading cc-ping, the daemon detects the binary has changed and exits so the service manager can restart it with the new version. `daemon status` warns if the running daemon is outdated
 
 Logs are written to `~/.config/cc-ping/daemon.log`.
 

package/dist/cli.js

@@ -701,6 +701,7 @@ __export(daemon_exports, {
   daemonStopPath: () => daemonStopPath,
   getDaemonStatus: () => getDaemonStatus,
   isProcessRunning: () => isProcessRunning,
+  msUntilUtcHour: () => msUntilUtcHour,
   parseInterval: () => parseInterval,
   readDaemonState: () => readDaemonState,
   removeDaemonState: () => removeDaemonState,
@@ -717,6 +718,8 @@ import {
   openSync as fsOpenSync,
   mkdirSync as mkdirSync4,
   readFileSync as readFileSync6,
+  realpathSync,
+  statSync as statSync2,
   unlinkSync,
   writeFileSync as writeFileSync3
 } from "fs";
@@ -800,13 +803,17 @@ function getDaemonStatus(deps) {
     const nextPingMs = new Date(state.lastPingAt).getTime() + state.intervalMs - Date.now();
     nextPingIn = formatUptime(Math.max(0, nextPingMs));
   }
+  const currentVersion = deps?.currentVersion;
+  const versionMismatch = currentVersion != null && state.version != null ? state.version !== currentVersion : false;
   return {
     running: true,
     pid: state.pid,
     startedAt: state.startedAt,
     intervalMs: state.intervalMs,
     uptime,
-    nextPingIn
+    nextPingIn,
+    versionMismatch,
+    daemonVersion: state.version
   };
 }
 function formatUptime(ms) {
@@ -818,32 +825,47 @@ function formatUptime(ms) {
   if (minutes > 0) return `${minutes}m ${seconds}s`;
   return `${seconds}s`;
 }
+function msUntilUtcHour(targetHour, now) {
+  const currentMs = now.getUTCHours() * 36e5 + now.getUTCMinutes() * 6e4 + now.getUTCSeconds() * 1e3 + now.getUTCMilliseconds();
+  const targetMs = targetHour * 36e5;
+  const diff = targetMs - currentMs;
+  return diff > 0 ? diff : diff + 24 * 36e5;
+}
 async function daemonLoop(intervalMs, options, deps) {
   let wakeDelayMs;
   while (!deps.shouldStop()) {
+    if (deps.hasUpgraded?.()) {
+      deps.log("Binary upgraded, exiting for restart...");
+      return "upgrade";
+    }
     const allAccounts = deps.listAccounts();
     let accounts = deps.isWindowActive ? allAccounts.filter((a) => !deps.isWindowActive(a.handle)) : allAccounts;
     const skipped = allAccounts.length - accounts.length;
     if (skipped > 0) {
       deps.log(`Skipping ${skipped} account(s) with active window`);
     }
+    let soonestDeferHour;
     if (deps.shouldDeferPing) {
       const deferResults = /* @__PURE__ */ new Map();
       for (const a of accounts) {
-        deferResults.set(
-          a.handle,
-          deps.shouldDeferPing(a.handle, a.configDir).defer
-        );
+        deferResults.set(a.handle, deps.shouldDeferPing(a.handle, a.configDir));
       }
-      const deferredCount = [...deferResults.values()].filter(Boolean).length;
-      if (deferredCount > 0) {
-        accounts = accounts.filter((a) => !deferResults.get(a.handle));
-        deps.log(`Deferring ${deferredCount} account(s) (smart scheduling)`);
+      const deferred = [...deferResults.entries()].filter(([, r]) => r.defer);
+      if (deferred.length > 0) {
+        accounts = accounts.filter((a) => !deferResults.get(a.handle)?.defer);
+        deps.log(`Deferring ${deferred.length} account(s) (smart scheduling)`);
+        for (const [, r] of deferred) {
+          if (r.deferUntilUtcHour !== void 0 && (soonestDeferHour === void 0 || /* c8 ignore next -- production default */
+          msUntilUtcHour(r.deferUntilUtcHour, deps.now?.() ?? /* @__PURE__ */ new Date()) < /* c8 ignore next -- production default */
+          msUntilUtcHour(soonestDeferHour, deps.now?.() ?? /* @__PURE__ */ new Date()))) {
+            soonestDeferHour = r.deferUntilUtcHour;
+          }
+        }
       }
     }
     if (accounts.length === 0) {
       deps.log(
-        allAccounts.length === 0 ? "No accounts configured, waiting..." : "All accounts have active windows, waiting..."
+        allAccounts.length === 0 ? "No accounts configured, waiting..." : soonestDeferHour !== void 0 ? "All accounts deferred (smart scheduling), waiting..." : "All accounts have active windows, waiting..."
       );
     } else {
       deps.log(
@@ -872,9 +894,20 @@ async function daemonLoop(intervalMs, options, deps) {
       deps.updateState?.({ lastPingAt: (/* @__PURE__ */ new Date()).toISOString() });
     }
     if (deps.shouldStop()) break;
-    deps.log(`Sleeping ${Math.round(intervalMs / 6e4)}m until next ping...`);
+    let sleepMs = intervalMs;
+    if (soonestDeferHour !== void 0) {
+      const msUntilDefer = msUntilUtcHour(
+        soonestDeferHour,
+        /* c8 ignore next -- production default */
+        deps.now?.() ?? /* @__PURE__ */ new Date()
+      );
+      if (msUntilDefer > 0 && msUntilDefer < intervalMs) {
+        sleepMs = msUntilDefer;
+      }
+    }
+    deps.log(`Sleeping ${Math.round(sleepMs / 6e4)}m until next ping...`);
     const sleepStart = Date.now();
-    await deps.sleep(intervalMs);
+    await deps.sleep(sleepMs);
     const overshootMs = Date.now() - sleepStart - intervalMs;
     if (overshootMs > 6e4) {
       wakeDelayMs = overshootMs;
@@ -883,6 +916,7 @@ async function daemonLoop(intervalMs, options, deps) {
       wakeDelayMs = void 0;
     }
   }
+  return "stop";
 }
 function startDaemon(options, deps) {
   const _getDaemonStatus = deps?.getDaemonStatus ?? getDaemonStatus;
@@ -928,7 +962,8 @@ function startDaemon(options, deps) {
     pid: child.pid,
     startedAt: (/* @__PURE__ */ new Date()).toISOString(),
     intervalMs,
-    configDir
+    configDir,
+    version: options.version
   });
   return { success: true, pid: child.pid };
 }
@@ -999,14 +1034,18 @@ async function runDaemon(intervalMs, options, deps) {
   deps.onSignal("SIGTERM", onSigterm);
   deps.onSignal("SIGINT", onSigint);
   deps.log(`Daemon started. Interval: ${Math.round(intervalMs / 6e4)}m`);
+  let exitReason = "stop";
   try {
-    await daemonLoop(intervalMs, options, deps);
+    exitReason = await daemonLoop(intervalMs, options, deps);
   } finally {
     deps.removeSignal("SIGTERM", onSigterm);
     deps.removeSignal("SIGINT", onSigint);
     deps.log("Daemon stopping...");
     cleanup();
   }
+  if (exitReason === "upgrade") {
+    deps.exit(75);
+  }
 }
 async function runDaemonWithDefaults(intervalMs, options) {
   const stopPath = daemonStopPath();
@@ -1035,6 +1074,8 @@ async function runDaemonWithDefaults(intervalMs, options) {
       return shouldDefer2(/* @__PURE__ */ new Date(), schedule.optimalPingHour);
     };
   }
+  const binaryPath = realpathSync(process.argv[1]);
+  const startMtimeMs = statSync2(binaryPath).mtimeMs;
   await runDaemon(intervalMs, options, {
     runPing: runPing2,
     listAccounts: listAccounts2,
@@ -1043,6 +1084,13 @@ async function runDaemonWithDefaults(intervalMs, options) {
     log: (msg) => console.log(msg),
     isWindowActive: (handle) => getWindowReset2(handle) !== null,
     shouldDeferPing,
+    hasUpgraded: () => {
+      try {
+        return statSync2(binaryPath).mtimeMs !== startMtimeMs;
+      } catch {
+        return false;
+      }
+    },
     updateState: (patch) => {
       const current = readDaemonState();
       if (current) writeDaemonState({ ...current, ...patch });
@@ -1799,7 +1847,7 @@ init_paths();
 init_run_ping();
 
 // src/scan.ts
-import { existsSync as existsSync7, readdirSync, statSync as statSync2 } from "fs";
+import { existsSync as existsSync7, readdirSync, statSync as statSync3 } from "fs";
 import { homedir as homedir2 } from "os";
 import { join as join9 } from "path";
 function scanAccounts(dir) {
@@ -1807,7 +1855,7 @@ function scanAccounts(dir) {
   if (!existsSync7(accountsDir)) return [];
   return readdirSync(accountsDir).filter((name) => {
     const full = join9(accountsDir, name);
-    return statSync2(full).isDirectory() && !name.startsWith(".") && existsSync7(join9(full, ".claude.json"));
+    return statSync3(full).isDirectory() && !name.startsWith(".") && existsSync7(join9(full, ".claude.json"));
   }).map((name) => ({
     handle: name,
     configDir: join9(accountsDir, name)
@@ -1868,7 +1916,7 @@ function suggestAccount(accounts, now = /* @__PURE__ */ new Date()) {
 }
 
 // src/cli.ts
-var program = new Command().name("cc-ping").description("Ping Claude Code sessions to trigger quota windows early").version("1.4.0").option(
+var program = new Command().name("cc-ping").description("Ping Claude Code sessions to trigger quota windows early").version("1.5.1").option(
   "--config <path>",
   "Path to config directory (default: ~/.config/cc-ping, env: CC_PING_CONFIG)"
 ).hook("preAction", (thisCommand) => {
@@ -2088,7 +2136,8 @@ daemon.command("start").description("Start the daemon process").option(
     quiet: opts.quiet,
     bell: opts.bell,
     notify: opts.notify,
-    smartSchedule
+    smartSchedule,
+    version: "1.5.1"
   });
   if (!result.success) {
     console.error(result.error);
@@ -2122,7 +2171,7 @@ daemon.command("stop").description("Stop the daemon process").action(async () =>
 daemon.command("status").description("Show daemon status").option("--json", "Output as JSON", false).action(async (opts) => {
   const { getServiceStatus: getServiceStatus2 } = await Promise.resolve().then(() => (init_service(), service_exports));
   const svc = getServiceStatus2();
-  const status = getDaemonStatus();
+  const status = getDaemonStatus({ currentVersion: "1.5.1" });
   if (opts.json) {
     const serviceInfo = svc.installed ? {
       service: {
@@ -2159,6 +2208,9 @@ daemon.command("status").description("Show daemon status").option("--json", "Out
     return;
   }
   console.log(`Daemon is running (PID: ${status.pid})`);
+  if (status.daemonVersion) {
+    console.log(`  Version: ${status.daemonVersion}`);
+  }
   console.log(`  Started: ${status.startedAt}`);
   console.log(
     `  Interval: ${Math.round((status.intervalMs ?? 0) / 6e4)}m`
@@ -2171,6 +2223,14 @@ daemon.command("status").description("Show daemon status").option("--json", "Out
     const kind = svc.platform === "darwin" ? "launchd" : "systemd";
     console.log(`  System service: installed (${kind})`);
   }
+  if (status.versionMismatch) {
+    console.log(
+      `  Warning: daemon is running v${status.daemonVersion} but v${"1.5.1"} is installed.`
+    );
+    console.log(
+      "  Restart to pick up the new version: cc-ping daemon stop && cc-ping daemon start"
+    );
+  }
   console.log("");
   printAccountTable();
 });
@@ -2227,7 +2287,8 @@ daemon.command("_run", { hidden: true }).option("--interval-ms <ms>", "Ping inte
       pid: process.pid,
       startedAt: (/* @__PURE__ */ new Date()).toISOString(),
       intervalMs,
-      configDir: resolveConfigDir2()
+      configDir: resolveConfigDir2(),
+      version: "1.5.1"
     });
   }
   await runDaemonWithDefaults(intervalMs, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wbern/cc-ping",
-  "version": "1.4.0",
+  "version": "1.5.1",
   "description": "Ping Claude Code sessions to trigger quota windows early across multiple accounts",
   "type": "module",
   "bin": {