charge-connect 0.1.0

package/cli.js

@@ -0,0 +1,109 @@
+#!/usr/bin/env node
+// charge-connect CLI — 앱에서 받은 페어링 코드로 연결하고 자동 수집을 등록한다.
+//
+// 사용법:
+//   npx charge-connect <페어링코드>   # 페어링 + 첫 수집 + 스케줄 등록 (일반 사용자용 원라이너)
+//   charge-connect run               # 수집 1회 (스케줄러가 호출)
+//   charge-connect unpair            # 페어링 해제
+//
+// 설정 파일: ~/.charge/config.json (CHARGE_HOME으로 위치 변경 가능)
+
+const fs = require("node:fs");
+const path = require("node:path");
+const { execFileSync } = require("node:child_process");
+
+const HOME = process.env.HOME ?? process.env.USERPROFILE;
+const CONF_DIR = process.env.CHARGE_HOME ?? path.join(HOME, ".charge");
+const CONF = path.join(CONF_DIR, "config.json");
+const WIN = process.platform === "win32";
+
+// 백엔드 주소 — collector/cloud.json (출시 시 charge 전용 프로젝트로 교체, npm 패키지에 포함)
+const CLOUD = (() => {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(__dirname, "cloud.json"), "utf8"));
+  } catch {
+    return {};
+  }
+})();
+
+async function pair(code) {
+  const url = process.env.CHARGE_URL ?? CLOUD.url;
+  const anon = process.env.CHARGE_ANON ?? CLOUD.anon;
+  if (!url || !anon) {
+    console.error("백엔드 주소가 없습니다 (collector/cloud.json 또는 CHARGE_URL/CHARGE_ANON).");
+    process.exit(1);
+  }
+  const res = await fetch(`${url}/rest/v1/rpc/charge_claim_pairing_code`, {
+    method: "POST",
+    headers: { apikey: anon, Authorization: `Bearer ${anon}`, "Content-Type": "application/json" },
+    body: JSON.stringify({ p_code: code, p_label: require("node:os").hostname() }),
+    signal: AbortSignal.timeout(15_000),
+  });
+  const token = res.ok ? await res.json() : null;
+  if (!token || typeof token !== "string") {
+    console.error(res.ok ? "잘못됐거나 만료된 페어링 코드입니다." : `페어링 실패 (${res.status}): ${await res.text()}`);
+    console.error("앱에서 새 코드를 발급받아 다시 시도하세요 (코드는 10분간 유효).");
+    process.exit(1);
+  }
+  // 디바이스 토큰은 본인만 읽을 수 있게 저장 (0700/0600)
+  fs.mkdirSync(CONF_DIR, { recursive: true, mode: 0o700 });
+  try { fs.chmodSync(CONF_DIR, 0o700); } catch {}
+  fs.writeFileSync(CONF, JSON.stringify({ url, anon, token }, null, 2), { mode: 0o600 });
+  try { fs.chmodSync(CONF, 0o600); } catch {}
+  console.log("✓ 페어링 완료");
+}
+
+// npx 캐시는 언제든 청소될 수 있으므로, 스케줄 등록 전에 런타임을 ~/.charge/app 으로 복사한다
+function installRuntime() {
+  const dest = path.join(CONF_DIR, "app");
+  fs.mkdirSync(dest, { recursive: true, mode: 0o700 });
+  for (const f of ["cli.js", "collect.js", "install.sh", "install.ps1", "cloud.json", "package.json"]) {
+    const src = path.join(__dirname, f);
+    if (fs.existsSync(src)) fs.copyFileSync(src, path.join(dest, f));
+  }
+  if (!WIN) {
+    try { fs.chmodSync(path.join(dest, "install.sh"), 0o755); } catch {}
+  }
+  return dest;
+}
+
+function collect(dir = __dirname) {
+  execFileSync(process.execPath, [path.join(dir, "collect.js")], { stdio: "inherit" });
+}
+
+function installSchedule() {
+  const dir = installRuntime();
+  const p = path.join(dir, WIN ? "install.ps1" : "install.sh");
+  if (WIN) {
+    execFileSync("powershell.exe", ["-ExecutionPolicy", "Bypass", "-File", p], { stdio: "inherit" });
+  } else {
+    execFileSync("/bin/bash", [p], { stdio: "inherit" });
+  }
+}
+
+(async () => {
+  const arg = process.argv[2];
+  if (!arg) {
+    console.error("사용법: npx charge-connect <페어링코드>  (앱 온보딩에서 코드 발급)");
+    process.exit(1);
+  }
+  if (arg === "run") {
+    collect();
+    return;
+  }
+  if (arg === "unpair") {
+    fs.rmSync(CONF, { force: true });
+    console.log("✓ 페어링 해제 (스케줄 해제는 install.sh/install.ps1 안내 참고)");
+    return;
+  }
+  // 페어링 코드로 간주: 페어링 → 첫 수집 → 스케줄 등록
+  await pair(arg);
+  console.log("첫 수집을 실행합니다…");
+  collect();
+  console.log("5분 간격 자동 수집을 등록합니다…");
+  installSchedule();
+  console.log("✓ 설정 끝! 이제 앱에서 데이터가 보입니다.");
+})().catch((e) => {
+  console.error(e.message ?? e);
+  process.exit(1);
+});

