@chainlesschain/personal-data-hub 0.4.28 → 0.4.30

package/__tests__/adapters/git-activity.test.js

@@ -1,222 +0,0 @@
-"use strict";
-
-import { describe, it, expect, beforeEach, afterEach, vi } from "vitest";
-import { mkdtempSync, rmSync, mkdirSync, writeFileSync } from "node:fs";
-import { join } from "node:path";
-import { tmpdir } from "node:os";
-import { execFileSync } from "node:child_process";
-
-// Every test here spawns real `git` (init/config/commit) across throwaway
-// repos. On Windows, under the full-suite parallel worker pool, that subprocess
-// fan-out routinely blows past the 10s default and flakes. Give the whole file
-// generous headroom — the work is real, the default timeout is just too tight.
-vi.setConfig({ testTimeout: 30000, hookTimeout: 30000 });
-
-const {
-  GitActivityAdapter,
-  GIT_ACTIVITY_NAME,
-  GIT_ACTIVITY_VERSION,
-} = require("../../lib/adapters/git-activity");
-const { assertAdapter } = require("../../lib/adapter-spec");
-const { EVENT_SUBTYPES } = require("../../lib/constants");
-const { validateEvent } = require("../../lib/schemas");
-
-let tmpDir;
-let codeRoot;
-
-// Anchor fixtures to "now - 1h" so the default --since=180.days filter
-// never drops them. Bumping the literal in one place avoids drift if the
-// adapter's default window changes.
-const FIXTURE_NOW = Date.now();
-function ts(offsetSec = 0) {
-  return FIXTURE_NOW - 3_600_000 + offsetSec * 1000;
-}
-
-// Build a single throwaway repo with N commits — each committed with
-// GIT_AUTHOR_DATE so the timestamps are deterministic.
-function makeRepo(name, commits) {
-  const dir = join(codeRoot, name);
-  mkdirSync(dir, { recursive: true });
-  const G = (args, env = {}) =>
-    execFileSync("git", ["-C", dir, ...args], {
-      encoding: "utf-8",
-      env: {
-        ...process.env,
-        GIT_CONFIG_NOSYSTEM: "1",
-        ...env,
-      },
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-  G(["init", "-q", "-b", "main"]);
-  G(["config", "user.email", "test@example.com"]);
-  G(["config", "user.name", "Test"]);
-  G(["config", "commit.gpgsign", "false"]);
-  let i = 0;
-  for (const c of commits) {
-    const file = join(dir, `f${i}.txt`);
-    writeFileSync(file, `content ${i}\n`, "utf-8");
-    G(["add", "."]);
-    const dt = new Date(c.tsMs).toISOString();
-    G(["commit", "-m", c.subject, "--author", `${c.author || "Test User"} <test@example.com>`], {
-      GIT_AUTHOR_DATE: dt,
-      GIT_COMMITTER_DATE: dt,
-    });
-    i++;
-  }
-  return dir;
-}
-
-beforeEach(() => {
-  tmpDir = mkdtempSync(join(tmpdir(), "git-act-test-"));
-  codeRoot = join(tmpDir, "code");
-  mkdirSync(codeRoot, { recursive: true });
-});
-
-afterEach(() => {
-  rmSync(tmpDir, { recursive: true, force: true });
-});
-
-describe("GitActivityAdapter — contract + identity", () => {
-  it("conforms to PersonalDataAdapter contract", () => {
-    expect(assertAdapter(new GitActivityAdapter())).toEqual({ ok: true });
-  });
-
-  it("identifies as git-activity with sync:git-log-local capability", () => {
-    const a = new GitActivityAdapter();
-    expect(a.name).toBe(GIT_ACTIVITY_NAME);
-    expect(a.name).toBe("git-activity");
-    expect(a.version).toBe(GIT_ACTIVITY_VERSION);
-    expect(a.capabilities).toContain("sync:git-log-local");
-  });
-});
-
-describe("GitActivityAdapter.authenticate", () => {
-  it("NO_GIT_REPOS when codeRoot empty", async () => {
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const r = await a.authenticate({});
-    expect(r.ok).toBe(false);
-    expect(r.reason).toBe("NO_GIT_REPOS");
-  });
-
-  it("ok when at least one repo exists", async () => {
-    makeRepo("a", [{ subject: "init", tsMs: ts(0) }]);
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const r = await a.authenticate({});
-    expect(r.ok).toBe(true);
-    expect(r.repoCount).toBe(1);
-  });
-});
-
-describe("GitActivityAdapter.sync", () => {
-  it("yields commits with author+subject+ts, originalId stable across syncs", async () => {
-    makeRepo("a", [
-      { subject: "first commit", tsMs: ts(1), author: "Alice" },
-      { subject: "second commit", tsMs: ts(2), author: "Alice" },
-    ]);
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const raws1 = [];
-    for await (const r of a.sync()) raws1.push(r);
-    expect(raws1).toHaveLength(2);
-    expect(raws1[0].payload.subject).toBeTruthy();
-    expect(raws1[0].payload.authorName).toBe("Alice");
-    expect(raws1[0].payload.repoName).toBe("a");
-    expect(raws1[0].originalId).toMatch(/^git-commit:/);
-    // Re-sync — originalIds should match (idempotent)
-    const raws2 = [];
-    for await (const r of a.sync()) raws2.push(r);
-    const ids1 = raws1.map((r) => r.originalId).sort();
-    const ids2 = raws2.map((r) => r.originalId).sort();
-    expect(ids2).toEqual(ids1);
-  });
-
-  it("multi-repo: enumerates every .git dir under the root", async () => {
-    makeRepo("repo-a", [{ subject: "a1", tsMs: ts(1) }]);
-    makeRepo("repo-b", [{ subject: "b1", tsMs: ts(2) }]);
-    makeRepo("repo-c", [{ subject: "c1", tsMs: ts(3) }]);
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const raws = [];
-    for await (const r of a.sync()) raws.push(r);
-    const repoNames = new Set(raws.map((r) => r.payload.repoName));
-    expect(repoNames).toEqual(new Set(["repo-a", "repo-b", "repo-c"]));
-  });
-
-  it("respects limit", async () => {
-    makeRepo("a", [
-      { subject: "1", tsMs: ts(1) },
-      { subject: "2", tsMs: ts(2) },
-      { subject: "3", tsMs: ts(3) },
-    ]);
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const raws = [];
-    for await (const r of a.sync({ limit: 2 })) raws.push(r);
-    expect(raws).toHaveLength(2);
-  });
-
-  it("skips non-.git directories silently", async () => {
-    makeRepo("real-repo", [{ subject: "x", tsMs: ts(1) }]);
-    mkdirSync(join(codeRoot, "not-a-repo"), { recursive: true });
-    writeFileSync(join(codeRoot, "not-a-repo", "README.md"), "no .git here", "utf-8");
-    const a = new GitActivityAdapter({ codeRoots: [codeRoot] });
-    const raws = [];
-    for await (const r of a.sync()) raws.push(r);
-    expect(raws).toHaveLength(1);
-    expect(raws[0].payload.repoName).toBe("real-repo");
-  });
-});
-
-describe("GitActivityAdapter.normalize", () => {
-  it("maps commit → schema-valid Event(OTHER) with author as actor", () => {
-    const a = new GitActivityAdapter();
-    const { events } = a.normalize({
-      kind: "commit",
-      originalId: "git-commit:/code/foo:abc",
-      capturedAt: 1_700_000_005_000,
-      payload: {
-        sha: "abcdef0123456789",
-        shortSha: "abcdef01",
-        authoredAtMs: 1_700_000_001_000,
-        authorName: "Alice",
-        authorEmail: "alice@example.com",
-        subject: "Fix the bug",
-        repoDir: "/code/foo",
-        repoName: "foo",
-      },
-    });
-    expect(events).toHaveLength(1);
-    const e = events[0];
-    expect(e.subtype).toBe(EVENT_SUBTYPES.OTHER);
-    expect(e.actor).toBe("Alice");
-    expect(e.content.title).toBe("Fix the bug");
-    expect(e.occurredAt).toBe(1_700_000_001_000);
-    expect(e.extra.repoName).toBe("foo");
-    expect(e.extra.sha).toBe("abcdef0123456789");
-    expect(validateEvent(e).valid).toBe(true);
-  });
-
-  it("truncates long commit subjects to 100 chars in title", () => {
-    const a = new GitActivityAdapter();
-    const longSubj = "x".repeat(200);
-    const { events } = a.normalize({
-      kind: "commit",
-      capturedAt: 1_700_000_000_000,
-      originalId: "git-commit:foo:long",
-      payload: {
-        sha: "deadbeef",
-        shortSha: "deadbeef",
-        authoredAtMs: 1_700_000_000_000,
-        subject: longSubj,
-        authorName: "X",
-        repoName: "r",
-      },
-    });
-    expect(events[0].content.title.length).toBeLessThanOrEqual(101);
-    expect(events[0].content.title.endsWith("…")).toBe(true);
-    expect(events[0].content.text).toBe(longSubj);
-  });
-
-  it("throws on unknown raw.kind", () => {
-    expect(() => new GitActivityAdapter().normalize({ kind: "bogus" })).toThrow(
-      /unknown raw\.kind=bogus/,
-    );
-  });
-});

package/__tests__/adapters/gov-12123.test.js

@@ -1,103 +0,0 @@
-"use strict";
-
-import { describe, it, expect } from "vitest";
-const fs = require("node:fs");
-const path = require("node:path");
-const os = require("node:os");
-const crypto = require("node:crypto");
-
-const g = require("../../lib/adapters/gov-12123");
-
-function writeTmp(content) {
-  const p = path.join(os.tmpdir(), `cc-12123-${crypto.randomUUID()}.json`);
-  fs.writeFileSync(p, content, "utf-8");
-  return p;
-}
-async function collect(gen) {
-  const out = [];
-  for await (const x of gen) out.push(x);
-  return out;
-}
-const COOKIES = "GAB_SSO=abc";
-
-describe("gov-12123", () => {
-  it("name + mappers (chinese-field aliases)", () => {
-    expect(g.NAME).toBe("gov-12123");
-    const v = g.mapViolation({ wzbh: "V1", wfsj: 1716383000, wfdz: "环岛路", wfxw: "超速50%以下", fkje: "200", wfjfs: "3" });
-    expect(v).toMatchObject({ violationId: "V1", location: "环岛路", reason: "超速50%以下" });
-    expect(v.fine).toBe(200);
-    expect(v.points).toBe(3);
-    expect(g.mapViolation({ wfxw: "x" })).toBe(null);
-    const l = g.mapLicense({ dabh: "L1", zt: "正常", ljjf: 3, yxqz: 1900000000 });
-    expect(l).toMatchObject({ licenseId: "L1", status: "正常", cumulativePoints: 3 });
-    expect(g.mapLicense({ zt: "x" })).toBe(null);
-  });
-  it("extractLicense wraps single object", () => {
-    expect(g.extractLicense({ data: { dabh: "L1" } })).toHaveLength(1);
-    expect(g.extractLicense({ licenseId: "L2" })).toHaveLength(1);
-    expect(g.extractLicense({ list: [{ dabh: "L3" }] })).toHaveLength(1);
-  });
-
-  it("snapshot → violation + license OTHER events", async () => {
-    const SNAP = JSON.stringify({
-      schemaVersion: 1,
-      snapshottedAt: 1716383000000,
-      account: { userId: "u1" },
-      events: [
-        { kind: "violation", id: "v-V1", violationId: "V1", time: 1716383000, location: "环岛路", reason: "超速", fine: 200, points: 3 },
-        { kind: "license", id: "l-L1", licenseId: "L1", status: "正常", cumulativePoints: 3, validUntil: 1900000000 },
-      ],
-    });
-    const p = writeTmp(SNAP);
-    try {
-      const a = new g.Tmri12123Adapter();
-      const items = await collect(a.sync({ inputPath: p }));
-      expect(items).toHaveLength(2);
-      const v = a.normalize(items[0]);
-      expect(v.events[0].subtype).toBe("other");
-      expect(v.events[0].content.title).toContain("交通违章");
-      expect(v.events[0].extra.fine).toBe(200);
-      expect(v.events[0].extra.points).toBe(3);
-      expect(items[0].originalId).toBe("12123:violation:V1");
-      const l = a.normalize(items[1]);
-      expect(l.events[0].content.title).toContain("驾驶证状态");
-      expect(l.events[0].extra.cumulativePoints).toBe(3);
-      expect(items[1].originalId).toBe("12123:license:L1");
-    } finally {
-      fs.unlinkSync(p);
-    }
-  });
-
-  it("cookie-api: paginated violations + single license + unverified", async () => {
-    const a = new g.Tmri12123Adapter({
-      account: { cookies: COOKIES, userId: "u1" },
-      fetchFn: async ({ url, query }) => {
-        if (url.includes("/violation")) return query.page > 1 ? { list: [] } : { list: [{ wzbh: "V9", wfsj: 1716383000, wfxw: "闯红灯", fkje: 200, wfjfs: 6 }] };
-        return { data: { dabh: "L9", zt: "正常", ljjf: 6 } };
-      },
-    });
-    expect(await a.authenticate()).toMatchObject({ ok: true, mode: "cookie", unverified: true });
-    const items = await collect(a.sync({}));
-    expect(items).toHaveLength(2);
-    expect(items.map((i) => i.originalId).sort()).toEqual(["12123:license:L9", "12123:violation:V9"]);
-  });
-
-  it("province base host (verified .122.gov.cn/app); override + default", () => {
-    // default province bj
-    const a = new g.Tmri12123Adapter({ province: "fj" });
-    expect(a.province).toBe("fj");
-    expect(a._urls.violation).toBe("https://fj.122.gov.cn/app/violation/list");
-    expect(a._urls.license).toBe("https://fj.122.gov.cn/app/license/info");
-    // bad province → default bj
-    expect(new g.Tmri12123Adapter({ province: "XX" })._urls.violation).toBe("https://bj.122.gov.cn/app/violation/list");
-    // explicit url override still wins
-    expect(new g.Tmri12123Adapter({ violationUrl: "https://x/y" })._urls.violation).toBe("https://x/y");
-  });
-
-  it("high sensitivity + legalGate; default fetch / no input throw", async () => {
-    expect(new g.Tmri12123Adapter().dataDisclosure.sensitivity).toBe("high");
-    expect(new g.Tmri12123Adapter().dataDisclosure.legalGate).toBe(true);
-    await expect(collect(new g.Tmri12123Adapter({ account: { cookies: COOKIES } }).sync({}))).rejects.toThrow(/no fetchFn/);
-    await expect(collect(new g.Tmri12123Adapter().sync({}))).rejects.toThrow(/needs opts.inputPath/);
-  });
-});

package/__tests__/adapters/gov-ixiamen.test.js

@@ -1,150 +0,0 @@
-"use strict";
-
-import { describe, it, expect } from "vitest";
-const fs = require("node:fs");
-const path = require("node:path");
-const os = require("node:os");
-const crypto = require("node:crypto");
-
-const ix = require("../../lib/adapters/gov-ixiamen");
-
-function writeTmp(content) {
-  const p = path.join(os.tmpdir(), `cc-ix-${crypto.randomUUID()}.json`);
-  fs.writeFileSync(p, content, "utf-8");
-  return p;
-}
-async function collect(gen) {
-  const out = [];
-  for await (const x of gen) out.push(x);
-  return out;
-}
-
-const COOKIES = "XMGOV_SSO=abc; tgc=xyz";
-
-describe("gov-ixiamen mappers", () => {
-  it("name/version/capabilities", () => {
-    expect(ix.NAME).toBe("gov-ixiamen");
-    expect(ix.VERSION).toBe("0.2.0");
-  });
-  it("inferCategory: explicit wins, else keyword, else fallback", () => {
-    expect(ix.inferCategory("随便", "医保")).toBe("医保");
-    expect(ix.inferCategory("城乡居民医保缴费")).toBe("医保");
-    expect(ix.inferCategory("住房公积金提取")).toBe("公积金");
-    expect(ix.inferCategory("机动车违章处理")).toBe("车驾管");
-    expect(ix.inferCategory("某个没见过的事项")).toBe("其他政务");
-  });
-  it("mapService maps gov-service fields; no id → null", () => {
-    const rec = ix.mapService({
-      service_id: "S1",
-      service_name: "养老保险待遇资格认证",
-      handle_time: 1716383000,
-      status: "已办结",
-      deptName: "厦门市社保中心",
-    });
-    expect(rec).toMatchObject({ serviceId: "S1", category: "社保", status: "已办结", dept: "厦门市社保中心" });
-    expect(rec.handledMs).toBe(1716383000000);
-    expect(ix.mapService({ service_name: "noid" })).toBe(null);
-  });
-  it("extractList tolerant", () => {
-    expect(ix.extractList({ list: [{ id: 1 }] })).toHaveLength(1);
-    expect(ix.extractList({ data: { records: [{ id: 1 }] } })).toHaveLength(1);
-    expect(ix.extractList({})).toEqual([]);
-  });
-});
-
-describe("IXiamenAdapter (snapshot + cookie-api)", () => {
-  const SNAP = JSON.stringify({
-    schemaVersion: 1,
-    snapshottedAt: 1716383000000,
-    account: { userId: "u1", name: "张三" },
-    events: [
-      {
-        kind: "service",
-        id: "svc-S1",
-        serviceId: "S1",
-        serviceName: "住房公积金缴存明细查询",
-        handledTime: 1716383000,
-        status: "已办结",
-        dept: "厦门住房公积金中心",
-      },
-    ],
-  });
-
-  it("snapshot sync + normalize → INTERACTION event + category topic", async () => {
-    const p = writeTmp(SNAP);
-    try {
-      const a = new ix.IXiamenAdapter();
-      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
-      const items = await collect(a.sync({ inputPath: p }));
-      expect(items).toHaveLength(1);
-      expect(items[0].originalId).toBe("ixiamen:service:S1");
-      const batch = a.normalize(items[0]);
-      expect(batch.events[0].subtype).toBe("interaction");
-      expect(batch.events[0].content.title).toBe("办理: 住房公积金缴存明细查询");
-      expect(batch.events[0].extra.category).toBe("公积金");
-      expect(batch.topics[0].name).toBe("公积金");
-      expect(batch.topics[0].id).toBe("topic-ixiamen-cat-公积金");
-      expect(batch.events[0].extra.topicRef).toBe("topic-ixiamen-cat-公积金");
-    } finally {
-      fs.unlinkSync(p);
-    }
-  });
-
-  it("dataDisclosure: high sensitivity + legalGate (gov real-name)", () => {
-    const a = new ix.IXiamenAdapter();
-    expect(a.dataDisclosure.sensitivity).toBe("high");
-    expect(a.dataDisclosure.legalGate).toBe(true);
-  });
-
-  it("cookie-api: best-effort fetch + paginate + unverified flag", async () => {
-    const pages = [
-      { list: [{ id: 7, name: "门诊报销", category: "医保", handledTime: 1716383000 }] },
-      { list: [] },
-    ];
-    const calls = [];
-    const a = new ix.IXiamenAdapter({
-      account: { cookies: COOKIES, userId: "u1" },
-      fetchFn: async ({ url, cookies, query, sign }) => {
-        calls.push({ url, cookies, page: query.page, sign });
-        return query.page === 1 ? pages[0] : pages[1];
-      },
-    });
-    const auth = await a.authenticate();
-    expect(auth).toMatchObject({ ok: true, mode: "cookie", unverified: true });
-    const items = await collect(a.sync({}));
-    expect(items).toHaveLength(1);
-    expect(items[0].originalId).toBe("ixiamen:service:7");
-    expect(calls[0].cookies).toBe(COOKIES);
-    expect(calls[0].sign).toBe(null);
-    const batch = a.normalize(items[0]);
-    expect(batch.events[0].extra.category).toBe("医保");
-  });
-
-  it("cookie-api: signProvider seam invoked + sinceWatermark stops early", async () => {
-    let seen = null;
-    const a = new ix.IXiamenAdapter({
-      account: { cookies: COOKIES },
-      signProvider: async ({ url, query }) => {
-        seen = { url, page: query.page };
-        return "gov-sig";
-      },
-      fetchFn: async () => ({
-        list: [
-          { id: "new", name: "新事项", handledTime: 1716390000 },
-          { id: "old", name: "旧事项", handledTime: 1700000000 },
-        ],
-      }),
-    });
-    const items = await collect(a.sync({ sinceWatermark: 1716000000000 }));
-    expect(items).toHaveLength(1); // old one below watermark stops iteration
-    expect(items[0].originalId).toBe("ixiamen:service:new");
-    expect(seen.url).toContain("buss.ixiamen.org.cn");
-  });
-
-  it("default fetch throws; no input throws", async () => {
-    const a = new ix.IXiamenAdapter({ account: { cookies: COOKIES } });
-    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
-    const b = new ix.IXiamenAdapter();
-    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
-  });
-});

package/__tests__/adapters/gov-tax.test.js

@@ -1,135 +0,0 @@
-"use strict";
-
-import { describe, it, expect } from "vitest";
-const fs = require("node:fs");
-const path = require("node:path");
-const os = require("node:os");
-const crypto = require("node:crypto");
-
-const tx = require("../../lib/adapters/gov-tax");
-
-function writeTmp(content) {
-  const p = path.join(os.tmpdir(), `cc-tax-${crypto.randomUUID()}.json`);
-  fs.writeFileSync(p, content, "utf-8");
-  return p;
-}
-async function collect(gen) {
-  const out = [];
-  for await (const x of gen) out.push(x);
-  return out;
-}
-
-const COOKIES = "ETAX_SSO=abc; sid=xyz";
-
-describe("gov-tax mappers", () => {
-  it("name/version", () => {
-    expect(tx.NAME).toBe("gov-tax");
-    expect(tx.VERSION).toBe("0.1.0");
-  });
-  it("periodToMs / toAmount", () => {
-    expect(tx.periodToMs("2025-03")).toBe(Date.parse("2025-03-01T00:00:00Z"));
-    expect(tx.periodToMs("202503")).toBe(Date.parse("2025-03-01T00:00:00Z"));
-    expect(tx.toAmount("¥1,234.56")).toBeCloseTo(1234.56, 2);
-    expect(tx.toAmount(2000)).toBe(2000);
-    expect(tx.toAmount("abc")).toBe(null);
-  });
-  it("mapIncome / mapDeclaration field aliases; no id → null", () => {
-    const inc = tx.mapIncome({ record_id: "I1", tax_period: "2025-03", income_type: "工资薪金", amount: "20,000", withheldTax: 1234.56, company: "某某公司", companyId: "9144" });
-    expect(inc).toMatchObject({ recordId: "I1", incomeType: "工资薪金", payerName: "某某公司", payerId: "9144" });
-    expect(inc.amount).toBe(20000);
-    expect(inc.withheld).toBeCloseTo(1234.56, 2);
-    expect(tx.mapIncome({ amount: 1 })).toBe(null);
-    const dec = tx.mapDeclaration({ id: "D1", tax_year: 2024, type: "综合所得年度汇算", status: "已退税", amount: -800 });
-    expect(dec).toMatchObject({ recordId: "D1", year: 2024, declType: "综合所得年度汇算", status: "已退税", settleAmount: -800 });
-    expect(tx.mapDeclaration({ year: 2024 })).toBe(null);
-  });
-  it("extractList tolerant", () => {
-    expect(tx.extractList({ list: [{ id: 1 }] })).toHaveLength(1);
-    expect(tx.extractList({ data: { records: [{ id: 1 }] } })).toHaveLength(1);
-    expect(tx.extractList({})).toEqual([]);
-  });
-});
-
-describe("TaxAdapter (snapshot + cookie-api)", () => {
-  const SNAP = JSON.stringify({
-    schemaVersion: 1,
-    snapshottedAt: 1716383000000,
-    account: { userId: "u1" },
-    events: [
-      { kind: "income", id: "inc-I1", recordId: "I1", period: "2025-03", incomeType: "工资薪金", amount: 20000, withheld: 1234.56, payerName: "某某科技有限公司", payerId: "9144ABC" },
-      { kind: "declaration", id: "dec-D1", recordId: "D1", year: 2024, declType: "综合所得年度汇算", status: "已退税", settleAmount: -800, declaredAt: 1716383000 },
-    ],
-  });
-
-  it("income → INCOME event + employer Person(MERCHANT)", async () => {
-    const p = writeTmp(SNAP);
-    try {
-      const a = new tx.TaxAdapter();
-      expect((await a.authenticate({ inputPath: p })).mode).toBe("snapshot-file");
-      const items = await collect(a.sync({ inputPath: p }));
-      expect(items).toHaveLength(2);
-      const inc = a.normalize(items[0]);
-      expect(inc.events[0].subtype).toBe("income");
-      expect(inc.events[0].extra.incomeType).toBe("工资薪金");
-      expect(inc.events[0].extra.amount).toBe(20000);
-      expect(inc.persons).toHaveLength(1);
-      expect(inc.persons[0].subtype).toBe("merchant");
-      expect(inc.persons[0].names[0]).toBe("某某科技有限公司");
-      expect(inc.events[0].extra.payerRef).toBe(inc.persons[0].id);
-      expect(items[0].originalId).toBe("tax:income:I1");
-    } finally {
-      fs.unlinkSync(p);
-    }
-  });
-
-  it("declaration → OTHER event with settleAmount", async () => {
-    const p = writeTmp(SNAP);
-    try {
-      const a = new tx.TaxAdapter();
-      const items = await collect(a.sync({ inputPath: p }));
-      const dec = a.normalize(items[1]);
-      expect(dec.events[0].subtype).toBe("other");
-      expect(dec.events[0].content.title).toContain("个税申报");
-      expect(dec.events[0].extra.settleAmount).toBe(-800);
-      expect(dec.events[0].extra.year).toBe(2024);
-      expect(items[1].originalId).toBe("tax:declaration:D1");
-    } finally {
-      fs.unlinkSync(p);
-    }
-  });
-
-  it("dataDisclosure: high sensitivity + legalGate (financial/tax)", () => {
-    const a = new tx.TaxAdapter();
-    expect(a.dataDisclosure.sensitivity).toBe("high");
-    expect(a.dataDisclosure.legalGate).toBe(true);
-  });
-
-  it("cookie-api: best-effort both kinds + unverified flag + sign seam", async () => {
-    let signed = 0;
-    const a = new tx.TaxAdapter({
-      account: { cookies: COOKIES, userId: "u1" },
-      signProvider: async () => {
-        signed += 1;
-        return "sig";
-      },
-      fetchFn: async ({ url, query }) => {
-        if (query.page > 1) return { list: [] };
-        if (url.includes("/income")) return { list: [{ recordId: "I9", period: "2025-01", incomeType: "劳务报酬", amount: 5000 }] };
-        return { list: [{ recordId: "D9", year: 2024, declType: "年度汇算", settleAmount: 300 }] };
-      },
-    });
-    const auth = await a.authenticate();
-    expect(auth).toMatchObject({ ok: true, mode: "cookie", unverified: true });
-    const items = await collect(a.sync({}));
-    expect(items).toHaveLength(2);
-    expect(items.map((i) => i.originalId).sort()).toEqual(["tax:declaration:D9", "tax:income:I9"]);
-    expect(signed).toBeGreaterThan(0);
-  });
-
-  it("default fetch throws; no input throws", async () => {
-    const a = new tx.TaxAdapter({ account: { cookies: COOKIES } });
-    await expect(collect(a.sync({}))).rejects.toThrow(/no fetchFn configured/);
-    const b = new tx.TaxAdapter();
-    await expect(collect(b.sync({}))).rejects.toThrow(/needs opts.inputPath/);
-  });
-});