ai-cc-router 0.2.5 → 0.2.6

package/dist/cli/cmd-service.js

@@ -4,6 +4,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);
 // Resolve the path to the compiled CLI entry point
 const __filename = fileURLToPath(import.meta.url);
@@ -18,6 +19,9 @@ export function registerService(program) {
         .description("Register cc-router to start automatically on system boot")
         .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) {

package/dist/cli/cmd-setup.js

@@ -13,8 +13,7 @@ import { DEFAULT_RATE_LIMITS } from "../proxy/types.js";
 import { existsSync } from "fs";
 import { checkMitmproxyInstalled, isCaCertInstalled, generateCaCert, installCaCert, writeAddonScript, getNetworkExtensionStatus, 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);
 // ─── Public registration ──────────────────────────────────────────────────────
 export function registerSetup(program) {
@@ -219,33 +218,6 @@ async function runSetupWizard({ addMode }) {
     // ─── Post-setup interactive flow ─────────────────────────────────────────
     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() {
-    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) {
     console.log(chalk.bold(`\n${"━".repeat(40)}\n  Configure this machine\n${"━".repeat(40)}\n`));

package/dist/cli/cmd-start.js

@@ -2,6 +2,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);
 export function registerStart(program) {
     program
@@ -13,6 +14,9 @@ export function registerStart(program) {
         .option("--accounts <path>", "Path to accounts.json", ACCOUNTS_PATH)
         .action(async (opts) => {
         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;
         }

package/dist/proxy/server.js

@@ -6,7 +6,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";
@@ -385,8 +385,11 @@ export async function startServer(opts = {}) {
         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();

package/dist/utils/telemetry.js

@@ -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";
 // ─── Aptabase configuration ──────────────────────────────────────────────────
@@ -84,3 +85,33 @@ export function startHeartbeat(accountCount) {
     }, 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() {
+    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;
+    }
+}

package/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": {