@wbern/cc-ping 1.0.0 → 1.2.0

package/README.md

@@ -90,7 +90,7 @@ Show all accounts with their quota window state — whether they have an active
 
 ### `cc-ping suggest`
 
-Recommend which account to use next based on quota window state. Prefers accounts whose windows have already expired or are about to.
+Recommend which account to use next based on quota window state. Prefers accounts that need pinging or whose windows are about to reset.
 
 ### `cc-ping next-reset`
 

package/dist/cli.js

@@ -186,6 +186,26 @@ var init_bell = __esm({
   }
 });
 
+// src/color.ts
+function isColorEnabled() {
+  if (process.env.NO_COLOR) return false;
+  if (process.env.FORCE_COLOR === "1") return true;
+  if (process.env.FORCE_COLOR === "0") return false;
+  return process.stdout.isTTY ?? false;
+}
+function wrap(code, text) {
+  return isColorEnabled() ? `\x1B[${code}m${text}\x1B[0m` : text;
+}
+var green, red, yellow;
+var init_color = __esm({
+  "src/color.ts"() {
+    "use strict";
+    green = (text) => wrap("32", text);
+    red = (text) => wrap("31", text);
+    yellow = (text) => wrap("33", text);
+  }
+});
+
 // src/history.ts
 import { appendFileSync, existsSync as existsSync4, mkdirSync as mkdirSync3, readFileSync as readFileSync4 } from "fs";
 import { join as join5 } from "path";
@@ -463,13 +483,13 @@ async function runPing(accounts, options) {
       parallel: options.parallel
     });
   }