package/cloud.json

@@ -0,0 +1,4 @@
+{
+  "url": "https://kfzdukmoprvmqiyrptqt.supabase.co",
+  "anon": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6ImtmemR1a21vcHJ2bXFpeXJwdHF0Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3ODUzMzAyODUsImV4cCI6MjEwMDkwNjI4NX0.MCrxQhsoKEMMnM5_x1huHdbyMjph5TWJ83hptP9s-9I"
+}

package/collect.js

@@ -0,0 +1,634 @@
+#!/usr/bin/env node
+// Charge 수집기 — ccusage로 토큰 사용량을 뽑아 Charge 백엔드에 업로드한다.
+// 사용법: node collect.js [--dry-run] [--days N]
+// 인증: `npx charge-connect <페어링코드>`가 저장한 ~/.charge/config.json의 디바이스 토큰
+
+const { execFileSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const DRY_RUN = process.argv.includes("--dry-run");
+const daysArg = process.argv.indexOf("--days");
+const parsedDays = daysArg > -1 ? parseInt(process.argv[daysArg + 1], 10) : NaN;
+const DAYS = Number.isFinite(parsedDays) && parsedDays > 0 ? parsedDays : 60;
+const CACHE_FILE = path.join(__dirname, ".last-payload.json");
+const HOME = process.env.HOME ?? process.env.USERPROFILE;
+const WIN = process.platform === "win32";
+const EXTRA_PATH = WIN ? "" : ":/opt/homebrew/bin:/usr/local/bin";
+const DEFAULT_CODEXBAR_CLI = "/Applications/CodexBar.app/Contents/Helpers/CodexBarCLI";
+
+function run(cmd, args, timeout = 120_000) {
+  return execFileSync(cmd, args, {
+    encoding: "utf8",
+    maxBuffer: 64 * 1024 * 1024,
+    timeout,
+    env: { ...process.env, PATH: `${process.env.PATH}${EXTRA_PATH}` },
+    // Windows에서 npx/ccusage는 .cmd 셔틀이라 셸을 거쳐야 실행된다 (인자는 모두 고정 문자열)
+    shell: WIN,
+  });
+}
+
+function runCcusage(args) {
+  // 전역 설치본이 있으면 사용(빠름), 없으면 npx로 대체
+  try {
+    return JSON.parse(run("ccusage", args));
+  } catch (e) {
+    console.error(`ccusage 직접 실행 실패(${e.code ?? e.message}), npx로 재시도`);
+    return JSON.parse(run("npx", ["-y", "ccusage@latest", ...args], 300_000));
+  }
+}
+
+// 프로바이더 계정 식별자 해시 — 원문 대신 해시만 업로드 (다른 계정이면 카드가 분리되도록)
+function accountHash(id) {
+  if (!id) return null;
+  return require("node:crypto").createHash("sha256").update(String(id)).digest("hex").slice(0, 12);
+}
+
+/// 리셋 시각이 이미 지난 창은 무효 처리 (리셋 후 100% 박제 방지)
+function dropExpired(w) {
+  if (!w) return null;
+  if (w.resets_at && new Date(w.resets_at).getTime() < Date.now()) return null;
+  return w;
+}
+
+const PROVIDER_NAMES = {
+  "azure-openai": "Azure OpenAI",
+  "openai": "OpenAI",
+  "opencode": "OpenCode",
+  "opencodego": "OpenCode Go",
+  "openrouter": "OpenRouter",
+  "vertexai": "Vertex AI",
+  "alibaba-coding-plan": "Alibaba Coding Plan",
+  "alibaba-token-plan": "Alibaba Token Plan",
+  "antigravity": "Antigravity",
+  "copilot": "GitHub Copilot",
+  "deepseek": "DeepSeek",
+  "jetbrains": "JetBrains",
+  "minimax": "MiniMax",
+  "perplexity": "Perplexity",
+  "windsurf": "Windsurf",
+  "zai": "Z.ai",
+};
+
+function titleCaseProvider(id) {
+  return String(id)
+    .split(/[-_.]+/)
+    .filter(Boolean)
+    .map((part) => part[0]?.toUpperCase() + part.slice(1))
+    .join(" ");
+}
+
+function normalizeResetAt(value) {
+  if (value == null || value === "") return null;
+  const numeric = typeof value === "number" ? value : Number.NaN;
+  const date = Number.isFinite(numeric)
+    ? new Date(numeric < 10_000_000_000 ? numeric * 1000 : numeric)
+    : new Date(value);
+  return Number.isNaN(date.getTime()) ? null : date.toISOString();
+}
+
+function durationLabel(minutes) {
+  if (minutes === 300) return "Session";
+  if (minutes === 1440) return "Daily";
+  if (minutes === 10_080) return "Weekly";
+  if (minutes === 43_200) return "Monthly";
+  return null;
+}
+
+function explicitWindowLabel(window) {
+  const value = window?.label ?? window?.title ?? window?.displayName ?? window?.name ?? window?.limitName;
+  return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+
+function normalizeRateWindow(window, slot, duplicateDuration = false, forcedLabel = null) {
+  if (!window || typeof window !== "object") return null;
+  const percent = Number(window.usedPercent ?? window.percent ?? window.utilization);
+  if (!Number.isFinite(percent)) return null;
+  const rawMinutes = window.windowMinutes ?? window.window_minutes ?? window.durationMinutes;
+  const parsedMinutes = rawMinutes == null ? null : Number(rawMinutes);
+  const minutes = Number.isFinite(parsedMinutes) && parsedMinutes > 0 ? parsedMinutes : null;
+  const baseLabel = durationLabel(minutes);
+  const slotLabel = slot[0].toUpperCase() + slot.slice(1);
+  const label = forcedLabel
+    ?? explicitWindowLabel(window)
+    ?? (duplicateDuration && baseLabel ? `${slotLabel} ${baseLabel.toLowerCase()}` : baseLabel)
+    ?? slotLabel;
+  return dropExpired({
+    percent: Math.min(100, Math.max(0, percent)),
+    resets_at: normalizeResetAt(window.resetsAt ?? window.resets_at ?? window.resetAt),
+    window_minutes: minutes,
+    label,
+  });
+}
+
+function textValue(...values) {
+  return values.find((value) => typeof value === "string" && value.trim())?.trim() ?? null;
+}
+
+function usefulPlan(...values) {
+  const value = textValue(...values);
+  if (!value) return null;
+  const generic = new Set(["api", "auto", "browser", "cli", "cookie", "oauth", "unknown", "web"]);
+  return generic.has(value.toLowerCase()) ? null : value;
+}
+
+function sinceStr(days) {
+  const d = new Date(Date.now() - days * 86400_000);
+  return `${d.getFullYear()}${String(d.getMonth() + 1).padStart(2, "0")}${String(d.getDate()).padStart(2, "0")}`;
+}
+
+function collectDaily() {
+  const data = runCcusage(["daily", "--json", "--since", sinceStr(DAYS)]);
+  let rows = data.daily ?? [];
+  // 에이전트별 행과 "all" 집계 행이 섞여 있으면 "all"만 사용해 중복 합산을 방지
+  if (rows.some((r) => r.agent === "all")) rows = rows.filter((r) => r.agent === "all");
+  const byDay = new Map();
+  for (const r of rows) {
+    const e = byDay.get(r.period) ?? {
+      period: r.period,
+      total_cost: 0, total_tokens: 0, input_tokens: 0, output_tokens: 0,
+      cache_read_tokens: 0, cache_creation_tokens: 0, models: [],
+    };
+    e.total_cost += r.totalCost ?? 0;
+    e.total_tokens += r.totalTokens ?? 0;
+    e.input_tokens += r.inputTokens ?? 0;
+    e.output_tokens += r.outputTokens ?? 0;
+    e.cache_read_tokens += r.cacheReadTokens ?? 0;
+    e.cache_creation_tokens += r.cacheCreationTokens ?? 0;
+    e.models = e.models.concat(r.modelBreakdowns ?? []);
+    byDay.set(r.period, e);
+  }
+  return [...byDay.values()].sort((a, b) => a.period.localeCompare(b.period));
+}
+
+function collectLive() {
+  const data = runCcusage(["blocks", "--active", "--json"]);
+  return (data.blocks ?? []).find((b) => b.isActive) ?? null;
+}
+
+// Claude Code 자격증명: macOS는 Keychain, Windows/Linux는 ~/.claude/.credentials.json
+function claudeCredentials() {
+  try {
+    return JSON.parse(run("security", ["find-generic-password", "-s", "Claude Code-credentials", "-w"]));
+  } catch {
+    return JSON.parse(fs.readFileSync(path.join(HOME, ".claude", ".credentials.json"), "utf8"));
+  }
+}
+
+// Claude: Claude Code OAuth 세션을 재사용해 공식 usage API 조회
+async function claudeProvider() {
+  try {
+    const cred = claudeCredentials();
+    const oauth = cred.claudeAiOauth ?? cred;
+    const token = oauth.accessToken;
+    // rateLimitTier "default_claude_max_20x" → "Max 20x", 없으면 subscriptionType "max" → "Max"
+    const tier = /max_(\d+)x/.exec(oauth.rateLimitTier ?? "");
+    const plan = tier
+      ? `Max ${tier[1]}x`
+      : oauth.subscriptionType
+        ? oauth.subscriptionType[0].toUpperCase() + oauth.subscriptionType.slice(1)
+        : null;
+    const res = await fetch("https://api.anthropic.com/api/oauth/usage", {
+      headers: { Authorization: `Bearer ${token}`, "anthropic-beta": "oauth-2025-04-20" },
+      signal: AbortSignal.timeout(10_000),
+    });
+    if (!res.ok) return null;
+    const d = await res.json();
+    // 계정 UUID → 해시 (프로필 조회 실패 시 null — 캐시 폴백이 채워준다)
+    let account = null;
+    try {
+      const pr = await fetch("https://api.anthropic.com/api/oauth/profile", {
+        headers: { Authorization: `Bearer ${token}`, "anthropic-beta": "oauth-2025-04-20" },
+        signal: AbortSignal.timeout(10_000),
+      });
+      if (pr.ok) account = accountHash((await pr.json()).account?.uuid);
+    } catch {}
+    const win = (w, mins) =>
+      w ? { percent: w.utilization ?? 0, resets_at: w.resets_at ?? null, window_minutes: mins } : null;
+    // limits 배열의 weekly_scoped 항목 = 모델별 주간 한도 (예: "Fable only")
+    const extras = (d.limits ?? [])
+      .filter((l) => l.kind === "weekly_scoped" && l.scope?.model?.display_name)
+      .map((l) => ({
+        name: l.scope.model.display_name,
+        window: {
+          percent: l.percent ?? 0,
+          resets_at: l.resets_at ?? null,
+          window_minutes: 10080,
+          label: `${l.scope.model.display_name} weekly`,
+        },
+      }));
+    return {
+      id: "claude",
+      name: "Claude",
+      plan,
+      account,
+      session: dropExpired(win(d.five_hour, 300)),
+      weekly: dropExpired(win(d.seven_day, 10080)),
+      extras: extras.length ? extras : null,
+    };
+  } catch (e) {
+    console.error(`claude 프로바이더 수집 실패: ${e.message ?? e}`);
+    return null;
+  }
+}
+
+// Codex: 최신 세션 로그에 기록된 rate_limits 스냅샷 파싱
+// Codex 자격증명·계정 정보 (~/.codex/auth.json) — 없으면 null
+function codexAuth() {
+  try {
+    const auth = JSON.parse(fs.readFileSync(path.join(HOME, ".codex", "auth.json"), "utf8"));
+    let plan = null;
+    let account = null;
+    try {
+      // id_token JWT의 chatgpt_plan_type ("education" 등) + 계정 식별자
+      const seg = auth.tokens.id_token.split(".")[1];
+      const claims = JSON.parse(Buffer.from(seg, "base64url").toString("utf8"));
+      const a = claims["https://api.openai.com/auth"] ?? {};
+      if (a.chatgpt_plan_type) plan = a.chatgpt_plan_type[0].toUpperCase() + a.chatgpt_plan_type.slice(1);
+      account = accountHash(a.chatgpt_account_id);
+    } catch {}
+    return {
+      accessToken: auth.tokens?.access_token ?? null,
+      accountId: auth.tokens?.account_id ?? null,
+      plan,
+      account,
+    };
+  } catch {
+    return null;
+  }
+}
+
+// Codex 실시간 조회: Codex CLI 자신이 60초마다 폴링하는 것과 같은 엔드포인트를
+// 로컬 OAuth 토큰으로 호출한다. 토큰 갱신은 하지 않는다 — 만료됐으면 null을 반환하고
+// 스냅샷 폴백에 맡긴다 (CLI가 다음 실행 때 알아서 갱신해 둔다).
+async function codexLiveWindows(auth) {
+  if (!auth?.accessToken || !auth?.accountId) return null;
+  try {
+    const res = await fetch("https://chatgpt.com/backend-api/wham/usage", {
+      headers: {
+        Authorization: `Bearer ${auth.accessToken}`,
+        "chatgpt-account-id": auth.accountId,
+        "User-Agent": "charge-connect",
+      },
+      signal: AbortSignal.timeout(10_000),
+    });
+    if (!res.ok) return null;
+    const d = await res.json();
+    const win = (w) =>
+      w && Number.isFinite(Number(w.used_percent))
+        ? {
+            percent: Number(w.used_percent),
+            resets_at: w.reset_at ? new Date(w.reset_at * 1000).toISOString() : null,
+            window_minutes: Number.isFinite(Number(w.limit_window_seconds))
+              ? Math.round(Number(w.limit_window_seconds) / 60)
+              : null,
+          }
+        : null;
+    const session = win(d.rate_limit?.primary_window);
+    const weekly = win(d.rate_limit?.secondary_window);
+    if (!session && !weekly) return null;
+    const plan = usefulPlan(d.plan_type);
+    return { session, weekly, plan: plan ? plan[0].toUpperCase() + plan.slice(1) : null };
+  } catch {
+    return null;
+  }
+}
+
+// Codex 스냅샷 폴백: 가장 최근 세션 로그(.jsonl)에 기록된 마지막 rate_limits —
+// 마지막으로 Codex를 실제 사용한 시점의 값이라 실시간 조회가 실패했을 때만 쓴다
+function codexSnapshotWindows() {
+  const dir = path.join(HOME, ".codex", "sessions");
+  let latest = null;
+  (function walk(d) {
+    for (const e of fs.readdirSync(d, { withFileTypes: true })) {
+      const p = path.join(d, e.name);
+      if (e.isDirectory()) walk(p);
+      else if (e.name.endsWith(".jsonl")) {
+        const m = fs.statSync(p).mtimeMs;
+        if (!latest || m > latest.m) latest = { p, m };
+      }
+    }
+  })(dir);
+  if (!latest) return null;
+
+  const findRL = (o) => {
+    if (!o || typeof o !== "object") return null;
+    if (o.rate_limits) return o.rate_limits;
+    for (const v of Object.values(o)) {
+      const r = findRL(v);
+      if (r) return r;
+    }
+    return null;
+  };
+  let rl = null;
+  for (const line of fs.readFileSync(latest.p, "utf8").split("\n")) {
+    if (!line.includes('"rate_limits"')) continue;
+    try {
+      rl = findRL(JSON.parse(line)) ?? rl;
+    } catch {}
+  }
+  if (!rl) return null;
+  const win = (w) =>
+    w
+      ? {
+          percent: w.used_percent ?? 0,
+          resets_at: w.resets_at ? new Date(w.resets_at * 1000).toISOString() : null,
+          window_minutes: w.window_minutes ?? null,
+        }
+      : null;
+  return { session: win(rl.primary), weekly: win(rl.secondary) };
+}
+
+async function codexProvider() {
+  try {
+    const auth = codexAuth();
+    const windows = (await codexLiveWindows(auth)) ?? codexSnapshotWindows();
+    if (!windows) return null;
+    return {
+      id: "codex",
+      name: "Codex",
+      plan: windows.plan ?? auth?.plan ?? null,
+      account: auth?.account ?? null,
+      session: dropExpired(windows.session),
+      weekly: dropExpired(windows.weekly),
+      extras: null,
+    };
+  } catch (e) {
+    console.error(`codex 프로바이더 수집 실패: ${e.message ?? e}`);
+    return null;
+  }
+}
+
+function extraWindowValues(value) {
+  if (Array.isArray(value)) return value;
+  if (!value || typeof value !== "object") return [];
+  return Object.entries(value).map(([name, window]) => ({ name, ...(window ?? {}) }));
+}
+
+// CodexBar 공통 JSON을 Charge의 두 기본 창 + 추가 창 구조로 변환한다.
+// 원본 identity는 절대 반환하지 않고 계정 식별값의 짧은 해시만 보낸다.
+function codexBarEntryToProvider(entry) {
+  if (!entry || entry.error || typeof entry !== "object") return null;
+  const id = textValue(entry.provider, entry.id)?.toLowerCase();
+  if (!id || id === "claude" || id === "codex") return null;
+
+  const usage = entry.usage && typeof entry.usage === "object" ? entry.usage : entry;
+  const identity = usage.identity && typeof usage.identity === "object"
+    ? usage.identity
+    : entry.identity && typeof entry.identity === "object" ? entry.identity : {};
+  const slots = ["primary", "secondary", "tertiary"]
+    .map((slot) => ({ slot, value: usage[slot] ?? entry[slot] }))
+    .filter(({ value }) => value && typeof value === "object");
+  const durationCounts = new Map();
+  for (const { value } of slots) {
+    const minutes = Number(value.windowMinutes ?? value.window_minutes ?? value.durationMinutes);
+    if (Number.isFinite(minutes)) durationCounts.set(minutes, (durationCounts.get(minutes) ?? 0) + 1);
+  }
+  const normalizedWindows = slots
+    .map(({ slot, value }) => {
+      const minutes = Number(value.windowMinutes ?? value.window_minutes ?? value.durationMinutes);
+      return {
+        slot,
+        window: normalizeRateWindow(value, slot, (durationCounts.get(minutes) ?? 0) > 1),
+      };
+    })
+    .filter(({ window }) => window);
+  const primary = normalizedWindows.find(({ slot }) => slot === "primary")?.window ?? null;
+  const secondary = normalizedWindows.find(({ slot }) => slot === "secondary")?.window ?? null;
+
+  const extras = normalizedWindows
+    .filter(({ slot }) => slot === "tertiary")
+    .map(({ window }) => ({ name: window.label, window }));
+  const rawExtras = extraWindowValues(usage.extraRateWindows ?? entry.extraRateWindows);
+  rawExtras.forEach((raw, index) => {
+    const value = raw.window && typeof raw.window === "object" ? raw.window : raw;
+    const label = explicitWindowLabel(raw)
+      ?? explicitWindowLabel(value)
+      ?? `Limit ${index + normalizedWindows.length + 1}`;
+    const window = normalizeRateWindow(value, "limit", false, label);
+    if (window) extras.push({ name: label, window });
+  });
+
+  if (!primary && !secondary && extras.length === 0) return null;
+  const rawAccount = textValue(
+    identity.accountEmail,
+    identity.email,
+    usage.accountEmail,
+    entry.accountEmail,
+    identity.accountId,
+    usage.accountId,
+    identity.accountOrganization,
+    usage.accountOrganization
+  );
+  const plan = usefulPlan(
+    usage.plan,
+    identity.plan,
+    usage.subscription,
+    identity.subscription,
+    usage.loginMethod,
+    identity.loginMethod
+  );
+
+  return {
+    id,
+    name: textValue(entry.displayName, entry.providerName, usage.providerName) ?? PROVIDER_NAMES[id] ?? titleCaseProvider(id),
+    plan,
+    account: accountHash(rawAccount),
+    session: primary,
+    weekly: secondary,
+    extras: extras.length ? extras : null,
+    status: null,
+    collector_source: "codexbar",
+  };
+}
+
+function parseCodexBarJSON(raw) {
+  const text = String(raw ?? "").trim();
+  if (!text) return null;
+  try {
+    const parsed = JSON.parse(text);
+    return Array.isArray(parsed) ? parsed : [parsed];
+  } catch {
+    const start = text.indexOf("[");
+    const end = text.lastIndexOf("]");
+    if (start < 0 || end <= start) return null;
+    try {
+      return JSON.parse(text.slice(start, end + 1));
+    } catch {
+      return null;
+    }
+  }
+}
+
+function collectCodexBarProviders() {
+  if (process.env.CHARGE_DISABLE_CODEXBAR === "1") return { providers: [], complete: false };
+  const cli = process.env.CHARGE_CODEXBAR_CLI
+    ?? (!WIN && fs.existsSync(DEFAULT_CODEXBAR_CLI) ? DEFAULT_CODEXBAR_CLI : null);
+  if (!cli) return { providers: [], complete: false };
+
+  let raw = "";
+  let commandSucceeded = true;
+  try {
+    raw = run(cli, ["usage", "--format", "json"], 90_000);
+  } catch (e) {
+    commandSucceeded = false;
+    raw = e.stdout?.toString?.() ?? "";
+    if (!raw.trim()) {
+      console.error(`CodexBar 프로바이더 수집 실패: ${e.message ?? e}`);
+      return { providers: [], complete: false };
+    }
+  }
+
+  const entries = parseCodexBarJSON(raw);
+  if (!entries) {
+    console.error("CodexBar 프로바이더 수집 실패: JSON 출력을 해석할 수 없습니다.");
+    return { providers: [], complete: false };
+  }
+  const bridgeEntries = entries.filter((entry) => !["claude", "codex"].includes(entry?.provider));
+  const providers = bridgeEntries.map(codexBarEntryToProvider).filter(Boolean);
+  const complete = commandSucceeded && !bridgeEntries.some((entry) => entry?.error);
+  for (const entry of bridgeEntries.filter((item) => item?.error)) {
+    console.error(`CodexBar ${entry.provider ?? "프로바이더"} 수집 실패: ${entry.error.message ?? "알 수 없는 오류"}`);
+  }
+  return { providers, complete };
+}
+
+// 프로바이더 상태 페이지 (Statuspage 공용 API)
+async function statusOf(url) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(8_000) });
+    if (!res.ok) return null;
+    const d = await res.json();
+    return { indicator: d.status?.indicator ?? "none", description: d.status?.description ?? null };
+  } catch {
+    return null;
+  }
+}
+
+async function collectProviders() {
+  const claudePromise = claudeProvider();
+  const claudeStatusPromise = statusOf("https://status.anthropic.com/api/v2/status.json");
+  const codexStatusPromise = statusOf("https://status.openai.com/api/v2/status.json");
+  const codexPromise = codexProvider();
+  const codexBar = collectCodexBarProviders();
+  const [claude, codex, claudeStatus, codexStatus] = await Promise.all([
+    claudePromise,
+    codexPromise,
+    claudeStatusPromise,
+    codexStatusPromise,
+  ]);
+  if (claude) claude.status = claudeStatus;
+  if (codex) codex.status = codexStatus;
+  return {
+    providers: [claude, codex, ...codexBar.providers].filter(Boolean),
+    codexBarComplete: codexBar.complete,
+  };
+}
+
+// 업로드 설정 — 우선순위: CHARGE_* 환경변수(테스트용) → ~/.charge/config.json(페어링)
+function resolveMode() {
+  if (process.env.CHARGE_TOKEN && process.env.CHARGE_URL && process.env.CHARGE_ANON) {
+    return { url: process.env.CHARGE_URL, anon: process.env.CHARGE_ANON, token: process.env.CHARGE_TOKEN };
+  }
+  const conf = path.join(process.env.CHARGE_HOME ?? path.join(HOME, ".charge"), "config.json");
+  try {
+    return JSON.parse(fs.readFileSync(conf, "utf8"));
+  } catch {
+    return null;
+  }
+}
+
+// 디바이스 토큰으로 charge_upload RPC 호출 (서버가 본인 행에만 기록)
+async function pairedUpload(mode, daily, live, providers) {
+  const res = await fetch(`${mode.url}/rest/v1/rpc/charge_upload`, {
+    method: "POST",
+    headers: {
+      apikey: mode.anon,
+      Authorization: `Bearer ${mode.anon}`,
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({ p_token: mode.token, p_daily: daily, p_live: live, p_providers: providers }),
+    signal: AbortSignal.timeout(30_000),
+  });
+  if (!res.ok) throw new Error(`업로드 실패 (${res.status}): ${await res.text()}`);
+}
+
+async function main() {
+  // 이전 성공 페이로드 캐시 — 일부 수집이 실패해도 그 부분만 이전 값으로 유지
+  let cache = {};
+  try {
+    cache = JSON.parse(fs.readFileSync(CACHE_FILE, "utf8"));
+  } catch {}
+
+  let daily, live, providers;
+  try {
+    daily = collectDaily();
+  } catch (e) {
+    console.error(`daily 수집 실패, 이전 값 유지: ${e.message ?? e}`);
+    daily = cache.daily ?? [];
+  }
+  try {
+    live = collectLive();
+  } catch (e) {
+    console.error(`live 수집 실패, 이전 값 유지: ${e.message ?? e}`);
+    live = cache.live ?? null;
+  }
+  let providerCollection;
+  try {
+    providerCollection = await collectProviders();
+  } catch (e) {
+    console.error(`프로바이더 수집 실패, 이전 값 유지: ${e.message ?? e}`);
+    providerCollection = { providers: [], codexBarComplete: false };
+  }
+  providers = providerCollection.providers;
+  // 일부 프로바이더만 실패해도 목록에서 사라지지 않게 이전 값으로 채운다 (앱 설정 토글 유지)
+  for (const prev of cache.providers ?? []) {
+    if (providers.some((p) => p.id === prev.id)) continue;
+    // CodexBar가 정상 완료된 경우, 거기서 더 이상 반환하지 않는 항목은 사용자가 끈 것으로 본다.
+    if (providerCollection.codexBarComplete && prev.collector_source === "codexbar") continue;
+    providers.push(prev);
+  }
+  // 계정 식별 실패 시 마지막으로 알려진 계정 해시 유지 (계정 미상('')과 실제 계정 행이 갈라지는 것 방지)
+  for (const p of providers) {
+    if (!p.account) p.account = (cache.providers ?? []).find((c) => c.id === p.id)?.account ?? null;
+  }
+
+  if (DRY_RUN) {
+    console.log(JSON.stringify({ daily: daily.slice(-1), live, providers }, null, 2));
+    console.log(`\n[dry-run] daily ${daily.length}행 + live + providers ${providers.length}개 업로드 예정`);
+    return;
+  }
+
+  const mode = resolveMode();
+  if (!mode) {
+    console.error("페어링이 안 돼 있습니다. 앱에서 코드를 발급받아 `npx charge-connect <코드>`를 실행하세요.");
+    process.exit(1);
+  }
+
+  const now = new Date().toISOString();
+  await pairedUpload(mode, daily, live, providers);
+
+  fs.writeFileSync(CACHE_FILE, JSON.stringify({ daily, live, providers }));
+  console.log(`[${now}] daily ${daily.length}행 + live + providers ${providers.length}개 업로드 완료`);
+}
+
+if (require.main === module) {
+  main().catch((e) => {
+    console.error(e.message ?? e);
+    process.exit(1);
+  });
+}
+
+module.exports = {
+  accountHash,
+  codexBarEntryToProvider,
+  collectCodexBarProviders,
+  dropExpired,
+  durationLabel,
+  normalizeRateWindow,
+  normalizeResetAt,
+  parseCodexBarJSON,
+  resolveMode,
+  titleCaseProvider,
+  usefulPlan,
+};

package/install.ps1

@@ -0,0 +1,27 @@
+# Charge 수집기를 Windows 작업 스케줄러에 등록한다 (5분 간격).
+# 실행: PowerShell에서 .\install.ps1  (실행 정책 오류 시: powershell -ExecutionPolicy Bypass -File install.ps1)
+$ErrorActionPreference = "Stop"
+
+$taskName = "ChargeConnect"
+$scriptDir = Split-Path -Parent $MyInvocation.MyCommand.Path
+$node = (Get-Command node).Source
+$log = Join-Path $env:USERPROFILE "charge-connect.log"
+
+# 예전 이름(ChargeCollector)으로 등록된 잔재가 있으면 정리
+Unregister-ScheduledTask -TaskName "ChargeCollector" -Confirm:$false -ErrorAction SilentlyContinue
+
+# cmd /c 로 감싸 로그 리다이렉션 (작업 스케줄러는 자체 리다이렉션이 없음)
+$arg = "/c `"`"$node`" `"$scriptDir\collect.js`" >> `"$log`" 2>&1`""
+$action = New-ScheduledTaskAction -Execute "cmd.exe" -Argument $arg
+$trigger = New-ScheduledTaskTrigger -Once -At (Get-Date) `
+    -RepetitionInterval (New-TimeSpan -Minutes 5) `
+    -RepetitionDuration (New-TimeSpan -Days 3650)
+$settings = New-ScheduledTaskSettingsSet -StartWhenAvailable `
+    -AllowStartIfOnBatteries -DontStopIfGoingOnBatteries `
+    -ExecutionTimeLimit (New-TimeSpan -Minutes 10)
+
+Register-ScheduledTask -TaskName $taskName -Action $action -Trigger $trigger -Settings $settings -Force | Out-Null
+Start-ScheduledTask -TaskName $taskName
+
+Write-Host "등록 완료: $taskName (5분 간격). 로그: $log"
+Write-Host "해제하려면: Unregister-ScheduledTask -TaskName $taskName -Confirm:`$false"

package/install.sh

@@ -0,0 +1,41 @@
+#!/bin/bash
+# launchd에 수집기를 등록한다 (5분 간격).
+set -euo pipefail
+
+LABEL="com.charge.connect"
+PLIST="$HOME/Library/LaunchAgents/$LABEL.plist"
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+LOG="$HOME/Library/Logs/charge-connect.log"
+
+mkdir -p "$HOME/Library/LaunchAgents" "$HOME/Library/Logs"
+
+# 예전 이름(charge-collector)으로 등록된 잔재가 있으면 정리
+OLD_PLIST="$HOME/Library/LaunchAgents/com.charge.collector.plist"
+if [ -f "$OLD_PLIST" ]; then
+  launchctl unload "$OLD_PLIST" 2>/dev/null || true
+  rm -f "$OLD_PLIST"
+fi
+
+cat > "$PLIST" <<EOF
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>$LABEL</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/zsh</string>
+    <string>-lc</string>
+    <string>exec node "$SCRIPT_DIR/collect.js"</string>
+  </array>
+  <key>StartInterval</key><integer>300</integer>
+  <key>RunAtLoad</key><true/>
+  <key>StandardOutPath</key><string>$LOG</string>
+  <key>StandardErrorPath</key><string>$LOG</string>
+</dict>
+</plist>
+EOF
+
+launchctl unload "$PLIST" 2>/dev/null || true
+launchctl load "$PLIST"
+echo "등록 완료: $LABEL (5분 간격). 로그: $LOG"

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "charge-connect",
+  "version": "0.1.0",
+  "description": "Connects your computer to the Charge iPhone app and uploads AI coding usage",
+  "bin": {
+    "charge-connect": "cli.js"
+  },
+  "scripts": {
+    "test": "node --test collect.test.js"
+  },
+  "files": [
+    "cli.js",
+    "collect.js",
+    "install.sh",
+    "install.ps1",
+    "cloud.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/baekdusan/charge.git"
+  }
+}