ccjk 13.4.0 → 13.5.1

package/dist/chunks/ccjk-all.mjs

@@ -1,6 +1,6 @@
 import a from './index2.mjs';
 import { c as consola, a as analyzeProject } from '../shared/ccjk.DypYla6I.mjs';
-import { c as createCompleteCloudClient } from '../shared/ccjk.BNVSnyu0.mjs';
+import { c as createCompleteCloudClient } from '../shared/ccjk.C3YuTovw.mjs';
 import { i18n, ensureI18nInitialized } from './index5.mjs';
 import { createHash } from 'node:crypto';
 import { promises, readFileSync } from 'node:fs';

package/dist/chunks/codex.mjs

@@ -7,11 +7,11 @@ import ora from './index7.mjs';
 import { a as semver } from '../shared/ccjk.CxpGa6MC.mjs';
 import { p as parse } from '../shared/ccjk.BBtCGd_g.mjs';
 import { x as K } from './main.mjs';
-import { CODEX_AUTH_FILE, SUPPORTED_LANGS, CODEX_DIR, CODEX_AGENTS_FILE, CODEX_PROMPTS_DIR, CODEX_CONFIG_FILE, AI_OUTPUT_LANGUAGES, ZCF_CONFIG_FILE } from './constants.mjs';
+import { CODEX_AUTH_FILE, SUPPORTED_LANGS, CODEX_CONFIG_FILE, CODEX_DIR, CODEX_AGENTS_FILE, CODEX_PROMPTS_DIR, AI_OUTPUT_LANGUAGES, ZCF_CONFIG_FILE } from './constants.mjs';
 import { ensureI18nInitialized, i18n, format } from './index5.mjs';
 import { updateZcfConfig, readZcfConfig, readDefaultTomlConfig, updateTomlConfig } from './ccjk-config.mjs';
 import { e as applyAiLanguageDirective } from './config2.mjs';
-import { exists, readFile, ensureDir, writeFileAtomic, writeFile, copyFile, copyDir } from './fs-operations.mjs';
+import { exists, readFile, ensureDir, writeFileAtomic, writeFile, copyDir, copyFile } from './fs-operations.mjs';
 import { readJsonConfig, writeJsonConfig } from './json-config.mjs';
 import { i as isWindows, m as getMcpCommand, l as getSystemRoot, w as wrapCommandWithSudo, n as normalizeTomlPath } from './platform.mjs';
 import { a as addNumbersToChoices } from '../shared/ccjk.BFQ7yr5S.mjs';
@@ -809,10 +809,13 @@ function writeCodexConfig(data) {
   ensureDir(CODEX_DIR);
   writeFileAtomic(CODEX_CONFIG_FILE, renderCodexConfig(data));
 }
-function writeAuthFile(newEntries) {
+function writeAuthFile(newEntries, authMode) {
   ensureDir(CODEX_DIR);
   const existing = readJsonConfig(CODEX_AUTH_FILE, { defaultValue: {} }) || {};
   const merged = { ...existing, ...newEntries };
+  if (authMode) {
+    merged.auth_mode = authMode;
+  }
   writeJsonConfig(CODEX_AUTH_FILE, merged, { pretty: true });
 }
 async function isCodexInstalled() {
@@ -1177,7 +1180,7 @@ async function applyCustomApiConfig(customApiConfig) {
     otherConfig: existingConfig?.otherConfig || []
   };
   writeCodexConfig(configData);
-  writeJsonConfig(CODEX_AUTH_FILE, authEntries);
+  writeJsonConfig(CODEX_AUTH_FILE, { ...authEntries, auth_mode: "apikey" });
   updateZcfConfig({ codeToolType: "codex" });
   console.log(a.green(`\u2714 ${i18n.t("codex:apiConfigured")}`));
 }
@@ -1385,7 +1388,8 @@ async function configureCodexApi(options) {
       baseUrl: selectedProvider2 === "custom" ? answers.baseUrl : prefilledBaseUrl,
       wireApi: selectedProvider2 === "custom" ? answers.wireApi || "responses" : prefilledWireApi,
       tempEnvKey,
-      requiresOpenaiAuth: true,
+      requiresOpenaiAuth: false,
+      // Custom/third-party providers use their own API key, not OpenAI OAuth
       model: customModel || prefilledModel || "gpt-5-codex"
       // Use custom model, provider's default model, or fallback
     };
@@ -1423,7 +1427,7 @@ async function configureCodexApi(options) {
     mcpServices: existingConfig?.mcpServices || [],
     otherConfig: existingConfig?.otherConfig || []
   });
-  writeAuthFile(authEntries);
+  writeAuthFile(authEntries, "apikey");
   updateZcfConfig({ codeToolType: "codex" });
   console.log(a.green(i18n.t("codex:apiConfigured")));
 }
