@chainlesschain/personal-data-hub 0.4.29 → 0.4.30

package/__tests__/whatsapp-adapter.test.js

@@ -1,138 +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 { WhatsAppAdapter } = require("../lib");
-const { assertAdapter } = require("../lib/adapter-spec");
-const { validateBatch } = require("../lib/batch");
-
-function makeMockDriver(scriptedRows) {
-  return function () {
-    return {
-      prepare(sql) {
-        return {
-          all() {
-            for (const [matchSubstr, rows] of scriptedRows) {
-              if (sql.includes(matchSubstr)) return rows;
-            }
-            throw new Error("no such table");
-          },
-        };
-      },
-      close() {},
-    };
-  };
-}
-
-function tmpDb() {
-  const dir = fs.mkdtempSync(path.join(os.tmpdir(), "wa-"));
-  const dbPath = path.join(dir, "msgstore.db");
-  fs.writeFileSync(dbPath, "fake");
-  return { dir, dbPath };
-}
-
-describe("WhatsAppAdapter", () => {
-  it("contract conformance", () => {
-    const a = new WhatsAppAdapter({ account: { phone: "13800001111" } });
-    expect(assertAdapter(a).ok).toBe(true);
-    expect(a.extractMode).toBe("device-pull");
-    expect(a.dataDisclosure.legalGate).toBe(true);
-  });
-
-  it("no-arg ctor passes contract (2026-05-25 v0.6 — account.phone OPTIONAL for snapshot mode)", () => {
-    const a = new WhatsAppAdapter();
-    expect(assertAdapter(a).ok).toBe(true);
-    expect(a.capabilities).toContain("sync:snapshot");
-    expect(a.capabilities).toContain("sync:sqlite");
-  });
-
-  it("authenticate fails without DB", async () => {
-    const a = new WhatsAppAdapter({ account: { phone: "1" } });
-    const r = await a.authenticate();
-    expect(r.ok).toBe(false);
-    expect(r.reason).toBe("DB_NOT_PULLED");
-  });
-
-  it("sync yields contact + chat + message + call", async () => {
-    const { dir, dbPath } = tmpDb();
-    try {
-      const mockDriver = makeMockDriver([
-        ["FROM jid", [
-          { _id: 1, user: "13800001111", display_name: "Alice", raw_string: "13800001111@s.whatsapp.net" },
-          { _id: 2, user: "group", display_name: "Group A", raw_string: "123456@g.us" },
-        ]],
-        ["FROM chat", [{ _id: 1, subject: "Chat 1" }]],
-        ["FROM message", [
-          { _id: 1, key_remote_jid: "1", text_data: "Hi", timestamp: 1700000000, from_me: 0 },
-        ]],
-        ["FROM messages", []],
-        ["FROM call_log", [
-          { _id: 1, jid_row_id: 1, video_call: 0, duration: 60, from_me: 1, timestamp: 1700001000, call_result: "completed" },
-        ]],
-      ]);
-      const a = new WhatsAppAdapter({
-        account: { phone: "13800001111" },
-        dbPath,
-        dbDriverFactory: () => mockDriver,
-      });
-      const raws = [];
-      for await (const r of a.sync()) raws.push(r);
-      // 2 jid contacts + 1 chat + 1 message + 1 call = 5
-      expect(raws.length).toBe(5);
-      const contacts = raws.filter((r) => r.payload.kind === "contact");
-      const calls = raws.filter((r) => r.payload.kind === "call");
-      expect(contacts).toHaveLength(2);
-      expect(calls).toHaveLength(1);
-
-      // Normalize all + validate
-      for (const r of raws) {
-        const batch = a.normalize(r);
-        expect(validateBatch(batch).valid).toBe(true);
-      }
-    } finally {
-      fs.rmSync(dir, { recursive: true, force: true });
-    }
-  });
-
-  it("group jid → Topic not Person", async () => {
-    const a = new WhatsAppAdapter({ account: { phone: "1" } });
-    const batch = a.normalize({
-      adapter: "messaging-whatsapp",
-      originalId: "jid-2",
-      capturedAt: Date.now(),
-      payload: { kind: "contact", row: { _id: 2, raw_string: "123456@g.us", display_name: "Group A" } },
-    });
-    expect(batch.topics).toHaveLength(1);
-    expect(batch.persons).toHaveLength(0);
-  });
-
-  it("individual jid → Person with phone identifier", async () => {
-    const a = new WhatsAppAdapter({ account: { phone: "1" } });
-    const batch = a.normalize({
-      adapter: "messaging-whatsapp",
-      originalId: "jid-1",
-      capturedAt: Date.now(),
-      payload: { kind: "contact", row: { _id: 1, user: "13800001111", display_name: "Alice", raw_string: "13800001111@s.whatsapp.net" } },
-    });
-    expect(batch.persons).toHaveLength(1);
-    expect(batch.persons[0].identifiers.phone).toEqual(["13800001111"]);
-  });
-
-  it("call event captures duration + video flag", async () => {
-    const a = new WhatsAppAdapter({ account: { phone: "1" } });
-    const batch = a.normalize({
-      adapter: "messaging-whatsapp",
-      originalId: "call-1",
-      capturedAt: Date.now(),
-      payload: { kind: "call", row: { _id: 1, jid_row_id: 1, video_call: 1, duration: 300, from_me: 1, timestamp: 1700001000 } },
-    });
-    expect(batch.events[0].subtype).toBe("call");
-    expect(batch.events[0].extra.duration).toBe(300);
-    expect(batch.events[0].extra.isVideo).toBe(true);
-    expect(batch.events[0].extra.fromMe).toBe(true);
-  });
-});