-  for (const r of results) {
-    const status = r.success ? "ok" : "FAIL";
+  const total = results.length;
+  for (let idx = 0; idx < results.length; idx++) {
+    const r = results[idx];
+    const status = r.success ? green("ok") : red("FAIL");
     const detail = r.error ? ` (${r.error})` : "";
-    const cr = r.claudeResponse;
-    const costInfo = cr ? `  $${cr.total_cost_usd.toFixed(4)} ${cr.usage.input_tokens + cr.usage.output_tokens} tok` : "";
     logger.log(
-      `  ${r.handle}: ${status} ${r.durationMs}ms${detail}${costInfo}`
+      `  [${idx + 1}/${total}] ${r.handle}: ${status} ${r.durationMs}ms${detail}`
     );
     appendHistoryEntry({
       timestamp: (/* @__PURE__ */ new Date()).toISOString(),
@@ -480,13 +500,13 @@ async function runPing(accounts, options) {
     });
     if (r.success) {
       let meta;
-      if (cr) {
+      if (r.claudeResponse) {
         meta = {
-          costUsd: cr.total_cost_usd,
-          inputTokens: cr.usage.input_tokens,
-          outputTokens: cr.usage.output_tokens,
-          model: cr.model,
-          sessionId: cr.session_id
+          costUsd: r.claudeResponse.total_cost_usd,
+          inputTokens: r.claudeResponse.usage.input_tokens,
+          outputTokens: r.claudeResponse.usage.output_tokens,
+          model: r.claudeResponse.model,
+          sessionId: r.claudeResponse.session_id
         };
       }
       recordPing(r.handle, /* @__PURE__ */ new Date(), meta);
@@ -544,6 +564,7 @@ var init_run_ping = __esm({
   "src/run-ping.ts"() {
     "use strict";
     init_bell();
+    init_color();
     init_history();
     init_logger();
     init_notify();
@@ -1402,27 +1423,8 @@ function generateCompletion(shell) {
 init_config();
 init_daemon();
 
-// src/filter-accounts.ts
-function filterAccounts(accounts, handles) {
-  if (handles.length === 0) return accounts;
-  const unknown = handles.filter((h) => !accounts.some((a) => a.handle === h));
-  if (unknown.length > 0) {
-    throw new Error(`Unknown account(s): ${unknown.join(", ")}`);
-  }
-  const set = new Set(handles);
-  return accounts.filter((a) => set.has(a.handle));
-}
-function filterByGroup(accounts, group) {
-  if (!group) return accounts;
-  const filtered = accounts.filter((a) => a.group === group);
-  if (filtered.length === 0) {
-    throw new Error(`No accounts in group: ${group}`);
-  }
-  return filtered;
-}
-
-// src/cli.ts
-init_history();
+// src/default-command.ts
+init_config();
 
 // src/identity.ts
 import { readFileSync as readFileSync6 } from "fs";
@@ -1471,76 +1473,25 @@ function findDuplicates(accounts) {
   return result;
 }
 
-// src/next-reset.ts
-init_state();
-function getNextReset(accounts, now = /* @__PURE__ */ new Date()) {
-  let best = null;
-  for (const account of accounts) {
-    const window = getWindowReset(account.handle, now);
-    if (!window) continue;
-    if (best === null || window.remainingMs < best.remainingMs) {
-      best = {
-        handle: account.handle,
-        configDir: account.configDir,
-        remainingMs: window.remainingMs,
-        resetAt: window.resetAt.toISOString(),
-        timeUntilReset: formatTimeRemaining(window.remainingMs)
-      };
-    }
-  }
-  return best;
-}
-
-// src/cli.ts
-init_notify();
-init_paths();
-init_run_ping();
-
-// src/scan.ts
-import { existsSync as existsSync6, readdirSync, statSync as statSync2 } from "fs";
-import { homedir as homedir2 } from "os";
-import { join as join8 } from "path";
-var ACCOUNTS_DIR = join8(homedir2(), ".claude-accounts");
-function scanAccounts() {
-  if (!existsSync6(ACCOUNTS_DIR)) return [];
-  return readdirSync(ACCOUNTS_DIR).filter((name) => {
-    const full = join8(ACCOUNTS_DIR, name);
-    return statSync2(full).isDirectory() && !name.startsWith(".");
-  }).map((name) => ({
-    handle: name,
-    configDir: join8(ACCOUNTS_DIR, name)
-  }));
-}
-
-// src/stagger.ts
-init_state();
-function calculateStagger(accountCount, windowMs = QUOTA_WINDOW_MS) {
-  if (accountCount <= 1) return 0;
-  return Math.floor(windowMs / accountCount);
-}
-function parseStagger(value, accountCount) {
-  if (value === "auto") {
-    return calculateStagger(accountCount);
-  }
-  const minutes = Number(value);
-  if (Number.isNaN(minutes)) {
-    throw new Error(`Invalid stagger value: ${value}`);
-  }
-  if (minutes <= 0) {
-    throw new Error("Stagger must be a positive number");
-  }
-  return minutes * 60 * 1e3;
-}
-
 // src/status.ts
+init_color();
 init_config();
 init_state();
+function colorizeStatus(windowStatus) {
+  switch (windowStatus) {
+    case "active":
+      return green(windowStatus);
+    case "needs ping":
+      return red(windowStatus);
+    default:
+      return yellow(windowStatus);
+  }
+}
 function formatStatusLine(status) {
   const ping = status.lastPing === null ? "never" : status.lastPing.replace("T", " ").replace(/\.\d+Z$/, "Z");
   const reset = status.timeUntilReset !== null ? ` (resets in ${status.timeUntilReset})` : "";
-  const cost = status.lastCostUsd !== null && status.lastTokens !== null ? `  $${status.lastCostUsd.toFixed(4)} ${status.lastTokens} tok` : "";
   const dup = status.duplicateOf ? `  [duplicate of ${status.duplicateOf}]` : "";
-  return `  ${status.handle}: ${status.windowStatus}  last ping: ${ping}${reset}${cost}${dup}`;
+  return `  ${status.handle}: ${colorizeStatus(status.windowStatus)}  last ping: ${ping}${reset}${dup}`;
 }
 function getAccountStatuses(accounts, now = /* @__PURE__ */ new Date(), duplicates) {
   const dupLookup = /* @__PURE__ */ new Map();
@@ -1575,7 +1526,7 @@ function getAccountStatuses(accounts, now = /* @__PURE__ */ new Date(), duplicat
       handle: account.handle,
       configDir: account.configDir,
       lastPing: lastPing.toISOString(),
-      windowStatus: window ? "active" : "expired",
+      windowStatus: window ? "active" : "needs ping",
       timeUntilReset: window ? formatTimeRemaining(window.remainingMs) : null,
       lastCostUsd,
       lastTokens,
@@ -1596,6 +1547,117 @@ function printAccountTable(log = console.log, now = /* @__PURE__ */ new Date())
   }
 }
 
+// src/default-command.ts
+function showDefault(log = console.log, now = /* @__PURE__ */ new Date()) {
+  const accounts = listAccounts();
+  if (accounts.length === 0) {
+    log("No accounts configured.");
+    log("\nGet started:");
+    log("  cc-ping scan        Auto-discover accounts");
+    log("  cc-ping add <h> <d> Add an account manually");
+    return;
+  }
+  const dupes = findDuplicates(accounts);
+  const statuses = getAccountStatuses(accounts, now, dupes);
+  for (const s of statuses) {
+    log(formatStatusLine(s));
+  }
+  const needsPing = statuses.filter((s) => s.windowStatus !== "active");
+  if (needsPing.length > 0) {
+    log("");
+    log("Suggested next steps:");
+    log("  cc-ping ping              Ping accounts that need it");
+    log("  cc-ping daemon start      Auto-ping on a schedule");
+  }
+}
+
+// src/filter-accounts.ts
+init_state();
+function filterAccounts(accounts, handles) {
+  if (handles.length === 0) return accounts;
+  const unknown = handles.filter((h) => !accounts.some((a) => a.handle === h));
+  if (unknown.length > 0) {
+    throw new Error(`Unknown account(s): ${unknown.join(", ")}`);
+  }
+  const set = new Set(handles);
+  return accounts.filter((a) => set.has(a.handle));
+}
+function filterNeedsPing(accounts, now = /* @__PURE__ */ new Date()) {
+  return accounts.filter((a) => !getWindowReset(a.handle, now));
+}
+function filterByGroup(accounts, group) {
+  if (!group) return accounts;
+  const filtered = accounts.filter((a) => a.group === group);
+  if (filtered.length === 0) {
+    throw new Error(`No accounts in group: ${group}`);
+  }
+  return filtered;
+}
+
+// src/cli.ts
+init_history();
+
+// src/next-reset.ts
+init_state();
+function getNextReset(accounts, now = /* @__PURE__ */ new Date()) {
+  let best = null;
+  for (const account of accounts) {
+    const window = getWindowReset(account.handle, now);
+    if (!window) continue;
+    if (best === null || window.remainingMs < best.remainingMs) {
+      best = {
+        handle: account.handle,
+        configDir: account.configDir,
+        remainingMs: window.remainingMs,
+        resetAt: window.resetAt.toISOString(),
+        timeUntilReset: formatTimeRemaining(window.remainingMs)
+      };
+    }
+  }
+  return best;
+}
+
+// src/cli.ts
+init_notify();
+init_paths();
+init_run_ping();
+
+// src/scan.ts
+import { existsSync as existsSync6, readdirSync, statSync as statSync2 } from "fs";
+import { homedir as homedir2 } from "os";
+import { join as join8 } from "path";
+var ACCOUNTS_DIR = join8(homedir2(), ".claude-accounts");
+function scanAccounts() {
+  if (!existsSync6(ACCOUNTS_DIR)) return [];
+  return readdirSync(ACCOUNTS_DIR).filter((name) => {
+    const full = join8(ACCOUNTS_DIR, name);
+    return statSync2(full).isDirectory() && !name.startsWith(".");
+  }).map((name) => ({
+    handle: name,
+    configDir: join8(ACCOUNTS_DIR, name)
+  }));
+}
+
+// src/stagger.ts
+init_state();
+function calculateStagger(accountCount, windowMs = QUOTA_WINDOW_MS) {
+  if (accountCount <= 1) return 0;
+  return Math.floor(windowMs / accountCount);
+}
+function parseStagger(value, accountCount) {
+  if (value === "auto") {
+    return calculateStagger(accountCount);
+  }
+  const minutes = Number(value);
+  if (Number.isNaN(minutes)) {
+    throw new Error(`Invalid stagger value: ${value}`);
+  }
+  if (minutes <= 0) {
+    throw new Error("Stagger must be a positive number");
+  }
+  return minutes * 60 * 1e3;
+}
+
 // src/suggest.ts
 init_state();
 function suggestAccount(accounts, now = /* @__PURE__ */ new Date()) {
@@ -1627,7 +1689,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.0.0").option(
+var program = new Command().name("cc-ping").description("Ping Claude Code sessions to trigger quota windows early").version("1.2.0").option(
   "--config <path>",
   "Path to config directory (default: ~/.config/cc-ping, env: CC_PING_CONFIG)"
 ).hook("preAction", (thisCommand) => {
@@ -1635,8 +1697,13 @@ var program = new Command().name("cc-ping").description("Ping Claude Code sessio
   if (opts.config) {
     setConfigDir(opts.config);
   }
+}).action(() => {
+  showDefault();
 });
-program.command("ping").description("Ping configured accounts to start quota windows").argument("[handles...]", "Specific account handles to ping (default: all)").option("--parallel", "Ping all accounts in parallel", false).option("-q, --quiet", "Suppress all output except errors (for cron)", false).option("--json", "Output results as JSON", false).option("-g, --group <group>", "Ping only accounts in this group").option("--bell", "Ring terminal bell on ping failure", false).option("--notify", "Send desktop notification on ping failure", false).option(
+program.command("ping").description("Ping configured accounts to start quota windows").argument(
+  "[handles...]",
+  "Specific handles to ping (default: accounts that need it)"
+).option("--parallel", "Ping all accounts in parallel", false).option("-q, --quiet", "Suppress all output except errors (for cron)", false).option("--json", "Output results as JSON", false).option("-g, --group <group>", "Ping only accounts in this group").option("--bell", "Ring terminal bell on ping failure", false).option("--notify", "Send desktop notification on ping failure", false).option(
   "--stagger <minutes|auto>",
   "Delay between account pings (minutes or 'auto')"
 ).action(async (handles, opts) => {
@@ -1647,10 +1714,13 @@ program.command("ping").description("Ping configured accounts to start quota win
     );
     process.exit(1);
   }
-  const targets = filterAccounts(
-    filterByGroup(accounts, opts.group),
-    handles
-  );
+  const grouped = filterByGroup(accounts, opts.group);
+  const selected = handles.length > 0 ? filterAccounts(grouped, handles) : grouped;
+  const targets = handles.length > 0 ? selected : filterNeedsPing(selected);
+  if (targets.length === 0) {
+    console.log("All accounts have active windows. Nothing to ping.");
+    process.exit(0);
+  }
   const staggerMs = opts.stagger ? parseStagger(opts.stagger, targets.length) : void 0;
   const exitCode = await runPing(targets, {
     parallel: opts.parallel,
@@ -1837,7 +1907,7 @@ daemon.command("start").description("Start the daemon process").option(
   const svc = getServiceStatus2();
   if (!svc.installed) {
     console.log(
-      "Hint: won't survive a reboot. Use `daemon install` for a persistent service."
+      "Hint: won't survive a reboot. Use `cc-ping daemon install` for a persistent service."
     );
   }
   printAccountTable();
@@ -1853,7 +1923,7 @@ daemon.command("stop").description("Stop the daemon process").action(async () =>
   const svc = getServiceStatus2();
   if (svc.installed) {
     console.log(
-      "Note: system service is installed. The daemon may restart. Use `daemon uninstall` to fully remove."
+      "Note: system service is installed. The daemon may restart. Use `cc-ping daemon uninstall` to fully remove."
     );
   }
 });
@@ -1929,7 +1999,7 @@ daemon.command("install").description("Install daemon as a system service (launc
   }
   console.log(`Service installed: ${result.servicePath}`);
   console.log(
-    "The daemon will start automatically on login. Use `daemon uninstall` to remove."
+    "The daemon will start automatically on login. Use `cc-ping daemon uninstall` to remove."
   );
 });
 daemon.command("uninstall").description("Remove daemon system service").action(async () => {

package/package.json

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