imsg-mcp 1.15.1 → 1.16.0

package/CHANGELOG.md

@@ -3,6 +3,13 @@
 All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and follows [Semantic Versioning](https://semver.org/).
 
+# [1.16.0](https://github.com/george43g/imsg-mcp/compare/v1.15.1...v1.16.0) (2026-07-25)
+
+
+### Features
+
+* **contacts:** rank search_contacts by relevance with matchedField ([352ccd2](https://github.com/george43g/imsg-mcp/commit/352ccd2da1263f26baa31ef38737a9d52bdf3aa0))
+
 ## [1.15.1](https://github.com/george43g/imsg-mcp/compare/v1.15.0...v1.15.1) (2026-07-25)
 
 

package/dist/cli.js

@@ -4,7 +4,7 @@ import { createInterface } from "node:readline";
 import { fileURLToPath, pathToFileURL } from "node:url";
 import { Command } from "commander";
 import { d as checkLocalAccess, f as formatAccessReport, I as IMPLEMENTED_TYPES, A as ANALYTIC_INFO, i as installShutdownHandlers, r as registerCleanup, l as looksLikeThreadSlug } from "./shutdown-0TCv4XJB.js";
-import { A as APP_VERSION, t as toYaml } from "./meta-BzRJT7r0.js";
+import { A as APP_VERSION, t as toYaml } from "./meta-DcLrk46N.js";
 import { spawn } from "node:child_process";
 import { join, dirname } from "node:path";
 function distRoot() {
@@ -447,7 +447,7 @@ async function runExportCommand(target, opts) {
   const { homedir } = await import("node:os");
   const { dirname: dirname2, join: join2, isAbsolute, resolve } = await import("node:path");
   const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-0TCv4XJB.js").then((n) => n.a2);
-  const { IMessageDB } = await import("./imessage-db-7ldOiURZ.js").then((n) => n.i);
+  const { IMessageDB } = await import("./imessage-db-DXFIm7is.js").then((n) => n.i);
   const { streamExport } = await import("./exportStream-BFxilSlL.js");
   const { parseUserDate } = await import("./date-parse-DJXMfq3a.js");
   const format = normalizeFormat(opts.format ?? "md");
@@ -719,7 +719,7 @@ program.command("interpret <rowId>").description("Interpret one attachment (tran
     return;
   }
   const { getContactsDbPaths, getImsgDbPath, getSlugsDbPath } = await import("./shutdown-0TCv4XJB.js").then((n) => n.a2);
-  const { IMessageDB } = await import("./imessage-db-7ldOiURZ.js").then((n) => n.i);
+  const { IMessageDB } = await import("./imessage-db-DXFIm7is.js").then((n) => n.i);
   const { getInterpretRuntime, refForAttachment } = await import("./media-intel-runtime-BkxG4bmW.js").then((n) => n.c);
   const { deleteMediaIntel } = await import("./media-intel-cache-mCgH4z9P.js");
   const db = new IMessageDB(getImsgDbPath(), getContactsDbPaths(), getSlugsDbPath());

package/dist/{imessage-db-7ldOiURZ.js → imessage-db-DXFIm7is.js}

@@ -6,6 +6,144 @@ import { fileURLToPath } from "node:url";
 import { existsSync, readdirSync, mkdirSync } from "node:fs";
 import { O as OBJECT_REPLACEMENT_CHAR, p as perf, m as isGroupGuid, n as isGroupChatIdentifier, q as generateThreadSlug, T as Tables, t as AssociatedMessageType, u as macAutoTimestampToDate, v as isReactionType, M as MAC_EPOCH_OFFSET, N as NANOS_PER_SECOND, x as macTimestampToDate$1, y as parseAssociatedMessageGuid$1 } from "./shutdown-0TCv4XJB.js";
 import bplist, { parseBuffer } from "bplist-parser";
+const EMOJI_REGEX = /[\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}\u{1F1E6}-\u{1F1FF}]/gu;
+const WHITESPACE_REGEX = /\s+/g;
+function cleanText(s) {
+  return s.toLowerCase().replace(EMOJI_REGEX, " ").replace(WHITESPACE_REGEX, " ").trim();
+}
+function tokenSet(s) {
+  if (!s) return /* @__PURE__ */ new Set();
+  return new Set(s.split(" ").filter(Boolean));
+}
+function levenshtein(a, b, maxLen = 200) {
+  if (a === b) return 0;
+  const aLen = Math.min(a.length, maxLen);
+  const bLen = Math.min(b.length, maxLen);
+  if (aLen === 0) return bLen;
+  if (bLen === 0) return aLen;
+  let prev = new Array(bLen + 1);
+  let curr = new Array(bLen + 1);
+  for (let j = 0; j <= bLen; j++) prev[j] = j;
+  for (let i = 1; i <= aLen; i++) {
+    curr[0] = i;
+    for (let j = 1; j <= bLen; j++) {
+      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+      const del = (prev[j] ?? 0) + 1;
+      const ins = (curr[j - 1] ?? 0) + 1;
+      const sub = (prev[j - 1] ?? 0) + cost;
+      curr[j] = Math.min(del, ins, sub);
+    }
+    [prev, curr] = [curr, prev];
+  }
+  return prev[bLen] ?? Math.max(aLen, bLen);
+}
+function levenshteinRatio(a, b) {
+  if (a === b) return 1;
+  const aLen = Math.min(a.length, 200);
+  const bLen = Math.min(b.length, 200);
+  const maxLen = Math.max(aLen, bLen);
+  if (maxLen === 0) return 1;
+  return 1 - levenshtein(a, b) / maxLen;
+}
+function fuzzyScore(query, candidate) {
+  if (query && candidate && candidate.toLowerCase().includes(query.toLowerCase())) {
+    return 0.95;
+  }
+  const q = cleanText(query);
+  const c = cleanText(candidate);
+  if (!q || !c) return 0;
+  if (c.includes(q)) return 0.95;
+  if (q.includes(c)) return 0.9;
+  const qTokens = tokenSet(q);
+  const cTokens = tokenSet(c);
+  let intersection = 0;
+  for (const tok of qTokens) {
+    if (cTokens.has(tok)) intersection++;
+  }
+  const dice = 2 * intersection / (qTokens.size + cTokens.size || 1);
+  let bestTokenLev = 0;
+  if (qTokens.size === 1) {
+    for (const tok of cTokens) {
+      const r = levenshteinRatio(q, tok);
+      if (r > bestTokenLev) bestTokenLev = r;
+    }
+  }
+  const levRatio = Math.max(levenshteinRatio(q, c), bestTokenLev);
+  const blend = qTokens.size <= 1 ? 0.1 * dice + 0.9 * levRatio : 0.7 * dice + 0.3 * levRatio;
+  return Math.max(0, Math.min(1, blend));
+}
+function rankFuzzy(query, candidates, getText, minScore = 0.6) {
+  const out = [];
+  for (const c of candidates) {
+    const score = fuzzyScore(query, getText(c));
+    if (score >= minScore) out.push({ item: c, score });
+  }
+  out.sort((a, b) => b.score - a.score);
+  return out;
+}
+function scoreTextField(query, value) {
+  if (!value) return 0;
+  const v = value.toLowerCase();
+  const q = query.toLowerCase().trim();
+  if (!q) return 0;
+  if (v === q) return 1;
+  if (v.startsWith(q)) return 0.9;
+  if (v.includes(q)) return 0.7;
+  return fuzzyScore(q, v);
+}
+function scorePhoneField(query, phone) {
+  const qd = query.replace(/\D/g, "");
+  const pd = phone.replace(/\D/g, "");
+  if (!qd || !pd) return 0;
+  if (pd === qd) return 1;
+  if (pd.includes(qd)) return 0.8;
+  return 0;
+}
+const NAME_FIELDS = [
+  ["displayName", (c) => c.displayName],
+  ["firstName", (c) => c.firstName],
+  ["lastName", (c) => c.lastName],
+  ["nickname", (c) => c.nickname],
+  ["organization", (c) => c.organization]
+];
+function scoreContactMatch(query, contact, floor = 0.6) {
+  let best = 0;
+  let field = "displayName";
+  for (const [name, get] of NAME_FIELDS) {
+    const s = scoreTextField(query, get(contact));
+    if (s > best) {
+      best = s;
+      field = name;
+    }
+  }
+  for (const phone of contact.phoneNumbers) {
+    const s = scorePhoneField(query, phone);
+    if (s > best) {
+      best = s;
+      field = "phone";
+    }
+  }
+  for (const email of contact.emails) {
+    const s = scoreTextField(query, email);
+    if (s > best) {
+      best = s;
+      field = "email";
+    }
+  }
+  if (best < floor) return null;
+  return { contact, score: Math.round(best * 1e3) / 1e3, matchedField: field };
+}
+function rankContacts(query, contacts, floor = 0.6) {
+  const out = [];
+  for (const c of contacts) {
+    const m = scoreContactMatch(query, c, floor);
+    if (m) out.push(m);
+  }
+  out.sort(
+    (a, b) => b.score - a.score || a.contact.displayName.localeCompare(b.contact.displayName)
+  );
+  return out;
+}
 function normalizePhoneNumber(phone) {
   const digits = phone.replace(/\D/g, "");
   if (digits.length === 11 && digits.startsWith("1")) {
@@ -319,6 +457,18 @@ class ContactsDB {
       (c) => c.displayName.toLowerCase().includes(lowerQuery) || c.phoneNumbers.some((p) => p.includes(query)) || c.emails.some((e) => e.toLowerCase().includes(lowerQuery))
     );
   }
+  /**
+   * Search contacts, ranked by relevance with the matched field annotated.
+   * Preserves the substring recall of searchContacts (a substring match scores
+   * 0.7, above the inclusion floor) while ordering best-first so callers can
+   * disambiguate close matches instead of eyeballing an unordered list.
+   */
+  searchContactsRanked(query) {
+    if (!this.initialized) {
+      this.initialize();
+    }
+    return rankContacts(query, Array.from(this.contactCache.values()));
+  }
   /**
    * Build display name from contact fields
    */
@@ -373,81 +523,6 @@ class ContactsDB {
     };
   }
 }
-const EMOJI_REGEX = /[\u{1F300}-\u{1FAFF}\u{2600}-\u{27BF}\u{1F1E6}-\u{1F1FF}]/gu;
-const WHITESPACE_REGEX = /\s+/g;
-function cleanText(s) {
-  return s.toLowerCase().replace(EMOJI_REGEX, " ").replace(WHITESPACE_REGEX, " ").trim();
-}
-function tokenSet(s) {
-  if (!s) return /* @__PURE__ */ new Set();
-  return new Set(s.split(" ").filter(Boolean));
-}
-function levenshtein(a, b, maxLen = 200) {
-  if (a === b) return 0;
-  const aLen = Math.min(a.length, maxLen);
-  const bLen = Math.min(b.length, maxLen);
-  if (aLen === 0) return bLen;
-  if (bLen === 0) return aLen;
-  let prev = new Array(bLen + 1);
-  let curr = new Array(bLen + 1);
-  for (let j = 0; j <= bLen; j++) prev[j] = j;
-  for (let i = 1; i <= aLen; i++) {
-    curr[0] = i;
-    for (let j = 1; j <= bLen; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      const del = (prev[j] ?? 0) + 1;
-      const ins = (curr[j - 1] ?? 0) + 1;
-      const sub = (prev[j - 1] ?? 0) + cost;
-      curr[j] = Math.min(del, ins, sub);
-    }
-    [prev, curr] = [curr, prev];
-  }
-  return prev[bLen] ?? Math.max(aLen, bLen);
-}
-function levenshteinRatio(a, b) {
-  if (a === b) return 1;
-  const aLen = Math.min(a.length, 200);
-  const bLen = Math.min(b.length, 200);
-  const maxLen = Math.max(aLen, bLen);
-  if (maxLen === 0) return 1;
-  return 1 - levenshtein(a, b) / maxLen;
-}
-function fuzzyScore(query, candidate) {
-  if (query && candidate && candidate.toLowerCase().includes(query.toLowerCase())) {
-    return 0.95;
-  }
-  const q = cleanText(query);
-  const c = cleanText(candidate);
-  if (!q || !c) return 0;
-  if (c.includes(q)) return 0.95;
-  if (q.includes(c)) return 0.9;
-  const qTokens = tokenSet(q);
-  const cTokens = tokenSet(c);
-  let intersection = 0;
-  for (const tok of qTokens) {
-    if (cTokens.has(tok)) intersection++;
-  }
-  const dice = 2 * intersection / (qTokens.size + cTokens.size || 1);
-  let bestTokenLev = 0;
-  if (qTokens.size === 1) {
-    for (const tok of cTokens) {
-      const r = levenshteinRatio(q, tok);
-      if (r > bestTokenLev) bestTokenLev = r;
-    }
-  }
-  const levRatio = Math.max(levenshteinRatio(q, c), bestTokenLev);
-  const blend = qTokens.size <= 1 ? 0.1 * dice + 0.9 * levRatio : 0.7 * dice + 0.3 * levRatio;
-  return Math.max(0, Math.min(1, blend));
-}
-function rankFuzzy(query, candidates, getText, minScore = 0.6) {
-  const out = [];
-  for (const c of candidates) {
-    const score = fuzzyScore(query, getText(c));
-    if (score >= minScore) out.push({ item: c, score });
-  }
-  out.sort((a, b) => b.score - a.score);
-  return out;
-}
 const __dirname$1 = dirname(fileURLToPath(import.meta.url));
 let _native;
 function tryLoadNative() {
@@ -3221,4 +3296,4 @@ export {
   normalizedPhoneVariants as n,
   rankFuzzy as r
 };
-//# sourceMappingURL=imessage-db-7ldOiURZ.js.map
+//# sourceMappingURL=imessage-db-DXFIm7is.js.map