chainlesschain 0.162.12 → 0.162.14

package/src/commands/__tests__/hub-wechat.test.js

@@ -0,0 +1,243 @@
+/**
+ * cc hub wechat <verb> CLI command unit tests (Phase 12.6.9 CLI surface).
+ *
+ * The command handlers accept `_getHub` test seam so this suite never
+ * starts a real hub. We synthesize a tiny fake hub whose methods return
+ * canned responses matching the real ones (Phase 12.6.8 wiring methods).
+ */
+
+import { describe, it, expect, beforeEach, vi, afterEach } from "vitest";
+
+import { _internal } from "../hub.js";
+
+let logSpy, errSpy, exitSpy;
+
+function fakeHub(overrides = {}) {
+  return {
+    probeWechatEnv: vi.fn(async () => ({
+      ok: true,
+      suggestedKeyProvider: "md5",
+      reasons: ["WeChat 7.0.22 — md5 path"],
+      device: { reachable: true, serial: "DEVICE_A", abi: "arm64-v8a" },
+      root: { detected: false, magiskInstalled: false },
+      frida: { serverRunning: false, port: null },
+      wechat: { installed: true, versionName: "7.0.22", majorVersion: 7 },
+      warnings: [],
+      ...overrides.probe,
+    })),
+    registerWechatAdapter: vi.fn(async (opts) => {
+      if (!opts.account || !opts.account.uin) {
+        return { ok: false, reason: "UIN_REQUIRED" };
+      }
+      return {
+        ok: true,
+        name: "wechat",
+        version: "0.5.0",
+        capabilities: ["sync:sqlite"],
+        sensitivity: "high",
+        chosenKeyProvider: opts.keyProviderOverride || "md5",
+        probe: { suggestedKeyProvider: "md5", reasons: [] },
+        registeredAt: 1716280000000,
+        ...overrides.register,
+      };
+    }),
+    listWechatAccounts: vi.fn(() => overrides.list || [
+      {
+        uin: "1234567890",
+        dbPath: "/tmp/EnMicroMsg.db",
+        hasWechatDataPath: true,
+        chosenKeyProvider: "md5",
+        registeredAt: 1716280000000,
+        lastSyncAt: null,
+      },
+    ]),
+    unregisterWechatAdapter: vi.fn(async (uin) => {
+      if (!uin) return { ok: false, reason: "UIN_REQUIRED" };
+      return { ok: true, removed: uin === "1234567890", uin, ...overrides.unregister };
+    }),
+  };
+}
+
+beforeEach(() => {
+  logSpy = vi.spyOn(console, "log").mockImplementation(() => {});
+  errSpy = vi.spyOn(console, "error").mockImplementation(() => {});
+  exitSpy = vi.spyOn(process, "exit").mockImplementation((_code) => {
+    throw new Error("process.exit called");
+  });
+});
+
+afterEach(() => {
+  logSpy.mockRestore();
+  errSpy.mockRestore();
+  exitSpy.mockRestore();
+});
+
+describe("cc hub wechat env-probe", () => {
+  it("prints human-readable summary by default", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatEnvProbe({ _getHub: async () => hub });
+    expect(hub.probeWechatEnv).toHaveBeenCalledOnce();
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/suggested.*md5/);
+    expect(out).toMatch(/device.*reachable.*DEVICE_A/);
+    expect(out).toMatch(/wechat.*7\.0\.22/);
+  });
+
+  it("--json prints raw probe shape", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatEnvProbe({ _getHub: async () => hub, json: true });
+    const out = logSpy.mock.calls.map((c) => c[0]).join("\n");
+    expect(JSON.parse(out)).toEqual(
+      expect.objectContaining({
+        suggestedKeyProvider: "md5",
+        device: expect.objectContaining({ reachable: true }),
+      }),
+    );
+  });
+});
+
+describe("cc hub wechat register", () => {
+  it("requires --uin (exits 1 via fail())", async () => {
+    const hub = fakeHub();
+    // With --json, fail() writes { error: "..." } to console.log; without
+    // --json, it writes a red ✗ to logger.error. We test both paths and
+    // assert at least one captured the missing-uin reason.
+    await expect(
+      _internal.cmdWechatRegister({ _getHub: async () => hub, json: true }),
+    ).rejects.toThrow(/process\.exit/);
+    const allOut =
+      logSpy.mock.calls.map((c) => c.map((p) => (typeof p === "string" ? p : JSON.stringify(p))).join(" ")).join("\n") +
+      "\n" +
+      errSpy.mock.calls.map((c) => c.map((p) => (typeof p === "string" ? p : JSON.stringify(p))).join(" ")).join("\n");
+    expect(allOut).toMatch(/--uin|uin/i);
+  });
+
+  it("forwards --uin / --db / --wechat-data-path / --force-provider to hub", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatRegister({
+      _getHub: async () => hub,
+      uin: "1234567890",
+      db: "/tmp/EnMicroMsg.db",
+      wechatDataPath: "/tmp/com.tencent.mm",
+      forceProvider: "md5",
+    });
+    const callArg = hub.registerWechatAdapter.mock.calls[0][0];
+    expect(callArg.account.uin).toBe("1234567890");
+    expect(callArg.dbPath).toBe("/tmp/EnMicroMsg.db");
+    expect(callArg.wechatDataPath).toBe("/tmp/com.tencent.mm");
+    expect(callArg.keyProviderOverride).toBe("md5");
+  });
+
+  it("forwards --frida-device-id into fridaOpts", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatRegister({
+      _getHub: async () => hub,
+      uin: "wxid_abc",
+      forceProvider: "frida",
+      fridaDeviceId: "EMU_X",
+    });
+    const callArg = hub.registerWechatAdapter.mock.calls[0][0];
+    expect(callArg.fridaOpts).toEqual({ deviceId: "EMU_X" });
+  });
+
+  it("prints provider + sensitivity on success", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatRegister({
+      _getHub: async () => hub,
+      uin: "1234567890",
+    });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/wechat registered.*1234567890/);
+    expect(out).toMatch(/provider.*md5/);
+    expect(out).toMatch(/sensitivity.*high/);
+  });
+
+  it("exits 1 and surfaces reason + probe.reasons on ENV_UNSUPPORTED", async () => {
+    const hub = fakeHub({
+      register: {
+        ok: false,
+        reason: "ENV_UNSUPPORTED",
+        message: "No root",
+        probe: { reasons: ["WeChat 8.0.50 needs root", "frida not running"] },
+      },
+    });
+    await expect(
+      _internal.cmdWechatRegister({
+        _getHub: async () => hub,
+        uin: "wxid_abc",
+      }),
+    ).rejects.toThrow(/process\.exit/);
+    const errOut = errSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(errOut).toMatch(/ENV_UNSUPPORTED/);
+    expect(errOut).toMatch(/needs root/);
+    expect(errOut).toMatch(/frida not running/);
+  });
+
+  it("--json prints raw register response without ANSI noise", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatRegister({
+      _getHub: async () => hub,
+      uin: "1234567890",
+      json: true,
+    });
+    const out = logSpy.mock.calls.map((c) => c[0]).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed.ok).toBe(true);
+    expect(parsed.chosenKeyProvider).toBe("md5");
+    expect(parsed.sensitivity).toBe("high");
+  });
+});
+
+describe("cc hub wechat list", () => {
+  it("prints account rows", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatList({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/uin=1234567890/);
+    expect(out).toMatch(/provider=md5/);
+  });
+
+  it("prints '(no registered)' when empty", async () => {
+    const hub = fakeHub({ list: [] });
+    await _internal.cmdWechatList({ _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/no registered/);
+  });
+
+  it("--json prints accounts array", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatList({ _getHub: async () => hub, json: true });
+    const out = logSpy.mock.calls.map((c) => c[0]).join("\n");
+    const parsed = JSON.parse(out);
+    expect(Array.isArray(parsed.accounts)).toBe(true);
+    expect(parsed.accounts[0].uin).toBe("1234567890");
+  });
+});
+
+describe("cc hub wechat unregister", () => {
+  it("calls hub with uin + reports removed", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatUnregister("1234567890", { _getHub: async () => hub });
+    expect(hub.unregisterWechatAdapter).toHaveBeenCalledWith("1234567890");
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/removed wechat account.*1234567890/);
+  });
+
+  it("reports nothing-removed for missing uin (still ok:true)", async () => {
+    const hub = fakeHub({ unregister: { removed: false } });
+    await _internal.cmdWechatUnregister("ghost", { _getHub: async () => hub });
+    const out = logSpy.mock.calls.map((c) => c.join(" ")).join("\n");
+    expect(out).toMatch(/was not registered/);
+  });
+
+  it("--json prints raw response", async () => {
+    const hub = fakeHub();
+    await _internal.cmdWechatUnregister("1234567890", {
+      _getHub: async () => hub,
+      json: true,
+    });
+    const out = logSpy.mock.calls.map((c) => c[0]).join("\n");
+    const parsed = JSON.parse(out);
+    expect(parsed).toEqual(expect.objectContaining({ ok: true, removed: true, uin: "1234567890" }));
+  });
+});