@@ -1654,6 +1658,7 @@ async function switchToOfficialLogin() {
     writeCodexConfig(updatedConfig);
     const auth = readJsonConfig(CODEX_AUTH_FILE, { defaultValue: {} }) || {};
     auth.OPENAI_API_KEY = null;
+    auth.auth_mode = "chatgpt";
     writeJsonConfig(CODEX_AUTH_FILE, auth, { pretty: true });
     console.log(a.green(i18n.t("codex:officialConfigured")));
     return true;
@@ -1699,6 +1704,7 @@ async function switchToProvider(providerId) {
     const auth = readJsonConfig(CODEX_AUTH_FILE, { defaultValue: {} }) || {};
     const envValue = auth[provider.tempEnvKey] || null;
     auth.OPENAI_API_KEY = envValue;
+    auth.auth_mode = "apikey";
     writeJsonConfig(CODEX_AUTH_FILE, auth, { pretty: true });
     console.log(a.green(i18n.t("codex:providerSwitchSuccess", { provider: providerId })));
     return true;

package/dist/chunks/menu.mjs

@@ -417,7 +417,13 @@ async function handleHierarchicalMenu() {
       break;
     }
     case "5": {
-      await configureApiFeature();
+      const currentCodeTool = getCurrentCodeTool();
+      if (currentCodeTool === "codex") {
+        const { configureCodexApi } = await import('./codex.mjs').then(function (n) { return n.i; });
+        await configureCodexApi();
+      } else {
+        await configureApiFeature();
+      }
       break;
     }
     case "6": {
@@ -515,7 +521,13 @@ async function showSimplifiedMenu() {
       break;
     }
     case "3": {
-      await configureApiFeature();
+      const currentCodeTool = getCurrentCodeTool();
+      if (currentCodeTool === "codex") {
+        const { configureCodexApi } = await import('./codex.mjs').then(function (n) { return n.i; });
+        await configureCodexApi();
+      } else {
+        await configureApiFeature();
+      }
       break;
     }
     case "4": {

package/dist/chunks/package.mjs

@@ -1,3 +1,3 @@
-const version = "13.4.0";
+const version = "13.5.1";
 
 export { version };

package/dist/i18n/locales/en/codex.json

@@ -121,6 +121,23 @@
   "providerManager.wireApiInvalid": "Wire API must be either \"responses\" or \"chat\"",
   "providerManager.unknownError": "Unknown error",
   "envKeyMigrationComplete": "✔ env_key to temp_env_key migration completed",
+  "presetPrompt": "Select a Codex preset bundle",
+  "presetApplied": "✔ Codex preset applied: {{preset}}",
+  "presetSummary": "Workflows {{workflows}} · MCP {{services}}",
+  "presets": {
+    "minimal": {
+      "name": "Minimal",
+      "description": "Lean workflow bundle with search and docs MCP"
+    },
+    "dev": {
+      "name": "Dev",
+      "description": "Balanced workflow bundle with search, docs, and repo context"
+    },
+    "full": {
+      "name": "Full",
+      "description": "Expanded workflow bundle with deeper repo assistance"
+    }
+  },
   "errorSwitchingProvider": "Error switching provider: {{error}}",
   "errorSwitchingToOfficialLogin": "Error switching to official login: {{error}}",
   "errorDuringUninstall": "Error during uninstall: {{error}}"

package/dist/i18n/locales/en/menu.json

@@ -43,6 +43,8 @@
     "changeLanguage": "Change Language / 切换语言",
     "switchCodeTool": "Switch Code Tool",
     "uninstall": "Uninstall CCJK",
+    "codexImportWorkflow": "Import Workflows",
+    "codexPreset": "Preset Bundle",
     "mcpMarket": "MCP Market",
     "marketplace": "Marketplace",
     "hooksSync": "Hooks Sync",
@@ -56,6 +58,8 @@
     "changeLanguage": "Switch interface language",
     "switchCodeTool": "Switch between different code tools",
     "uninstall": "Uninstall CCJK and related configurations",
+    "codexImportWorkflow": "Install Codex prompt workflows and AGENTS templates",
+    "codexPreset": "Apply a ready-made Codex capability bundle for workflows and MCP services",
     "mcpMarket": "Browse and install MCP services",
     "marketplace": "Browse and install extension packages",
     "hooksSync": "Sync Git Hooks configuration",
@@ -65,6 +69,29 @@
     "outputStyles": "Configure output styles",
     "doctor": "Run environment health check"
   },
+  "toolMode": {
+    "claude": {
+      "title": "Claude Workspace",
+      "summary": "Full CCJK surface with diagnostics, cloud sync, and extensions.",
+      "focus": "Workflows, diagnostics, permissions, and cloud-connected tools.",
+      "config": "Primary config: ~/.claude/settings.json",
+      "menuTitle": "Claude Control Center"
+    },
+    "codex": {
+      "title": "Codex Workspace",
+      "summary": "Lean setup focused on provider wiring, prompts, MCP, and memory.",
+      "focus": "API provider, MCP services, default model, and AGENTS-based memory.",
+      "config": "Primary config: ~/.codex/config.toml",
+      "menuTitle": "Codex Control Center"
+    },
+    "generic": {
+      "title": "Tool Workspace",
+      "summary": "CCJK adapts the menu to the active coding tool.",
+      "focus": "Core setup, configuration, and tool-specific actions.",
+      "config": "Using the active tool configuration profile.",
+      "menuTitle": "CCJK Control Center"
+    }
+  },
   "menu": {
     "title": "CCJK Main Menu",
     "breadcrumb": {
@@ -194,4 +221,4 @@
     "exit": "0. 🚪 Exit"
   },
   "memoryManagement": "M. Memory Management"
-}
+}

package/dist/i18n/locales/zh-CN/codex.json

@@ -121,6 +121,23 @@
   "providerManager.wireApiInvalid": "Wire API 必须是 \"responses\" 或 \"chat\"",
   "providerManager.unknownError": "未知错误",
   "envKeyMigrationComplete": "✔ 已完成 env_key 到 temp_env_key 的迁移",
+  "presetPrompt": "选择一个 Codex 预设套装",
+  "presetApplied": "✔ 已应用 Codex 预设：{{preset}}",
+  "presetSummary": "工作流 {{workflows}} · MCP {{services}}",
+  "presets": {
+    "minimal": {
+      "name": "Minimal",
+      "description": "轻量工作流套装，包含搜索与文档 MCP"
+    },
+    "dev": {
+      "name": "Dev",
+      "description": "均衡开发工作流套装，包含搜索、文档与仓库上下文能力"
+    },
+    "full": {
+      "name": "Full",
+      "description": "增强型工作流套装，提供更完整的仓库辅助能力"
+    }
+  },
   "errorSwitchingProvider": "切换提供商时出错：{{error}}",
   "errorSwitchingToOfficialLogin": "切换到官方登录时出错：{{error}}",
   "errorDuringUninstall": "卸载过程中出错：{{error}}"

package/dist/i18n/locales/zh-CN/menu.json

@@ -43,6 +43,8 @@
     "changeLanguage": "切换语言 / Change Language",
     "switchCodeTool": "切换代码工具",
     "uninstall": "卸载 CCJK",
+    "codexImportWorkflow": "导入工作流",
+    "codexPreset": "预设套装",
     "mcpMarket": "MCP 市场",
     "marketplace": "扩展市场",
     "hooksSync": "Hooks 同步",
@@ -56,6 +58,8 @@
     "changeLanguage": "切换界面语言",
     "switchCodeTool": "在不同代码工具之间切换",
     "uninstall": "卸载 CCJK 及相关配置",
+    "codexImportWorkflow": "安装 Codex Prompt 工作流与 AGENTS 模板",
+    "codexPreset": "一键套用 Codex 能力套装，仅增强工作流与 MCP 服务",
     "mcpMarket": "浏览和安装 MCP 服务",
     "marketplace": "浏览和安装扩展包",
     "hooksSync": "同步 Git Hooks 配置",
@@ -65,6 +69,29 @@
     "outputStyles": "配置输出样式",
     "doctor": "运行环境健康检查"
   },
+  "toolMode": {
+    "claude": {
+      "title": "Claude 工作台",
+      "summary": "完整 CCJK 界面，包含诊断、云功能与扩展能力。",
+      "focus": "工作流、诊断、权限配置与云端集成功能。",
+      "config": "主配置文件：~/.claude/settings.json",
+      "menuTitle": "Claude 控制中心"
+    },
+    "codex": {
+      "title": "Codex 工作台",
+      "summary": "精简界面，聚焦 Provider 接线、Prompts、MCP 与记忆配置。",
+      "focus": "API Provider、MCP 服务、默认模型与 AGENTS 记忆。",
+      "config": "主配置文件：~/.codex/config.toml",
+      "menuTitle": "Codex 控制中心"
+    },
+    "generic": {
+      "title": "工具工作台",
+      "summary": "CCJK 会根据当前代码工具自动调整菜单界面。",
+      "focus": "核心初始化、配置管理与工具专属操作。",
+      "config": "使用当前激活工具的配置档案。",
+      "menuTitle": "CCJK 控制中心"
+    }
+  },
   "menu": {
     "title": "CCJK 主菜单",
     "breadcrumb": {
@@ -194,4 +221,4 @@
     "exit": "0. 🚪 退出"
   },
   "memoryManagement": "M. Memory 管理"
-}
+}