package/scripts/_make-fixture-all.js

@@ -1,126 +0,0 @@
-#!/usr/bin/env node
-/**
- * Build a complete fixture directory with all 4 system-data sources:
- *
- *   <out>/
- *     contacts2.db          (raw_contacts + data + mimetypes)
- *     mmssms.db             (sms)
- *     wifi/
- *       WifiConfigStore.xml
- *
- * Usage:
- *   node scripts/_make-fixture-all.js ./fixtures
- */
-
-"use strict";
-
-const fs = require("node:fs");
-const path = require("node:path");
-const Database = require("better-sqlite3-multiple-ciphers");
-
-const outDir = path.resolve(process.argv[2] || "./fixtures");
-fs.mkdirSync(path.join(outDir, "wifi"), { recursive: true });
-
-// ── contacts2.db ──────────────────────────────────────────────────────────
-const contactsPath = path.join(outDir, "contacts2.db");
-if (fs.existsSync(contactsPath)) fs.unlinkSync(contactsPath);
-const contacts = new Database(contactsPath);
-contacts.exec(`
-  CREATE TABLE raw_contacts (
-    _id INTEGER PRIMARY KEY, display_name TEXT, starred INTEGER DEFAULT 0, deleted INTEGER DEFAULT 0
-  );
-  CREATE TABLE mimetypes (_id INTEGER PRIMARY KEY, mimetype TEXT NOT NULL UNIQUE);
-  CREATE TABLE data (
-    _id INTEGER PRIMARY KEY, raw_contact_id INTEGER NOT NULL, mimetype_id INTEGER NOT NULL, data1 TEXT
-  );
-  CREATE TABLE calls (
-    _id INTEGER PRIMARY KEY, number TEXT, type INTEGER, duration INTEGER, date INTEGER, name TEXT, is_read INTEGER DEFAULT 1
-  );
-`);
-const MT = { phone: 5, email: 1, org: 4, note: 10, photo: 14 };
-const mi = contacts.prepare("INSERT INTO mimetypes (_id, mimetype) VALUES (?, ?)");
-mi.run(MT.phone, "vnd.android.cursor.item/phone_v2");
-mi.run(MT.email, "vnd.android.cursor.item/email_v2");
-mi.run(MT.org, "vnd.android.cursor.item/organization");
-mi.run(MT.note, "vnd.android.cursor.item/note");
-mi.run(MT.photo, "vnd.android.cursor.item/photo");
-const ci = contacts.prepare(
-  "INSERT INTO raw_contacts (_id, display_name, starred, deleted) VALUES (?, ?, ?, 0)",
-);
-ci.run(1, "妈妈", 1);
-ci.run(2, "张三", 0);
-ci.run(3, "李四 Manager", 0);
-ci.run(5, "工商银行客服", 0);
-const di = contacts.prepare(
-  "INSERT INTO data (raw_contact_id, mimetype_id, data1) VALUES (?, ?, ?)",
-);
-di.run(1, MT.phone, "13800001111");
-di.run(1, MT.phone, "13900002222");
-di.run(1, MT.email, "mom@example.com");
-di.run(1, MT.note, "亲妈，过年回家");
-di.run(2, MT.phone, "13711112222");
-di.run(3, MT.phone, "13822223333");
-di.run(3, MT.email, "lisi@corp.example.com");
-di.run(3, MT.org, "Example Corp");
-di.run(5, MT.phone, "95588");
-// Calls table inside contacts2.db (pre-Android-11 location)
-const li = contacts.prepare(
-  "INSERT INTO calls (_id, number, type, duration, date, name, is_read) VALUES (?, ?, ?, ?, ?, ?, ?)",
-);
-li.run(1, "13800001111", 1, 120, 1737000000000, "妈妈", 1);
-li.run(2, "13800001111", 2, 45, 1737010000000, "妈妈", 1);
-li.run(3, "13999998888", 3, 0, 1737020000000, "", 0);
-li.run(4, "10086", 1, 8, 1737030000000, "中国移动", 1);
-contacts.close();
-console.log("wrote:", contactsPath);
-
-// ── mmssms.db ─────────────────────────────────────────────────────────────
-const smsPath = path.join(outDir, "mmssms.db");
-if (fs.existsSync(smsPath)) fs.unlinkSync(smsPath);
-const sms = new Database(smsPath);
-sms.exec(`
-  CREATE TABLE sms (
-    _id INTEGER PRIMARY KEY, thread_id INTEGER, address TEXT, body TEXT,
-    type INTEGER, date INTEGER, read INTEGER
-  );
-`);
-const si = sms.prepare(
-  "INSERT INTO sms (_id, thread_id, address, body, type, date, read) VALUES (?, ?, ?, ?, ?, ?, ?)",
-);
-si.run(1, 100, "13800001111", "妈妈我到家了", 2, 1737000000000, 1);
-si.run(2, 100, "13800001111", "好的，注意安全", 1, 1737000010000, 1);
-si.run(3, 200, "10086", "【中国移动】您的话费余额为 ¥36.50", 1, 1737000020000, 1);
-si.run(4, 300, "95588", "【工商银行】您的验证码为 123456，3 分钟内有效", 1, 1737000030000, 0);
-sms.close();
-console.log("wrote:", smsPath);
-
-// ── wifi/WifiConfigStore.xml ──────────────────────────────────────────────
-const wifiXml = path.join(outDir, "wifi", "WifiConfigStore.xml");
-fs.writeFileSync(
-  wifiXml,
-  `<?xml version='1.0' encoding='UTF-8'?>
-<WifiConfigStoreData>
-  <NetworkList>
-    <Network>
-      <WifiConfiguration>
-        <string name="SSID">"Home_5G"</string>
-        <string name="PreSharedKey">"secret"</string>
-        <string name="KeyMgmt">WPA-PSK</string>
-        <boolean name="HiddenSSID">false</boolean>
-      </WifiConfiguration>
-    </Network>
-    <Network>
-      <WifiConfiguration>
-        <string name="SSID">"Starbucks Free"</string>
-        <string name="KeyMgmt">NONE</string>
-        <boolean name="HiddenSSID">false</boolean>
-      </WifiConfiguration>
-    </Network>
-  </NetworkList>
-</WifiConfigStoreData>
-`,
-  "utf-8",
-);
-console.log("wrote:", wifiXml);
-
-console.log("\nAll fixtures ready under:", outDir);

