fix(telemetry): show disclosure on first proxy start for existing users

Existing users upgrading from pre-telemetry versions were getting events
sent without seeing the disclosure. Now showTelemetryDisclosureIfNeeded()
is called from every entry point: foreground start, daemon start, service
install, and setup wizard — idempotent, only prints once.

Author: VictorMinemu

package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-cc-router",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "description": "Round-robin proxy for Claude Max OAuth tokens — use multiple Claude Max accounts with Claude Code",
   "type": "module",
   "bin": {

src/cli/cmd-service.ts

@@ -6,6 +6,7 @@ import { fileURLToPath } from "url";
 import { join, dirname } from "path";
 import chalk from "chalk";
 import { detectPlatform } from "../utils/platform.js";
+import { showTelemetryDisclosureIfNeeded } from "../utils/telemetry.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -25,6 +26,10 @@ export function registerService(program: Command): void {
     .action(async () => {
       console.log(chalk.cyan("\nInstalling cc-router as a system service...\n"));
 
+      // Show telemetry disclosure once before the service takes over — after
+      // this point output goes to PM2 logs, not the user's terminal.
+      showTelemetryDisclosureIfNeeded();
+
       // 1. Verify PM2 is installed
       const pm2Version = await getPm2Version();
       if (!pm2Version) {

src/cli/cmd-setup.ts

@@ -28,8 +28,7 @@ import {
   openNetworkExtensionSettings,
 } from "../interceptor/mitmproxy-manager.js";
 import { printDesktopSupportExplainer, printNetworkExtensionInstructions } from "./cmd-client.js";
-import { loadTelemetryState, writeTelemetryState } from "../config/telemetry.js";
-import { trackEvent } from "../utils/telemetry.js";
+import { trackEvent, showTelemetryDisclosureIfNeeded } from "../utils/telemetry.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -261,32 +260,6 @@ async function runSetupWizard({ addMode }: { addMode: boolean }): Promise<void>
   await runPostSetupFlow(merged.length);
 }
 
-// Anonymous telemetry disclosure, shown exactly once after a successful setup.
-// Controlled by telemetry.disclosureShown in ~/.cc-router/telemetry.json.
-function showTelemetryDisclosureIfNeeded(): void {
-  try {
-    const state = loadTelemetryState();
-    if (state.disclosureShown) return;
-    console.log();
-    console.log(chalk.dim("─".repeat(60)));
-    console.log(chalk.bold("  Anonymous usage analytics"));
-    console.log();
-    console.log("  CC-Router sends anonymous lifecycle events (version, OS,");
-    console.log("  startup, heartbeat) to help us understand usage and prioritize");
-    console.log("  improvements. No IPs, no tokens, no prompts, no request content.");
-    console.log();
-    console.log(`  Disable:    ${chalk.cyan("cc-router telemetry off")}`);
-    console.log(`  Or set:     ${chalk.cyan("DO_NOT_TRACK=1")}   |   ${chalk.cyan("CC_ROUTER_TELEMETRY=0")}`);
-    console.log(`  Source:     ${chalk.dim("src/utils/telemetry.ts")}`);
-    console.log(chalk.dim("─".repeat(60)));
-    console.log();
-    state.disclosureShown = true;
-    writeTelemetryState(state);
-  } catch {
-    // never block setup on telemetry errors
-  }
-}
-
 // ─── Post-setup interactive flow ─────────────────────────────────────────────
 
 async function runPostSetupFlow(accountCount: number): Promise<void> {

src/cli/cmd-start.ts

@@ -3,6 +3,7 @@ import { execFile } from "child_process";
 import { promisify } from "util";
 import chalk from "chalk";
 import { PROXY_PORT, LITELLM_PORT, ACCOUNTS_PATH } from "../config/paths.js";
+import { showTelemetryDisclosureIfNeeded } from "../utils/telemetry.js";
 
 const execFileAsync = promisify(execFile);
 
@@ -16,6 +17,9 @@ export function registerStart(program: Command): void {
     .option("--accounts <path>", "Path to accounts.json", ACCOUNTS_PATH)
     .action(async (opts: { port: string; daemon?: boolean; litellm?: string | boolean; accounts: string }) => {
       if (opts.daemon) {
+        // Show telemetry disclosure in the user's terminal before handing off
+        // to PM2 — once the daemon starts, its stdout goes to PM2 logs.
+        showTelemetryDisclosureIfNeeded();
         await startDaemon();
         return;
       }

src/proxy/server.ts

@@ -9,7 +9,7 @@ import { TokenPool } from "./token-pool.js";
 import { needsRefresh, refreshAccountToken, saveAccounts, startRefreshLoop } from "./token-refresher.js";
 import { loadAccounts, accountsFileExists, readAccountsFromPath, readConfig } from "../config/manager.js";
 import { checkForUpdate, performUpdate, restartSelf } from "../utils/self-update.js";
-import { trackEvent, startHeartbeat } from "../utils/telemetry.js";
+import { trackEvent, startHeartbeat, showTelemetryDisclosureIfNeeded } from "../utils/telemetry.js";
 import { loadTelemetryState } from "../config/telemetry.js";
 import { logRoute, logError, logStartup } from "./logger.js";
 import { stats } from "./stats.js";
@@ -447,8 +447,11 @@ export async function startServer(opts: ServerOptions = {}): Promise<void> {
     logStartup(port, host, mode, target, accounts.length);
     if (autoUpdate) console.log(chalk.gray("  Auto-update: enabled (patch/minor)"));
 
-    // Anonymous telemetry — fire-and-forget, never blocks proxy startup
+    // Anonymous telemetry — fire-and-forget, never blocks proxy startup.
+    // Show the disclosure on the very first start (covers existing users
+    // upgrading from versions before telemetry existed) before sending anything.
     try {
+      showTelemetryDisclosureIfNeeded();
       const telemetryState = loadTelemetryState();
       // First-run detection: if the install is brand new, emit app_started too
       const firstRunAge = Date.now() - new Date(telemetryState.firstRunAt).getTime();

src/utils/telemetry.ts

@@ -1,5 +1,6 @@
 import os from "os";
-import { isTelemetryEnabled, loadTelemetryState } from "../config/telemetry.js";
+import chalk from "chalk";
+import { isTelemetryEnabled, loadTelemetryState, writeTelemetryState } from "../config/telemetry.js";
 import { detectPlatform } from "./platform.js";
 import { getCurrentVersion } from "./self-update.js";
 
@@ -107,3 +108,32 @@ export function startHeartbeat(accountCount: number): void {
   }, 6 * 60 * 60 * 1000);
   timer.unref();
 }
+
+// One-time disclosure shown the very first time CC-Router runs after install
+// or upgrade. Idempotent — gated by telemetry.disclosureShown so it's safe to
+// call from multiple entry points (setup wizard, foreground start, daemon
+// start, service install). Returns true if the disclosure was just shown.
+export function showTelemetryDisclosureIfNeeded(): boolean {
+  try {
+    const state = loadTelemetryState();
+    if (state.disclosureShown) return false;
+    console.log();
+    console.log(chalk.dim("─".repeat(60)));
+    console.log(chalk.bold("  Anonymous usage analytics"));
+    console.log();
+    console.log("  CC-Router sends anonymous lifecycle events (version, OS,");
+    console.log("  startup, heartbeat) to help us understand usage and prioritize");
+    console.log("  improvements. No IPs, no tokens, no prompts, no request content.");
+    console.log();
+    console.log(`  Disable:    ${chalk.cyan("cc-router telemetry off")}`);
+    console.log(`  Or set:     ${chalk.cyan("DO_NOT_TRACK=1")}   |   ${chalk.cyan("CC_ROUTER_TELEMETRY=0")}`);
+    console.log(`  Source:     ${chalk.dim("src/utils/telemetry.ts")}`);
+    console.log(chalk.dim("─".repeat(60)));
+    console.log();
+    state.disclosureShown = true;
+    writeTelemetryState(state);
+    return true;
+  } catch {
+    return false;
+  }
+}