package/dist/index.d.mts

@@ -579,7 +579,7 @@ interface BatchTemplateResponse$1 {
 /**
  * Usage metric type
  */
-type MetricType = 'template_download' | 'recommendation_shown' | 'recommendation_accepted' | 'analysis_completed' | 'error_occurred';
+type MetricType = 'template_download' | 'recommendation_shown' | 'recommendation_accepted' | 'analysis_completed' | 'error_occurred' | 'command_run' | (string & {});
 /**
  * Usage report payload
  */
@@ -596,6 +596,10 @@ interface UsageReport {
     nodeVersion: string;
     /** Operating system */
     platform: string;
+    /** Stable device identifier */
+    deviceId?: string;
+    /** Client version reported to analytics endpoints */
+    clientVersion?: string;
     /** Project language if applicable */
     language?: string;
     /** Additional context data - use TelemetryEventData from dto.ts for strict typing */
@@ -679,10 +683,22 @@ interface CloudClientConfig {
     maxRetries?: number;
     /** Enable telemetry reporting */
     enableTelemetry?: boolean;
+    /** Enable client usage analytics endpoints */
+    enableUsageAnalytics?: boolean;
     /** API key if required */
     apiKey?: string;
     /** Language for API responses */
     language?: string;
+    /** Stable device token for analytics/auth headers */
+    deviceToken?: string;
+    /** Stable device ID for usage analytics dedupe */
+    deviceId?: string;
+    /** Stable anonymous installation/user ID */
+    anonymousUserId?: string;
+    /** Override analytics platform label */
+    platform?: string;
+    /** Automatically send startup handshake on initialization */
+    autoHandshake?: boolean;
 }
 /**
  * Cache entry metadata
@@ -723,6 +739,43 @@ interface TelemetryConfig {
     /** Anonymous user ID */
     userId?: string;
 }
+interface ClientIdentity {
+    deviceId: string;
+    anonymousUserId: string;
+    clientVersion: string;
+    platform: string;
+    deviceToken?: string;
+}
+interface DeviceRegistrationRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface DeviceRegistrationResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
+interface HandshakeRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface HandshakeResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
+interface SyncRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface SyncResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
 
 /**
  * Cloud Client Implementation
@@ -739,7 +792,14 @@ interface TelemetryConfig {
 declare class CloudClient {
     private fetch;
     private config;
+    private identity;
     constructor(config: CloudClientConfig);
+    private getDefaultHeaders;
+    private resolveIdentity;
+    private loadOrCreateStoredIdentity;
+    private buildAnalyticsPayload;
+    private canSendUsageAnalytics;
+    getIdentity(): ClientIdentity;
     /**
      * Calculate retry delay with exponential backoff
      */
@@ -812,6 +872,9 @@ declare class CloudClient {
      * Get current configuration
      */
     getConfig(): CloudClientConfig;
+    registerDevice(payload?: Partial<DeviceRegistrationRequest>): Promise<DeviceRegistrationResponse>;
+    handshake(payload?: Partial<HandshakeRequest>): Promise<HandshakeResponse>;
+    syncClientUsage(payload?: Partial<SyncRequest>): Promise<SyncResponse>;
 }
 /**
  * Create a default cloud client instance
@@ -2595,6 +2658,9 @@ declare class FallbackCloudClient {
      * Report usage (no fallback)
      */
     reportUsage(report: UsageReport): Promise<UsageReportResponse>;
+    registerDevice(payload?: Partial<DeviceRegistrationRequest>): Promise<DeviceRegistrationResponse>;
+    handshake(payload?: Partial<HandshakeRequest>): Promise<HandshakeResponse>;
+    syncClientUsage(payload?: Partial<SyncRequest>): Promise<SyncResponse>;
     /**
      * Health check (no fallback)
      */

package/dist/index.d.ts

@@ -579,7 +579,7 @@ interface BatchTemplateResponse$1 {
 /**
  * Usage metric type
  */
-type MetricType = 'template_download' | 'recommendation_shown' | 'recommendation_accepted' | 'analysis_completed' | 'error_occurred';
+type MetricType = 'template_download' | 'recommendation_shown' | 'recommendation_accepted' | 'analysis_completed' | 'error_occurred' | 'command_run' | (string & {});
 /**
  * Usage report payload
  */
@@ -596,6 +596,10 @@ interface UsageReport {
     nodeVersion: string;
     /** Operating system */
     platform: string;
+    /** Stable device identifier */
+    deviceId?: string;
+    /** Client version reported to analytics endpoints */
+    clientVersion?: string;
     /** Project language if applicable */
     language?: string;
     /** Additional context data - use TelemetryEventData from dto.ts for strict typing */
@@ -679,10 +683,22 @@ interface CloudClientConfig {
     maxRetries?: number;
     /** Enable telemetry reporting */
     enableTelemetry?: boolean;
+    /** Enable client usage analytics endpoints */
+    enableUsageAnalytics?: boolean;
     /** API key if required */
     apiKey?: string;
     /** Language for API responses */
     language?: string;
+    /** Stable device token for analytics/auth headers */
+    deviceToken?: string;
+    /** Stable device ID for usage analytics dedupe */
+    deviceId?: string;
+    /** Stable anonymous installation/user ID */
+    anonymousUserId?: string;
+    /** Override analytics platform label */
+    platform?: string;
+    /** Automatically send startup handshake on initialization */
+    autoHandshake?: boolean;
 }
 /**
  * Cache entry metadata
@@ -723,6 +739,43 @@ interface TelemetryConfig {
     /** Anonymous user ID */
     userId?: string;
 }
+interface ClientIdentity {
+    deviceId: string;
+    anonymousUserId: string;
+    clientVersion: string;
+    platform: string;
+    deviceToken?: string;
+}
+interface DeviceRegistrationRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface DeviceRegistrationResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
+interface HandshakeRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface HandshakeResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
+interface SyncRequest {
+    deviceId: string;
+    platform: string;
+    clientVersion: string;
+}
+interface SyncResponse {
+    success: boolean;
+    requestId?: string;
+    message?: string;
+}
 
 /**
  * Cloud Client Implementation
@@ -739,7 +792,14 @@ interface TelemetryConfig {
 declare class CloudClient {
     private fetch;
     private config;
+    private identity;
     constructor(config: CloudClientConfig);
+    private getDefaultHeaders;
+    private resolveIdentity;
+    private loadOrCreateStoredIdentity;
+    private buildAnalyticsPayload;
+    private canSendUsageAnalytics;
+    getIdentity(): ClientIdentity;
     /**
      * Calculate retry delay with exponential backoff
      */
@@ -812,6 +872,9 @@ declare class CloudClient {
      * Get current configuration
      */
     getConfig(): CloudClientConfig;
+    registerDevice(payload?: Partial<DeviceRegistrationRequest>): Promise<DeviceRegistrationResponse>;
+    handshake(payload?: Partial<HandshakeRequest>): Promise<HandshakeResponse>;
+    syncClientUsage(payload?: Partial<SyncRequest>): Promise<SyncResponse>;
 }
 /**
  * Create a default cloud client instance
@@ -2595,6 +2658,9 @@ declare class FallbackCloudClient {
      * Report usage (no fallback)
      */
     reportUsage(report: UsageReport): Promise<UsageReportResponse>;
+    registerDevice(payload?: Partial<DeviceRegistrationRequest>): Promise<DeviceRegistrationResponse>;
+    handshake(payload?: Partial<HandshakeRequest>): Promise<HandshakeResponse>;
+    syncClientUsage(payload?: Partial<SyncRequest>): Promise<SyncResponse>;
     /**
      * Health check (no fallback)
      */

package/dist/index.mjs

@@ -1,6 +1,6 @@
 export { P as ProjectAnalyzer, T as TemplatesClient, d as analyzeDependencies, a as analyzeProject, h as batchAnalyze, b as createTemplatesClient, e as detectProject, f as detectProjectType, g as getTemplatesClient } from './shared/ccjk.DypYla6I.mjs';
-import { a as createCloudClient } from './shared/ccjk.BNVSnyu0.mjs';
-export { C as CachedCloudClient, b as CloudCache, d as CloudClient, F as FallbackCloudClient, R as RetryableCloudClient, T as TelemetryReporter, c as createCompleteCloudClient, g as getTelemetry, i as initializeTelemetry, r as retryUtils, s as stopTelemetry, t as telemetryUtils, e as trackEvent, w as withRetry } from './shared/ccjk.BNVSnyu0.mjs';
+import { a as createCloudClient } from './shared/ccjk.C3YuTovw.mjs';
+export { C as CachedCloudClient, b as CloudCache, d as CloudClient, F as FallbackCloudClient, R as RetryableCloudClient, T as TelemetryReporter, c as createCompleteCloudClient, g as getTelemetry, i as initializeTelemetry, r as retryUtils, s as stopTelemetry, t as telemetryUtils, e as trackEvent, w as withRetry } from './shared/ccjk.C3YuTovw.mjs';
 import { CLOUD_ENDPOINTS } from './chunks/constants.mjs';
 export { C as CloudError, a as CloudErrorCode, b as CloudErrorFactory, f as formatErrorForLogging, g as getRetryDelay, h as handleCloudError, i as isAuthError, c as isRateLimitError, d as isRetryableError, e as isRetryableErrorCode } from './shared/ccjk.D8ZLYSZZ.mjs';
 import { e as extractString } from './shared/ccjk.C2jHOZVP.mjs';
@@ -270,15 +270,8 @@ function validateUsageReport(report) {
   const errors = [];
   if (!report.reportId || typeof report.reportId !== "string")
     errors.push("reportId is required and must be a string");
-  const validMetricTypes = [
-    "template_download",
-    "recommendation_shown",
-    "recommendation_accepted",
-    "analysis_completed",
-    "error_occurred"
-  ];
-  if (!validMetricTypes.includes(report.metricType))
-    errors.push(`metricType must be one of: ${validMetricTypes.join(", ")}`);
+  if (!report.metricType || typeof report.metricType !== "string")
+    errors.push("metricType is required and must be a string");
   if (!report.timestamp || typeof report.timestamp !== "string")
     errors.push("timestamp is required and must be a string");
   if (!report.ccjkVersion || typeof report.ccjkVersion !== "string")
@@ -287,6 +280,10 @@ function validateUsageReport(report) {
     errors.push("nodeVersion is required and must be a string");
   if (!report.platform || typeof report.platform !== "string")
     errors.push("platform is required and must be a string");
+  if (report.deviceId !== void 0 && typeof report.deviceId !== "string")
+    errors.push("deviceId must be a string when provided");
+  if (report.clientVersion !== void 0 && typeof report.clientVersion !== "string")
+    errors.push("clientVersion must be a string when provided");
   return {
     valid: errors.length === 0,
     errors

package/dist/shared/{ccjk.BNVSnyu0.mjs → ccjk.C3YuTovw.mjs}

@@ -1,9 +1,10 @@
 import { c as consola, o as ofetch } from './ccjk.DypYla6I.mjs';
-import fs__default, { readFileSync } from 'node:fs';
-import path__default, { dirname, join } from 'node:path';
+import fs__default, { existsSync, readFileSync, mkdirSync, writeFileSync } from 'node:fs';
+import path__default, { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
 import { fileURLToPath } from 'node:url';
-import { CLOUD_ENDPOINTS } from '../chunks/constants.mjs';
 import { randomUUID } from 'node:crypto';
+import { CLOUD_ENDPOINTS } from '../chunks/constants.mjs';
 
 const defaults = Object.freeze({
   ignoreUnknown: false,
@@ -926,28 +927,96 @@ try {
 }
 const API_PREFIX = "/api/v1";
 const HEALTH_PATH = `${API_PREFIX}/health`;
+const CLIENT_USAGE_STATE_DIR = join(homedir(), ".ccjk");
+const CLIENT_USAGE_STATE_FILE = join(CLIENT_USAGE_STATE_DIR, "cloud-client-identity.json");
 class CloudClient {
   fetch;
   config;
+  identity;
   constructor(config) {
     this.config = {
       timeout: 1e4,
       enableRetry: true,
       maxRetries: 3,
       enableTelemetry: true,
+      enableUsageAnalytics: true,
+      autoHandshake: true,
       ...config
     };
+    this.identity = this.resolveIdentity();
     this.fetch = ofetch.create({
       baseURL: this.config.baseURL,
       timeout: this.config.timeout,
-      headers: {
-        "User-Agent": `CCJK/${this.config.version || CCJK_VERSION}`,
-        ...this.config.apiKey && { Authorization: `Bearer ${this.config.apiKey}` }
-      },
+      headers: this.getDefaultHeaders(),
       retry: this.config.enableRetry ? this.config.maxRetries : 0,
       retryDelay: (context) => this.calculateRetryDelay(context.options.retry || 0)
     });
   }
+  getDefaultHeaders() {
+    const headers = {
+      "User-Agent": `CCJK/${this.identity.clientVersion}`,
+      "X-CCJK-Version": this.identity.clientVersion,
+      "X-Anonymous-User-Id": this.identity.anonymousUserId
+    };
+    if (this.config.apiKey) {
+      headers.Authorization = `Bearer ${this.config.apiKey}`;
+    }
+    if (this.identity.deviceToken) {
+      headers["X-Device-Token"] = this.identity.deviceToken;
+    }
+    return headers;
+  }
+  resolveIdentity() {
+    const storedIdentity = this.loadOrCreateStoredIdentity();
+    const clientVersion = this.config.version || CCJK_VERSION;
+    return {
+      anonymousUserId: this.config.anonymousUserId || storedIdentity.anonymousUserId,
+      deviceId: this.config.deviceId || storedIdentity.deviceId,
+      clientVersion,
+      platform: this.config.platform || process.platform,
+      deviceToken: this.config.deviceToken
+    };
+  }
+  loadOrCreateStoredIdentity() {
+    try {
+      if (existsSync(CLIENT_USAGE_STATE_FILE)) {
+        const stored = JSON.parse(readFileSync(CLIENT_USAGE_STATE_FILE, "utf-8"));
+        if (stored.anonymousUserId && stored.deviceId) {
+          return {
+            anonymousUserId: stored.anonymousUserId,
+            deviceId: stored.deviceId
+          };
+        }
+      }
+    } catch (error) {
+      consola.debug("Failed to read stored cloud client identity:", error);
+    }
+    const generated = {
+      anonymousUserId: process.env.CCJK_ANONYMOUS_USER_ID || randomUUID(),
+      deviceId: process.env.CCJK_DEVICE_ID || randomUUID()
+    };
+    try {
+      mkdirSync(CLIENT_USAGE_STATE_DIR, { recursive: true });
+      writeFileSync(CLIENT_USAGE_STATE_FILE, JSON.stringify(generated, null, 2));
+    } catch (error) {
+      consola.debug("Failed to persist cloud client identity:", error);
+    }
+    return generated;
+  }
+  buildAnalyticsPayload(payload) {
+    return {
+      deviceId: payload?.deviceId || this.identity.deviceId,
+      platform: payload?.platform || this.identity.platform,
+      clientVersion: payload?.clientVersion || this.identity.clientVersion,
+      ...payload
+    };
+  }
+  canSendUsageAnalytics() {
+    return this.config.enableUsageAnalytics !== false;
+  }
+  getIdentity() {
+    return { ...this.identity };
+  }
   /**
    * Calculate retry delay with exponential backoff
    */
@@ -1102,11 +1171,24 @@ class CloudClient {
    * @returns Usage report response
    */
   async reportUsage(report) {
+    if (!this.canSendUsageAnalytics()) {
+      return {
+        success: false,
+        requestId: "",
+        message: "Usage analytics disabled"
+      };
+    }
     try {
       consola.debug("Reporting usage:", report.metricType);
+      const payload = {
+        ...report,
+        deviceId: report.deviceId || this.identity.deviceId,
+        platform: report.platform || this.identity.platform,
+        clientVersion: report.clientVersion || report.ccjkVersion || this.identity.clientVersion
+      };
       const response = await this.fetch(`${API_PREFIX}/usage/current`, {
         method: "POST",
-        body: report,
+        body: payload,
         timeout: 5e3
         // 5s timeout - telemetry should be fast
       });
@@ -1147,14 +1229,12 @@ class CloudClient {
    */
   updateConfig(config) {
     this.config = { ...this.config, ...config };
-    if (config.baseURL || config.timeout || config.apiKey) {
+    this.identity = this.resolveIdentity();
+    if (config.baseURL || config.timeout || config.apiKey || config.version || config.deviceToken || config.anonymousUserId || config.deviceId || config.platform) {
       this.fetch = ofetch.create({
         baseURL: this.config.baseURL,
         timeout: this.config.timeout,
-        headers: {
-          "User-Agent": `CCJK/${this.config.version || CCJK_VERSION}`,
-          ...this.config.apiKey && { Authorization: `Bearer ${this.config.apiKey}` }
-        },
+        headers: this.getDefaultHeaders(),
         retry: this.config.enableRetry ? this.config.maxRetries : 0,
         retryDelay: (context) => this.calculateRetryDelay(context.options.retry || 0)
       });
@@ -1166,6 +1246,72 @@ class CloudClient {
   getConfig() {
     return { ...this.config };
   }
+  async registerDevice(payload) {
+    if (!this.canSendUsageAnalytics()) {
+      return {
+        success: false,
+        message: "Usage analytics disabled"
+      };
+    }
+    try {
+      return await this.fetch("/device/register", {
+        method: "POST",
+        body: this.buildAnalyticsPayload(payload),
+        timeout: 5e3
+      });
+    } catch (error) {
+      consola.debug("Failed to register device (non-blocking):", error);
+      return {
+        success: false,
+        requestId: "",
+        message: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async handshake(payload) {
+    if (!this.canSendUsageAnalytics()) {
+      return {
+        success: false,
+        message: "Usage analytics disabled"
+      };
+    }
+    try {
+      return await this.fetch(`${API_PREFIX}/handshake`, {
+        method: "POST",
+        body: this.buildAnalyticsPayload(payload),
+        timeout: 5e3
+      });
+    } catch (error) {
+      consola.debug("Failed to send handshake (non-blocking):", error);
+      return {
+        success: false,
+        requestId: "",
+        message: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
+  async syncClientUsage(payload) {
+    if (!this.canSendUsageAnalytics()) {
+      return {
+        success: false,
+        message: "Usage analytics disabled"
+      };
+    }
+    try {
+      return await this.fetch(`${API_PREFIX}/sync`, {
+        method: "POST",
+        body: this.buildAnalyticsPayload(payload),
+        timeout: 5e3
+      });
+    } catch (error) {
+      consola.debug("Failed to sync client usage (non-blocking):", error);
+      return {
+        success: false,
+        requestId: "",
+        message: error instanceof Error ? error.message : "Unknown error"
+      };
+    }
+  }
 }
 function createCloudClient(config) {
   return new CloudClient({
@@ -1337,7 +1483,7 @@ class TelemetryReporter {
   constructor(client, config = {}) {
     this.client = client;
     this.config = { ...DEFAULT_TELEMETRY_CONFIG, ...config };
-    this.userId = this.config.userId || this.generateUserId();
+    this.userId = this.config.userId || this.client.getIdentity().anonymousUserId || this.generateUserId();
     if (this.config.enabled) {
       this.startFlushTimer();
     }
@@ -1578,6 +1724,11 @@ function initializeTelemetry(client, config) {
     });
   }
   globalTelemetry = new TelemetryReporter(client, config);
+  if (client.getConfig().autoHandshake !== false && client.getConfig().enableUsageAnalytics !== false) {
+    client.handshake().catch((error) => {
+      consola.debug("Failed to send startup handshake (non-blocking):", error);
+    });
+  }
   return globalTelemetry;
 }
 function getTelemetry() {
@@ -1680,6 +1831,15 @@ class FallbackCloudClient {
   async reportUsage(report) {
     return this.client.reportUsage(report);
   }
+  async registerDevice(payload) {
+    return this.client.registerDevice(payload);
+  }
+  async handshake(payload) {
+    return this.client.handshake(payload);
+  }
+  async syncClientUsage(payload) {
+    return this.client.syncClientUsage(payload);
+  }
   /**
    * Health check (no fallback)
    */

package/package.json

@@ -1,8 +1,7 @@
 {
   "name": "ccjk",
   "type": "module",
-  "version": "13.4.0",
-  "packageManager": "pnpm@10.17.1",
+  "version": "13.5.1",
   "description": "Turn Claude Code into a production-ready AI dev environment with one-command setup, persistent memory, MCP automation, cloud sync, and zero-config browser workflows.",
   "author": {
     "name": "CCJK Team",
@@ -81,71 +80,6 @@
   "engines": {
     "node": ">=20"
   },
-  "scripts": {
-    "dev": "tsx ./src/cli.ts",
-    "build": "unbuild",
-    "start": "node bin/ccjk.mjs",
-    "typecheck": "tsc --noEmit",
-    "release:verify": "node scripts/release-verify.mjs",
-    "release:verify:full": "node scripts/release-verify.mjs --with-tests",
-    "prepublishOnly": "node scripts/validate-prepublish.mjs && pnpm contract:check && pnpm build",
-    "lint": "eslint",
-    "lint:fix": "eslint --fix",
-    "test": "vitest",
-    "test:ui": "vitest --ui",
-    "test:coverage": "vitest run --coverage",
-    "test:run": "vitest run",
-    "test:watch": "vitest watch",
-    "test:e2e": "NODE_ENV=test vitest --config vitest.e2e.config.ts",
-    "test:e2e:run": "NODE_ENV=test vitest run --config vitest.e2e.config.ts",
-    "test:e2e:ui": "NODE_ENV=test vitest --config vitest.e2e.config.ts --ui",
-    "test:e2e:coverage": "NODE_ENV=test vitest run --config vitest.e2e.config.ts --coverage",
-    "test:e2e:debug": "NODE_ENV=test CCJK_E2E_DEBUG=true vitest --config vitest.e2e.config.ts",
-    "test:v2": "vitest --config vitest.config.v2.ts",
-    "test:v2:ui": "vitest --config vitest.config.v2.ts --ui",
-    "test:v2:coverage": "vitest run --config vitest.config.v2.ts --coverage",
-    "test:v2:run": "vitest run --config vitest.config.v2.ts",
-    "test:v2:watch": "vitest watch --config vitest.config.v2.ts",
-    "test:integration": "NODE_ENV=test vitest --config vitest.integration.config.ts",
-    "test:integration:run": "NODE_ENV=test vitest run --config vitest.integration.config.ts",
-    "test:integration:ui": "NODE_ENV=test vitest --config vitest.integration.config.ts --ui",
-    "test:integration:coverage": "NODE_ENV=test vitest run --config vitest.integration.config.ts --coverage",
-    "prepare": "husky",
-    "format": "prettier --write src/**/*.ts",
-    "prepublish:fix": "node scripts/fix-package-catalog.mjs",
-    "cleanup": "node scripts/cleanup.js",
-    "cleanup:auto": "node scripts/cleanup.js --auto",
-    "cleanup:dry": "node scripts/cleanup.js --dry-run",
-    "clean": "rm -rf dist coverage .turbo *.tsbuildinfo",
-    "benchmark:compression": "tsx scripts/benchmark-compression.ts",
-    "v2:setup": "chmod +x scripts/v2-dev-setup.sh && ./scripts/v2-dev-setup.sh",
-    "v2:setup:skip-tests": "chmod +x scripts/v2-dev-setup.sh && ./scripts/v2-dev-setup.sh --skip-tests",
-    "v2:services:up": "docker-compose -f docker-compose.dev.yml up -d",
-    "v2:services:down": "docker-compose -f docker-compose.dev.yml down",
-    "v2:services:restart": "docker-compose -f docker-compose.dev.yml restart",
-    "v2:services:logs": "docker-compose -f docker-compose.dev.yml logs -f",
-    "v2:services:status": "docker-compose -f docker-compose.dev.yml ps",
-    "v2:db:reset": "docker-compose -f docker-compose.dev.yml down postgres && docker volume rm ccjk-public_postgres_data && docker-compose -f docker-compose.dev.yml up -d postgres",
-    "v2:db:migrate": "echo 'Database migration script - to be implemented'",
-    "v2:db:seed": "echo 'Database seeding script - to be implemented'",
-    "v2:cache:clear": "docker exec ccjk-redis-dev redis-cli FLUSHALL",
-    "v2:search:reindex": "curl -X DELETE http://localhost:9200/ccjk_dev* && echo 'Elasticsearch indexes cleared'",
-    "v2:health": "chmod +x scripts/health-check.sh && ./scripts/health-check.sh",
-    "v2:dev": "concurrently \"pnpm v2:services:up\" \"pnpm dev\"",
-    "v2:test:integration": "NODE_ENV=test pnpm test -- --config vitest.integration.config.ts",
-    "v2:test:e2e": "NODE_ENV=test pnpm test -- --config vitest.e2e.config.ts",
-    "v2:monitoring:up": "docker-compose -f docker-compose.dev.yml --profile monitoring up -d",
-    "v2:tracing:up": "docker-compose -f docker-compose.dev.yml --profile tracing up -d",
-    "v2:clean": "pnpm clean && docker-compose -f docker-compose.dev.yml down -v && docker system prune -f",
-    "benchmark": "tsx src/v2/__tests__/benchmarks.ts",
-    "benchmark:save": "tsx src/v2/__tests__/benchmarks.ts && echo 'Results saved to .ccjk/benchmark-results.json'",
-    "benchmark:detailed": "tsx src/v2/__tests__/benchmarks.ts --detailed",
-    "benchmark:server": "npx http-server docs/v2 -p 8080 -o dashboard.html",
-    "benchmark:open": "open docs/v2/dashboard.html || xdg-open docs/v2/dashboard.html || start docs/v2/dashboard.html",
-    "i18n:check": "tsx scripts/check-i18n.ts",
-    "i18n:report": "tsx scripts/check-i18n.ts --report",
-    "contract:check": "node scripts/check-remote-contract.mjs"
-  },
   "dependencies": {
     "better-sqlite3": "^12.6.2",
     "fdir": "^6.5.0",
@@ -208,5 +142,68 @@
     "unbuild": "^3.6.1",
     "uuid": "^11.1.0",
     "vitest": "^3.2.4"
+  },
+  "scripts": {
+    "dev": "tsx ./src/cli.ts",
+    "build": "unbuild",
+    "start": "node bin/ccjk.mjs",
+    "typecheck": "tsc --noEmit",
+    "release:verify": "node scripts/release-verify.mjs",
+    "release:verify:full": "node scripts/release-verify.mjs --with-tests",
+    "lint": "eslint",
+    "lint:fix": "eslint --fix",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:coverage": "vitest run --coverage",
+    "test:run": "vitest run",
+    "test:watch": "vitest watch",
+    "test:e2e": "NODE_ENV=test vitest --config vitest.e2e.config.ts",
+    "test:e2e:run": "NODE_ENV=test vitest run --config vitest.e2e.config.ts",
+    "test:e2e:ui": "NODE_ENV=test vitest --config vitest.e2e.config.ts --ui",
+    "test:e2e:coverage": "NODE_ENV=test vitest run --config vitest.e2e.config.ts --coverage",
+    "test:e2e:debug": "NODE_ENV=test CCJK_E2E_DEBUG=true vitest --config vitest.e2e.config.ts",
+    "test:v2": "vitest --config vitest.config.v2.ts",
+    "test:v2:ui": "vitest --config vitest.config.v2.ts --ui",
+    "test:v2:coverage": "vitest run --config vitest.config.v2.ts --coverage",
+    "test:v2:run": "vitest run --config vitest.config.v2.ts",
+    "test:v2:watch": "vitest watch --config vitest.config.v2.ts",
+    "test:integration": "NODE_ENV=test vitest --config vitest.integration.config.ts",
+    "test:integration:run": "NODE_ENV=test vitest run --config vitest.integration.config.ts",
+    "test:integration:ui": "NODE_ENV=test vitest --config vitest.integration.config.ts --ui",
+    "test:integration:coverage": "NODE_ENV=test vitest run --config vitest.integration.config.ts --coverage",
+    "format": "prettier --write src/**/*.ts",
+    "prepublish:fix": "node scripts/fix-package-catalog.mjs",
+    "cleanup": "node scripts/cleanup.js",
+    "cleanup:auto": "node scripts/cleanup.js --auto",
+    "cleanup:dry": "node scripts/cleanup.js --dry-run",
+    "clean": "rm -rf dist coverage .turbo *.tsbuildinfo",
+    "benchmark:compression": "tsx scripts/benchmark-compression.ts",
+    "v2:setup": "chmod +x scripts/v2-dev-setup.sh && ./scripts/v2-dev-setup.sh",
+    "v2:setup:skip-tests": "chmod +x scripts/v2-dev-setup.sh && ./scripts/v2-dev-setup.sh --skip-tests",
+    "v2:services:up": "docker-compose -f docker-compose.dev.yml up -d",
+    "v2:services:down": "docker-compose -f docker-compose.dev.yml down",
+    "v2:services:restart": "docker-compose -f docker-compose.dev.yml restart",
+    "v2:services:logs": "docker-compose -f docker-compose.dev.yml logs -f",
+    "v2:services:status": "docker-compose -f docker-compose.dev.yml ps",
+    "v2:db:reset": "docker-compose -f docker-compose.dev.yml down postgres && docker volume rm ccjk-public_postgres_data && docker-compose -f docker-compose.dev.yml up -d postgres",
+    "v2:db:migrate": "echo 'Database migration script - to be implemented'",
+    "v2:db:seed": "echo 'Database seeding script - to be implemented'",
+    "v2:cache:clear": "docker exec ccjk-redis-dev redis-cli FLUSHALL",
+    "v2:search:reindex": "curl -X DELETE http://localhost:9200/ccjk_dev* && echo 'Elasticsearch indexes cleared'",
+    "v2:health": "chmod +x scripts/health-check.sh && ./scripts/health-check.sh",
+    "v2:dev": "concurrently \"pnpm v2:services:up\" \"pnpm dev\"",
+    "v2:test:integration": "NODE_ENV=test pnpm test -- --config vitest.integration.config.ts",
+    "v2:test:e2e": "NODE_ENV=test pnpm test -- --config vitest.e2e.config.ts",
+    "v2:monitoring:up": "docker-compose -f docker-compose.dev.yml --profile monitoring up -d",
+    "v2:tracing:up": "docker-compose -f docker-compose.dev.yml --profile tracing up -d",
+    "v2:clean": "pnpm clean && docker-compose -f docker-compose.dev.yml down -v && docker system prune -f",
+    "benchmark": "tsx src/v2/__tests__/benchmarks.ts",
+    "benchmark:save": "tsx src/v2/__tests__/benchmarks.ts && echo 'Results saved to .ccjk/benchmark-results.json'",
+    "benchmark:detailed": "tsx src/v2/__tests__/benchmarks.ts --detailed",
+    "benchmark:server": "npx http-server docs/v2 -p 8080 -o dashboard.html",
+    "benchmark:open": "open docs/v2/dashboard.html || xdg-open docs/v2/dashboard.html || start docs/v2/dashboard.html",
+    "i18n:check": "tsx scripts/check-i18n.ts",
+    "i18n:report": "tsx scripts/check-i18n.ts --report",
+    "contract:check": "node scripts/check-remote-contract.mjs"
   }
-}
+}