qwenproxy-cli 1.0.0 → 1.0.2

package/src/sync/index.ts

@@ -1,362 +1,362 @@
-import "dotenv/config";
-import fs from "node:fs";
-import path from "node:path";
-import os from "node:os";
-
-import { config } from "../core/config.ts";
-import { getSyncStatePath } from "../core/paths.ts";
-import type {
-  ClientSyncResult,
-  SyncAllOptions,
-  SyncRecord,
-  SyncStateFile,
-} from "./types.ts";
-import { syncClaudeCode, restoreClaudeCode } from "./claude-code.ts";
-import { syncCodex, restoreCodex } from "./codex.ts";
-import { syncOpenCode, restoreOpenCode } from "./opencode.ts";
-import { syncOmp, restoreOmp } from "./omp.ts";
-
-export function resolveApiKey(overrideKey?: string, configKey?: string): string {
-  if (overrideKey && overrideKey.trim().length > 0) {
-    return overrideKey.trim();
-  }
-  const envKey = process.env.API_KEY || process.env.ADMIN_PASSWORD || configKey;
-  if (envKey && envKey.trim().length > 0) {
-    return envKey.trim();
-  }
-  return "sk-qwenproxy-local";
-}
-export function normalizeClientName(name: string): "claude-code" | "codex" | "opencode" | "omp" | null {
-  const clean = name.trim().toLowerCase().replace(/[-_ ]/g, "");
-  if (clean === "claude" || clean === "claudecode" || clean === "anthropic") return "claude-code";
-  if (clean === "codex" || clean === "codexcli" || clean === "openai") return "codex";
-  if (clean === "opencode") return "opencode";
-  if (clean === "omp" || clean === "ohmypi") return "omp";
-  return null;
-}
-
-export function resolveBaseUrls(port = 7936, host = "127.0.0.1"): {
-  anthropicBaseUrl: string;
-  openaiBaseUrl: string;
-} {
-  const cleanHost = host === "0.0.0.0" ? "127.0.0.1" : host;
-  return {
-    anthropicBaseUrl: `http://${cleanHost}:${port}`,
-    openaiBaseUrl: `http://${cleanHost}:${port}/v1`,
-  };
-}
-
-export function getDefaultPaths(): {
-  claudeCode: string;
-  codex: string;
-  openCode: string;
-  omp: string;
-} {
-  const home = os.homedir();
-
-  // OpenCode can be ~/.config/opencode/opencode.jsonc or ~/.opencode/opencode.jsonc
-  const openCodeCandidates = [
-    path.join(home, ".config", "opencode", "opencode.jsonc"),
-    path.join(home, ".config", "opencode", "opencode.json"),
-    path.join(home, ".opencode", "opencode.jsonc"),
-    path.join(home, ".opencode", "opencode.json"),
-  ];
-  const existingOpenCode = openCodeCandidates.find((p) => fs.existsSync(p));
-
-  return {
-    claudeCode: path.join(home, ".claude", "settings.json"),
-    codex: process.env.CODEX_HOME
-      ? path.join(process.env.CODEX_HOME, "config.toml")
-      : path.join(home, ".codex", "config.toml"),
-    openCode: existingOpenCode || openCodeCandidates[0],
-    omp: path.join(home, ".omp", "agent", "models.yml"),
-  };
-}
-
-export function getDefaultStateFilePath(): string {
-  return getSyncStatePath();
-}
-export interface ClientDetectionStatus {
-  id: "claude-code" | "codex" | "opencode" | "omp";
-  installed: boolean;
-  synced: boolean;
-  model?: string;
-  url?: string;
-}
-
-/**
- * Inspects a client configuration file to determine whether the client is installed
- * and whether it is actively configured to route to QwenProxy.
- */
-export function inspectClientSyncStatus(
-  id: "claude-code" | "codex" | "opencode" | "omp",
-  filePath?: string,
-  port = 7936,
-): ClientDetectionStatus {
-  const defaultPaths = getDefaultPaths();
-  const targetPath =
-    filePath ||
-    (id === "claude-code"
-      ? defaultPaths.claudeCode
-      : id === "codex"
-        ? defaultPaths.codex
-        : id === "opencode"
-          ? defaultPaths.openCode
-          : defaultPaths.omp);
-
-  if (!fs.existsSync(targetPath)) {
-    return { id, installed: false, synced: false };
-  }
-
-  try {
-    const raw = fs.readFileSync(targetPath, "utf-8");
-
-    if (id === "claude-code") {
-      const data = JSON.parse(raw);
-      const url = data?.env?.ANTHROPIC_BASE_URL || "";
-      const model = data?.env?.ANTHROPIC_MODEL || data?.model || "";
-      const isSynced =
-        (url.includes(String(port)) || url.includes("qwenproxy")) &&
-        (model.toLowerCase().includes("qwen") || Boolean(data?.env?.ANTHROPIC_AUTH_TOKEN));
-      return {
-        id,
-        installed: true,
-        synced: isSynced,
-        model: model || undefined,
-        url: url || undefined,
-      };
-    }
-
-    if (id === "codex") {
-      const hasProvider = raw.includes("[model_providers.qwenproxy]");
-      const isProviderActive = /^model_provider\s*=\s*["']qwenproxy["']/m.test(raw);
-      const modelMatch = raw.match(/^model\s*=\s*["']([^"']+)["']/m);
-      const model = modelMatch ? modelMatch[1] : undefined;
-      return {
-        id,
-        installed: true,
-        synced: hasProvider && isProviderActive,
-        model,
-      };
-    }
-
-    if (id === "opencode") {
-      const hasQwen =
-        raw.includes('"qwenproxy"') &&
-        (raw.includes(String(port)) || raw.includes("QwenProxy") || raw.includes("qwen3"));
-      return {
-        id,
-        installed: true,
-        synced: hasQwen,
-      };
-    }
-
-    if (id === "omp") {
-      const hasQwen =
-        /^ {2}qwenproxy:\s*$/m.test(raw) ||
-        raw.includes("qwenproxy:") ||
-        (raw.includes(String(port)) && raw.includes("qwen3"));
-      return {
-        id,
-        installed: true,
-        synced: hasQwen,
-      };
-    }
-  } catch {
-    return { id, installed: true, synced: false };
-  }
-
-  return { id, installed: true, synced: false };
-}
-
-export interface SyncAllResult {
-  apiKey: string;
-  port: number;
-  host: string;
-  clients: {
-    claudeCode?: ClientSyncResult;
-    codex?: ClientSyncResult;
-    openCode?: ClientSyncResult;
-    omp?: ClientSyncResult;
-  };
-}
-
-export function syncAllClients(options: SyncAllOptions = {}): SyncAllResult {
-  const defaultPaths = getDefaultPaths();
-  const paths = {
-    claudeCode: options.customPaths?.claudeCode || defaultPaths.claudeCode,
-    codex: options.customPaths?.codex || defaultPaths.codex,
-    openCode: options.customPaths?.openCode || defaultPaths.openCode,
-    omp: options.customPaths?.omp || defaultPaths.omp,
-  };
-
-  const port = options.port ?? (config.server?.port || 7936);
-  const configuredHost = config.server?.host;
-  const host = options.host ?? (configuredHost && configuredHost !== "0.0.0.0" ? configuredHost : "127.0.0.1");
-  const apiKey = resolveApiKey(options.apiKey, config.apiKey);
-  const { anthropicBaseUrl, openaiBaseUrl } = resolveBaseUrls(port, host);
-  const stateFilePath = options.stateFilePath || getDefaultStateFilePath();
-
-  const results: SyncAllResult = {
-    apiKey,
-    port,
-    host,
-    clients: {},
-  };
-
-  const stateRecords: SyncStateFile["clients"] = {};
-  const shouldSync = (client: "claude-code" | "codex" | "opencode" | "omp") => {
-    if (!options.targets || options.targets.length === 0) return true;
-    return options.targets.includes(client);
-  };
-
-  // 1. Claude Code
-  if (shouldSync("claude-code")) {
-    const claudeExisted = fs.existsSync(paths.claudeCode);
-    const claudeRes = syncClaudeCode({
-      filePath: paths.claudeCode,
-      apiKey,
-      baseUrl: anthropicBaseUrl,
-    });
-    results.clients.claudeCode = claudeRes;
-    if (claudeRes.success && claudeRes.backupPath) {
-      stateRecords.claudeCode = {
-        filePath: paths.claudeCode,
-        backupPath: claudeRes.backupPath,
-        existedBefore: claudeExisted,
-        syncedAt: Date.now(),
-      };
-    }
-  }
-
-  // 2. Codex
-  if (shouldSync("codex")) {
-    const codexExisted = fs.existsSync(paths.codex);
-    const codexRes = syncCodex({
-      filePath: paths.codex,
-      apiKey,
-      baseUrl: openaiBaseUrl,
-      setActive: options.setActive ?? true,
-    });
-    results.clients.codex = codexRes;
-    if (codexRes.success && codexRes.backupPath) {
-      stateRecords.codex = {
-        filePath: paths.codex,
-        backupPath: codexRes.backupPath,
-        existedBefore: codexExisted,
-        syncedAt: Date.now(),
-      };
-    }
-  }
-
-  // 3. OpenCode
-  if (shouldSync("opencode")) {
-    const openCodeExisted = fs.existsSync(paths.openCode);
-    const openCodeRes = syncOpenCode({
-      filePath: paths.openCode,
-      apiKey,
-      baseUrl: openaiBaseUrl,
-    });
-    results.clients.openCode = openCodeRes;
-    if (openCodeRes.success && openCodeRes.backupPath) {
-      stateRecords.openCode = {
-        filePath: paths.openCode,
-        backupPath: openCodeRes.backupPath,
-        existedBefore: openCodeExisted,
-        syncedAt: Date.now(),
-      };
-    }
-  }
-
-  // 4. OMP
-  if (shouldSync("omp")) {
-    const ompExisted = fs.existsSync(paths.omp);
-    const ompRes = syncOmp({
-      filePath: paths.omp,
-      apiKey,
-      baseUrl: openaiBaseUrl,
-    });
-    results.clients.omp = ompRes;
-    if (ompRes.success && ompRes.backupPath) {
-      stateRecords.omp = {
-        filePath: paths.omp,
-        backupPath: ompRes.backupPath,
-        existedBefore: ompExisted,
-        syncedAt: Date.now(),
-      };
-    }
-  }
-
-  // Persist sync state
-  try {
-    fs.mkdirSync(path.dirname(stateFilePath), { recursive: true });
-    const stateContent: SyncStateFile = {
-      version: 1,
-      updatedAt: new Date().toISOString(),
-      apiKey,
-      port,
-      host,
-      clients: stateRecords,
-    };
-    fs.writeFileSync(stateFilePath, JSON.stringify(stateContent, null, 2) + "\n", "utf-8");
-  } catch (err) {
-    console.error("Warning: could not write sync state file:", err);
-  }
-
-  return results;
-}
-
-export interface RestoreAllResult {
-  restoredCount: number;
-  details: ClientSyncResult[];
-}
-
-export function restoreAllClients(options: { stateFilePath?: string } = {}): RestoreAllResult {
-  const stateFilePath = options.stateFilePath || getDefaultStateFilePath();
-  const details: ClientSyncResult[] = [];
-  let restoredCount = 0;
-
-  if (!fs.existsSync(stateFilePath)) {
-    return { restoredCount: 0, details };
-  }
-
-  try {
-    const raw = fs.readFileSync(stateFilePath, "utf-8");
-    const state: SyncStateFile = JSON.parse(raw);
-
-    if (state.clients.claudeCode?.backupPath) {
-      const res = restoreClaudeCode(state.clients.claudeCode.filePath, state.clients.claudeCode.backupPath);
-      details.push(res);
-      if (res.success) restoredCount++;
-    }
-
-    if (state.clients.codex?.backupPath) {
-      const res = restoreCodex(state.clients.codex.filePath, state.clients.codex.backupPath);
-      details.push(res);
-      if (res.success) restoredCount++;
-    }
-
-    if (state.clients.openCode?.backupPath) {
-      const res = restoreOpenCode(state.clients.openCode.filePath, state.clients.openCode.backupPath);
-      details.push(res);
-      if (res.success) restoredCount++;
-    }
-
-    if (state.clients.omp?.backupPath) {
-      const res = restoreOmp(state.clients.omp.filePath, state.clients.omp.backupPath);
-      details.push(res);
-      if (res.success) restoredCount++;
-    }
-
-    // Remove state file after successful restoration
-    try {
-      fs.unlinkSync(stateFilePath);
-    } catch {
-      // Ignore
-    }
-  } catch (err) {
-    console.error("Error reading sync state file:", err);
-  }
-
-  return { restoredCount, details };
-}
+import "dotenv/config";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+
+import { config } from "../core/config.ts";
+import { getSyncStatePath } from "../core/paths.ts";
+import type {
+  ClientSyncResult,
+  SyncAllOptions,
+  SyncRecord,
+  SyncStateFile,
+} from "./types.ts";
+import { syncClaudeCode, restoreClaudeCode } from "./claude-code.ts";
+import { syncCodex, restoreCodex } from "./codex.ts";
+import { syncOpenCode, restoreOpenCode } from "./opencode.ts";
+import { syncOmp, restoreOmp } from "./omp.ts";
+
+export function resolveApiKey(overrideKey?: string, configKey?: string): string {
+  if (overrideKey && overrideKey.trim().length > 0) {
+    return overrideKey.trim();
+  }
+  const envKey = process.env.API_KEY || process.env.ADMIN_PASSWORD || configKey;
+  if (envKey && envKey.trim().length > 0) {
+    return envKey.trim();
+  }
+  return "sk-qwenproxy-local";
+}
+export function normalizeClientName(name: string): "claude-code" | "codex" | "opencode" | "omp" | null {
+  const clean = name.trim().toLowerCase().replace(/[-_ ]/g, "");
+  if (clean === "claude" || clean === "claudecode" || clean === "anthropic") return "claude-code";
+  if (clean === "codex" || clean === "codexcli" || clean === "openai") return "codex";
+  if (clean === "opencode") return "opencode";
+  if (clean === "omp" || clean === "ohmypi") return "omp";
+  return null;
+}
+
+export function resolveBaseUrls(port = 7936, host = "127.0.0.1"): {
+  anthropicBaseUrl: string;
+  openaiBaseUrl: string;
+} {
+  const cleanHost = host === "0.0.0.0" ? "127.0.0.1" : host;
+  return {
+    anthropicBaseUrl: `http://${cleanHost}:${port}`,
+    openaiBaseUrl: `http://${cleanHost}:${port}/v1`,
+  };
+}
+
+export function getDefaultPaths(): {
+  claudeCode: string;
+  codex: string;
+  openCode: string;
+  omp: string;
+} {
+  const home = os.homedir();
+
+  // OpenCode can be ~/.config/opencode/opencode.jsonc or ~/.opencode/opencode.jsonc
+  const openCodeCandidates = [
+    path.join(home, ".config", "opencode", "opencode.jsonc"),
+    path.join(home, ".config", "opencode", "opencode.json"),
+    path.join(home, ".opencode", "opencode.jsonc"),
+    path.join(home, ".opencode", "opencode.json"),
+  ];
+  const existingOpenCode = openCodeCandidates.find((p) => fs.existsSync(p));
+
+  return {
+    claudeCode: path.join(home, ".claude", "settings.json"),
+    codex: process.env.CODEX_HOME
+      ? path.join(process.env.CODEX_HOME, "config.toml")
+      : path.join(home, ".codex", "config.toml"),
+    openCode: existingOpenCode || openCodeCandidates[0],
+    omp: path.join(home, ".omp", "agent", "models.yml"),
+  };
+}
+
+export function getDefaultStateFilePath(): string {
+  return getSyncStatePath();
+}
+export interface ClientDetectionStatus {
+  id: "claude-code" | "codex" | "opencode" | "omp";
+  installed: boolean;
+  synced: boolean;
+  model?: string;
+  url?: string;
+}
+
+/**
+ * Inspects a client configuration file to determine whether the client is installed
+ * and whether it is actively configured to route to QwenProxy.
+ */
+export function inspectClientSyncStatus(
+  id: "claude-code" | "codex" | "opencode" | "omp",
+  filePath?: string,
+  port = 7936,
+): ClientDetectionStatus {
+  const defaultPaths = getDefaultPaths();
+  const targetPath =
+    filePath ||
+    (id === "claude-code"
+      ? defaultPaths.claudeCode
+      : id === "codex"
+        ? defaultPaths.codex
+        : id === "opencode"
+          ? defaultPaths.openCode
+          : defaultPaths.omp);
+
+  if (!fs.existsSync(targetPath)) {
+    return { id, installed: false, synced: false };
+  }
+
+  try {
+    const raw = fs.readFileSync(targetPath, "utf-8");
+
+    if (id === "claude-code") {
+      const data = JSON.parse(raw);
+      const url = data?.env?.ANTHROPIC_BASE_URL || "";
+      const model = data?.env?.ANTHROPIC_MODEL || data?.model || "";
+      const isSynced =
+        (url.includes(String(port)) || url.includes("qwenproxy")) &&
+        (model.toLowerCase().includes("qwen") || Boolean(data?.env?.ANTHROPIC_AUTH_TOKEN));
+      return {
+        id,
+        installed: true,
+        synced: isSynced,
+        model: model || undefined,
+        url: url || undefined,
+      };
+    }
+
+    if (id === "codex") {
+      const hasProvider = raw.includes("[model_providers.qwenproxy]");
+      const isProviderActive = /^model_provider\s*=\s*["']qwenproxy["']/m.test(raw);
+      const modelMatch = raw.match(/^model\s*=\s*["']([^"']+)["']/m);
+      const model = modelMatch ? modelMatch[1] : undefined;
+      return {
+        id,
+        installed: true,
+        synced: hasProvider && isProviderActive,
+        model,
+      };
+    }
+
+    if (id === "opencode") {
+      const hasQwen =
+        raw.includes('"qwenproxy"') &&
+        (raw.includes(String(port)) || raw.includes("QwenProxy") || raw.includes("qwen3"));
+      return {
+        id,
+        installed: true,
+        synced: hasQwen,
+      };
+    }
+
+    if (id === "omp") {
+      const hasQwen =
+        /^ {2}qwenproxy:\s*$/m.test(raw) ||
+        raw.includes("qwenproxy:") ||
+        (raw.includes(String(port)) && raw.includes("qwen3"));
+      return {
+        id,
+        installed: true,
+        synced: hasQwen,
+      };
+    }
+  } catch {
+    return { id, installed: true, synced: false };
+  }
+
+  return { id, installed: true, synced: false };
+}
+
+export interface SyncAllResult {
+  apiKey: string;
+  port: number;
+  host: string;
+  clients: {
+    claudeCode?: ClientSyncResult;
+    codex?: ClientSyncResult;
+    openCode?: ClientSyncResult;
+    omp?: ClientSyncResult;
+  };
+}
+
+export function syncAllClients(options: SyncAllOptions = {}): SyncAllResult {
+  const defaultPaths = getDefaultPaths();
+  const paths = {
+    claudeCode: options.customPaths?.claudeCode || defaultPaths.claudeCode,
+    codex: options.customPaths?.codex || defaultPaths.codex,
+    openCode: options.customPaths?.openCode || defaultPaths.openCode,
+    omp: options.customPaths?.omp || defaultPaths.omp,
+  };
+
+  const port = options.port ?? (config.server?.port || 7936);
+  const configuredHost = config.server?.host;
+  const host = options.host ?? (configuredHost && configuredHost !== "0.0.0.0" ? configuredHost : "127.0.0.1");
+  const apiKey = resolveApiKey(options.apiKey, config.apiKey);
+  const { anthropicBaseUrl, openaiBaseUrl } = resolveBaseUrls(port, host);
+  const stateFilePath = options.stateFilePath || getDefaultStateFilePath();
+
+  const results: SyncAllResult = {
+    apiKey,
+    port,
+    host,
+    clients: {},
+  };
+
+  const stateRecords: SyncStateFile["clients"] = {};
+  const shouldSync = (client: "claude-code" | "codex" | "opencode" | "omp") => {
+    if (!options.targets || options.targets.length === 0) return true;
+    return options.targets.includes(client);
+  };
+
+  // 1. Claude Code
+  if (shouldSync("claude-code")) {
+    const claudeExisted = fs.existsSync(paths.claudeCode);
+    const claudeRes = syncClaudeCode({
+      filePath: paths.claudeCode,
+      apiKey,
+      baseUrl: anthropicBaseUrl,
+    });
+    results.clients.claudeCode = claudeRes;
+    if (claudeRes.success && claudeRes.backupPath) {
+      stateRecords.claudeCode = {
+        filePath: paths.claudeCode,
+        backupPath: claudeRes.backupPath,
+        existedBefore: claudeExisted,
+        syncedAt: Date.now(),
+      };
+    }
+  }
+
+  // 2. Codex
+  if (shouldSync("codex")) {
+    const codexExisted = fs.existsSync(paths.codex);
+    const codexRes = syncCodex({
+      filePath: paths.codex,
+      apiKey,
+      baseUrl: openaiBaseUrl,
+      setActive: options.setActive ?? true,
+    });
+    results.clients.codex = codexRes;
+    if (codexRes.success && codexRes.backupPath) {
+      stateRecords.codex = {
+        filePath: paths.codex,
+        backupPath: codexRes.backupPath,
+        existedBefore: codexExisted,
+        syncedAt: Date.now(),
+      };
+    }
+  }
+
+  // 3. OpenCode
+  if (shouldSync("opencode")) {
+    const openCodeExisted = fs.existsSync(paths.openCode);
+    const openCodeRes = syncOpenCode({
+      filePath: paths.openCode,
+      apiKey,
+      baseUrl: openaiBaseUrl,
+    });
+    results.clients.openCode = openCodeRes;
+    if (openCodeRes.success && openCodeRes.backupPath) {
+      stateRecords.openCode = {
+        filePath: paths.openCode,
+        backupPath: openCodeRes.backupPath,
+        existedBefore: openCodeExisted,
+        syncedAt: Date.now(),
+      };
+    }
+  }
+
+  // 4. OMP
+  if (shouldSync("omp")) {
+    const ompExisted = fs.existsSync(paths.omp);
+    const ompRes = syncOmp({
+      filePath: paths.omp,
+      apiKey,
+      baseUrl: openaiBaseUrl,
+    });
+    results.clients.omp = ompRes;
+    if (ompRes.success && ompRes.backupPath) {
+      stateRecords.omp = {
+        filePath: paths.omp,
+        backupPath: ompRes.backupPath,
+        existedBefore: ompExisted,
+        syncedAt: Date.now(),
+      };
+    }
+  }
+
+  // Persist sync state
+  try {
+    fs.mkdirSync(path.dirname(stateFilePath), { recursive: true });
+    const stateContent: SyncStateFile = {
+      version: 1,
+      updatedAt: new Date().toISOString(),
+      apiKey,
+      port,
+      host,
+      clients: stateRecords,
+    };
+    fs.writeFileSync(stateFilePath, JSON.stringify(stateContent, null, 2) + "\n", "utf-8");
+  } catch (err) {
+    console.error("Warning: could not write sync state file:", err);
+  }
+
+  return results;
+}
+
+export interface RestoreAllResult {
+  restoredCount: number;
+  details: ClientSyncResult[];
+}
+
+export function restoreAllClients(options: { stateFilePath?: string } = {}): RestoreAllResult {
+  const stateFilePath = options.stateFilePath || getDefaultStateFilePath();
+  const details: ClientSyncResult[] = [];
+  let restoredCount = 0;
+
+  if (!fs.existsSync(stateFilePath)) {
+    return { restoredCount: 0, details };
+  }
+
+  try {
+    const raw = fs.readFileSync(stateFilePath, "utf-8");
+    const state: SyncStateFile = JSON.parse(raw);
+
+    if (state.clients.claudeCode?.backupPath) {
+      const res = restoreClaudeCode(state.clients.claudeCode.filePath, state.clients.claudeCode.backupPath);
+      details.push(res);
+      if (res.success) restoredCount++;
+    }
+
+    if (state.clients.codex?.backupPath) {
+      const res = restoreCodex(state.clients.codex.filePath, state.clients.codex.backupPath);
+      details.push(res);
+      if (res.success) restoredCount++;
+    }
+
+    if (state.clients.openCode?.backupPath) {
+      const res = restoreOpenCode(state.clients.openCode.filePath, state.clients.openCode.backupPath);
+      details.push(res);
+      if (res.success) restoredCount++;
+    }
+
+    if (state.clients.omp?.backupPath) {
+      const res = restoreOmp(state.clients.omp.filePath, state.clients.omp.backupPath);
+      details.push(res);
+      if (res.success) restoredCount++;
+    }
+
+    // Remove state file after successful restoration
+    try {
+      fs.unlinkSync(stateFilePath);
+    } catch {
+      // Ignore
+    }
+  } catch (err) {
+    console.error("Error reading sync state file:", err);
+  }
+
+  return { restoredCount, details };
+}