package/scripts/_make-fixture-contacts.js

@@ -1,84 +0,0 @@
-#!/usr/bin/env node
-/**
- * Build a synthetic Android contacts2.db at the given path.
- *
- * Only used by the smoke runner / docs walkthrough — production code never
- * relies on this. Mirrors the fixture from
- * packages/personal-data-hub-bridge/tests/test_parsers_system_contacts.py.
- *
- * Usage:
- *   node scripts/_make-fixture-contacts.js ./fixtures/contacts2.db
- */
-
-"use strict";
-
-const fs = require("node:fs");
-const path = require("node:path");
-const Database = require("better-sqlite3-multiple-ciphers");
-
-const target = path.resolve(process.argv[2] || "./fixtures/contacts2.db");
-fs.mkdirSync(path.dirname(target), { recursive: true });
-if (fs.existsSync(target)) fs.unlinkSync(target);
-
-const db = new Database(target);
-try {
-  db.exec(`
-    CREATE TABLE raw_contacts (
-      _id INTEGER PRIMARY KEY,
-      display_name TEXT,
-      starred INTEGER DEFAULT 0,
-      deleted INTEGER DEFAULT 0
-    );
-    CREATE TABLE mimetypes (
-      _id INTEGER PRIMARY KEY,
-      mimetype TEXT NOT NULL UNIQUE
-    );
-    CREATE TABLE data (
-      _id INTEGER PRIMARY KEY,
-      raw_contact_id INTEGER NOT NULL,
-      mimetype_id INTEGER NOT NULL,
-      data1 TEXT
-    );
-  `);
-
-  const MT = {
-    phone: 5,
-    email: 1,
-    org: 4,
-    note: 10,
-    photo: 14,
-  };
-  const insertMime = db.prepare(
-    "INSERT INTO mimetypes (_id, mimetype) VALUES (?, ?)",
-  );
-  insertMime.run(MT.phone, "vnd.android.cursor.item/phone_v2");
-  insertMime.run(MT.email, "vnd.android.cursor.item/email_v2");
-  insertMime.run(MT.org, "vnd.android.cursor.item/organization");
-  insertMime.run(MT.note, "vnd.android.cursor.item/note");
-  insertMime.run(MT.photo, "vnd.android.cursor.item/photo");
-
-  const insertC = db.prepare(
-    "INSERT INTO raw_contacts (_id, display_name, starred, deleted) VALUES (?, ?, ?, 0)",
-  );
-  insertC.run(1, "妈妈", 1);
-  insertC.run(2, "张三", 0);
-  insertC.run(3, "李四 Manager", 0);
-  insertC.run(4, "", 0); // nameless — skipped by parser
-  insertC.run(5, "工商银行客服", 0);
-
-  const insertD = db.prepare(
-    "INSERT INTO data (raw_contact_id, mimetype_id, data1) VALUES (?, ?, ?)",
-  );
-  insertD.run(1, MT.phone, "13800001111");
-  insertD.run(1, MT.phone, "13900002222");
-  insertD.run(1, MT.email, "mom@example.com");
-  insertD.run(1, MT.note, "亲妈，过年回家");
-  insertD.run(2, MT.phone, "13711112222");
-  insertD.run(3, MT.phone, "13822223333");
-  insertD.run(3, MT.email, "lisi@corp.example.com");
-  insertD.run(3, MT.org, "Example Corp");
-  insertD.run(5, MT.phone, "95588");
-} finally {
-  db.close();
-}
-console.log("fixture written:", target);

