just-usage 0.0.5 → 0.0.6

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## v0.0.6
+
+## What's Changed
+Detect newly installed CLIs on refresh, keep provider tabs out of the URL, and write action logs. in [#3b3f92c](https://github.com/spheceo/just-usage/commit/3b3f92c086e55533da48ebac2023b41ce32d21a3)
+Remove obsolete architecture plan in [#23d08e9](https://github.com/spheceo/just-usage/commit/23d08e96a8a485692062802d3e01886857573af9)
+
 ## v0.0.5
 
 ## What's Changed

package/dist/cli.js

@@ -15,7 +15,7 @@ import { mkdirSync } from "node:fs";
 // package.json
 var package_default = {
   name: "just-usage",
-  version: "0.0.5",
+  version: "0.0.6",
   description: "One local page for your coding-CLI subscription quotas: Claude, Codex, Cursor, Antigravity, Grok, OpenCode Go.",
   type: "module",
   license: "MIT",
@@ -481,12 +481,15 @@ async function codexLogin(codexHome, onAuthUrl, timeoutMs = 5 * 60000) {
 
 // src/adapters/claude.ts
 import { createHash } from "node:crypto";
-import { existsSync as existsSync2, readFileSync as readFileSync2 } from "node:fs";
-import { homedir as homedir2 } from "node:os";
-import { join as join2 } from "node:path";
+import { existsSync as existsSync3, readFileSync as readFileSync2 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join3 } from "node:path";
 
 // src/proc.ts
 import { spawn as spawn2 } from "node:child_process";
+import { existsSync } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { delimiter, join as join2 } from "node:path";
 function run(cmd, args, opts = {}) {
   return new Promise((resolve) => {
     let stdout = "";
@@ -500,7 +503,7 @@ function run(cmd, args, opts = {}) {
       resolve({ code, stdout, stderr });
     };
     const child = spawn2(cmd, args, {
-      env: { ...process.env, ...opts.env },
+      env: spawnEnv(opts.env),
       stdio: ["pipe", "pipe", "pipe"]
     });
     const timer = setTimeout(() => {
@@ -523,23 +526,70 @@ function run(cmd, args, opts = {}) {
 }
 function runInteractive(cmd, args, env) {
   return new Promise((resolve, reject) => {
-    const child = spawn2(cmd, args, { env: { ...process.env, ...env }, stdio: "inherit" });
+    const child = spawn2(cmd, args, { env: spawnEnv(env), stdio: "inherit" });
     child.on("error", reject);
     child.on("close", (code) => resolve(code));
   });
 }
 var whichCache = new Map;
-function which(bin) {
+function extraBinDirs() {
+  const home = homedir2();
+  const dirs = [
+    join2(home, ".local", "bin"),
+    join2(home, "bin"),
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    "/home/linuxbrew/.linuxbrew/bin",
+    join2(home, ".npm-global", "bin")
+  ];
+  if (process.platform === "win32") {
+    const local = process.env.LOCALAPPDATA;
+    if (local)
+      dirs.push(join2(local, "agy", "bin"));
+  }
+  return dirs.filter((d) => existsSync(d));
+}
+function spawnEnv(extra) {
+  const pathKey = process.platform === "win32" && process.env.Path && !process.env.PATH ? "Path" : "PATH";
+  const current = extra?.[pathKey] ?? extra?.PATH ?? process.env[pathKey] ?? process.env.PATH ?? "";
+  const seen = new Set;
+  const parts = [];
+  for (const dir of [...extraBinDirs(), ...current.split(delimiter)]) {
+    if (!dir || seen.has(dir))
+      continue;
+    seen.add(dir);
+    parts.push(dir);
+  }
+  return { ...process.env, ...extra, [pathKey]: parts.join(delimiter) };
+}
+async function resolveBin(bin) {
+  const finder = process.platform === "win32" ? "where" : "which";
+  const res = await run(finder, [bin], { timeoutMs: 5000 });
+  if (res.code === 0) {
+    const first = res.stdout.split(/\r?\n/).map((s) => s.trim()).find(Boolean);
+    if (first && existsSync(first))
+      return first;
+  }
+  const names = process.platform === "win32" ? [bin, `${bin}.exe`, `${bin}.cmd`] : [bin];
+  for (const dir of extraBinDirs()) {
+    for (const name of names) {
+      const candidate = join2(dir, name);
+      if (existsSync(candidate))
+        return candidate;
+    }
+  }
+  return null;
+}
+function clearBinCache() {
+  whichCache.clear();
+  versionCache.clear();
+}
+function which(bin, opts = {}) {
+  if (opts.fresh)
+    whichCache.delete(bin);
   let p = whichCache.get(bin);
   if (!p) {
-    p = (async () => {
-      const finder = process.platform === "win32" ? "where" : "which";
-      const res = await run(finder, [bin], { timeoutMs: 5000 });
-      if (res.code !== 0)
-        return null;
-      const first = res.stdout.split(/\r?\n/).map((s) => s.trim()).find(Boolean);
-      return first ?? null;
-    })();
+    p = resolveBin(bin);
     whichCache.set(bin, p);
   }
   return p;
@@ -581,7 +631,7 @@ function withTimeout(p, ms, label) {
 }
 
 // src/secrets.ts
-import { existsSync, readFileSync, writeFileSync, chmodSync } from "node:fs";
+import { existsSync as existsSync2, readFileSync, writeFileSync, chmodSync } from "node:fs";
 import { dirname } from "node:path";
 var SERVICE = "just-usage";
 
@@ -608,7 +658,7 @@ class FileStore {
   kind = "file";
   read() {
     const file = paths.secrets();
-    if (!existsSync(file))
+    if (!existsSync2(file))
       return {};
     try {
       return JSON.parse(readFileSync(file, "utf8"));
@@ -680,8 +730,8 @@ async function readClaudeCredentials(configDir) {
         return creds;
     }
   }
-  const file = join2(configDir ?? join2(homedir2(), ".claude"), ".credentials.json");
-  if (existsSync2(file))
+  const file = join3(configDir ?? join3(homedir3(), ".claude"), ".credentials.json");
+  if (existsSync3(file))
     return parseCreds(readFileSync2(file, "utf8"));
   return null;
 }
@@ -834,9 +884,9 @@ import { renameSync, rmSync as rmSync2 } from "node:fs";
 
 // src/adapters/antigravity.ts
 import { createHash as createHash2, randomBytes } from "node:crypto";
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { join as join3 } from "node:path";
+import { existsSync as existsSync4, readFileSync as readFileSync3 } from "node:fs";
+import { homedir as homedir4 } from "node:os";
+import { join as join4 } from "node:path";
 var AGY_CLIENT_ID = "1071006060591-tmhssin2h21lcre235vtolojh4g403ep.apps.googleusercontent.com";
 var AGY_CLIENT_SECRET = "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";
 var AGY_REDIRECT_URI = "https://antigravity.google/oauth-callback";
@@ -853,11 +903,11 @@ var KEYCHAIN_SERVICE = "gemini";
 var KEYCHAIN_ACCOUNT = "antigravity";
 var FALLBACK_CLI_VERSION2 = "1.1.26";
 function settingsFile() {
-  return join3(homedir3(), ".gemini", "antigravity-cli", "settings.json");
+  return join4(homedir4(), ".gemini", "antigravity-cli", "settings.json");
 }
 function usesGeminiApiKey() {
   try {
-    if (!existsSync3(settingsFile()))
+    if (!existsSync4(settingsFile()))
       return false;
     const parsed = JSON.parse(readFileSync3(settingsFile(), "utf8"));
     return parsed.modelProvider === "gemini" && Boolean(process.env.GEMINI_API_KEY?.trim());
@@ -923,8 +973,18 @@ async function tokenFromSecretTool() {
     return null;
   return parseAgyKeyringBlob(res.stdout);
 }
+function tokenFromOauthFile() {
+  const file = join4(homedir4(), ".gemini", "antigravity-cli", "antigravity-oauth-token");
+  if (!existsSync4(file))
+    return null;
+  try {
+    return parseAgyKeyringBlob(readFileSync3(file, "utf8"));
+  } catch {
+    return null;
+  }
+}
 async function readDefaultAgyToken() {
-  return await tokenFromKeychain() ?? await tokenFromSecretTool();
+  return await tokenFromKeychain() ?? await tokenFromSecretTool() ?? tokenFromOauthFile();
 }
 function createPkce() {
   const verifier = randomBytes(32).toString("base64url");
@@ -1188,20 +1248,20 @@ async function fetchAntigravity(account) {
 }
 
 // src/adapters/opencode.ts
-import { existsSync as existsSync4, readFileSync as readFileSync4 } from "node:fs";
-import { homedir as homedir4 } from "node:os";
-import { join as join4 } from "node:path";
+import { existsSync as existsSync5, readFileSync as readFileSync4 } from "node:fs";
+import { homedir as homedir5 } from "node:os";
+import { join as join5 } from "node:path";
 var USAGE_URL2 = "https://opencode.ai/zen/go/v1/usage";
 function openCodeAuthFile() {
   if (process.env.OPENCODE_AUTH_FILE)
     return process.env.OPENCODE_AUTH_FILE;
   const xdg = process.env.XDG_DATA_HOME;
-  const base = xdg && xdg.trim() ? xdg : join4(homedir4(), ".local", "share");
-  return join4(base, "opencode", "auth.json");
+  const base = xdg && xdg.trim() ? xdg : join5(homedir5(), ".local", "share");
+  return join5(base, "opencode", "auth.json");
 }
 function readOpenCodeGoKey() {
   const file = openCodeAuthFile();
-  if (!existsSync4(file))
+  if (!existsSync5(file))
     return null;
   try {
     const parsed = JSON.parse(readFileSync4(file, "utf8"));
@@ -1263,12 +1323,70 @@ async function fetchOpenCode(account) {
   }
 }
 
+// src/log.ts
+import { appendFileSync } from "node:fs";
+import { homedir as homedir6 } from "node:os";
+import { join as join6 } from "node:path";
+var SECRET_KEY = /^(.*[._-]?)?(secret|token|password|authorization|cookie|verifier|refresh_token|access_token|api[_-]?key|key)$/i;
+var SKIP_KEY = /^(url|authurl|callback|body|headers|authorization)$/i;
+var MAX_STRING = 400;
+function logDir() {
+  const override = process.env.JUST_USAGE_LOG_DIR;
+  if (override && override.trim())
+    return override.trim();
+  return join6(homedir6(), ".just-usage", "logs");
+}
+function logFile(at = new Date) {
+  return join6(logDir(), `${at.toISOString().slice(0, 10)}.log`);
+}
+function sanitizeFields(fields) {
+  if (!fields)
+    return {};
+  const out = {};
+  for (const [k, v] of Object.entries(fields)) {
+    if (v === undefined)
+      continue;
+    if (SECRET_KEY.test(k) || SKIP_KEY.test(k))
+      continue;
+    if (v === null || typeof v === "number" || typeof v === "boolean") {
+      out[k] = v;
+      continue;
+    }
+    if (typeof v === "string") {
+      out[k] = v.length <= MAX_STRING ? v : `${v.slice(0, MAX_STRING)}…`;
+      continue;
+    }
+    if (Array.isArray(v) && v.every((x) => typeof x === "string" || typeof x === "number")) {
+      out[k] = v.slice(0, 20);
+    }
+  }
+  return out;
+}
+function log(level, event, fields) {
+  try {
+    ensureDir(logDir());
+    const line = JSON.stringify({
+      ts: new Date().toISOString(),
+      level,
+      event,
+      pid: process.pid,
+      v: VERSION,
+      ...sanitizeFields(fields)
+    });
+    appendFileSync(logFile(), `${line}
+`, { encoding: "utf8", mode: 384 });
+  } catch {}
+}
+function logError(event, e, fields) {
+  log("error", event, { ...fields, message: errorMessage(e) });
+}
+
 // src/registry.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, writeFileSync as writeFileSync2, rmSync } from "node:fs";
-import { dirname as dirname2, join as join5 } from "node:path";
+import { existsSync as existsSync6, readFileSync as readFileSync5, writeFileSync as writeFileSync2, rmSync } from "node:fs";
+import { dirname as dirname2, join as join7 } from "node:path";
 function readRegistry() {
   const file = paths.registry();
-  if (!existsSync5(file))
+  if (!existsSync6(file))
     return { version: 1, accounts: [] };
   try {
     const parsed = JSON.parse(readFileSync5(file, "utf8"));
@@ -1304,7 +1422,7 @@ function newAccountId(provider, hint) {
   }
 }
 function profileDirFor(provider, id) {
-  return join5(paths.profiles(provider), id.split(":")[1] ?? "account");
+  return join7(paths.profiles(provider), id.split(":")[1] ?? "account");
 }
 function saveAccount(record) {
   const reg = readRegistry();
@@ -1361,6 +1479,7 @@ async function addClaudeToken(token, label) {
     createdAt: new Date().toISOString()
   };
   saveAccount(account);
+  log("info", "account.add", { account: account.id, provider: account.provider, kind: account.kind });
   return { account };
 }
 async function addOpenCodeKey(key, label) {
@@ -1383,6 +1502,12 @@ async function addOpenCodeKey(key, label) {
     createdAt: new Date().toISOString()
   };
   saveAccount(account);
+  log("info", "account.add", {
+    account: account.id,
+    provider: account.provider,
+    kind: account.kind,
+    warning: status === 403 ? "no-subscription" : undefined
+  });
   return {
     account,
     warning: status === 403 ? "Key is valid but has no active OpenCode Go subscription." : undefined
@@ -1394,7 +1519,9 @@ function renameExtraAccount(id, label) {
   if (!getAccount(id))
     throw new AccountError(`Unknown account: ${id}`, 404);
   updateAccount(id, { label: label.trim() });
-  return getAccount(id);
+  const account = getAccount(id);
+  log("info", "account.rename", { account: account.id, provider: account.provider });
+  return account;
 }
 async function removeExtraAccount(id) {
   if (id.endsWith(":default"))
@@ -1404,6 +1531,7 @@ async function removeExtraAccount(id) {
     throw new AccountError(`Unknown account: ${id}`, 404);
   if (rec.kind === "token")
     await secretStore().delete(id);
+  log("info", "account.remove", { account: rec.id, provider: rec.provider, kind: rec.kind });
   return rec;
 }
 function saveCodexProfile(opts) {
@@ -1425,6 +1553,7 @@ function saveCodexProfile(opts) {
     createdAt: new Date().toISOString()
   };
   saveAccount(account);
+  log("info", "account.add", { account: account.id, provider: account.provider, kind: account.kind });
   return account;
 }
 function isLocalCallbackUrl(raw) {
@@ -1464,7 +1593,7 @@ function dropCodexSession(id, removeDir) {
   }
 }
 async function beginCodexAdd(label) {
-  if (!await which("codex"))
+  if (!await which("codex", { fresh: true }))
     throw new AccountError("codex is not installed (npm i -g @openai/codex).");
   const tmpId = newAccountId("codex", label?.trim() || "pending");
   const dir = ensureDir(profileDirFor("codex", tmpId));
@@ -1483,11 +1612,14 @@ async function beginCodexAdd(label) {
   handle.completed.then((info) => {
     rec.account = saveCodexProfile({ label: rec.label, tmpId, dir, email: info.email });
     rec.status = "done";
+    log("info", "account.login.done", { account: rec.account.id, provider: "codex" });
   }).catch((e) => {
     rec.status = "error";
     rec.error = e instanceof Error ? e.message : String(e);
+    logError("account.login.error", e, { provider: "codex" });
   });
   codexSessions.set(id, rec);
+  log("info", "account.login.start", { provider: "codex", kind: "add" });
   return { sessionId: id, authUrl: handle.authUrl };
 }
 async function beginCodexRelogin(accountId) {
@@ -1512,11 +1644,14 @@ async function beginCodexRelogin(accountId) {
     updateAccount(existing.id, { email: info.email });
     rec.account = { ...existing, email: info.email };
     rec.status = "done";
+    log("info", "account.login.done", { account: existing.id, provider: "codex" });
   }).catch((e) => {
     rec.status = "error";
     rec.error = e instanceof Error ? e.message : String(e);
+    logError("account.login.error", e, { account: existing.id, provider: "codex" });
   });
   codexSessions.set(id, rec);
+  log("info", "account.login.start", { account: existing.id, provider: "codex", kind: "relogin" });
   return { sessionId: id, authUrl: handle.authUrl };
 }
 function codexSessionStatus(sessionId) {
@@ -1563,9 +1698,11 @@ function startAgySession(opts) {
   return { sessionId: id, authUrl };
 }
 async function beginAntigravityAdd(label) {
-  if (!await which("agy"))
+  if (!await which("agy", { fresh: true }))
     throw new AccountError("agy is not installed (https://antigravity.google/docs/cli/install).");
-  return startAgySession({ label });
+  const started = startAgySession({ label });
+  log("info", "account.login.start", { provider: "antigravity", kind: "add" });
+  return started;
 }
 async function beginAntigravityRelogin(accountId) {
   const existing = getAccount(accountId);
@@ -1574,7 +1711,9 @@ async function beginAntigravityRelogin(accountId) {
   if (existing.provider !== "antigravity" || existing.kind !== "token") {
     throw new AccountError(`${accountId} cannot be re-authenticated this way.`);
   }
-  return startAgySession({ accountId });
+  const started = startAgySession({ accountId });
+  log("info", "account.login.start", { account: accountId, provider: "antigravity", kind: "relogin" });
+  return started;
 }
 function antigravitySessionStatus(sessionId) {
   const rec = agySessions.get(sessionId);
@@ -1617,21 +1756,29 @@ async function submitAntigravityCallback(sessionId, raw) {
       saveAccount(rec.account);
     }
     rec.status = "done";
+    log("info", rec.accountId ? "account.login.done" : "account.add", {
+      account: rec.account.id,
+      provider: "antigravity",
+      kind: rec.account.kind
+    });
     return rec.account;
   } catch (e) {
     rec.status = "error";
     rec.error = e instanceof Error ? e.message : String(e);
+    logError("account.login.error", e, { provider: "antigravity", account: rec.accountId });
     throw new AccountError(rec.error);
   }
 }
 
 // src/collect.ts
-import { hostname } from "node:os";
+import { existsSync as existsSync9 } from "node:fs";
+import { homedir as homedir9, hostname } from "node:os";
+import { join as join10 } from "node:path";
 
 // src/adapters/cursor.ts
-import { existsSync as existsSync6, readFileSync as readFileSync6 } from "node:fs";
-import { homedir as homedir5 } from "node:os";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync7, readFileSync as readFileSync6 } from "node:fs";
+import { homedir as homedir7 } from "node:os";
+import { join as join8 } from "node:path";
 var USAGE_URL3 = "https://api2.cursor.sh/aiserver.v1.DashboardService/GetCurrentPeriodUsage";
 var GROK_BOT_URL = "https://api2.cursor.sh/aiserver.v1.DashboardService/GetSandUsageStatus";
 var PLAN_URL = "https://api2.cursor.sh/aiserver.v1.DashboardService/GetPlanInfo";
@@ -1643,7 +1790,7 @@ function tokenFromAuthJson(parsed) {
   return typeof parsed.accessToken === "string" && parsed.accessToken ? parsed.accessToken : null;
 }
 function tokenFromAuthFile(file) {
-  if (!existsSync6(file))
+  if (!existsSync7(file))
     return null;
   try {
     return tokenFromAuthJson(JSON.parse(readFileSync6(file, "utf8")));
@@ -1652,16 +1799,16 @@ function tokenFromAuthFile(file) {
   }
 }
 function authFiles() {
-  const home = homedir5();
+  const home = homedir7();
   const out = [];
   if (process.platform === "win32") {
-    const roaming = process.env.APPDATA || join6(home, "AppData", "Roaming");
-    out.push(join6(roaming, "Cursor", "auth.json"));
+    const roaming = process.env.APPDATA || join8(home, "AppData", "Roaming");
+    out.push(join8(roaming, "Cursor", "auth.json"));
   } else if (process.platform !== "darwin") {
-    const xdg = process.env.XDG_CONFIG_HOME || join6(home, ".config");
-    out.push(join6(xdg, "cursor", "auth.json"));
+    const xdg = process.env.XDG_CONFIG_HOME || join8(home, ".config");
+    out.push(join8(xdg, "cursor", "auth.json"));
   }
-  out.push(join6(home, ".cursor", "auth.json"));
+  out.push(join8(home, ".cursor", "auth.json"));
   return out;
 }
 async function tokenFromKeychain2() {
@@ -1841,9 +1988,9 @@ async function fetchCursor(account) {
 }
 
 // src/adapters/grok.ts
-import { existsSync as existsSync7, readFileSync as readFileSync7 } from "node:fs";
-import { homedir as homedir6 } from "node:os";
-import { join as join7 } from "node:path";
+import { existsSync as existsSync8, readFileSync as readFileSync7 } from "node:fs";
+import { homedir as homedir8 } from "node:os";
+import { join as join9 } from "node:path";
 var DEFAULT_PROXY = "https://cli-chat-proxy.grok.com/v1";
 var TOKEN_URL = "https://auth.x.ai/oauth2/token";
 var FALLBACK_CLI_VERSION3 = "1.0.13";
@@ -1858,7 +2005,7 @@ var TIER_NAMES = {
 function authFile() {
   if (process.env.GROK_AUTH_FILE)
     return process.env.GROK_AUTH_FILE;
-  return join7(homedir6(), ".grok", "auth.json");
+  return join9(homedir8(), ".grok", "auth.json");
 }
 function proxyBase() {
   const raw = process.env.GROK_CLI_CHAT_PROXY_BASE_URL?.trim();
@@ -1908,7 +2055,7 @@ function sessionFromAuthJson(parsed) {
 }
 function readGrokSession() {
   const file = authFile();
-  if (!existsSync7(file))
+  if (!existsSync8(file))
     return null;
   try {
     return sessionFromAuthJson(JSON.parse(readFileSync7(file, "utf8")));
@@ -2102,10 +2249,53 @@ function providerName(id) {
 }
 
 // src/collect.ts
+function providerHomeMarkers(id) {
+  const home = homedir9();
+  switch (id) {
+    case "antigravity":
+      return [
+        join10(home, ".gemini", "antigravity-cli", "antigravity-oauth-token"),
+        join10(home, ".gemini", "antigravity-cli", "settings.json"),
+        join10(home, ".gemini", "antigravity-cli", "installation_id")
+      ];
+    case "claude":
+      return [join10(home, ".claude", ".credentials.json"), join10(home, ".claude", "settings.json")];
+    case "codex":
+      return [join10(home, ".codex", "auth.json"), join10(home, ".codex", "config.toml")];
+    case "cursor":
+      return [join10(home, ".cursor", "auth.json")];
+    case "grok":
+      return [join10(home, ".grok", "auth.json")];
+    case "opencode": {
+      const xdg = process.env.XDG_DATA_HOME;
+      const base = xdg && xdg.trim() ? xdg : join10(home, ".local", "share");
+      return [join10(base, "opencode", "auth.json")];
+    }
+  }
+}
+function providerHomeExists(id) {
+  return providerHomeMarkers(id).some((file) => existsSync9(file));
+}
+function isProviderPresent(opts) {
+  if (opts.binPath)
+    return true;
+  if (opts.provider === "opencode")
+    return true;
+  return opts.homeExists;
+}
 async function detectProviders() {
+  clearBinCache();
   return Promise.all(PROVIDERS.map(async (p) => {
-    const path = await which(p.bin);
-    return { id: p.id, installed: path !== null, version: null };
+    const path = await which(p.bin, { fresh: true });
+    const homeExists = providerHomeExists(p.id);
+    const installed = isProviderPresent({ binPath: path, homeExists, provider: p.id });
+    log("info", "detect", {
+      provider: p.id,
+      installed,
+      path: path ?? undefined,
+      home: homeExists || undefined
+    });
+    return { id: p.id, installed, version: null };
   }));
 }
 function resolveAccounts(provider, installed) {
@@ -2120,9 +2310,24 @@ function resolveAccounts(provider, installed) {
 }
 async function fetchAccount(account) {
   try {
-    return await withTimeout(fetchSnapshot(account), FETCH_TIMEOUT_MS, `${account.provider} fetch`);
+    const snap = await withTimeout(fetchSnapshot(account), FETCH_TIMEOUT_MS, `${account.provider} fetch`);
+    log(snap.status === "error" ? "error" : "info", "quotas.fetch", {
+      account: snap.account.id,
+      provider: snap.account.provider,
+      status: snap.status,
+      windows: snap.windows.length,
+      message: snap.message ?? undefined
+    });
+    return snap;
   } catch (e) {
-    return snapshot(account, "error", { message: e instanceof Error ? e.message : String(e) });
+    const snap = snapshot(account, "error", { message: e instanceof Error ? e.message : String(e) });
+    log("error", "quotas.fetch", {
+      account: account.id,
+      provider: account.provider,
+      status: snap.status,
+      message: snap.message ?? undefined
+    });
+    return snap;
   }
 }
 async function collectReport(update, only) {
@@ -2132,10 +2337,19 @@ async function collectReport(update, only) {
     const accounts = resolveAccounts(p.id, pres.installed);
     const [snapshots, version] = await Promise.all([
       Promise.all(accounts.map(fetchAccount)),
-      pres.installed ? binVersion(p.bin) : Promise.resolve(null)
+      pres.installed ? binVersion(await which(p.bin) ?? p.bin) : Promise.resolve(null)
     ]);
     return { id: p.id, name: p.name, installed: pres.installed, version, accounts: snapshots };
   }));
+  const accounts = providers.flatMap((p) => p.accounts);
+  log("info", "quotas.collect", {
+    providers: providers.length,
+    accounts: accounts.length,
+    ok: accounts.filter((a) => a.status === "ok").length,
+    error: accounts.filter((a) => a.status === "error").length,
+    signed_out: accounts.filter((a) => a.status === "signed_out").length,
+    unsupported: accounts.filter((a) => a.status === "unsupported").length
+  });
   return {
     version: VERSION,
     hostname: formatHostname(hostname()),
@@ -2180,7 +2394,7 @@ class ReportCache {
 }
 
 // src/instance.ts
-import { existsSync as existsSync8, readdirSync, readFileSync as readFileSync8, unlinkSync, writeFileSync as writeFileSync3 } from "node:fs";
+import { existsSync as existsSync10, readdirSync, readFileSync as readFileSync8, unlinkSync, writeFileSync as writeFileSync3 } from "node:fs";
 function looksLikeJustUsageCommand(command) {
   const s = command.replace(/\\/g, "/").toLowerCase();
   return s.includes("just-usage") || /\/just-usage\/(?:src\/|dist\/)?cli\.(ts|js)\b/.test(s);
@@ -2217,7 +2431,7 @@ function writeRunRecord(opts) {
 }
 function readRunRecord(port) {
   const file = paths.runRecord(port);
-  if (!existsSync8(file))
+  if (!existsSync10(file))
     return null;
   return parseRunRecord(readFileSync8(file, "utf8"));
 }
@@ -2229,7 +2443,7 @@ function removeRunRecord(port) {
 }
 function listRunPorts() {
   const dir = paths.runDir();
-  if (!existsSync8(dir))
+  if (!existsSync10(dir))
     return [];
   const ports = [];
   for (const name of readdirSync(dir)) {
@@ -2350,13 +2564,17 @@ async function terminate(pids) {
 async function stopPort(port) {
   const found = await oursOnPort(port);
   if (found.pids.length === 0) {
-    if (found.listening && !isJustUsageHealth(found.health))
+    if (found.listening && !isJustUsageHealth(found.health)) {
+      log("warn", "stop.busy", { port });
       return { status: "busy", port };
+    }
     removeRunRecord(port);
+    log("info", "stop.idle", { port });
     return { status: "idle", port };
   }
   await terminate(found.pids);
   removeRunRecord(port);
+  log("info", "stop.ok", { port, pids: found.pids });
   return { status: "stopped", port, pids: found.pids };
 }
 async function stopServers(opts) {
@@ -2714,8 +2932,8 @@ var ui_default = `<!doctype html>
     if (cached && Array.isArray(cached.providers)) report = cached;
   } catch {}
   const params = new URLSearchParams(location.search);
-  const wanted = params.get("tab");
-  let active = PROVIDERS.some(([id]) => id === wanted) ? wanted : localStorage.getItem("ju.tab") || "claude";
+  let active = localStorage.getItem("ju.tab") || "claude";
+  if (!PROVIDERS.some(([id]) => id === active)) active = "claude";
   let settingsOpen = params.get("view") === "settings";
   let loading = false;
   let busy = false;
@@ -2864,16 +3082,17 @@ var ui_default = `<!doctype html>
     else render();
   }
 
+  function syncUrl() {
+    const want = settingsOpen ? \`\${location.pathname}?view=settings\` : location.pathname;
+    if (location.pathname + location.search !== want) history.replaceState(null, "", want);
+  }
+
   function setView(open) {
     settingsOpen = open;
     $("dash").hidden = open;
     $("settings").hidden = !open;
-    const btn = $("opts-btn");
     $("opts-label").textContent = open ? "Back" : "Options";
-    const q = new URLSearchParams();
-    if (open) q.set("view", "settings");
-    else q.set("tab", active);
-    history.replaceState(null, "", q.toString() ? \`?\${q}\` : location.pathname);
+    syncUrl();
     if (open) {
       renderSettings();
       renderChrome();
@@ -3534,6 +3753,7 @@ var ui_default = `<!doctype html>
   document.addEventListener("visibilitychange", () => {
     if (document.visibilityState === "visible") maybeAutoRefresh();
   });
+  syncUrl();
   if (report) render();
   load(false);
 })();
@@ -3641,9 +3861,23 @@ async function startServer(opts) {
     cache.invalidate();
     return out;
   };
+  const quietPath = (path) => path === "/favicon.svg" || path === "/favicon.ico" || path.startsWith("/logos/");
   const handler = async (req, res) => {
     const url = new URL(req.url ?? "/", "http://localhost");
+    const started = Date.now();
     res.setHeader("X-Content-Type-Options", "nosniff");
+    if (!quietPath(url.pathname)) {
+      res.on("finish", () => {
+        const status = res.statusCode;
+        log(status >= 500 ? "error" : status >= 400 ? "warn" : "info", "http", {
+          method: req.method ?? "GET",
+          path: url.pathname,
+          refresh: url.searchParams.get("refresh") === "1" || undefined,
+          status,
+          ms: Date.now() - started
+        });
+      });
+    }
     try {
       const method = req.method ?? "GET";
       if ((url.pathname === "/favicon.svg" || url.pathname === "/favicon.ico") && (method === "GET" || method === "HEAD")) {
@@ -3745,6 +3979,7 @@ async function startServer(opts) {
       json(res, 404, { error: "not found" });
     } catch (e) {
       if (e instanceof AccountError) {
+        log("warn", "http.error", { path: url.pathname, status: e.status, message: e.message });
         json(res, e.status, { error: e.message });
         return;
       }
@@ -3752,6 +3987,7 @@ async function startServer(opts) {
         json(res, 400, { error: "Invalid JSON." });
         return;
       }
+      logError("http.error", e, { path: url.pathname, status: 500 });
       json(res, 500, { error: e instanceof Error ? e.message : String(e) });
     }
   };
@@ -3760,12 +3996,15 @@ async function startServer(opts) {
     server.once("error", reject);
     server.listen(opts.port, opts.host, () => {
       writeRunRecord({ port: opts.port, host: opts.host });
+      const urls = reachableUrls(opts.host, opts.port, tailscaleIp);
+      log("info", "serve.start", { host: opts.host, port: opts.port, urls: urls.map((u) => u.url) });
       resolve({
         close: () => {
+          log("info", "serve.stop", { port: opts.port });
           removeRunRecord(opts.port);
           server.close();
         },
-        urls: reachableUrls(opts.host, opts.port, tailscaleIp)
+        urls
       });
     });
   });
@@ -3879,12 +4118,12 @@ function renderReport(report, now = Date.now()) {
 }
 
 // src/update.ts
-import { existsSync as existsSync9, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "node:fs";
+import { existsSync as existsSync11, readFileSync as readFileSync9, writeFileSync as writeFileSync4 } from "node:fs";
 import { dirname as dirname3 } from "node:path";
 var CHECK_INTERVAL_MS = 12 * 60 * 60 * 1000;
 function readCache() {
   const file = paths.updateCache();
-  if (!existsSync9(file))
+  if (!existsSync11(file))
     return null;
   try {
     const parsed = JSON.parse(readFileSync9(file, "utf8"));
@@ -3941,11 +4180,15 @@ async function checkForUpdate(force = false) {
       latest = null;
     }
   }
-  if (!latest)
+  if (!latest) {
+    log("warn", "update.check", { ok: false });
     return cached ? toInfo(cached) : null;
+  }
   const entry = { checkedAt: new Date().toISOString(), latest };
   writeCache(entry);
-  return toInfo(entry);
+  const info = toInfo(entry);
+  log("info", "update.check", { latest: info.latest, available: info.available });
+  return info;
 }
 function toInfo(c) {
   return { current: VERSION, latest: c.latest, available: semverGt(c.latest, VERSION), checkedAt: c.checkedAt };
@@ -3976,7 +4219,10 @@ function upgradeCommand(pm, version = "latest") {
 async function runUpgrade(pm, version = "latest") {
   const [cmd, args] = upgradeCommand(pm, version);
   console.log(`$ ${cmd} ${args.join(" ")}`);
-  return runInteractive(cmd, args);
+  log("info", "update.upgrade", { pm, version });
+  const code = await runInteractive(cmd, args);
+  log(code === 0 ? "info" : "error", "update.upgrade.done", { pm, version, code: code ?? undefined });
+  return code;
 }
 
 // src/cli.ts
@@ -4008,6 +4254,8 @@ Cursor uses whatever \`cursor-agent\` is logged in as (single account).
 Grok uses whatever \`grok login --oauth\` stored (single account).
 Antigravity extras are extra Google logins; they do not replace \`agy\`'s signed-in account.
 
+Logs are appended to ~/.just-usage/logs (one JSON line per action).
+
 Stop
   \`just-usage stop\` asks the server to exit — the same as Ctrl+C in the terminal
   that started it. Use this when that terminal is gone or another instance is
@@ -4054,6 +4302,7 @@ See also
   just-usage --help              All commands
 `;
 function fail(msg, code = 1) {
+  log("error", "cli.fail", { message: msg, code });
   console.error(msg);
   process.exit(code);
 }
@@ -4120,6 +4369,7 @@ Update available: v${u.current} → v${u.latest}. Run: just-usage upgrade
       fail(`Port ${port} is already in use. Stop it with: ${stop}
 Or start another: just-usage serve --port ${port + 1}`);
     }
+    logError("serve.error", e, { host, port });
     throw e;
   }
   console.log(`${PACKAGE_NAME} v${VERSION}`);
@@ -4141,6 +4391,7 @@ Press Ctrl+C to stop. From another terminal: ${stopHint}`);
 }
 async function cmdStatus(argv) {
   const { values } = parseArgs({ args: argv, options: { json: { type: "boolean" } }, allowPositionals: true, strict: false });
+  log("info", "cli.status", { json: values.json === true });
   const [report, update] = await Promise.all([collectReport(null), checkForUpdate().catch(() => null)]);
   report.update = update;
   if (values.json) {
@@ -4151,6 +4402,7 @@ async function cmdStatus(argv) {
 }
 function cmdAccounts() {
   const rows = listAccounts();
+  log("info", "cli.accounts", { extra: rows.length });
   console.log("Default accounts come from each CLI's own login (codex login, claude /login, cursor-agent login, grok login --oauth, opencode auth login, agy).");
   if (rows.length === 0) {
     console.log(`
@@ -4202,9 +4454,11 @@ async function addClaudeProfile(label) {
   if (!status?.loggedIn) {
     const { rmSync } = await import("node:fs");
     rmSync(dir, { recursive: true, force: true });
+    log("error", "account.login.error", { provider: "claude", message: "login did not complete" });
     fail("Login did not complete; nothing was saved.");
   }
   saveAccount({ id, provider: "claude", label: label ?? id.split(":")[1], kind: "profile", path: dir, email: null, createdAt: new Date().toISOString() });
+  log("info", "account.add", { account: id, provider: "claude", kind: "profile" });
   console.log(`
 Added ${id}. Note: on macOS the first read may trigger a Keychain prompt — choose "Always Allow".`);
 }
@@ -4269,6 +4523,7 @@ async function cmdLogin(argv) {
     fail(`Unknown account: ${id}`);
   if (rec.kind !== "profile" || !rec.path)
     fail(`${id} is a ${rec.kind} account; remove and re-add it instead.`);
+  log("info", "account.login.start", { account: id, provider: rec.provider, kind: "relogin" });
   if (rec.provider === "codex") {
     const info = await codexLogin(rec.path, (url) => {
       console.log(`
@@ -4278,10 +4533,15 @@ ${url}
       openInBrowser(url);
     });
     updateAccount(id, { email: info.email });
+    log("info", "account.login.done", { account: id, provider: "codex" });
     console.log(`Re-authenticated ${id}${info.email ? ` (${info.email})` : ""}.`);
   } else if (rec.provider === "claude") {
     await runInteractive("claude", ["auth", "login"], { CLAUDE_CONFIG_DIR: rec.path });
     const status = await claudeAuthStatus(rec.path);
+    log(status?.loggedIn ? "info" : "error", status?.loggedIn ? "account.login.done" : "account.login.error", {
+      account: id,
+      provider: "claude"
+    });
     console.log(status?.loggedIn ? `Re-authenticated ${id}.` : "Login did not complete.");
   } else {
     fail(`${providerName(rec.provider)} accounts cannot be re-authenticated this way.`);
@@ -4348,6 +4608,7 @@ async function cmdUpgrade(argv) {
 async function main() {
   const argv = process.argv.slice(2);
   const cmd = argv[0];
+  log("info", "cli", { command: cmd ?? "serve" });
   if (cmd === "--version" || cmd === "-v" || cmd === "version") {
     console.log(VERSION);
     return;
@@ -4387,6 +4648,7 @@ ${HELP}`);
   }
 }
 main().catch((e) => {
+  logError("cli.crash", e);
   console.error(e instanceof Error ? e.message : String(e));
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "just-usage",
-  "version": "0.0.5",
+  "version": "0.0.6",
   "description": "One local page for your coding-CLI subscription quotas: Claude, Codex, Cursor, Antigravity, Grok, OpenCode Go.",
   "type": "module",
   "license": "MIT",