fleetlens 0.1.3 → 0.2.0

package/dist/index.js

@@ -209,7 +209,7 @@ async function checkForUpdate() {
   if (process.env.__FLEETLENS_UPDATED === "1" || process.env.__CCLENS_UPDATED === "1") return;
   const latest = await fetchLatestVersion();
   if (latest === null) return;
-  const current = "0.1.3";
+  const current = "0.2.0";
   if (!shouldUpdate(current, latest)) return;
   console.log(`Updating ${PACKAGE_NAME} ${current} \u2192 ${latest}...`);
   const ok = runNpmInstall();
@@ -226,7 +226,7 @@ async function checkForUpdate() {
 }
 async function forceUpdate() {
   const latest = await fetchLatestVersion();
-  const current = "0.1.3";
+  const current = "0.2.0";
   if (latest === null) {
     console.error("Could not reach npm registry. Check your network.");
     process.exit(1);
@@ -253,6 +253,187 @@ var init_updater = __esm({
   }
 });
 
+// src/usage/storage.ts
+import { appendFileSync, mkdirSync as mkdirSync2, readFileSync as readFileSync2, existsSync as existsSync2 } from "node:fs";
+import { dirname as dirname3 } from "node:path";
+function appendSnapshot(filePath, snapshot) {
+  mkdirSync2(dirname3(filePath), { recursive: true });
+  appendFileSync(filePath, JSON.stringify(snapshot) + "\n", "utf8");
+}
+function readSnapshots(filePath) {
+  if (!existsSync2(filePath)) return [];
+  const content = readFileSync2(filePath, "utf8");
+  const snapshots = [];
+  for (const line of content.split("\n")) {
+    if (!line.trim()) continue;
+    try {
+      snapshots.push(JSON.parse(line));
+    } catch {
+    }
+  }
+  return snapshots;
+}
+function latestSnapshot(filePath) {
+  const all = readSnapshots(filePath);
+  return all.length > 0 ? all[all.length - 1] : null;
+}
+var init_storage = __esm({
+  "src/usage/storage.ts"() {
+    "use strict";
+  }
+});
+
+// src/commands/daemon.ts
+var daemon_exports = {};
+__export(daemon_exports, {
+  daemon: () => daemon,
+  getDaemonStatusInfo: () => getDaemonStatusInfo,
+  startDaemonSilent: () => startDaemonSilent,
+  stopDaemonSilent: () => stopDaemonSilent
+});
+import { spawn as spawn2 } from "node:child_process";
+import { join as join2, dirname as dirname4 } from "node:path";
+import { fileURLToPath as fileURLToPath2 } from "node:url";
+import { existsSync as existsSync3, statSync, readFileSync as readFileSync3 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+function startDaemonSilent() {
+  cleanStalePid(DAEMON_PID);
+  const existing = readPid(DAEMON_PID);
+  if (existing !== null && isProcessAlive(existing.pid)) {
+    return { started: false, pid: existing.pid, alreadyRunning: true };
+  }
+  const script = workerPath();
+  if (!existsSync3(script)) {
+    return {
+      started: false,
+      pid: null,
+      alreadyRunning: false,
+      error: `Daemon worker not found at ${script}. Rebuild with: pnpm -F fleetlens build`
+    };
+  }
+  const child = spawn2(process.execPath, [script], {
+    detached: true,
+    stdio: "ignore"
+  });
+  child.unref();
+  const pid = child.pid;
+  writePid(DAEMON_PID, pid);
+  return { started: true, pid, alreadyRunning: false };
+}
+function stopDaemonSilent() {
+  cleanStalePid(DAEMON_PID);
+  const entry = readPid(DAEMON_PID);
+  if (entry === null) return { stopped: false, pid: null };
+  try {
+    process.kill(entry.pid, "SIGTERM");
+  } catch {
+  }
+  removePid(DAEMON_PID);
+  return { stopped: true, pid: entry.pid };
+}
+function getDaemonStatusInfo() {
+  cleanStalePid(DAEMON_PID);
+  const entry = readPid(DAEMON_PID);
+  const running = entry !== null && isProcessAlive(entry.pid);
+  const latest = latestSnapshot(USAGE_LOG);
+  const lastSnapshotAgeMs = latest ? Date.now() - new Date(latest.captured_at).getTime() : null;
+  const usageLogSize = existsSync3(USAGE_LOG) ? statSync(USAGE_LOG).size : null;
+  return {
+    running,
+    pid: running ? entry.pid : null,
+    lastSnapshotAgeMs,
+    lastSnapshot: latest,
+    usageLogSize
+  };
+}
+function workerPath() {
+  const here = dirname4(fileURLToPath2(import.meta.url));
+  return join2(here, "daemon-worker.js");
+}
+async function daemon(args2) {
+  const sub = args2[0] ?? "status";
+  switch (sub) {
+    case "start":
+      await daemonStart();
+      break;
+    case "stop":
+      daemonStop();
+      break;
+    case "status":
+      daemonStatus();
+      break;
+    case "logs":
+      daemonLogs();
+      break;
+    default:
+      console.error(`Unknown daemon subcommand: ${sub}`);
+      console.error("Usage: fleetlens daemon <start|stop|status|logs>");
+      process.exit(1);
+  }
+}
+async function daemonStart() {
+  const result = startDaemonSilent();
+  if (result.alreadyRunning) {
+    console.log(`Daemon is already running (PID ${result.pid})`);
+    return;
+  }
+  if (!result.started) {
+    console.error(result.error);
+    process.exit(1);
+  }
+  console.log(`Daemon started (PID ${result.pid})`);
+  console.log(`Polling every 5 minutes. Logs: ${DAEMON_LOG}`);
+}
+function daemonStop() {
+  const result = stopDaemonSilent();
+  if (!result.stopped) {
+    console.log("Daemon is not running.");
+    return;
+  }
+  console.log(`Stopped daemon (PID ${result.pid})`);
+}
+function daemonStatus() {
+  const info = getDaemonStatusInfo();
+  if (info.running) {
+    console.log(`Daemon: running (PID ${info.pid})`);
+  } else {
+    console.log("Daemon: not running");
+  }
+  if (info.lastSnapshot && info.lastSnapshotAgeMs !== null) {
+    const age = Math.round(info.lastSnapshotAgeMs / 1e3);
+    const ageStr = age < 60 ? `${age}s` : age < 3600 ? `${Math.round(age / 60)}m` : `${Math.round(age / 3600)}h`;
+    console.log(`Last snapshot: ${ageStr} ago`);
+    console.log(`  5h:    ${info.lastSnapshot.five_hour.utilization?.toFixed(1) ?? "\u2014"}%`);
+    console.log(`  7d:    ${info.lastSnapshot.seven_day.utilization?.toFixed(1) ?? "\u2014"}%`);
+  } else {
+    console.log("Last snapshot: none yet");
+  }
+  if (info.usageLogSize !== null) {
+    console.log(`Usage log: ${USAGE_LOG} (${info.usageLogSize} bytes)`);
+  }
+}
+function daemonLogs() {
+  if (!existsSync3(DAEMON_LOG)) {
+    console.log("No daemon logs yet.");
+    return;
+  }
+  const content = readFileSync3(DAEMON_LOG, "utf8");
+  const lines = content.trim().split("\n").slice(-20);
+  for (const line of lines) process.stdout.write(line + "\n");
+}
+var STATE_DIR2, DAEMON_PID, USAGE_LOG, DAEMON_LOG;
+var init_daemon = __esm({
+  "src/commands/daemon.ts"() {
+    "use strict";
+    init_pid();
+    init_storage();
+    STATE_DIR2 = join2(homedir2(), ".cclens");
+    DAEMON_PID = join2(STATE_DIR2, "daemon.pid");
+    USAGE_LOG = join2(STATE_DIR2, "usage.jsonl");
+    DAEMON_LOG = join2(STATE_DIR2, "daemon.log");
+  }
+});
+
 // src/commands/start.ts
 var start_exports = {};
 __export(start_exports, {
@@ -262,33 +443,48 @@ async function start(args2) {
   const portFlag = args2.indexOf("--port");
   const port = portFlag !== -1 ? parseInt(args2[portFlag + 1], 10) : void 0;
   const noOpen = args2.includes("--no-open");
+  const noDaemon = args2.includes("--no-daemon");
   try {
     await checkForUpdate();
   } catch {
   }
-  const status = getServerStatus();
-  if (status.running) {
-    const url = `http://localhost:${status.port}`;
-    console.log(`fleetlens is already running on ${url} (PID ${status.pid})`);
-    if (!noOpen) openBrowser(url);
-    return;
+  const status2 = getServerStatus();
+  let serverUrl;
+  let serverPid;
+  if (status2.running) {
+    serverUrl = `http://localhost:${status2.port}`;
+    serverPid = status2.pid;
+    console.log(`Server:  already running on ${serverUrl} (PID ${serverPid})`);
+  } else {
+    console.log("Starting Fleetlens...");
+    try {
+      const result = await startServer({ port });
+      serverUrl = `http://localhost:${result.port}`;
+      serverPid = result.pid;
+      console.log(`Server:  started on ${serverUrl} (PID ${serverPid})`);
+    } catch (err) {
+      console.error(`Failed to start server: ${err.message}`);
+      process.exit(1);
+    }
   }
-  console.log("Starting fleetlens...");
-  try {
-    const result = await startServer({ port });
-    const url = `http://localhost:${result.port}`;
-    console.log(`fleetlens running on ${url} (PID ${result.pid})`);
-    if (!noOpen) openBrowser(url);
-  } catch (err) {
-    console.error(`Failed to start: ${err.message}`);
-    process.exit(1);
+  if (!noDaemon) {
+    const daemon2 = startDaemonSilent();
+    if (daemon2.alreadyRunning) {
+      console.log(`Daemon:  already running (PID ${daemon2.pid})`);
+    } else if (daemon2.started) {
+      console.log(`Daemon:  started (PID ${daemon2.pid})`);
+    } else {
+      console.warn(`Daemon:  failed to start \u2014 ${daemon2.error}`);
+    }
   }
+  if (!noOpen) openBrowser(serverUrl);
 }
 var init_start = __esm({
   "src/commands/start.ts"() {
     "use strict";
     init_server();
     init_updater();
+    init_daemon();
   }
 });
 
@@ -298,20 +494,70 @@ __export(stop_exports, {
   stop: () => stop
 });
 async function stop() {
-  const status = getServerStatus();
-  if (!status.running) {
-    console.log("fleetlens is not running.");
-    return;
+  let didSomething = false;
+  const status2 = getServerStatus();
+  if (status2.running) {
+    const result = stopServer();
+    if (result.stopped) {
+      console.log(`Server:  stopped (PID ${result.pid})`);
+      didSomething = true;
+    }
+  } else {
+    console.log("Server:  not running");
   }
-  const result = stopServer();
-  if (result.stopped) {
-    console.log(`Stopped fleetlens (PID ${result.pid})`);
+  const daemon2 = stopDaemonSilent();
+  if (daemon2.stopped) {
+    console.log(`Daemon:  stopped (PID ${daemon2.pid})`);
+    didSomething = true;
+  } else {
+    console.log("Daemon:  not running");
+  }
+  if (!didSomething) {
+    console.log("Fleetlens is not running.");
   }
 }
 var init_stop = __esm({
   "src/commands/stop.ts"() {
     "use strict";
     init_server();
+    init_daemon();
+  }
+});
+
+// src/commands/status.ts
+var status_exports = {};
+__export(status_exports, {
+  status: () => status
+});
+async function status() {
+  const server = getServerStatus();
+  if (server.running) {
+    const url = `http://localhost:${server.port}`;
+    console.log(`Server:  running on ${url} (PID ${server.pid})`);
+  } else {
+    console.log("Server:  not running");
+  }
+  const daemon2 = getDaemonStatusInfo();
+  if (daemon2.running) {
+    console.log(`Daemon:  running (PID ${daemon2.pid})`);
+  } else {
+    console.log("Daemon:  not running");
+  }
+  if (daemon2.lastSnapshot && daemon2.lastSnapshotAgeMs !== null) {
+    const age = Math.round(daemon2.lastSnapshotAgeMs / 1e3);
+    const ageStr = age < 60 ? `${age}s` : age < 3600 ? `${Math.round(age / 60)}m` : `${Math.round(age / 3600)}h`;
+    console.log(`Latest:  ${ageStr} ago`);
+    console.log(`  5h:    ${daemon2.lastSnapshot.five_hour.utilization?.toFixed(1) ?? "\u2014"}%`);
+    console.log(`  7d:    ${daemon2.lastSnapshot.seven_day.utilization?.toFixed(1) ?? "\u2014"}%`);
+  } else {
+    console.log("Latest:  no usage snapshot yet");
+  }
+}
+var init_status = __esm({
+  "src/commands/status.ts"() {
+    "use strict";
+    init_server();
+    init_daemon();
   }
 });
 
@@ -325,9 +571,9 @@ async function web(args2) {
   const positional = args2.filter((a) => !a.startsWith("--"));
   const rawPath = positional[0] ?? "";
   const path2 = rawPath.startsWith("/") ? rawPath : rawPath ? `/${rawPath}` : "";
-  const status = getServerStatus();
-  if (status.running) {
-    const url = `http://localhost:${status.port}${path2}`;
+  const status2 = getServerStatus();
+  if (status2.running) {
+    const url = `http://localhost:${status2.port}${path2}`;
     console.log(noOpen ? `Server running at ${url}` : `Opening ${url}`);
     if (!noOpen) openBrowser(url);
     return;
@@ -998,8 +1244,8 @@ async function printStats(sinceDate) {
   const output = renderTable(rows, "Claude Code Token Usage Report \u2014 Daily");
   const today = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
   const todaySessions = filtered.filter((s) => s.firstTimestamp?.startsWith(today)).length;
-  const status = getServerStatus();
-  const serverLine = status.running ? `Server running on http://localhost:${status.port}` : "Server not running";
+  const status2 = getServerStatus();
+  const serverLine = status2.running ? `Server running on http://localhost:${status2.port}` : "Server not running";
   console.log(output);
   console.log(`  ${todaySessions} sessions today \xB7 ${serverLine}`);
   console.log("");
@@ -1087,9 +1333,9 @@ var init_stats = __esm({
 
 // src/usage/token.ts
 import { execFileSync } from "node:child_process";
-import { readFileSync as readFileSync2 } from "node:fs";
-import { homedir as homedir2, platform } from "node:os";
-import { join as join2 } from "node:path";
+import { readFileSync as readFileSync4 } from "node:fs";
+import { homedir as homedir3, platform } from "node:os";
+import { join as join3 } from "node:path";
 function readOAuthToken() {
   if (platform() === "darwin") {
     return readFromMacKeychain() ?? readFromCredentialsFile();
@@ -1110,12 +1356,12 @@ function readFromMacKeychain() {
 }
 function readFromCredentialsFile() {
   const candidates = [
-    join2(homedir2(), ".claude", ".credentials.json"),
-    join2(homedir2(), ".config", "claude", "credentials.json")
+    join3(homedir3(), ".claude", ".credentials.json"),
+    join3(homedir3(), ".config", "claude", "credentials.json")
   ];
   for (const path2 of candidates) {
     try {
-      const blob = readFileSync2(path2, "utf8");
+      const blob = readFileSync4(path2, "utf8");
       const token = extractToken(blob);
       if (token) return token;
     } catch {
@@ -1309,48 +1555,18 @@ var init_format = __esm({
   }
 });
 
-// src/usage/storage.ts
-import { appendFileSync, mkdirSync as mkdirSync2, readFileSync as readFileSync3, existsSync as existsSync2 } from "node:fs";
-import { dirname as dirname3 } from "node:path";
-function appendSnapshot(filePath, snapshot) {
-  mkdirSync2(dirname3(filePath), { recursive: true });
-  appendFileSync(filePath, JSON.stringify(snapshot) + "\n", "utf8");
-}
-function readSnapshots(filePath) {
-  if (!existsSync2(filePath)) return [];
-  const content = readFileSync3(filePath, "utf8");
-  const snapshots = [];
-  for (const line of content.split("\n")) {
-    if (!line.trim()) continue;
-    try {
-      snapshots.push(JSON.parse(line));
-    } catch {
-    }
-  }
-  return snapshots;
-}
-function latestSnapshot(filePath) {
-  const all = readSnapshots(filePath);
-  return all.length > 0 ? all[all.length - 1] : null;
-}
-var init_storage = __esm({
-  "src/usage/storage.ts"() {
-    "use strict";
-  }
-});
-
 // src/commands/usage.ts
 var usage_exports = {};
 __export(usage_exports, {
   usage: () => usage
 });
-import { join as join3 } from "node:path";
-import { homedir as homedir3 } from "node:os";
+import { join as join4 } from "node:path";
+import { homedir as homedir4 } from "node:os";
 async function usage(args2) {
   const save = args2.includes("--save");
   try {
     const snapshot = await fetchUsage();
-    if (save) appendSnapshot(USAGE_LOG, snapshot);
+    if (save) appendSnapshot(USAGE_LOG2, snapshot);
     process.stdout.write(formatUsage(snapshot));
   } catch (err) {
     if (err instanceof UsageApiError) {
@@ -1360,131 +1576,14 @@ async function usage(args2) {
     throw err;
   }
 }
-var USAGE_LOG;
+var USAGE_LOG2;
 var init_usage = __esm({
   "src/commands/usage.ts"() {
     "use strict";
     init_api();
     init_format();
     init_storage();
-    USAGE_LOG = join3(homedir3(), ".cclens", "usage.jsonl");
-  }
-});
-
-// src/commands/daemon.ts
-var daemon_exports = {};
-__export(daemon_exports, {
-  daemon: () => daemon
-});
-import { spawn as spawn2 } from "node:child_process";
-import { join as join4, dirname as dirname4 } from "node:path";
-import { fileURLToPath as fileURLToPath2 } from "node:url";
-import { existsSync as existsSync3, statSync, readFileSync as readFileSync4 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-function workerPath() {
-  const here = dirname4(fileURLToPath2(import.meta.url));
-  return join4(here, "daemon-worker.js");
-}
-async function daemon(args2) {
-  const sub = args2[0] ?? "status";
-  switch (sub) {
-    case "start":
-      await daemonStart();
-      break;
-    case "stop":
-      daemonStop();
-      break;
-    case "status":
-      daemonStatus();
-      break;
-    case "logs":
-      daemonLogs();
-      break;
-    default:
-      console.error(`Unknown daemon subcommand: ${sub}`);
-      console.error("Usage: fleetlens daemon <start|stop|status|logs>");
-      process.exit(1);
-  }
-}
-async function daemonStart() {
-  cleanStalePid(DAEMON_PID);
-  const existing = readPid(DAEMON_PID);
-  if (existing !== null && isProcessAlive(existing.pid)) {
-    console.log(`Daemon is already running (PID ${existing.pid})`);
-    return;
-  }
-  const script = workerPath();
-  if (!existsSync3(script)) {
-    console.error(`Daemon worker not found at ${script}. Rebuild with: pnpm -F fleetlens build`);
-    process.exit(1);
-  }
-  const child = spawn2(process.execPath, [script], {
-    detached: true,
-    stdio: "ignore"
-  });
-  child.unref();
-  const pid = child.pid;
-  writePid(DAEMON_PID, pid);
-  console.log(`Daemon started (PID ${pid})`);
-  console.log(`Polling every 5 minutes. Logs: ${DAEMON_LOG}`);
-}
-function daemonStop() {
-  cleanStalePid(DAEMON_PID);
-  const entry = readPid(DAEMON_PID);
-  if (entry === null) {
-    console.log("Daemon is not running.");
-    return;
-  }
-  try {
-    process.kill(entry.pid, "SIGTERM");
-  } catch {
-  }
-  removePid(DAEMON_PID);
-  console.log(`Stopped daemon (PID ${entry.pid})`);
-}
-function daemonStatus() {
-  cleanStalePid(DAEMON_PID);
-  const entry = readPid(DAEMON_PID);
-  const running = entry !== null && isProcessAlive(entry.pid);
-  if (running) {
-    console.log(`Daemon: running (PID ${entry.pid})`);
-  } else {
-    console.log("Daemon: not running");
-  }
-  const latest = latestSnapshot(USAGE_LOG2);
-  if (latest) {
-    const age = Math.round((Date.now() - new Date(latest.captured_at).getTime()) / 1e3);
-    const ageStr = age < 60 ? `${age}s` : age < 3600 ? `${Math.round(age / 60)}m` : `${Math.round(age / 3600)}h`;
-    console.log(`Last snapshot: ${ageStr} ago`);
-    console.log(`  5h:    ${latest.five_hour.utilization?.toFixed(1) ?? "\u2014"}%`);
-    console.log(`  7d:    ${latest.seven_day.utilization?.toFixed(1) ?? "\u2014"}%`);
-  } else {
-    console.log("Last snapshot: none yet");
-  }
-  if (existsSync3(USAGE_LOG2)) {
-    const size = statSync(USAGE_LOG2).size;
-    console.log(`Usage log: ${USAGE_LOG2} (${size} bytes)`);
-  }
-}
-function daemonLogs() {
-  if (!existsSync3(DAEMON_LOG)) {
-    console.log("No daemon logs yet.");
-    return;
-  }
-  const content = readFileSync4(DAEMON_LOG, "utf8");
-  const lines = content.trim().split("\n").slice(-20);
-  for (const line of lines) process.stdout.write(line + "\n");
-}
-var STATE_DIR2, DAEMON_PID, USAGE_LOG2, DAEMON_LOG;
-var init_daemon = __esm({
-  "src/commands/daemon.ts"() {
-    "use strict";
-    init_pid();
-    init_storage();
-    STATE_DIR2 = join4(homedir4(), ".cclens");
-    DAEMON_PID = join4(STATE_DIR2, "daemon.pid");
-    USAGE_LOG2 = join4(STATE_DIR2, "usage.jsonl");
-    DAEMON_LOG = join4(STATE_DIR2, "daemon.log");
+    USAGE_LOG2 = join4(homedir4(), ".cclens", "usage.jsonl");
   }
 });
 
@@ -1503,6 +1602,11 @@ async function main() {
       await stop2();
       break;
     }
+    case "status": {
+      const { status: status2 } = await Promise.resolve().then(() => (init_status(), status_exports));
+      await status2();
+      break;
+    }
     case "web": {
       const { web: web2 } = await Promise.resolve().then(() => (init_web(), web_exports));
       await web2(args.slice(1));
@@ -1531,21 +1635,28 @@ async function main() {
     case "version":
     case "--version":
     case "-v":
-      console.log(`fleetlens ${"0.1.3"}`);
+      console.log(`fleetlens ${"0.2.0"}`);
       break;
     case "help":
     case "--help":
     case "-h":
       console.log(`Usage: fleetlens <command>
 
-Commands:
-  start [--port N] [--no-open]      Start the dashboard server
-  stop                              Stop the dashboard server
-  web [page] [--no-open]            Open dashboard in browser (e.g. 'web usage')
+Common:
+  start [--port N] [--no-open]      Start dashboard + usage daemon
+  stop                              Stop dashboard + usage daemon
+  status                            Show server + daemon + latest snapshot
   update                            Update to the latest version
-  stats [--live] [-s D] [--days N]  Show token usage statistics
-  usage [--save]                    Show Claude Code plan utilization (5h/7d)
-  daemon <start|stop|status|logs>   Background poller for usage metrics
+
+Terminal:
+  stats [--live] [-s D] [--days N]  Daily token usage table
+  usage [--save]                    Plan utilization (5h/7d) in one shot
+
+Advanced:
+  web [page] [--no-open]            Open dashboard in browser without auto-starting daemon
+  start --no-daemon                 Start only the web server (no daemon)
+  daemon <start|stop|status|logs>   Manage the usage daemon by itself
+
   version                           Print version`);
       break;
     default:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fleetlens",
-  "version": "0.1.3",
+  "version": "0.2.0",
   "description": "fleetlens — local-only dashboard and usage tracker for Claude Code sessions and agent fleets",
   "license": "MIT",
   "type": "module",