package/scripts/evaluate-entity-resolver.js

@@ -1,213 +0,0 @@
-#!/usr/bin/env node
-/**
- * Phase 8.8 — EntityResolver evaluation runner.
- *
- * Reads a labeled pair fixture, runs each pair through the configured
- * stages, computes recall / accuracy / per-stage breakdown, and exits
- * non-zero if the CI gate (recall ≥ 80%, accuracy ≥ 90%) fails.
- *
- * Usage:
- *   node scripts/evaluate-entity-resolver.js \
- *     [--fixture <path>] [--use-embedding] [--use-llm] [--require-pass]
- *
- * Defaults:
- *   - fixture: __tests__/fixtures/entity-resolver-200-mock.json
- *   - --use-embedding: skipped unless flag set (needs Ollama running)
- *   - --use-llm: skipped unless flag set (needs Ollama + chat model)
- *   - --require-pass: exit 1 when gate fails (use in CI; otherwise warn-only)
- */
-
-"use strict";
-
-const fs = require("node:fs");
-const path = require("node:path");
-
-const {
-  entityResolverRuleStage: ruleStage,
-} = require("../lib/entity-resolver");
-
-const args = parseArgs(process.argv.slice(2));
-const fixturePath = args.fixture || path.join(
-  __dirname, "..", "__tests__", "fixtures", "entity-resolver-200-mock.json"
-);
-const useEmbedding = !!args["use-embedding"];
-const useLlm = !!args["use-llm"];
-const requirePass = !!args["require-pass"];
-
-const RECALL_GATE = 0.80;
-const ACCURACY_GATE = 0.90;
-
-async function main() {
-  console.log("== EntityResolver evaluation ==");
-  console.log("fixture:", fixturePath);
-  if (!fs.existsSync(fixturePath)) {
-    console.error("\nFAIL: fixture not found");
-    process.exit(2);
-  }
-  const data = JSON.parse(fs.readFileSync(fixturePath, "utf-8"));
-  if (!Array.isArray(data.pairs) || data.pairs.length === 0) {
-    console.error("\nFAIL: fixture has no pairs");
-    process.exit(2);
-  }
-
-  const stages = { embedding: null, llm: null };
-  if (useEmbedding) {
-    const { EntityResolverEmbeddingStage } = require("../lib/entity-resolver");
-    stages.embedding = new EntityResolverEmbeddingStage({}).asStageFn();
-    console.log("embedding stage: Ollama nomic-embed-text @ localhost:11434");
-  }
-  if (useLlm) {
-    const { EntityResolverLLMStage } = require("../lib/entity-resolver");
-    const { OllamaClient } = require("../lib/llm-client");
-    const llm = new OllamaClient({ baseUrl: "http://localhost:11434", model: "qwen2.5:7b-instruct" });
-    stages.llm = new EntityResolverLLMStage({ llm }).asStageFn();
-    console.log("llm stage: Ollama qwen2.5:7b-instruct");
-  }
-
-  // Per-stage counters
-  const counts = {
-    ruleSame: 0, ruleDifferent: 0, ruleUncertain: 0,
-    embeddingSame: 0, embeddingDifferent: 0, embeddingUncertain: 0,
-    llmSame: 0, llmDifferent: 0, llmMaybe: 0,
-  };
-
-  // Confusion matrix
-  const confusion = { tp: 0, fp: 0, fn: 0, tn: 0, unresolved: 0 };
-
-  // Per-pair breakdown
-  const results = [];
-
-  for (const pair of data.pairs) {
-    const truth = pair.groundTruth; // "same" | "different"
-    const ruleVerdict = ruleStage(pair.a, pair.b).verdict;
-    let finalVerdict = ruleVerdict;
-    let stage = "rule";
-
-    if (ruleVerdict === "same") counts.ruleSame += 1;
-    else if (ruleVerdict === "different") counts.ruleDifferent += 1;
-    else counts.ruleUncertain += 1;
-
-    if (ruleVerdict === "uncertain" && stages.embedding) {
-      const e = await stages.embedding(pair.a, pair.b);
-      if (e.sim >= 0.85) {
-        finalVerdict = "same";
-        counts.embeddingSame += 1;
-        stage = "embedding";
-      } else if (e.sim < 0.55) {
-        finalVerdict = "different";
-        counts.embeddingDifferent += 1;
-        stage = "embedding";
-      } else {
-        counts.embeddingUncertain += 1;
-        if (stages.llm) {
-          const v = await stages.llm(pair.a, pair.b);
-          if (v.verdict === "yes" && v.confidence >= 0.7) {
-            finalVerdict = "same";
-            counts.llmSame += 1;
-            stage = "llm";
-          } else if (v.verdict === "no" && v.confidence >= 0.7) {
-            finalVerdict = "different";
-            counts.llmDifferent += 1;
-            stage = "llm";
-          } else {
-            finalVerdict = "review";
-            counts.llmMaybe += 1;
-            stage = "llm-review";
-          }
-        }
-      }
-    }
-
-    // Tally confusion (only counting decided verdicts)
-    if (finalVerdict === "same" && truth === "same") confusion.tp += 1;
-    else if (finalVerdict === "same" && truth === "different") confusion.fp += 1;
-    else if (finalVerdict === "different" && truth === "same") confusion.fn += 1;
-    else if (finalVerdict === "different" && truth === "different") confusion.tn += 1;
-    else confusion.unresolved += 1;
-
-    results.push({ id: pair.id, truth, finalVerdict, stage, category: pair.category });
-  }
-
-  const total = data.pairs.length;
-  const resolved = total - confusion.unresolved;
-  const accuracy = resolved > 0 ? (confusion.tp + confusion.tn) / resolved : 0;
-  const recall = (confusion.tp + confusion.fn) > 0
-    ? confusion.tp / (confusion.tp + confusion.fn)
-    : 1;
-  const precision = (confusion.tp + confusion.fp) > 0
-    ? confusion.tp / (confusion.tp + confusion.fp)
-    : 1;
-  const resolveRate = resolved / total;
-
-  // ── Report ──
-  console.log("\nPair counts:", { total, resolved, unresolved: confusion.unresolved });
-  console.log("\nPipeline stages:");
-  console.log(`  Rule:      same=${counts.ruleSame} different=${counts.ruleDifferent} uncertain=${counts.ruleUncertain}`);
-  if (stages.embedding) console.log(`  Embedding: same=${counts.embeddingSame} different=${counts.embeddingDifferent} uncertain=${counts.embeddingUncertain}`);
-  if (stages.llm) console.log(`  LLM:       same=${counts.llmSame} different=${counts.llmDifferent} maybe=${counts.llmMaybe}`);
-
-  console.log("\nConfusion (decided only):");
-  console.log(`  TP=${confusion.tp}  FP=${confusion.fp}  FN=${confusion.fn}  TN=${confusion.tn}`);
-  console.log(`  unresolved=${confusion.unresolved}  (rule "uncertain" with no embedding/llm wired)`);
-
-  console.log("\nMetrics:");
-  const recallStr = (recall * 100).toFixed(1) + "%";
-  const accStr = (accuracy * 100).toFixed(1) + "%";
-  const precStr = (precision * 100).toFixed(1) + "%";
-  const resolveStr = (resolveRate * 100).toFixed(1) + "%";
-  console.log(`  Recall:       ${recallStr}  (target ≥ ${(RECALL_GATE * 100).toFixed(0)}%) ${recall >= RECALL_GATE ? "✓" : "✗"}`);
-  console.log(`  Accuracy:     ${accStr}  (target ≥ ${(ACCURACY_GATE * 100).toFixed(0)}%) ${accuracy >= ACCURACY_GATE ? "✓" : "✗"}`);
-  console.log(`  Precision:    ${precStr}`);
-  console.log(`  Resolve rate: ${resolveStr}`);
-
-  // Per-category breakdown (useful for spotting weak spots)
-  const byCategory = {};
-  for (const r of results) {
-    const cat = r.category || "(uncat)";
-    if (!byCategory[cat]) byCategory[cat] = { total: 0, correct: 0, unresolved: 0 };
-    byCategory[cat].total += 1;
-    if (r.finalVerdict === "review" || r.finalVerdict === "uncertain") {
-      byCategory[cat].unresolved += 1;
-    } else if (r.finalVerdict === r.truth) {
-      byCategory[cat].correct += 1;
-    }
-  }
-  console.log("\nPer-category:");
-  for (const cat of Object.keys(byCategory)) {
-    const s = byCategory[cat];
-    const accStr = s.total - s.unresolved > 0
-      ? ((s.correct / (s.total - s.unresolved)) * 100).toFixed(0) + "%"
-      : "N/A";
-    console.log(`  ${cat}: ${s.correct}/${s.total - s.unresolved} correct (${accStr}); ${s.unresolved} unresolved`);
-  }
-
-  // Gate decision
-  const passed = recall >= RECALL_GATE && accuracy >= ACCURACY_GATE;
-  console.log(`\n${passed ? "✓ PASS" : "✗ FAIL"} — recall ${recallStr} / accuracy ${accStr}`);
-
-  if (!passed && requirePass) {
-    process.exit(1);
-  }
-}
-
-function parseArgs(argv) {
-  const out = {};
-  for (let i = 0; i < argv.length; i += 1) {
-    const a = argv[i];
-    if (a.startsWith("--")) {
-      const k = a.slice(2);
-      if (argv[i + 1] && !argv[i + 1].startsWith("--")) {
-        out[k] = argv[i + 1];
-        i += 1;
-      } else {
-        out[k] = true;
-      }
-    }
-  }
-  return out;
-}
-
-main().catch((err) => {
-  console.error("\nFATAL:", err && err.message ? err.message : err);
-  process.exit(2);
-});

