chainlesschain 0.162.20 → 0.162.26

package/src/commands/__tests__/hub-kuaishou-adb-sync.test.js

@@ -0,0 +1,161 @@
+/**
+ * Phase 6d — cc hub kuaishou-adb-sync CLI command unit tests.
+ *
+ * Mirror of hub-toutiao-adb-sync. Covers profileFetchFailed + CLI no-bridge
+ * short-circuit banner + lastErrorCode propagation.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy;
+let prevExitCode;
+
+function fakeHub(syncResult) {
+  return { kuaishouAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-kuaishou",
+    status: "ok",
+    rawCount: 26,
+    entityCounts: { events: 26, persons: 1, places: 0, items: 0, topics: 0 },
+    kuaishou: {
+      uid: "12345",
+      nickname: "Alice",
+      eventCounts: {
+        profile: 1,
+        watch: 15,
+        collect: 5,
+        search: 5,
+        total: 26,
+      },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 8, hadEncrypted: false },
+      profileFetchFailed: false,
+      signProviderUsed: "KuaishouSignBridge",
+      signProviderHits: 3,
+      signProviderFallbacks: 0,
+      cleanupFailed: false,
+    },
+  },
+};
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  prevExitCode = process.exitCode;
+  process.exitCode = 0;
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  process.exitCode = prevExitCode;
+});
+
+describe("cc hub kuaishou-adb-sync — happy path", () => {
+  it("prints human summary with nickname", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    expect(hub.kuaishouAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/kuaishou-adb-sync succeeded/);
+    expect(out).toMatch(/uid:.*12345/);
+    expect(out).toMatch(/nickname:\s+Alice/);
+    expect(out).toMatch(/profile:\s+1/);
+    expect(out).toMatch(/watch:\s+15/);
+    expect(out).toMatch(/collect:\s+5/);
+    expect(out).toMatch(/search:\s+5/);
+    expect(out).toMatch(/total:\s+26/);
+  });
+
+  it("--json outputs raw result", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdKuaishouAdbSync({
+      _getHub: async () => hub,
+      json: true,
+    });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.report.kuaishou.uid).toBe("12345");
+  });
+
+  it("renders profileFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.kuaishou.profileFetchFailed = true;
+    result.report.kuaishou.lastErrorCode = -8;
+    result.report.kuaishou.uid = null;
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/cookie 缺 kuaishou\.web\.cp\.api_ph/);
+    expect(out).toMatch(/profile fetch failed/);
+  });
+
+  it("renders 'no sign bridge' short-circuit banner in CLI context", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.kuaishou.signProviderUsed = "none";
+    result.report.kuaishou.signProviderHits = 0;
+    result.report.kuaishou.signProviderFallbacks = 3;
+    result.report.kuaishou.eventCounts.watch = 0;
+    result.report.kuaishou.eventCounts.collect = 0;
+    result.report.kuaishou.eventCounts.search = 0;
+    result.report.kuaishou.eventCounts.total = 1;
+    result.report.kuaishou.lastErrorCode = -99;
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/3 signed endpoints short-circuited/);
+    expect(out).toMatch(/no sign bridge in CLI context/);
+    expect(out).toMatch(/__NS_sig3 via Electron WebContentsView/);
+  });
+
+  it("renders lastErrorCode partial-result warning (non-(-99))", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.kuaishou.lastErrorCode = 412;
+    result.report.kuaishou.lastErrorMessage = "HTTP 412";
+    const hub = fakeHub(result);
+    await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/partial: lastErrorCode=412/);
+  });
+});
+
+describe("cc hub kuaishou-adb-sync — failure paths", () => {
+  function failCase(reason, expectedHint) {
+    return async () => {
+      const hub = fakeHub({ ok: false, reason, message: "synthetic" });
+      await _internal.cmdKuaishouAdbSync({ _getHub: async () => hub });
+      const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+      expect(out).toMatch(new RegExp(`kuaishou-adb-sync failed: ${reason}`));
+      if (expectedHint) {
+        expect(out).toMatch(expectedHint);
+      }
+      expect(process.exitCode).toBe(1);
+    };
+  }
+
+  it("BRIDGE_UNAVAILABLE banner", failCase("BRIDGE_UNAVAILABLE", /ADB_PATH/));
+  it("KUAISHOU_NO_ROOT banner", failCase("KUAISHOU_NO_ROOT", /Magisk root/));
+  it(
+    "KUAISHOU_NOT_INSTALLED banner",
+    failCase("KUAISHOU_NOT_INSTALLED", /com\.smile\.gifmaker/),
+  );
+  it(
+    "KUAISHOU_COOKIES_INCOMPLETE banner",
+    failCase(
+      "KUAISHOU_COOKIES_INCOMPLETE",
+      /userId \/ kuaishou\.web\.cp\.api_ph/,
+    ),
+  );
+  it(
+    "KUAISHOU_COOKIES_TRUNCATED banner",
+    failCase("KUAISHOU_COOKIES_TRUNCATED", /unplug \+ replug USB/),
+  );
+});

package/src/commands/__tests__/hub-toutiao-adb-sync.test.js

@@ -0,0 +1,158 @@
+/**
+ * Phase 6c — cc hub toutiao-adb-sync CLI command unit tests.
+ *
+ * Mirror of hub-xhs-adb-sync. Covers profileFetchFailed + CLI no-bridge
+ * short-circuit banner + lastErrorCode propagation.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy;
+let prevExitCode;
+
+function fakeHub(syncResult) {
+  return { toutiaoAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-toutiao",
+    status: "ok",
+    rawCount: 26,
+    entityCounts: { events: 26, persons: 1, places: 0, items: 0, topics: 0 },
+    toutiao: {
+      uid: "12345",
+      nickname: "Alice",
+      eventCounts: {
+        profile: 1,
+        feed: 15,
+        collection: 5,
+        search: 5,
+        total: 26,
+      },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 8, hadEncrypted: false },
+      profileFetchFailed: false,
+      signProviderUsed: "ToutiaoSignBridge",
+      signProviderHits: 3,
+      signProviderFallbacks: 0,
+      cleanupFailed: false,
+    },
+  },
+};
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  prevExitCode = process.exitCode;
+  process.exitCode = 0;
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  process.exitCode = prevExitCode;
+});
+
+describe("cc hub toutiao-adb-sync — happy path", () => {
+  it("prints human summary with nickname", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    expect(hub.toutiaoAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/toutiao-adb-sync succeeded/);
+    expect(out).toMatch(/uid:.*12345/);
+    expect(out).toMatch(/nickname:\s+Alice/);
+    expect(out).toMatch(/profile:\s+1/);
+    expect(out).toMatch(/feed:\s+15/);
+    expect(out).toMatch(/collection:\s+5/);
+    expect(out).toMatch(/search:\s+5/);
+    expect(out).toMatch(/total:\s+26/);
+  });
+
+  it("--json outputs raw result", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdToutiaoAdbSync({
+      _getHub: async () => hub,
+      json: true,
+    });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.report.toutiao.uid).toBe("12345");
+  });
+
+  it("renders profileFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.profileFetchFailed = true;
+    result.report.toutiao.lastErrorCode = 1;
+    result.report.toutiao.lastErrorMessage = "token expired";
+    result.report.toutiao.uid = null;
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/passport\/info\/v2 returned no user_id/);
+    expect(out).toMatch(/profile fetch failed/);
+  });
+
+  it("renders 'no sign bridge' short-circuit banner in CLI context", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.signProviderUsed = "none";
+    result.report.toutiao.signProviderHits = 0;
+    result.report.toutiao.signProviderFallbacks = 3;
+    result.report.toutiao.eventCounts.feed = 0;
+    result.report.toutiao.eventCounts.collection = 0;
+    result.report.toutiao.eventCounts.search = 0;
+    result.report.toutiao.eventCounts.total = 1; // just profile
+    result.report.toutiao.lastErrorCode = -99;
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/3 signed endpoints short-circuited/);
+    expect(out).toMatch(/no sign bridge in CLI context/);
+  });
+
+  it("renders lastErrorCode partial-result warning (non-(-99))", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.toutiao.lastErrorCode = 412;
+    result.report.toutiao.lastErrorMessage = "HTTP 412";
+    const hub = fakeHub(result);
+    await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/partial: lastErrorCode=412/);
+  });
+});
+
+describe("cc hub toutiao-adb-sync — failure paths", () => {
+  function failCase(reason, expectedHint) {
+    return async () => {
+      const hub = fakeHub({ ok: false, reason, message: "synthetic" });
+      await _internal.cmdToutiaoAdbSync({ _getHub: async () => hub });
+      const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+      expect(out).toMatch(new RegExp(`toutiao-adb-sync failed: ${reason}`));
+      if (expectedHint) {
+        expect(out).toMatch(expectedHint);
+      }
+      expect(process.exitCode).toBe(1);
+    };
+  }
+
+  it("BRIDGE_UNAVAILABLE banner", failCase("BRIDGE_UNAVAILABLE", /ADB_PATH/));
+  it("TOUTIAO_NO_ROOT banner", failCase("TOUTIAO_NO_ROOT", /Magisk root/));
+  it(
+    "TOUTIAO_NOT_INSTALLED banner",
+    failCase("TOUTIAO_NOT_INSTALLED", /com\.ss\.android\.article\.news/),
+  );
+  it(
+    "TOUTIAO_COOKIES_INCOMPLETE banner",
+    failCase("TOUTIAO_COOKIES_INCOMPLETE", /sessionid \/ sessionid_ss/),
+  );
+  it(
+    "TOUTIAO_COOKIES_TRUNCATED banner",
+    failCase("TOUTIAO_COOKIES_TRUNCATED", /unplug \+ replug USB/),
+  );
+});

package/src/commands/__tests__/hub-weibo-adb-sync.test.js

@@ -0,0 +1,163 @@
+/**
+ * Phase 3a — cc hub weibo-adb-sync CLI command unit tests.
+ *
+ * Same _getHub test-seam pattern. Mirrors hub-bilibili / hub-douyin tests.
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy;
+let prevExitCode;
+
+function fakeHub(syncResult) {
+  return { weiboAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-weibo",
+    status: "ok",
+    rawCount: 25,
+    entityCounts: { events: 25, persons: 0, places: 0, items: 0, topics: 0 },
+    weibo: {
+      uid: 1234567890,
+      eventCounts: { post: 15, favourite: 5, follow: 5, total: 25 },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 6, hasSub: true, hadEncrypted: false },
+      uidFetchFailed: false,
+      cleanupFailed: false,
+    },
+  },
+};
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  prevExitCode = process.exitCode;
+  process.exitCode = 0;
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  process.exitCode = prevExitCode;
+});
+
+describe("cc hub weibo-adb-sync — happy path", () => {
+  it("prints human summary", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    expect(hub.weiboAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/weibo-adb-sync succeeded/);
+    expect(out).toMatch(/uid:.*1234567890/);
+    expect(out).toMatch(/posts:\s+15/);
+    expect(out).toMatch(/favourites:\s+5/);
+    expect(out).toMatch(/follows:\s+5/);
+    expect(out).toMatch(/total:\s+25/);
+  });
+
+  it("--json outputs raw result", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub, json: true });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.report.weibo.uid).toBe(1234567890);
+  });
+
+  it("renders uidFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.weibo.uidFetchFailed = true;
+    result.report.weibo.lastErrorCode = -4;
+    result.report.weibo.uid = null;
+    const hub = fakeHub(result);
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/api\/config returned login=false/);
+    expect(out).toMatch(/uid fetch failed/);
+  });
+});
+
+describe("cc hub weibo-adb-sync — failure reasons", () => {
+  it("BRIDGE_UNAVAILABLE → exit 1 + install tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "BRIDGE_UNAVAILABLE",
+      message: "adb not found",
+    });
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    expect(process.exitCode).toBe(1);
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/Install Android Platform Tools/);
+  });
+
+  it("WEIBO_NO_ROOT → Magisk tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "WEIBO_NO_ROOT",
+      message: "uid=2000",
+    });
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/Magisk root/);
+  });
+
+  it("WEIBO_NOT_INSTALLED → install tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "WEIBO_NOT_INSTALLED",
+      message: "Cookies path missing",
+    });
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/Install Weibo App/);
+  });
+
+  it("WEIBO_COOKIES_INCOMPLETE → relog tip (SUB missing)", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "WEIBO_COOKIES_INCOMPLETE",
+      message: "missing SUB",
+    });
+    await _internal.cmdWeiboAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/SUB cookie missing.*relog/);
+  });
+});
+
+describe("cc hub weibo-adb-sync — options forwarding", () => {
+  it("forwards limit-post / limit-favourite / limit-follow", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdWeiboAdbSync({
+      _getHub: async () => hub,
+      limitPost: "50",
+      limitFavourite: "30",
+      limitFollow: "100",
+    });
+    const arg = hub.weiboAdbSync.mock.calls[0][0];
+    expect(arg.limits).toEqual({ post: 50, favourite: 30, follow: 100 });
+  });
+
+  it("forwards display-name + staging-dir", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdWeiboAdbSync({
+      _getHub: async () => hub,
+      displayName: "alice",
+      stagingDir: "/tmp/x",
+    });
+    const arg = hub.weiboAdbSync.mock.calls[0][0];
+    expect(arg.displayName).toBe("alice");
+    expect(arg.stagingDir).toBe("/tmp/x");
+  });
+});
+
+describe("cc hub weibo-adb-sync — _internal export", () => {
+  it("cmdWeiboAdbSync is exported", () => {
+    expect(typeof _internal.cmdWeiboAdbSync).toBe("function");
+  });
+});

package/src/commands/__tests__/hub-xhs-adb-sync.test.js

@@ -0,0 +1,155 @@
+/**
+ * Phase 3c — cc hub xhs-adb-sync CLI command unit tests.
+ *
+ * Mirror of hub-weibo-adb-sync test. Covers meFetchFailed warning + 461
+ * partial-result warning (X-S signing best-effort).
+ */
+
+import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy;
+let prevExitCode;
+
+function fakeHub(syncResult) {
+  return { xhsAdbSync: vi.fn(async (_opts) => syncResult) };
+}
+
+const HAPPY_RESULT = {
+  ok: true,
+  report: {
+    adapter: "social-xiaohongshu",
+    status: "ok",
+    rawCount: 20,
+    entityCounts: { events: 20, persons: 0, places: 0, items: 0, topics: 0 },
+    xhs: {
+      userId: "5e8c8f7e1234abcdef",
+      nickname: "Alice",
+      eventCounts: { note: 15, liked: 3, follow: 2, total: 20 },
+      lastErrorCode: 0,
+      lastErrorMessage: null,
+      cookieDiagnostic: { cookieCount: 8, hadEncrypted: false },
+      meFetchFailed: false,
+      cleanupFailed: false,
+    },
+  },
+};
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  prevExitCode = process.exitCode;
+  process.exitCode = 0;
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  process.exitCode = prevExitCode;
+});
+
+describe("cc hub xhs-adb-sync — happy path", () => {
+  it("prints human summary with nickname", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    expect(hub.xhsAdbSync).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/xhs-adb-sync succeeded/);
+    expect(out).toMatch(/userId:.*5e8c8f7e/);
+    expect(out).toMatch(/nickname:\s+Alice/);
+    expect(out).toMatch(/notes:\s+15/);
+    expect(out).toMatch(/liked:\s+3/);
+    expect(out).toMatch(/follows:\s+2/);
+    expect(out).toMatch(/total:\s+20/);
+  });
+
+  it("--json outputs raw result", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub, json: true });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.report.xhs.userId).toBe("5e8c8f7e1234abcdef");
+  });
+
+  it("renders meFetchFailed warning when set", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.xhs.meFetchFailed = true;
+    result.report.xhs.lastErrorCode = -7;
+    result.report.xhs.userId = null;
+    const hub = fakeHub(result);
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/\/user\/me returned no user_id/);
+    expect(out).toMatch(/me fetch failed/);
+  });
+
+  it("renders X-S 461 partial-result warning", async () => {
+    const result = JSON.parse(JSON.stringify(HAPPY_RESULT));
+    result.report.xhs.lastErrorCode = 461;
+    result.report.xhs.lastErrorMessage = "X-S validation failed";
+    result.report.xhs.eventCounts.total = 5; // partial — only 5 events got through
+    const hub = fakeHub(result);
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/X-S 签名 best-effort/);
+    expect(out).toMatch(/lastErrorCode=461/);
+  });
+});
+
+describe("cc hub xhs-adb-sync — failure reasons", () => {
+  it("BRIDGE_UNAVAILABLE → exit 1 + install tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "BRIDGE_UNAVAILABLE",
+      message: "adb not found",
+    });
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    expect(process.exitCode).toBe(1);
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/Install Android Platform Tools/);
+  });
+
+  it("XHS_NO_ROOT → Magisk tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "XHS_NO_ROOT",
+      message: "uid=2000",
+    });
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/Magisk root/);
+  });
+
+  it("XHS_COOKIES_INCOMPLETE → a1/web_session tip", async () => {
+    const hub = fakeHub({
+      ok: false,
+      reason: "XHS_COOKIES_INCOMPLETE",
+      message: "missing a1",
+    });
+    await _internal.cmdXhsAdbSync({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/a1 \/ web_session cookie missing/);
+  });
+});
+
+describe("cc hub xhs-adb-sync — options forwarding", () => {
+  it("forwards limit-note / limit-liked / limit-follow", async () => {
+    const hub = fakeHub(HAPPY_RESULT);
+    await _internal.cmdXhsAdbSync({
+      _getHub: async () => hub,
+      limitNote: "20",
+      limitLiked: "15",
+      limitFollow: "50",
+    });
+    const arg = hub.xhsAdbSync.mock.calls[0][0];
+    expect(arg.limits).toEqual({ note: 20, liked: 15, follow: 50 });
+  });
+});
+
+describe("cc hub xhs-adb-sync — _internal export", () => {
+  it("cmdXhsAdbSync is exported", () => {
+    expect(typeof _internal.cmdXhsAdbSync).toBe("function");
+  });
+});