package/src/commands/android.js

@@ -0,0 +1,284 @@
+/**
+ * `cc android` — Android-side data + control commands.
+ *
+ * Plan A Sub-Phase A7 scaffold. Exposes the bridge surface from
+ * `lib/cc-android-bridge.js` as commander subcommands. Method shapes mirror
+ * `docs/design/Personal_Data_Hub_Android_Standalone_Cc.md` §6.1.
+ *
+ * **v0.1 status**: native JNI bridge (`cc-android-bridge.node`) not yet
+ * bundled (A6 in progress). On non-Android hosts every command exits non-zero
+ * with `ANDROID_BRIDGE_NOT_AVAILABLE`. On Android with a missing binding,
+ * same error with a different reason string. This lets the surface land and
+ * be tested ahead of the JNI shipping work.
+ *
+ * All commands support `--json` for scripting and exit non-zero on error.
+ */
+
+import chalk from "chalk";
+import { logger } from "../lib/logger.js";
+import * as bridgeModule from "../lib/cc-android-bridge.js";
+
+function printJson(obj) {
+  console.log(JSON.stringify(obj, null, 2));
+}
+
+function fail(err, asJson) {
+  const msg = err && err.message ? err.message : String(err);
+  const code = err && err.code ? err.code : null;
+  if (asJson) {
+    printJson({ error: msg, code });
+  } else {
+    logger.error(chalk.red(`✗ ${msg}`));
+  }
+  process.exit(1);
+}
+
+async function run(method, params, options) {
+  try {
+    const result = await _deps.bridge.invoke(method, params);
+    if (options.json) {
+      printJson(result);
+    } else {
+      console.log(JSON.stringify(result, null, 2));
+    }
+  } catch (err) {
+    fail(err, options.json);
+  }
+}
+
+// ─── caps ────────────────────────────────────────────────────────────
+
+async function cmdCaps(options) {
+  const capsResult = _deps.bridge.caps();
+  if (options.json) {
+    printJson(capsResult);
+    return;
+  }
+  if (capsResult.available) {
+    logger.log(chalk.green("✓ android bridge available"));
+  } else {
+    logger.log(
+      chalk.yellow(`⚠ android bridge unavailable: ${capsResult.reason}`),
+    );
+  }
+}
+
+// ─── contacts / sms / calls — P1 ContentResolver ─────────────────────
+
+function cmdContactsPull(options) {
+  return run(
+    "contacts.query",
+    { since: options.since ? Number(options.since) : undefined },
+    options,
+  );
+}
+function cmdSmsPull(options) {
+  return run(
+    "sms.query",
+    { since: options.since ? Number(options.since) : undefined },
+    options,
+  );
+}
+function cmdCallsPull(options) {
+  return run(
+    "calls.query",
+    { since: options.since ? Number(options.since) : undefined },
+    options,
+  );
+}
+
+// ─── app — PackageManager ────────────────────────────────────────────
+
+function cmdAppList(options) {
+  return run("app.list", { includeSystem: !!options.system }, options);
+}
+function cmdAppLaunch(pkg, options) {
+  return run("app.launch", { pkg }, options);
+}
+function cmdAppIntent(pkg, action, options) {
+  const extras = {};
+  if (Array.isArray(options.extra)) {
+    for (const kv of options.extra) {
+      const idx = kv.indexOf("=");
+      if (idx > 0) extras[kv.slice(0, idx)] = kv.slice(idx + 1);
+    }
+  }
+  return run("app.intent", { pkg, action, extras }, options);
+}
+
+// ─── fs — SAF / sandbox ──────────────────────────────────────────────
+
+function cmdFsRead(target, options) {
+  return run("fs.read", { target }, options);
+}
+function cmdFsList(target, options) {
+  return run("fs.list", { target }, options);
+}
+
+// ─── a11y — Accessibility Service ────────────────────────────────────
+
+function cmdA11yQuery(options) {
+  return run("a11y.query", { filter: options.filter }, options);
+}
+function cmdA11yClick(nodeId, options) {
+  return run("a11y.click", { nodeId }, options);
+}
+function cmdA11yType(text, options) {
+  return run("a11y.type", { text }, options);
+}
+
+// ─── shizuku / root ──────────────────────────────────────────────────
+
+function cmdShizukuExec(cmd, options) {
+  return run("shizuku.exec", { cmd }, options);
+}
+function cmdRootExec(cmd, options) {
+  return run("root.exec", { cmd }, options);
+}
+
+// ─── perms ────────────────────────────────────────────────────────────
+
+function cmdPerms(name, options) {
+  return run("perms.check", { name }, options);
+}
+
+// ─── Commander wire-up ───────────────────────────────────────────────
+
+export function registerAndroidCommand(program) {
+  const android = program
+    .command("android")
+    .description(
+      "Android-native bridge: ContentResolver / SAF / Accessibility / Shizuku / root (Plan A A7)",
+    );
+
+  android
+    .command("caps")
+    .description("Probe what bridge capabilities are available on this device")
+    .option("--json", "Output JSON")
+    .action(cmdCaps);
+
+  const contacts = android
+    .command("contacts")
+    .description("ContentResolver: contacts");
+  contacts
+    .command("pull")
+    .description("Pull contacts (READ_CONTACTS runtime permission required)")
+    .option("--since <ms>", "Watermark — only newer entries")
+    .option("--json", "Output JSON")
+    .action(cmdContactsPull);
+
+  const sms = android.command("sms").description("ContentResolver: SMS");
+  sms
+    .command("pull")
+    .description("Pull SMS (READ_SMS runtime permission required)")
+    .option("--since <ms>", "Watermark")
+    .option("--json", "Output JSON")
+    .action(cmdSmsPull);
+
+  const calls = android
+    .command("calls")
+    .description("ContentResolver: call log");
+  calls
+    .command("pull")
+    .description("Pull call log (READ_CALL_LOG runtime permission required)")
+    .option("--since <ms>", "Watermark")
+    .option("--json", "Output JSON")
+    .action(cmdCallsPull);
+
+  const app = android
+    .command("app")
+    .description("PackageManager: app inventory + Intent");
+  app
+    .command("list")
+    .description("List installed packages")
+    .option("--system", "Include system packages")
+    .option("--json", "Output JSON")
+    .action(cmdAppList);
+  app
+    .command("launch <pkg>")
+    .description("Launch app by package id (default activity)")
+    .option("--json", "Output JSON")
+    .action(cmdAppLaunch);
+  app
+    .command("intent <pkg> <action>")
+    .description("Fire an Intent at <pkg> with <action>")
+    .option(
+      "--extra <kv...>",
+      "Repeatable extras as KEY=VAL (e.g. --extra foo=bar --extra n=1)",
+    )
+    .option("--json", "Output JSON")
+    .action(cmdAppIntent);
+
+  const fs = android.command("fs").description("SAF / sandbox filesystem");
+  fs.command("read <target>")
+    .description("Read file (sandbox path OR SAF tree URI)")
+    .option("--json", "Output JSON")
+    .action(cmdFsRead);
+  fs.command("list <target>")
+    .description("List directory")
+    .option("--json", "Output JSON")
+    .action(cmdFsList);
+
+  const a11y = android.command("a11y").description("Accessibility Service");
+  a11y
+    .command("query")
+    .description("Dump current screen's node tree")
+    .option("--filter <css>", "css-like filter")
+    .option("--json", "Output JSON")
+    .action(cmdA11yQuery);
+  a11y
+    .command("click <nodeId>")
+    .description("Click a node")
+    .option("--json", "Output JSON")
+    .action(cmdA11yClick);
+  a11y
+    .command("type <text>")
+    .description("Type text into focused field")
+    .option("--json", "Output JSON")
+    .action(cmdA11yType);
+
+  const shizuku = android
+    .command("shizuku")
+    .description("Shizuku ADB-like privileges");
+  shizuku
+    .command("exec <cmd>")
+    .description("Run shell via Shizuku")
+    .option("--json", "Output JSON")
+    .action(cmdShizukuExec);
+
+  const root = android.command("root").description("Magisk root su");
+  root
+    .command("exec <cmd>")
+    .description("Run shell as root")
+    .option("--json", "Output JSON")
+    .action(cmdRootExec);
+
+  android
+    .command("perms <name>")
+    .description("Check (and request) a runtime permission")
+    .option("--json", "Output JSON")
+    .action(cmdPerms);
+}
+
+// _deps injection seam — tests reach in and replace `bridge` with a mock so
+// the cmd* functions exercise the routing code without a real bridge.
+export const _deps = { bridge: bridgeModule };
+
+// Test-only exports.
+export const _cmds = {
+  cmdCaps,
+  cmdContactsPull,
+  cmdSmsPull,
+  cmdCallsPull,
+  cmdAppList,
+  cmdAppLaunch,
+  cmdAppIntent,
+  cmdFsRead,
+  cmdFsList,
+  cmdA11yQuery,
+  cmdA11yClick,
+  cmdA11yType,
+  cmdShizukuExec,
+  cmdRootExec,
+  cmdPerms,
+};