@vibescore/tracker 0.0.4 → 0.0.5

package/README.md

@@ -5,6 +5,8 @@
 **QUANTIFY YOUR AI OUTPUT**  
 _Real-time AI Analytics for Codex CLI_
 
+[**www.vibescore.space**](https://www.vibescore.space)
+
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
 [![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
@@ -50,6 +52,24 @@ npx --yes @vibescore/tracker sync
 npx --yes @vibescore/tracker status
 ```
 
+## 🧰 Troubleshooting
+
+### Streak shows 0 days while totals look correct
+
+- Streak is defined as consecutive days ending today. If today's total is 0, streak will be 0.
+- If you expect a non-zero streak, clear cached auth/heatmap data and sign in again:
+
+```js
+localStorage.removeItem('vibescore.dashboard.auth.v1');
+Object.keys(localStorage)
+  .filter((k) => k.startsWith('vibescore.heatmap.'))
+  .forEach((k) => localStorage.removeItem(k));
+location.reload();
+```
+
+- Complete the landing page sign-in flow again after reload.
+- Note: `insforge-auth-token` is not used by the dashboard; use `vibescore.dashboard.auth.v1`.
+
 ## 🏗️ Architecture
 
 ```mermaid

package/README.zh-CN.md

@@ -5,6 +5,8 @@
 **量化你的 AI 产出**  
 _Codex CLI 实时 AI 分析工具_
 
+[**www.vibescore.space**](https://www.vibescore.space)
+
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)
 [![Node.js Support](https://img.shields.io/badge/Node.js-%3E%3D18-brightgreen.svg)](https://nodejs.org/)
 [![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey.svg)](https://www.apple.com/macos/)
@@ -50,6 +52,24 @@ npx --yes @vibescore/tracker sync
 npx --yes @vibescore/tracker status
 ```
 
+## 🧰 常见问题
+
+### Streak 显示 0 天但总量正常
+
+- Streak 的口径是“从今天开始连续使用的天数”，如果今天的 total 为 0，streak 就是 0。
+- 如果你确认应该有 streak，请清理本地缓存并重新登录：
+
+```js
+localStorage.removeItem('vibescore.dashboard.auth.v1');
+Object.keys(localStorage)
+  .filter((k) => k.startsWith('vibescore.heatmap.'))
+  .forEach((k) => localStorage.removeItem(k));
+location.reload();
+```
+
+- 刷新后重新走一遍 landing page 的登录流程。
+- 说明：Dashboard 不使用 `insforge-auth-token`，实际存储在 `vibescore.dashboard.auth.v1`。
+
 ## 🏗️ 系统架构
 
 ```mermaid
@@ -92,6 +112,6 @@ npm run smoke
 ---
 
 <div align="center">
-  <b>System_Ready // 2014 VibeScore OS</b><br/>
+  <b>System_Ready // 2024 VibeScore OS</b><br/>
   <i>"More Tokens. More Vibe."</i>
 </div>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescore/tracker",
-  "version": "0.0.4",
+  "version": "0.0.5",
   "description": "Codex CLI token usage tracker (macOS-first, notify-driven).",
   "license": "MIT",
   "publishConfig": {

package/src/cli.js

@@ -48,7 +48,7 @@ function printHelp() {
       '',
       'Notes:',
       '  - init installs a Codex notify hook and issues a device token (default: browser sign in/up).',
-      '  - optional: set VIBESCORE_DASHBOARD_URL (or --dashboard-url) to use a hosted /connect page.',
+      '  - optional: set VIBESCORE_DASHBOARD_URL (or --dashboard-url) to use a hosted landing page.',
       '  - sync parses ~/.codex/sessions/**/rollout-*.jsonl and uploads token_count deltas.',
       '  - --debug prints original backend errors when they are normalized.',
       ''

package/src/commands/status.js

@@ -24,6 +24,7 @@ async function cmdStatus(argv = []) {
   const notifySignalPath = path.join(trackerDir, 'notify.signal');
   const throttlePath = path.join(trackerDir, 'sync.throttle');
   const uploadThrottlePath = path.join(trackerDir, 'upload.throttle.json');
+  const autoRetryPath = path.join(trackerDir, 'auto.retry.json');
   const codexHome = process.env.CODEX_HOME || path.join(home, '.codex');
   const codexConfigPath = path.join(codexHome, 'config.toml');
 
@@ -31,6 +32,7 @@ async function cmdStatus(argv = []) {
   const cursors = await readJson(cursorsPath);
   const queueState = (await readJson(queueStatePath)) || { offset: 0 };
   const uploadThrottle = normalizeUploadState(await readJson(uploadThrottlePath));
+  const autoRetry = await readJson(autoRetryPath);
 
   const queueSize = await safeStatSize(queuePath);
   const pendingBytes = Math.max(0, queueSize - (queueState.offset || 0));
@@ -51,6 +53,12 @@ async function cmdStatus(argv = []) {
   const lastUploadError = uploadThrottle.lastError
     ? `${uploadThrottle.lastErrorAt || 'unknown'} ${uploadThrottle.lastError}`
     : null;
+  const autoRetryAt = parseEpochMsToIso(autoRetry?.retryAtMs || null);
+  const autoRetryLine = autoRetryAt
+    ? `- Auto retry after: ${autoRetryAt} (${autoRetry?.reason || 'scheduled'}, pending ${Number(
+        autoRetry?.pendingBytes || 0
+      )} bytes)`
+    : null;
 
   process.stdout.write(
     [
@@ -65,6 +73,7 @@ async function cmdStatus(argv = []) {
       `- Next upload after: ${nextUpload || 'never'}`,
       `- Backoff until: ${backoffUntil || 'never'}`,
       lastUploadError ? `- Last upload error: ${lastUploadError}` : null,
+      autoRetryLine,
       `- Codex notify: ${notifyConfigured ? JSON.stringify(codexNotify) : 'unset'}`,
       ''
     ]

package/src/commands/sync.js

@@ -1,6 +1,7 @@
 const os = require('node:os');
 const path = require('node:path');
 const fs = require('node:fs/promises');
+const cp = require('node:child_process');
 
 const { ensureDir, readJson, writeJson, openLock } = require('../lib/fs');
 const { listRolloutFiles, parseRolloutIncremental } = require('../lib/rollout');
@@ -39,6 +40,7 @@ async function cmdSync(argv) {
     const config = await readJson(configPath);
     const cursors = (await readJson(cursorsPath)) || { version: 1, files: {}, updatedAt: null };
     const uploadThrottle = normalizeUploadState(await readJson(uploadThrottlePath));
+    let uploadThrottleState = uploadThrottle;
 
     const codexHome = process.env.CODEX_HOME || path.join(home, '.codex');
     const sessionsDir = path.join(codexHome, 'sessions');
@@ -72,6 +74,7 @@ async function cmdSync(argv) {
     const baseUrl = config?.baseUrl || process.env.VIBESCORE_INSFORGE_BASE_URL || 'https://5tmappuk.us-east.insforge.app';
 
     let uploadResult = null;
+    let uploadAttempted = false;
     if (deviceToken) {
       const beforeState = (await readJson(queueStatePath)) || { offset: 0 };
       const queueSize = await safeStatSize(queuePath);
@@ -79,16 +82,27 @@ async function cmdSync(argv) {
       let maxBatches = opts.auto ? 3 : opts.drain ? 10_000 : 10;
       let batchSize = UPLOAD_DEFAULTS.batchSize;
       let allowUpload = pendingBytes > 0;
+      let autoDecision = null;
 
       if (opts.auto) {
-        const decision = decideAutoUpload({
+        autoDecision = decideAutoUpload({
           nowMs: Date.now(),
           pendingBytes,
           state: uploadThrottle
         });
-        allowUpload = allowUpload && decision.allowed;
-        maxBatches = decision.allowed ? decision.maxBatches : 0;
-        batchSize = decision.batchSize;
+        allowUpload = allowUpload && autoDecision.allowed;
+        maxBatches = autoDecision.allowed ? autoDecision.maxBatches : 0;
+        batchSize = autoDecision.batchSize;
+        if (!autoDecision.allowed && pendingBytes > 0 && autoDecision.blockedUntilMs > 0) {
+          const reason = deriveAutoSkipReason({ decision: autoDecision, state: uploadThrottle });
+          await scheduleAutoRetry({
+            trackerDir,
+            retryAtMs: autoDecision.blockedUntilMs,
+            reason,
+            pendingBytes,
+            source: 'auto-throttled'
+          });
+        }
       }
 
       if (progress?.enabled && pendingBytes > 0 && allowUpload) {
@@ -99,6 +113,7 @@ async function cmdSync(argv) {
       }
 
       if (allowUpload && maxBatches > 0) {
+        uploadAttempted = true;
         try {
           uploadResult = await drainQueueToCloud({
             baseUrl,
@@ -118,12 +133,26 @@ async function cmdSync(argv) {
             }
           });
           if (uploadResult.attempted > 0) {
-            const next = recordUploadSuccess({ nowMs: Date.now(), state: uploadThrottle });
+            const next = recordUploadSuccess({ nowMs: Date.now(), state: uploadThrottleState });
+            uploadThrottleState = next;
             await writeJson(uploadThrottlePath, next);
           }
         } catch (e) {
-          const next = recordUploadFailure({ nowMs: Date.now(), state: uploadThrottle, error: e });
+          const next = recordUploadFailure({ nowMs: Date.now(), state: uploadThrottleState, error: e });
+          uploadThrottleState = next;
           await writeJson(uploadThrottlePath, next);
+          if (opts.auto && pendingBytes > 0) {
+            const retryAtMs = Math.max(next.nextAllowedAtMs || 0, next.backoffUntilMs || 0);
+            if (retryAtMs > 0) {
+              await scheduleAutoRetry({
+                trackerDir,
+                retryAtMs,
+                reason: 'backoff',
+                pendingBytes,
+                source: 'auto-error'
+              });
+            }
+          }
           throw e;
         }
       } else {
@@ -137,6 +166,21 @@ async function cmdSync(argv) {
     const queueSize = await safeStatSize(queuePath);
     const pendingBytes = Math.max(0, queueSize - Number(afterState.offset || 0));
 
+    if (pendingBytes <= 0) {
+      await clearAutoRetry(trackerDir);
+    } else if (opts.auto && uploadAttempted) {
+      const retryAtMs = Number(uploadThrottleState?.nextAllowedAtMs || 0);
+      if (retryAtMs > Date.now()) {
+        await scheduleAutoRetry({
+          trackerDir,
+          retryAtMs,
+          reason: 'backlog',
+          pendingBytes,
+          source: 'auto-backlog'
+        });
+      }
+    }
+
     await maybeSendHeartbeat({
       baseUrl,
       deviceToken,
@@ -174,12 +218,14 @@ function parseArgs(argv) {
   const out = {
     auto: false,
     fromNotify: false,
+    fromRetry: false,
     drain: false
   };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
     if (a === '--auto') out.auto = true;
     else if (a === '--from-notify') out.fromNotify = true;
+    else if (a === '--from-retry') out.fromRetry = true;
     else if (a === '--drain') out.drain = true;
     else throw new Error(`Unknown option: ${a}`);
   }
@@ -219,5 +265,103 @@ async function maybeSendHeartbeat({ baseUrl, deviceToken, trackerDir, uploadResu
   }
 }
 
+function deriveAutoSkipReason({ decision, state }) {
+  if (!decision || decision.reason !== 'throttled') return decision?.reason || 'unknown';
+  const backoffUntilMs = Number(state?.backoffUntilMs || 0);
+  const nextAllowedAtMs = Number(state?.nextAllowedAtMs || 0);
+  if (backoffUntilMs > 0 && backoffUntilMs >= nextAllowedAtMs) return 'backoff';
+  return 'throttled';
+}
+
+async function scheduleAutoRetry({ trackerDir, retryAtMs, reason, pendingBytes, source }) {
+  const retryMs = coerceRetryMs(retryAtMs);
+  if (!retryMs) return { scheduled: false, retryAtMs: 0 };
+
+  const retryPath = path.join(trackerDir, AUTO_RETRY_FILENAME);
+  const nowMs = Date.now();
+  const existing = await readJson(retryPath);
+  const existingMs = coerceRetryMs(existing?.retryAtMs);
+  if (existingMs && existingMs >= retryMs - 1000) {
+    return { scheduled: false, retryAtMs: existingMs };
+  }
+
+  const payload = {
+    version: 1,
+    retryAtMs: retryMs,
+    retryAt: new Date(retryMs).toISOString(),
+    reason: typeof reason === 'string' && reason.length > 0 ? reason : 'throttled',
+    pendingBytes: Math.max(0, Number(pendingBytes || 0)),
+    scheduledAt: new Date(nowMs).toISOString(),
+    source: typeof source === 'string' ? source : 'auto'
+  };
+
+  await writeJson(retryPath, payload);
+
+  const delayMs = Math.min(AUTO_RETRY_MAX_DELAY_MS, Math.max(0, retryMs - nowMs));
+  if (delayMs <= 0) return { scheduled: false, retryAtMs: retryMs };
+  if (process.env.VIBESCORE_AUTO_RETRY_NO_SPAWN === '1') {
+    return { scheduled: false, retryAtMs: retryMs };
+  }
+
+  spawnAutoRetryProcess({
+    retryPath,
+    trackerBinPath: path.join(trackerDir, 'app', 'bin', 'tracker.js'),
+    fallbackPkg: '@vibescore/tracker',
+    delayMs
+  });
+  return { scheduled: true, retryAtMs: retryMs };
+}
+
+async function clearAutoRetry(trackerDir) {
+  const retryPath = path.join(trackerDir, AUTO_RETRY_FILENAME);
+  await fs.unlink(retryPath).catch(() => {});
+}
+
+function spawnAutoRetryProcess({ retryPath, trackerBinPath, fallbackPkg, delayMs }) {
+  const script = buildAutoRetryScript({ retryPath, trackerBinPath, fallbackPkg, delayMs });
+  try {
+    const child = cp.spawn(process.execPath, ['-e', script], {
+      detached: true,
+      stdio: 'ignore',
+      env: process.env
+    });
+    child.unref();
+  } catch (_e) {}
+}
+
+function buildAutoRetryScript({ retryPath, trackerBinPath, fallbackPkg, delayMs }) {
+  return `'use strict';\n` +
+    `const fs = require('node:fs');\n` +
+    `const cp = require('node:child_process');\n` +
+    `const retryPath = ${JSON.stringify(retryPath)};\n` +
+    `const trackerBinPath = ${JSON.stringify(trackerBinPath)};\n` +
+    `const fallbackPkg = ${JSON.stringify(fallbackPkg)};\n` +
+    `const delayMs = ${Math.max(0, Math.floor(delayMs || 0))};\n` +
+    `setTimeout(() => {\n` +
+    `  let retryAtMs = 0;\n` +
+    `  try {\n` +
+    `    const raw = fs.readFileSync(retryPath, 'utf8');\n` +
+    `    retryAtMs = Number(JSON.parse(raw).retryAtMs || 0);\n` +
+    `  } catch (_) {}\n` +
+    `  if (!retryAtMs || Date.now() + 1000 < retryAtMs) process.exit(0);\n` +
+    `  const argv = ['sync', '--auto', '--from-retry'];\n` +
+    `  const cmd = fs.existsSync(trackerBinPath)\n` +
+    `    ? [process.execPath, trackerBinPath, ...argv]\n` +
+    `    : ['npx', '--yes', fallbackPkg, ...argv];\n` +
+    `  try {\n` +
+    `    const child = cp.spawn(cmd[0], cmd.slice(1), { detached: true, stdio: 'ignore', env: process.env });\n` +
+    `    child.unref();\n` +
+    `  } catch (_) {}\n` +
+    `}, delayMs);\n`;
+}
+
+function coerceRetryMs(v) {
+  const n = Number(v);
+  if (!Number.isFinite(n) || n <= 0) return 0;
+  return Math.floor(n);
+}
+
 const HEARTBEAT_MIN_INTERVAL_MINUTES = 30;
 const HEARTBEAT_MIN_INTERVAL_MS = HEARTBEAT_MIN_INTERVAL_MINUTES * 60 * 1000;
+const AUTO_RETRY_FILENAME = 'auto.retry.json';
+const AUTO_RETRY_MAX_DELAY_MS = 2 * 60 * 60 * 1000;

package/src/lib/browser-auth.js

@@ -10,7 +10,7 @@ async function beginBrowserAuth({ baseUrl, dashboardUrl, timeoutMs, open }) {
 
   const { callbackUrl, waitForCallback } = await startLocalCallbackServer({ callbackPath, timeoutMs });
 
-  const authUrl = dashboardUrl ? new URL('/connect', dashboardUrl) : new URL('/auth/sign-up', baseUrl);
+  const authUrl = dashboardUrl ? new URL('/', dashboardUrl) : new URL('/auth/sign-up', baseUrl);
   authUrl.searchParams.set('redirect', callbackUrl);
   if (dashboardUrl && baseUrl && baseUrl !== DEFAULT_BASE_URL) authUrl.searchParams.set('base_url', baseUrl);
 

package/src/lib/diagnostics.js

@@ -18,12 +18,14 @@ async function collectTrackerDiagnostics({
   const notifySignalPath = path.join(trackerDir, 'notify.signal');
   const throttlePath = path.join(trackerDir, 'sync.throttle');
   const uploadThrottlePath = path.join(trackerDir, 'upload.throttle.json');
+  const autoRetryPath = path.join(trackerDir, 'auto.retry.json');
   const codexConfigPath = path.join(codexHome, 'config.toml');
 
   const config = await readJson(configPath);
   const cursors = await readJson(cursorsPath);
   const queueState = (await readJson(queueStatePath)) || { offset: 0 };
   const uploadThrottle = normalizeUploadState(await readJson(uploadThrottlePath));
+  const autoRetry = await readJson(autoRetryPath);
 
   const queueSize = await safeStatSize(queuePath);
   const offsetBytes = Number(queueState.offset || 0);
@@ -37,6 +39,7 @@ async function collectTrackerDiagnostics({
   const codexNotify = notifyConfigured ? codexNotifyRaw.map((v) => redactValue(v, home)) : null;
 
   const lastSuccessAt = uploadThrottle.lastSuccessMs ? new Date(uploadThrottle.lastSuccessMs).toISOString() : null;
+  const autoRetryAt = parseEpochMsToIso(autoRetry?.retryAtMs);
 
   return {
     ok: true,
@@ -84,7 +87,18 @@ async function collectTrackerDiagnostics({
             message: redactError(String(uploadThrottle.lastError), home)
           }
         : null
-    }
+    },
+    auto_retry: autoRetryAt
+      ? {
+          next_retry_at: autoRetryAt,
+          reason: typeof autoRetry?.reason === 'string' ? autoRetry.reason : null,
+          pending_bytes: Number.isFinite(Number(autoRetry?.pendingBytes))
+            ? Math.max(0, Number(autoRetry.pendingBytes))
+            : null,
+          scheduled_at: typeof autoRetry?.scheduledAt === 'string' ? autoRetry.scheduledAt : null,
+          source: typeof autoRetry?.source === 'string' ? autoRetry.source : null
+        }
+      : null
   };
 }
 
@@ -135,4 +149,3 @@ function parseEpochMsToIso(v) {
 }
 
 module.exports = { collectTrackerDiagnostics };
-