package/scripts/run-native-tests-sandbox.sh

@@ -1,55 +0,0 @@
-#!/usr/bin/env bash
-# Run vault-search.test.js (FTS5 native integration) in an isolated sandbox.
-#
-# Background: the root node_modules bs3mc binding is built for Electron 39
-# (NODE_MODULE_VERSION 140) which doesn't match ANY Node.js version
-# (Node 24 = ABI 137, Node 25 = ABI 141). Plain `npm test` fails locally with
-# ABI mismatch. CI is unaffected because its node_modules is built fresh.
-#
-# This script:
-#   1. Copies lib/ + the target test into a temp sandbox
-#   2. Installs a separate bs3mc compiled for the CURRENT host Node ABI
-#   3. Runs vitest against it
-#
-# Idempotent; rerun any time. Sandbox lives under $TMPDIR/pdh-fts5-sandbox
-# so it survives between runs (faster re-install).
-#
-# Usage: bash packages/personal-data-hub/scripts/run-native-tests-sandbox.sh
-
-set -euo pipefail
-
-ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-SANDBOX="${TMPDIR:-/tmp}/pdh-fts5-sandbox"
-
-echo "==> Sandbox: $SANDBOX"
-mkdir -p "$SANDBOX/lib" "$SANDBOX/__tests__"
-
-# Sync sources every run (lib/ may have evolved since last sandbox build)
-cp -r "$ROOT/lib/." "$SANDBOX/lib/"
-cp "$ROOT/__tests__/vault-search.test.js" "$SANDBOX/__tests__/"
-# vault.test.js exercises native SQL (incl. sumEventAmount, intent=sum-amount Phase 2)
-cp "$ROOT/__tests__/vault.test.js" "$SANDBOX/__tests__/"
-
-# Minimal package.json — only the deps the target test needs.
-cat > "$SANDBOX/package.json" <<'EOF'
-{
-  "name": "pdh-fts5-sandbox",
-  "version": "0.0.0",
-  "private": true,
-  "type": "commonjs",
-  "scripts": { "test": "vitest run" },
-  "dependencies": { "better-sqlite3-multiple-ciphers": "^12.5.0" },
-  "devDependencies": { "vitest": "^4.1.5" }
-}
-EOF
-
-if [ ! -d "$SANDBOX/node_modules/better-sqlite3-multiple-ciphers/build" ]; then
-  echo "==> Installing deps (one-time, ~30-60s)"
-  (cd "$SANDBOX" && npm install --no-audit --no-fund --loglevel=warn)
-else
-  echo "==> Deps already installed (skipping npm install)"
-fi
-
-echo "==> Running tests"
-cd "$SANDBOX"
-exec node ./node_modules/vitest/vitest.mjs run