@hasna/contacts 0.3.2 → 0.4.1

package/dist/mcp/index.js

@@ -1,13 +1,32 @@
 #!/usr/bin/env bun
 // @bun
-
-// src/mcp/index.ts
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import {
-  CallToolRequestSchema,
-  ListToolsRequestSchema
-} from "@modelcontextprotocol/sdk/types.js";
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __toESM = (mod, isNodeMode, target) => {
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: () => mod[key],
+        enumerable: true
+      });
+  return to;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: (newValue) => all[name] = () => newValue
+    });
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
 
 // src/db/database.ts
 import { Database } from "bun:sqlite";
@@ -26,8 +45,47 @@ function ensureDir(filePath) {
   if (!existsSync(dir))
     mkdirSync(dir, { recursive: true });
 }
-var MIGRATIONS = [
-  `
+function getDatabase(path) {
+  if (_db)
+    return _db;
+  const dbPath = path || getDbPath();
+  ensureDir(dbPath);
+  const db = new Database(dbPath, { create: true });
+  db.exec("PRAGMA journal_mode=WAL");
+  db.exec("PRAGMA foreign_keys=ON");
+  runMigrations(db);
+  _db = db;
+  return db;
+}
+function uuid() {
+  return crypto.randomUUID();
+}
+function now() {
+  return new Date().toISOString();
+}
+function runMigrations(db) {
+  try {
+    const row = db.query("SELECT MAX(version) as v FROM _migrations").get();
+    const current = row?.v ?? -1;
+    for (let i = current + 1;i < MIGRATIONS.length; i++) {
+      db.exec(MIGRATIONS[i]);
+      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${i})`);
+    }
+  } catch {
+    for (const m of MIGRATIONS) {
+      try {
+        db.exec(m);
+      } catch {}
+    }
+    try {
+      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${MIGRATIONS.length - 1})`);
+    } catch {}
+  }
+}
+var MIGRATIONS, _db = null;
+var init_database = __esm(() => {
+  MIGRATIONS = [
+    `
   CREATE TABLE IF NOT EXISTS companies (
     id TEXT PRIMARY KEY,
     name TEXT NOT NULL,
@@ -180,7 +238,7 @@ var MIGRATIONS = [
 
   CREATE TABLE IF NOT EXISTS _migrations (version INTEGER PRIMARY KEY);
   `,
-  `
+    `
   ALTER TABLE contacts ADD COLUMN last_contacted_at TEXT;
   ALTER TABLE contacts ADD COLUMN website TEXT;
   ALTER TABLE contacts ADD COLUMN preferred_contact_method TEXT;
@@ -199,7 +257,7 @@ var MIGRATIONS = [
     PRIMARY KEY (contact_id, group_id)
   );
   `,
-  `
+    `
   ALTER TABLE contacts ADD COLUMN status TEXT DEFAULT 'active';
   ALTER TABLE contacts ADD COLUMN follow_up_at TEXT;
   ALTER TABLE contacts ADD COLUMN archived INTEGER NOT NULL DEFAULT 0;
@@ -213,7 +271,7 @@ var MIGRATIONS = [
     PRIMARY KEY (company_id, group_id)
   );
   `,
-  `
+    `
   CREATE TABLE IF NOT EXISTS company_relationships (
     id TEXT PRIMARY KEY,
     contact_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
@@ -226,7 +284,7 @@ var MIGRATIONS = [
   CREATE INDEX IF NOT EXISTS idx_company_relationships_contact ON company_relationships(contact_id);
   CREATE INDEX IF NOT EXISTS idx_company_relationships_company ON company_relationships(company_id);
   `,
-  `
+    `
   CREATE TABLE IF NOT EXISTS contact_notes (
     id TEXT PRIMARY KEY,
     contact_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
@@ -237,7 +295,7 @@ var MIGRATIONS = [
 
   CREATE INDEX IF NOT EXISTS idx_contact_notes_contact ON contact_notes(contact_id);
   `,
-  `
+    `
   ALTER TABLE companies ADD COLUMN is_owned_entity INTEGER NOT NULL DEFAULT 0;
   ALTER TABLE companies ADD COLUMN entity_type TEXT CHECK(entity_type IN ('operating','holding','dissolved','nonprofit','trust','branch','other'));
 
@@ -315,75 +373,71 @@ var MIGRATIONS = [
   );
 
   ALTER TABLE contact_notes ADD COLUMN company_id TEXT REFERENCES companies(id) ON DELETE SET NULL;
-  `
-];
-var _db = null;
-function getDatabase(path) {
-  if (_db)
-    return _db;
-  const dbPath = path || getDbPath();
-  ensureDir(dbPath);
-  const db = new Database(dbPath, { create: true });
-  db.exec("PRAGMA journal_mode=WAL");
-  db.exec("PRAGMA foreign_keys=ON");
-  runMigrations(db);
-  _db = db;
-  return db;
-}
-function uuid() {
-  return crypto.randomUUID();
-}
-function now() {
-  return new Date().toISOString();
-}
-function runMigrations(db) {
-  try {
-    const row = db.query("SELECT MAX(version) as v FROM _migrations").get();
-    const current = row?.v ?? -1;
-    for (let i = current + 1;i < MIGRATIONS.length; i++) {
-      db.exec(MIGRATIONS[i]);
-      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${i})`);
-    }
-  } catch {
-    for (const m of MIGRATIONS) {
-      try {
-        db.exec(m);
-      } catch {}
-    }
-    try {
-      db.exec(`INSERT OR REPLACE INTO _migrations(version) VALUES(${MIGRATIONS.length - 1})`);
-    } catch {}
-  }
-}
-
-// src/types/index.ts
-class ContactNotFoundError extends Error {
-  constructor(id) {
-    super(`Contact not found: ${id}`);
-    this.name = "ContactNotFoundError";
-  }
-}
+  `,
+    `
+  ALTER TABLE contacts ADD COLUMN do_not_contact INTEGER NOT NULL DEFAULT 0;
+  ALTER TABLE contacts ADD COLUMN priority INTEGER NOT NULL DEFAULT 3 CHECK(priority BETWEEN 1 AND 5);
+  ALTER TABLE contacts ADD COLUMN timezone TEXT;
 
-class CompanyNotFoundError extends Error {
-  constructor(id) {
-    super(`Company not found: ${id}`);
-    this.name = "CompanyNotFoundError";
-  }
-}
+  CREATE TABLE IF NOT EXISTS deals (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE SET NULL,
+    company_id TEXT REFERENCES companies(id) ON DELETE SET NULL,
+    stage TEXT NOT NULL DEFAULT 'lead' CHECK(stage IN ('lead','qualified','proposal','negotiation','won','lost','cancelled')),
+    value_usd REAL,
+    currency TEXT NOT NULL DEFAULT 'USD',
+    close_date TEXT,
+    notes TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
 
-class TagNotFoundError extends Error {
-  constructor(id) {
-    super(`Tag not found: ${id}`);
-    this.name = "TagNotFoundError";
-  }
-}
+  CREATE TABLE IF NOT EXISTS events (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    type TEXT NOT NULL DEFAULT 'meeting' CHECK(type IN ('meeting','call','lunch','email','demo','conference','intro','other')),
+    event_date TEXT NOT NULL,
+    duration_min INTEGER,
+    contact_ids TEXT NOT NULL DEFAULT '[]',
+    company_id TEXT REFERENCES companies(id) ON DELETE SET NULL,
+    notes TEXT,
+    outcome TEXT,
+    deal_id TEXT REFERENCES deals(id) ON DELETE SET NULL,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+  `
+  ];
+});
 
-class DuplicateTagNameError extends Error {
-  constructor(name) {
-    super(`Tag with name already exists: ${name}`);
-    this.name = "DuplicateTagNameError";
-  }
-}
+// src/types/index.ts
+var ContactNotFoundError, CompanyNotFoundError, TagNotFoundError, DuplicateTagNameError;
+var init_types = __esm(() => {
+  ContactNotFoundError = class ContactNotFoundError extends Error {
+    constructor(id) {
+      super(`Contact not found: ${id}`);
+      this.name = "ContactNotFoundError";
+    }
+  };
+  CompanyNotFoundError = class CompanyNotFoundError extends Error {
+    constructor(id) {
+      super(`Company not found: ${id}`);
+      this.name = "CompanyNotFoundError";
+    }
+  };
+  TagNotFoundError = class TagNotFoundError extends Error {
+    constructor(id) {
+      super(`Tag not found: ${id}`);
+      this.name = "TagNotFoundError";
+    }
+  };
+  DuplicateTagNameError = class DuplicateTagNameError extends Error {
+    constructor(name) {
+      super(`Tag with name already exists: ${name}`);
+      this.name = "DuplicateTagNameError";
+    }
+  };
+});
 
 // src/db/activity.ts
 function rowToActivity(row) {
@@ -412,8 +466,29 @@ function listActivity(opts = {}, db) {
   const rows = d.query(`SELECT * FROM activity_log ${where} ORDER BY created_at DESC LIMIT ? OFFSET ?`).all(...params, limit, offset);
   return { entries: rows.map(rowToActivity), total: totalRow.total };
 }
+var init_activity = __esm(() => {
+  init_database();
+});
 
 // src/db/contacts.ts
+var exports_contacts = {};
+__export(exports_contacts, {
+  updateContact: () => updateContact,
+  unarchiveContact: () => unarchiveContact,
+  searchContacts: () => searchContacts,
+  mergeContacts: () => mergeContacts,
+  listRecentContacts: () => listRecentContacts,
+  listContacts: () => listContacts,
+  listColdContacts: () => listColdContacts,
+  getContactByEmail: () => getContactByEmail,
+  getContact: () => getContact,
+  deleteContact: () => deleteContact,
+  createContact: () => createContact,
+  autoLinkContactToCompany: () => autoLinkContactToCompany,
+  archiveContact: () => archiveContact,
+  addPhoneToContact: () => addPhoneToContact,
+  addEmailToContact: () => addEmailToContact
+});
 function rowToContact(row) {
   return {
     ...row,
@@ -423,7 +498,10 @@ function rowToContact(row) {
     status: row.status ?? "active",
     follow_up_at: row.follow_up_at ?? null,
     archived: !!row.archived,
-    project_id: row.project_id ?? null
+    project_id: row.project_id ?? null,
+    do_not_contact: !!row.do_not_contact,
+    priority: row.priority ?? 3,
+    timezone: row.timezone ?? null
   };
 }
 function rowToEmail(row) {
@@ -508,8 +586,8 @@ function createContact(input, db) {
   const firstName = input.first_name ?? "";
   const lastName = input.last_name ?? "";
   const displayName = input.display_name ?? (firstName || lastName ? `${firstName} ${lastName}`.trim() : "Unnamed Contact");
-  d.run(`INSERT INTO contacts (id, first_name, last_name, display_name, nickname, avatar_url, notes, birthday, company_id, job_title, source, custom_fields, last_contacted_at, website, preferred_contact_method, status, follow_up_at, project_id, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO contacts (id, first_name, last_name, display_name, nickname, avatar_url, notes, birthday, company_id, job_title, source, custom_fields, last_contacted_at, website, preferred_contact_method, status, follow_up_at, project_id, do_not_contact, priority, timezone, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     firstName,
     lastName,
@@ -528,6 +606,9 @@ function createContact(input, db) {
     input.status ?? "active",
     input.follow_up_at ?? null,
     input.project_id ?? null,
+    input.do_not_contact ? 1 : 0,
+    input.priority ?? 3,
+    input.timezone ?? null,
     timestamp,
     timestamp
   ]);
@@ -571,12 +652,18 @@ function listContacts(opts = {}, db) {
     last_contacted_after,
     last_contacted_before,
     order_by = "display_name",
-    order_dir = "asc"
+    order_dir = "asc",
+    include_dnc = false,
+    priority_min,
+    updated_since
   } = opts;
   const conditions = [];
   const params = [];
   conditions.push("c.archived = ?");
   params.push(archived ? 1 : 0);
+  if (!include_dnc) {
+    conditions.push("c.do_not_contact = 0");
+  }
   if (company_id) {
     conditions.push("c.company_id = ?");
     params.push(company_id);
@@ -614,6 +701,14 @@ function listContacts(opts = {}, db) {
     conditions.push("c.last_contacted_at <= ?");
     params.push(last_contacted_before);
   }
+  if (priority_min !== undefined) {
+    conditions.push("c.priority >= ?");
+    params.push(priority_min);
+  }
+  if (updated_since) {
+    conditions.push("c.updated_at >= ?");
+    params.push(updated_since);
+  }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const validOrderBy = ["display_name", "created_at", "updated_at", "last_contacted_at", "follow_up_at"].includes(order_by) ? order_by : "display_name";
   const validOrderDir = order_dir === "desc" ? "DESC" : "ASC";
@@ -697,6 +792,18 @@ function updateContact(id, input, db) {
     setClauses.push("project_id = ?");
     params.push(input.project_id);
   }
+  if (input.do_not_contact !== undefined) {
+    setClauses.push("do_not_contact = ?");
+    params.push(input.do_not_contact ? 1 : 0);
+  }
+  if (input.priority !== undefined) {
+    setClauses.push("priority = ?");
+    params.push(input.priority ?? 3);
+  }
+  if (input.timezone !== undefined) {
+    setClauses.push("timezone = ?");
+    params.push(input.timezone);
+  }
   params.push(id);
   d.run(`UPDATE contacts SET ${setClauses.join(", ")} WHERE id = ?`, params);
   if (input.emails_add?.length) {
@@ -764,6 +871,11 @@ function searchContacts(query, db) {
   }
   return allRows.map((row) => loadContactDetails(d, rowToContact(row)));
 }
+function listRecentContacts(limit, db) {
+  const d = db || getDatabase();
+  const rows = d.query(`SELECT * FROM contacts ORDER BY updated_at DESC LIMIT ?`).all(limit);
+  return rows.map((row) => loadContactDetails(d, rowToContact(row)));
+}
 function mergeContacts(keepId, mergeId, db) {
   const d = db || getDatabase();
   const keepRow = d.query(`SELECT * FROM contacts WHERE id = ?`).get(keepId);
@@ -890,6 +1002,15 @@ function unarchiveContact(id, db) {
   const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(id);
   return loadContactDetails(d, rowToContact(updated));
 }
+function listColdContacts(days, db) {
+  const d = db || getDatabase();
+  const rows = d.query(`SELECT c.* FROM contacts c
+     WHERE c.archived = 0 AND c.do_not_contact = 0
+       AND (c.last_contacted_at IS NULL OR c.last_contacted_at < datetime('now', ? || ' days'))
+     ORDER BY c.last_contacted_at ASC NULLS FIRST
+     LIMIT 100`).all(`-${days}`);
+  return rows.map((row) => loadContactDetails(d, rowToContact(row)));
+}
 function autoLinkContactToCompany(contactId, db) {
   const d = db || getDatabase();
   const row = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
@@ -909,8 +1030,24 @@ function autoLinkContactToCompany(contactId, db) {
   const updated = d.query(`SELECT * FROM contacts WHERE id = ?`).get(contactId);
   return loadContactDetails(d, rowToContact(updated));
 }
+var init_contacts = __esm(() => {
+  init_types();
+  init_database();
+  init_activity();
+});
+
+// src/mcp/index.ts
+init_database();
+init_contacts();
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema
+} from "@modelcontextprotocol/sdk/types.js";
 
 // src/db/groups.ts
+init_database();
 function createGroup(db, input) {
   const id = uuid();
   db.query(`INSERT INTO groups(id, name, description, created_at, updated_at) VALUES(?,?,?,?,?)`).run(id, input.name, input.description ?? null, now(), now());
@@ -981,6 +1118,8 @@ function listGroupsForCompany(db, companyId) {
 }
 
 // src/db/tags.ts
+init_types();
+init_database();
 function rowToTag2(row) {
   return { ...row };
 }
@@ -1039,6 +1178,9 @@ function removeTagFromCompany(companyId, tagId, db) {
 }
 
 // src/db/companies.ts
+init_types();
+init_database();
+init_activity();
 function rowToCompany2(row) {
   return {
     ...row,
@@ -1292,6 +1434,8 @@ function unarchiveCompany(id, db) {
 }
 
 // src/db/relationships.ts
+init_types();
+init_database();
 function rowToRelationship(row) {
   return {
     ...row,
@@ -1388,7 +1532,12 @@ function deleteCompanyRelationship(id, db) {
   d.run(`DELETE FROM company_relationships WHERE id = ?`, [id]);
 }
 
+// src/mcp/index.ts
+init_activity();
+
 // src/db/notes.ts
+init_types();
+init_database();
 function addNote(contactId, body, createdBy, db, companyId) {
   const d = db || getDatabase();
   const contact = d.query(`SELECT id FROM contacts WHERE id = ?`).get(contactId);
@@ -1721,9 +1870,65 @@ function importFromJson(data) {
     };
   });
 }
+function parseLinkedInCsvLine(line) {
+  return parseCsvLine(line);
+}
+function parseLinkedIn(csv) {
+  const lines = csv.split(`
+`).filter((l) => l.trim());
+  if (!lines.length)
+    return [];
+  const headers = parseLinkedInCsvLine(lines[0]).map((h) => h.replace(/"/g, "").trim());
+  const firstNameIdx = headers.findIndex((h) => h === "First Name");
+  const lastNameIdx = headers.findIndex((h) => h === "Last Name");
+  const emailIdx = headers.findIndex((h) => h === "Email Address");
+  const companyIdx = headers.findIndex((h) => h === "Company");
+  const positionIdx = headers.findIndex((h) => h === "Position");
+  const urlIdx = headers.findIndex((h) => h === "URL");
+  const connectedIdx = headers.findIndex((h) => h === "Connected On");
+  const results = [];
+  for (let i = 1;i < lines.length; i++) {
+    const cols = parseLinkedInCsvLine(lines[i]);
+    const firstName = firstNameIdx >= 0 ? (cols[firstNameIdx] ?? "").trim() : "";
+    const lastName = lastNameIdx >= 0 ? (cols[lastNameIdx] ?? "").trim() : "";
+    if (!firstName && !lastName)
+      continue;
+    const contact = {
+      first_name: firstName,
+      last_name: lastName,
+      display_name: `${firstName} ${lastName}`.trim(),
+      source: "import"
+    };
+    if (emailIdx >= 0 && cols[emailIdx]?.trim()) {
+      contact.emails = [{ address: cols[emailIdx].trim(), type: "work", is_primary: true }];
+    }
+    if (positionIdx >= 0 && cols[positionIdx]?.trim()) {
+      contact.job_title = cols[positionIdx].trim();
+    }
+    if (urlIdx >= 0 && cols[urlIdx]?.trim()) {
+      contact.social_profiles = [{ platform: "linkedin", url: cols[urlIdx].trim(), is_primary: true }];
+    }
+    if (companyIdx >= 0 && cols[companyIdx]?.trim()) {
+      const connectedNote = connectedIdx >= 0 && cols[connectedIdx]?.trim() ? ` Connected on LinkedIn: ${cols[connectedIdx].trim()}` : "";
+      contact.notes = `Company: ${cols[companyIdx].trim()}${connectedNote}`;
+    } else if (connectedIdx >= 0 && cols[connectedIdx]?.trim()) {
+      contact.notes = `Connected on LinkedIn: ${cols[connectedIdx].trim()}`;
+    }
+    results.push(contact);
+  }
+  return results;
+}
+function isLinkedInFormat(data) {
+  const firstLine = data.split(`
+`)[0] ?? "";
+  const lower = firstLine.toLowerCase();
+  return lower.includes("first name") && lower.includes("url") && lower.includes("connected on");
+}
 async function importContacts(format, data) {
   switch (format) {
     case "csv":
+      if (isLinkedInFormat(data))
+        return parseLinkedIn(data);
       return importFromCsv(data);
     case "vcf":
       return parseVcf(data);
@@ -2241,6 +2446,7 @@ async function pullGoogleContactsAsInputs(opts = {}) {
 }
 
 // src/db/org-members.ts
+init_database();
 function rowToOrgMember(row) {
   return {
     id: row.id,
@@ -2318,6 +2524,7 @@ function listOrgMembersForContact(contactId, db) {
 }
 
 // src/db/vendor-comms.ts
+init_database();
 function rowToVendorComm(row) {
   return {
     id: row.id,
@@ -2403,6 +2610,7 @@ function markFollowUpDone(id, db) {
 }
 
 // src/db/contact-tasks.ts
+init_database();
 function rowToContactTask(row) {
   return {
     id: row.id,
@@ -2542,6 +2750,7 @@ function checkEscalations(db) {
 }
 
 // src/db/applications.ts
+init_database();
 function rowToApplication(row) {
   return {
     id: row.id,
@@ -2688,81 +2897,499 @@ function listFollowUpDue(db) {
   return rows.map(rowToApplication);
 }
 
+// src/lib/brief.ts
+init_database();
+init_contacts();
+
+// src/lib/timeline.ts
+init_database();
+function getContactTimeline(contactId, limit = 50, db) {
+  const _db2 = db || getDatabase();
+  const items = [];
+  const notes = _db2.query(`SELECT * FROM contact_notes WHERE contact_id = ? ORDER BY created_at DESC LIMIT 50`).all(contactId);
+  for (const n of notes) {
+    items.push({ date: n.created_at, type: "note", title: "Note", body: n.body });
+  }
+  const events = _db2.query(`SELECT * FROM events WHERE contact_ids LIKE ? ORDER BY event_date DESC LIMIT 50`).all(`%${contactId}%`);
+  for (const e of events) {
+    items.push({ date: e.event_date, type: "event", title: `${e.type}: ${e.title}`, body: e.notes ?? undefined, metadata: { outcome: e.outcome, duration_min: e.duration_min } });
+  }
+  const tasks = _db2.query(`SELECT * FROM contact_tasks WHERE contact_id = ? ORDER BY created_at DESC LIMIT 30`).all(contactId);
+  for (const t of tasks) {
+    items.push({ date: t.created_at, type: "task_created", title: `Task created: ${t.title}`, metadata: { deadline: t.deadline, priority: t.priority } });
+    if (t.status === "completed") {
+      items.push({ date: t.updated_at, type: "task_completed", title: `Task completed: ${t.title}` });
+    }
+  }
+  const comms = _db2.query(`SELECT vc.*, co.name as company_name FROM vendor_communications vc JOIN companies co ON vc.company_id = co.id WHERE vc.contact_id = ? ORDER BY vc.comm_date DESC LIMIT 20`).all(contactId);
+  for (const c of comms) {
+    items.push({ date: c.comm_date, type: "vendor_comm", title: `${c.type} \u2014 ${c.company_name}`, body: c.subject ?? undefined });
+  }
+  const activity = _db2.query(`SELECT * FROM activity_log WHERE contact_id = ? ORDER BY created_at DESC LIMIT 30`).all(contactId);
+  for (const a of activity) {
+    items.push({ date: a.created_at, type: "interaction", title: a.action, body: a.details ?? undefined });
+  }
+  return items.sort((a, b) => b.date.localeCompare(a.date)).slice(0, limit);
+}
+
+// src/lib/brief.ts
+function generateBrief(contactId, db) {
+  const _db2 = db || getDatabase();
+  const contact = getContact(contactId, _db2);
+  const notes = listNotes(contactId, _db2);
+  const allTasks = listContactTasks({ contact_id: contactId }, _db2);
+  const tasks = allTasks.filter((t) => !["completed", "cancelled"].includes(t.status));
+  const overdueTasks = allTasks.filter((t) => t.deadline && t.deadline < new Date().toISOString() && !["completed", "cancelled"].includes(t.status));
+  const companyRels = listCompanyRelationships({ contact_id: contactId }, _db2);
+  const recentTimeline = getContactTimeline(contactId, 5, _db2);
+  const daysSince = contact.last_contacted_at ? Math.floor((Date.now() - new Date(contact.last_contacted_at).getTime()) / 86400000) : null;
+  const lines = [];
+  lines.push(`# ${contact.display_name}`);
+  if (contact.job_title)
+    lines.push(`**Role:** ${contact.job_title}${contact.company_id ? ` (linked to company)` : ""}`);
+  if (contact.emails?.length) {
+    const primary = contact.emails.find((e) => e.is_primary) || contact.emails[0];
+    if (primary)
+      lines.push(`**Email:** ${primary.address}`);
+  }
+  if (contact.phones?.length) {
+    const primary = contact.phones.find((p) => p.is_primary) || contact.phones[0];
+    if (primary)
+      lines.push(`**Phone:** ${primary.number}`);
+  }
+  if (contact.preferred_contact_method)
+    lines.push(`**Preferred contact:** ${contact.preferred_contact_method}`);
+  lines.push("");
+  lines.push(`## Status`);
+  lines.push(`- Last contacted: ${daysSince !== null ? `${daysSince} days ago` : "never"}`);
+  lines.push(`- Status: ${contact.status || "active"}`);
+  if (contact.follow_up_at)
+    lines.push(`- Follow-up scheduled: ${contact.follow_up_at}`);
+  if (overdueTasks.length)
+    lines.push(`- OVERDUE TASKS: ${overdueTasks.length}`);
+  if (companyRels.length) {
+    lines.push("");
+    lines.push(`## Entity Relationships`);
+    for (const r of companyRels)
+      lines.push(`- ${r.relationship_type} \u2014 ${r.notes || ""}`);
+  }
+  if (tasks.length) {
+    lines.push("");
+    lines.push(`## Open Tasks`);
+    for (const t of tasks)
+      lines.push(`- [${t.priority}] ${t.title}${t.deadline ? ` (due ${t.deadline})` : ""}`);
+  }
+  if (notes.length) {
+    lines.push("");
+    lines.push(`## Recent Notes`);
+    for (const n of notes.slice(0, 3))
+      lines.push(`**${n.created_at.slice(0, 10)}:** ${n.body}`);
+  }
+  if (recentTimeline.length) {
+    lines.push("");
+    lines.push(`## Recent Activity`);
+    for (const item of recentTimeline)
+      lines.push(`- ${item.date.slice(0, 10)} ${item.title}`);
+  }
+  if (contact.notes) {
+    lines.push("");
+    lines.push(`## Background Notes`);
+    lines.push(contact.notes);
+  }
+  return lines.join(`
+`);
+}
+
 // src/mcp/index.ts
-var server = new Server({ name: "contacts", version: "0.1.0" }, { capabilities: { tools: {} } });
-server.setRequestHandler(ListToolsRequestSchema, async () => ({
-  tools: [
-    {
-      name: "create_contact",
-      description: "Create a new contact. Provide at minimum display_name or first_name+last_name. Emails, phones, addresses, and social_profiles are arrays of objects. relationship_type values: colleague|friend|family|reports_to|mentor|investor|partner|client|vendor|other. source values: manual|import|linkedin|github|twitter|email|calendar|crm|other.",
-      inputSchema: {
-        type: "object",
-        properties: {
-          first_name: { type: "string" },
-          last_name: { type: "string" },
-          display_name: { type: "string", description: "Display name (auto-generated from first+last if omitted)" },
-          nickname: { type: "string" },
-          job_title: { type: "string" },
-          company_id: { type: "string" },
-          notes: { type: "string" },
-          birthday: { type: "string", description: "YYYY-MM-DD" },
-          website: { type: "string", description: "Personal or professional website URL" },
-          last_contacted_at: { type: "string", description: "ISO 8601 datetime of last contact" },
-          preferred_contact_method: { type: "string", enum: ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"] },
-          status: { type: "string", enum: ["active", "pending_reply", "converted", "closed", "other"], description: "Contact lifecycle status (default: active)" },
-          follow_up_at: { type: "string", description: "ISO 8601 datetime to follow up with this contact" },
-          project_id: { type: "string", description: "Associate contact with a project ID" },
-          emails: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                address: { type: "string" },
-                type: { type: "string", enum: ["work", "personal", "other"] },
-                is_primary: { type: "boolean" }
-              },
-              required: ["address"]
-            }
-          },
-          phones: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                number: { type: "string" },
-                type: { type: "string", enum: ["mobile", "work", "home", "fax", "whatsapp", "other"] },
-                is_primary: { type: "boolean" }
-              },
-              required: ["number"]
-            }
-          },
-          addresses: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                type: { type: "string", enum: ["physical", "mailing", "billing", "virtual", "other"] },
-                street: { type: "string" },
-                city: { type: "string" },
-                state: { type: "string" },
-                zip: { type: "string" },
-                country: { type: "string" },
-                is_primary: { type: "boolean" }
-              }
-            }
-          },
-          social_profiles: {
-            type: "array",
-            items: {
-              type: "object",
-              properties: {
-                platform: { type: "string", enum: ["twitter", "linkedin", "github", "instagram", "telegram", "discord", "youtube", "tiktok", "bluesky", "facebook", "whatsapp", "snapchat", "reddit", "other"] },
-                handle: { type: "string" },
-                url: { type: "string" },
-                is_primary: { type: "boolean" }
-              },
-              required: ["platform"]
-            }
+init_contacts();
+
+// src/lib/upcoming.ts
+init_database();
+function getUpcomingItems(days = 7, db) {
+  const _db2 = db || getDatabase();
+  const items = [];
+  const now3 = new Date;
+  const future = new Date(now3.getTime() + days * 86400000);
+  const todayStr = now3.toISOString().slice(0, 10);
+  const futureStr = future.toISOString().slice(0, 10);
+  const followUps = _db2.query(`SELECT c.id, c.display_name, c.follow_up_at FROM contacts c WHERE c.follow_up_at IS NOT NULL AND c.follow_up_at <= ? AND c.do_not_contact = 0`).all(futureStr);
+  for (const r of followUps) {
+    items.push({ date: r.follow_up_at, type: "follow_up", contact_id: r.id, contact_name: r.display_name, title: `Follow up with ${r.display_name}`, urgency: r.follow_up_at < todayStr ? "overdue" : r.follow_up_at === todayStr ? "today" : "upcoming" });
+  }
+  const tasks = _db2.query(`SELECT ct.*, c.display_name FROM contact_tasks ct JOIN contacts c ON ct.contact_id = c.id WHERE ct.deadline IS NOT NULL AND ct.deadline <= ? AND ct.status NOT IN ('completed','cancelled')`).all(futureStr);
+  for (const t of tasks) {
+    items.push({ date: t.deadline, type: "task_deadline", contact_id: t.contact_id, contact_name: t.display_name, title: t.title, urgency: t.deadline < todayStr ? "overdue" : t.deadline === todayStr ? "today" : "upcoming" });
+  }
+  const apps = _db2.query(`SELECT a.*, c.display_name as contact_name FROM applications a LEFT JOIN contacts c ON a.primary_contact_id = c.id WHERE a.follow_up_date IS NOT NULL AND a.follow_up_date <= ?`).all(futureStr);
+  for (const a of apps) {
+    items.push({ date: a.follow_up_date, type: "application_followup", contact_name: a.contact_name ?? undefined, title: `Follow up: ${a.program_name}`, urgency: a.follow_up_date < todayStr ? "overdue" : a.follow_up_date === todayStr ? "today" : "upcoming" });
+  }
+  const vendorFU = _db2.query(`SELECT vc.*, co.name as company_name FROM vendor_communications vc JOIN companies co ON vc.company_id = co.id WHERE vc.follow_up_date IS NOT NULL AND vc.follow_up_date <= ? AND vc.follow_up_done = 0`).all(futureStr);
+  for (const v of vendorFU) {
+    items.push({ date: v.follow_up_date, type: "vendor_followup", company_id: v.company_id, company_name: v.company_name, title: `Follow up with ${v.company_name}: ${v.subject || v.type}`, urgency: v.follow_up_date < todayStr ? "overdue" : v.follow_up_date === todayStr ? "today" : "upcoming" });
+  }
+  const contacts = _db2.query(`SELECT id, display_name, birthday FROM contacts WHERE birthday IS NOT NULL AND do_not_contact = 0`).all();
+  for (const c of contacts) {
+    const bday = new Date(c.birthday);
+    const thisYear = new Date(now3.getFullYear(), bday.getMonth(), bday.getDate());
+    const nextBday = thisYear >= now3 ? thisYear : new Date(now3.getFullYear() + 1, bday.getMonth(), bday.getDate());
+    const nextStr = nextBday.toISOString().slice(0, 10);
+    if (nextStr <= futureStr) {
+      items.push({ date: nextStr, type: "birthday", contact_id: c.id, contact_name: c.display_name, title: `Birthday: ${c.display_name}`, urgency: nextStr === todayStr ? "today" : "upcoming" });
+    }
+  }
+  return items.sort((a, b) => a.date.localeCompare(b.date));
+}
+
+// src/lib/stats.ts
+init_database();
+function getNetworkStats(db) {
+  const _db2 = db || getDatabase();
+  const q = (sql) => _db2.query(sql).get();
+  const today = new Date().toISOString().slice(0, 10);
+  const d30 = new Date(Date.now() - 30 * 86400000).toISOString().slice(0, 10);
+  const d60 = new Date(Date.now() - 60 * 86400000).toISOString().slice(0, 10);
+  return {
+    total_contacts: q(`SELECT COUNT(*) c FROM contacts WHERE archived=0`).c,
+    total_companies: q(`SELECT COUNT(*) c FROM companies WHERE archived=0`).c,
+    owned_entities: q(`SELECT COUNT(*) c FROM companies WHERE is_owned_entity=1`).c,
+    total_tags: q(`SELECT COUNT(*) c FROM tags`).c,
+    total_groups: q(`SELECT COUNT(*) c FROM groups`).c,
+    total_deals: q(`SELECT COUNT(*) c FROM deals WHERE stage NOT IN ('won','lost','cancelled')`).c,
+    total_events: q(`SELECT COUNT(*) c FROM events`).c,
+    cold_30d: q(`SELECT COUNT(*) c FROM contacts WHERE archived=0 AND do_not_contact=0 AND (last_contacted_at IS NULL OR last_contacted_at < '${d30}')`).c,
+    cold_60d: q(`SELECT COUNT(*) c FROM contacts WHERE archived=0 AND do_not_contact=0 AND (last_contacted_at IS NULL OR last_contacted_at < '${d60}')`).c,
+    cold_never: q(`SELECT COUNT(*) c FROM contacts WHERE archived=0 AND do_not_contact=0 AND last_contacted_at IS NULL`).c,
+    contacts_with_email: q(`SELECT COUNT(DISTINCT contact_id) c FROM emails WHERE contact_id IS NOT NULL`).c,
+    contacts_with_phone: q(`SELECT COUNT(DISTINCT contact_id) c FROM phones WHERE contact_id IS NOT NULL`).c,
+    contacts_no_company: q(`SELECT COUNT(*) c FROM contacts WHERE archived=0 AND company_id IS NULL`).c,
+    overdue_tasks: q(`SELECT COUNT(*) c FROM contact_tasks WHERE deadline < '${today}' AND status NOT IN ('completed','cancelled')`).c,
+    pending_applications: q(`SELECT COUNT(*) c FROM applications WHERE status IN ('submitted','pending','follow_up_needed')`).c,
+    missing_invoices: q(`SELECT COUNT(*) c FROM vendor_communications WHERE type='invoice_request' AND status IN ('awaiting_response','no_response')`).c,
+    upcoming_7d: q(`SELECT COUNT(*) c FROM contacts WHERE follow_up_at BETWEEN '${today}' AND date('${today}','+7 days')`).c,
+    notes_count: q(`SELECT COUNT(*) c FROM contact_notes`).c,
+    active_deals_value: q(`SELECT COALESCE(SUM(value_usd),0) c FROM deals WHERE stage NOT IN ('won','lost','cancelled') AND currency='USD'`).c
+  };
+}
+
+// src/lib/audit.ts
+init_database();
+function auditContact(contact) {
+  const missing = [];
+  const suggestions = [];
+  let score = 0;
+  if (contact.emails?.length)
+    score += 20;
+  else {
+    missing.push("email");
+    suggestions.push("Add an email address");
+  }
+  if (contact.phones?.length)
+    score += 15;
+  else {
+    missing.push("phone");
+    suggestions.push("Add a phone number");
+  }
+  if (contact.company_id)
+    score += 15;
+  else {
+    missing.push("company");
+    suggestions.push("Link to a company");
+  }
+  if (contact.last_contacted_at)
+    score += 20;
+  else {
+    missing.push("last_contacted_at");
+    suggestions.push("Log a contact interaction");
+  }
+  if (contact.tags?.length)
+    score += 10;
+  else {
+    missing.push("tags");
+    suggestions.push("Add at least one tag");
+  }
+  if (contact.notes)
+    score += 10;
+  else {
+    missing.push("notes");
+    suggestions.push("Add notes");
+  }
+  if (contact.job_title)
+    score += 10;
+  else {
+    missing.push("job_title");
+    suggestions.push("Add a job title");
+  }
+  return { contact_id: contact.id, display_name: contact.display_name, score, missing, suggestions };
+}
+async function listContactAudit(db) {
+  const _db2 = db || getDatabase();
+  const { listContacts: listContacts2 } = await Promise.resolve().then(() => (init_contacts(), exports_contacts));
+  const { contacts } = listContacts2({ limit: 500, include_dnc: true }, _db2);
+  return contacts.map(auditContact).sort((a, b) => a.score - b.score);
+}
+
+// src/db/deals.ts
+init_database();
+function rowToDeal(row) {
+  return {
+    id: row.id,
+    title: row.title,
+    contact_id: row.contact_id,
+    company_id: row.company_id,
+    stage: row.stage,
+    value_usd: row.value_usd,
+    currency: row.currency,
+    close_date: row.close_date,
+    notes: row.notes,
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
+}
+function createDeal(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO deals (id, title, contact_id, company_id, stage, value_usd, currency, close_date, notes, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.title,
+    input.contact_id ?? null,
+    input.company_id ?? null,
+    input.stage ?? "lead",
+    input.value_usd ?? null,
+    input.currency ?? "USD",
+    input.close_date ?? null,
+    input.notes ?? null,
+    timestamp,
+    timestamp
+  ]);
+  return rowToDeal(d.query(`SELECT * FROM deals WHERE id = ?`).get(id));
+}
+function getDeal(id, db) {
+  const d = db || getDatabase();
+  const row = d.query(`SELECT * FROM deals WHERE id = ?`).get(id);
+  return row ? rowToDeal(row) : null;
+}
+function listDeals(opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (opts.stage) {
+    conditions.push("stage = ?");
+    params.push(opts.stage);
+  }
+  if (opts.contact_id) {
+    conditions.push("contact_id = ?");
+    params.push(opts.contact_id);
+  }
+  if (opts.company_id) {
+    conditions.push("company_id = ?");
+    params.push(opts.company_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM deals ${where} ORDER BY created_at DESC`).all(...params);
+  return rows.map(rowToDeal);
+}
+function updateDeal(id, input, db) {
+  const d = db || getDatabase();
+  const existing = d.query(`SELECT * FROM deals WHERE id = ?`).get(id);
+  if (!existing)
+    return null;
+  const setClauses = ["updated_at = ?"];
+  const params = [now()];
+  if (input.title !== undefined) {
+    setClauses.push("title = ?");
+    params.push(input.title);
+  }
+  if (input.contact_id !== undefined) {
+    setClauses.push("contact_id = ?");
+    params.push(input.contact_id ?? null);
+  }
+  if (input.company_id !== undefined) {
+    setClauses.push("company_id = ?");
+    params.push(input.company_id ?? null);
+  }
+  if (input.stage !== undefined) {
+    setClauses.push("stage = ?");
+    params.push(input.stage);
+  }
+  if (input.value_usd !== undefined) {
+    setClauses.push("value_usd = ?");
+    params.push(input.value_usd ?? null);
+  }
+  if (input.currency !== undefined) {
+    setClauses.push("currency = ?");
+    params.push(input.currency);
+  }
+  if (input.close_date !== undefined) {
+    setClauses.push("close_date = ?");
+    params.push(input.close_date ?? null);
+  }
+  if (input.notes !== undefined) {
+    setClauses.push("notes = ?");
+    params.push(input.notes ?? null);
+  }
+  params.push(id);
+  d.run(`UPDATE deals SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  return rowToDeal(d.query(`SELECT * FROM deals WHERE id = ?`).get(id));
+}
+function deleteDeal(id, db) {
+  const d = db || getDatabase();
+  d.run(`DELETE FROM deals WHERE id = ?`, [id]);
+}
+
+// src/db/events.ts
+init_database();
+function rowToEvent(row) {
+  let contact_ids = [];
+  try {
+    contact_ids = JSON.parse(row.contact_ids);
+  } catch {
+    contact_ids = [];
+  }
+  return {
+    id: row.id,
+    title: row.title,
+    type: row.type,
+    event_date: row.event_date,
+    duration_min: row.duration_min,
+    contact_ids,
+    company_id: row.company_id,
+    notes: row.notes,
+    outcome: row.outcome,
+    deal_id: row.deal_id,
+    created_at: row.created_at
+  };
+}
+function logEvent(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO events (id, title, type, event_date, duration_min, contact_ids, company_id, notes, outcome, deal_id, created_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.title,
+    input.type ?? "meeting",
+    input.event_date,
+    input.duration_min ?? null,
+    JSON.stringify(input.contact_ids ?? []),
+    input.company_id ?? null,
+    input.notes ?? null,
+    input.outcome ?? null,
+    input.deal_id ?? null,
+    timestamp
+  ]);
+  return rowToEvent(d.query(`SELECT * FROM events WHERE id = ?`).get(id));
+}
+function listEvents(opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (opts.contact_id) {
+    conditions.push("contact_ids LIKE ?");
+    params.push(`%${opts.contact_id}%`);
+  }
+  if (opts.company_id) {
+    conditions.push("company_id = ?");
+    params.push(opts.company_id);
+  }
+  if (opts.type) {
+    conditions.push("type = ?");
+    params.push(opts.type);
+  }
+  if (opts.date_from) {
+    conditions.push("event_date >= ?");
+    params.push(opts.date_from);
+  }
+  if (opts.date_to) {
+    conditions.push("event_date <= ?");
+    params.push(opts.date_to);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM events ${where} ORDER BY event_date DESC`).all(...params);
+  return rows.map(rowToEvent);
+}
+function deleteEvent(id, db) {
+  const d = db || getDatabase();
+  d.run(`DELETE FROM events WHERE id = ?`, [id]);
+}
+
+// src/mcp/index.ts
+var server = new Server({ name: "contacts", version: "0.1.0" }, { capabilities: { tools: {} } });
+server.setRequestHandler(ListToolsRequestSchema, async () => ({
+  tools: [
+    {
+      name: "create_contact",
+      description: "Create a new contact. Provide at minimum display_name or first_name+last_name. Emails, phones, addresses, and social_profiles are arrays of objects. relationship_type values: colleague|friend|family|reports_to|mentor|investor|partner|client|vendor|other. source values: manual|import|linkedin|github|twitter|email|calendar|crm|other.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          first_name: { type: "string" },
+          last_name: { type: "string" },
+          display_name: { type: "string", description: "Display name (auto-generated from first+last if omitted)" },
+          nickname: { type: "string" },
+          job_title: { type: "string" },
+          company_id: { type: "string" },
+          notes: { type: "string" },
+          birthday: { type: "string", description: "YYYY-MM-DD" },
+          website: { type: "string", description: "Personal or professional website URL" },
+          last_contacted_at: { type: "string", description: "ISO 8601 datetime of last contact" },
+          preferred_contact_method: { type: "string", enum: ["email", "phone", "telegram", "whatsapp", "linkedin", "twitter", "other"] },
+          status: { type: "string", enum: ["active", "pending_reply", "converted", "closed", "other"], description: "Contact lifecycle status (default: active)" },
+          follow_up_at: { type: "string", description: "ISO 8601 datetime to follow up with this contact" },
+          project_id: { type: "string", description: "Associate contact with a project ID" },
+          emails: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                address: { type: "string" },
+                type: { type: "string", enum: ["work", "personal", "other"] },
+                is_primary: { type: "boolean" }
+              },
+              required: ["address"]
+            }
+          },
+          phones: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                number: { type: "string" },
+                type: { type: "string", enum: ["mobile", "work", "home", "fax", "whatsapp", "other"] },
+                is_primary: { type: "boolean" }
+              },
+              required: ["number"]
+            }
+          },
+          addresses: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                type: { type: "string", enum: ["physical", "mailing", "billing", "virtual", "other"] },
+                street: { type: "string" },
+                city: { type: "string" },
+                state: { type: "string" },
+                zip: { type: "string" },
+                country: { type: "string" },
+                is_primary: { type: "boolean" }
+              }
+            }
+          },
+          social_profiles: {
+            type: "array",
+            items: {
+              type: "object",
+              properties: {
+                platform: { type: "string", enum: ["twitter", "linkedin", "github", "instagram", "telegram", "discord", "youtube", "tiktok", "bluesky", "facebook", "whatsapp", "snapchat", "reddit", "other"] },
+                handle: { type: "string" },
+                url: { type: "string" },
+                is_primary: { type: "boolean" }
+              },
+              required: ["platform"]
+            }
           },
           tag_ids: { type: "array", items: { type: "string" }, description: "Tag IDs to assign" },
           source: { type: "string", enum: ["manual", "import", "linkedin", "github", "twitter", "email", "calendar", "crm", "other"] }
@@ -3041,12 +3668,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
     },
     {
       name: "export_contacts",
-      description: "Export contacts to CSV, vCard (.vcf), or JSON format. Optionally specify contact_ids to export a subset; omit to export all contacts.",
+      description: "Export contacts to CSV, vCard (.vcf), or JSON format. Optionally specify contact_ids to export a subset; omit to export all contacts. Use updated_since to export only contacts updated after a date.",
       inputSchema: {
         type: "object",
         properties: {
           format: { type: "string", enum: ["json", "csv", "vcf"] },
-          contact_ids: { type: "array", items: { type: "string" }, description: "Specific contact IDs to export (omit for all)" }
+          contact_ids: { type: "array", items: { type: "string" }, description: "Specific contact IDs to export (omit for all)" },
+          updated_since: { type: "string", description: "ISO 8601 date \u2014 only export contacts updated/contacted after this date" }
         },
         required: ["format"]
       }
@@ -3837,6 +4465,228 @@ server.setRequestHandler(ListToolsRequestSchema, async () => ({
         },
         required: ["company_id"]
       }
+    },
+    {
+      name: "get_contact_brief",
+      description: "Generate a comprehensive pre-meeting briefing for a contact. Returns structured markdown covering: role/company, contact details, status, last contacted, open tasks, overdue items, entity relationships, recent notes, recent activity. Feed this to an AI before a meeting or call.",
+      inputSchema: {
+        type: "object",
+        properties: { contact_id: { type: "string" } },
+        required: ["contact_id"]
+      }
+    },
+    {
+      name: "list_cold_contacts",
+      description: "List contacts you haven't been in touch with for N days (default 30). Sorted by most neglected first. Use to identify who needs re-engagement. 'never' means last_contacted_at was never set.",
+      inputSchema: {
+        type: "object",
+        properties: { days: { type: "number", description: "Days threshold (default 30)" } }
+      }
+    },
+    {
+      name: "get_upcoming",
+      description: "Get a unified calendar of upcoming items: follow-ups due, birthdays, task deadlines, application follow-ups, vendor follow-ups. Default 7-day window. Returns items sorted by date with urgency (overdue/today/upcoming).",
+      inputSchema: {
+        type: "object",
+        properties: { days: { type: "number", description: "Days ahead to show (default 7)" } }
+      }
+    },
+    {
+      name: "get_network_stats",
+      description: "Get comprehensive network health stats: contact counts, cold contacts (30d/60d/never), data completeness, overdue tasks, pending applications, missing invoices, active deal pipeline value. The health dashboard for your network.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "audit_contacts",
+      description: "Score all contacts for data completeness (0-100). Points: email +20, phone +15, company +15, last_contacted_at +20, tags +10, notes +10, job_title +10. Returns contacts sorted by score ascending (worst first) so you know who to enrich.",
+      inputSchema: {
+        type: "object",
+        properties: { limit: { type: "number", description: "Number to show (default 20)" } }
+      }
+    },
+    {
+      name: "create_deal",
+      description: "Create a new deal or opportunity, optionally linked to a contact and/or company.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          title: { type: "string" },
+          contact_id: { type: "string" },
+          company_id: { type: "string" },
+          stage: { type: "string", enum: ["prospecting", "qualified", "proposal", "negotiation", "won", "lost"], description: "Deal stage (default: prospecting)" },
+          value_usd: { type: "number" },
+          currency: { type: "string" },
+          close_date: { type: "string", description: "Expected close date (YYYY-MM-DD)" },
+          notes: { type: "string" }
+        },
+        required: ["title"]
+      }
+    },
+    {
+      name: "get_deal",
+      description: "Get a deal by ID.",
+      inputSchema: {
+        type: "object",
+        properties: { id: { type: "string" } },
+        required: ["id"]
+      }
+    },
+    {
+      name: "list_deals",
+      description: "List deals, optionally filtered by stage, contact, or company.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          stage: { type: "string", enum: ["prospecting", "qualified", "proposal", "negotiation", "won", "lost"] },
+          contact_id: { type: "string" },
+          company_id: { type: "string" }
+        }
+      }
+    },
+    {
+      name: "update_deal",
+      description: "Update a deal's title, stage, value, close date, or notes.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          id: { type: "string" },
+          title: { type: "string" },
+          stage: { type: "string", enum: ["prospecting", "qualified", "proposal", "negotiation", "won", "lost"] },
+          value_usd: { type: "number" },
+          close_date: { type: "string" },
+          notes: { type: "string" }
+        },
+        required: ["id"]
+      }
+    },
+    {
+      name: "delete_deal",
+      description: "Delete a deal by ID.",
+      inputSchema: {
+        type: "object",
+        properties: { id: { type: "string" } },
+        required: ["id"]
+      }
+    },
+    {
+      name: "log_event",
+      description: "Log a meeting, call, or interaction event with one or more contacts.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          title: { type: "string" },
+          type: { type: "string", enum: ["meeting", "call", "email", "lunch", "conference", "demo", "other"] },
+          event_date: { type: "string", description: "ISO date or datetime of the event" },
+          duration_min: { type: "number", description: "Duration in minutes" },
+          contact_ids: { type: "array", items: { type: "string" }, description: "Contact IDs who attended" },
+          company_id: { type: "string" },
+          notes: { type: "string" },
+          outcome: { type: "string" },
+          deal_id: { type: "string" }
+        },
+        required: ["title", "event_date"]
+      }
+    },
+    {
+      name: "list_events",
+      description: "List events, optionally filtered by contact, company, type, or date range.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          contact_id: { type: "string" },
+          company_id: { type: "string" },
+          type: { type: "string" },
+          date_from: { type: "string" },
+          date_to: { type: "string" }
+        }
+      }
+    },
+    {
+      name: "delete_event",
+      description: "Delete an event by ID.",
+      inputSchema: {
+        type: "object",
+        properties: { id: { type: "string" } },
+        required: ["id"]
+      }
+    },
+    {
+      name: "get_contact_timeline",
+      description: "Get full chronological activity history for a contact: notes, events, tasks, vendor communications, interactions \u2014 all unified in reverse date order. The account history view.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          contact_id: { type: "string" },
+          limit: { type: "number", description: "Max items (default 50)" }
+        },
+        required: ["contact_id"]
+      }
+    },
+    {
+      name: "enrich_contact",
+      description: "Search the web for missing contact data (LinkedIn, Twitter, GitHub, phone, company website) using the contact's name, email, and company. Returns SUGGESTIONS only \u2014 does not auto-apply. Review and apply with update_contact.",
+      inputSchema: {
+        type: "object",
+        properties: { contact_id: { type: "string" } },
+        required: ["contact_id"]
+      }
+    },
+    {
+      name: "get_contacts_for_context",
+      description: "Find contacts relevant to a topic or domain. Searches job titles, notes, specializations, company names, relationship types, tags, and org memberships. Returns ranked results with relevance reason. Essential for agents: 'who do I contact about trademark law?' \u2192 returns attorneys at Revision Legal.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          topic: { type: "string", description: "Topic or domain to search for (e.g. 'trademark law', 'payroll', 'banking')" },
+          limit: { type: "number", description: "Max results (default 10)" }
+        },
+        required: ["topic"]
+      }
+    },
+    {
+      name: "set_reminder",
+      description: "Schedule a follow-up reminder for a contact. Sets follow_up_at to the specified date and adds a note with the reminder text. Will appear in get_upcoming results. Use: set_reminder({contact_id, remind_at: '2026-04-01', note: 'Check on invoice status'})",
+      inputSchema: {
+        type: "object",
+        properties: {
+          contact_id: { type: "string" },
+          remind_at: { type: "string", description: "Reminder date (YYYY-MM-DD)" },
+          note: { type: "string", description: "Optional reminder note" }
+        },
+        required: ["contact_id", "remind_at"]
+      }
+    },
+    {
+      name: "check_and_fire_webhooks",
+      description: "Check all registered webhooks and fire any that match current conditions: contact.stale (last_contacted_at > 30 days), task.overdue (deadline passed), followup.due (follow_up_at <= today). Returns list of fired webhooks.",
+      inputSchema: { type: "object", properties: {} }
+    },
+    {
+      name: "bulk_tag_contacts",
+      description: "Apply or remove a tag from multiple contacts at once. Either pass contact_ids array directly, or pass a search query and all matching contacts will be tagged. Returns count of contacts tagged.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          tag_id_or_name: { type: "string", description: "Tag ID (UUID) or tag name to apply/remove" },
+          action: { type: "string", enum: ["add", "remove"] },
+          contact_ids: { type: "array", items: { type: "string" }, description: "Specific contact IDs (alternative to query)" },
+          query: { type: "string", description: "Search query \u2014 all matching contacts will be tagged" }
+        },
+        required: ["tag_id_or_name", "action"]
+      }
+    },
+    {
+      name: "set_do_not_contact",
+      description: "Mark a contact as do-not-contact (DNC). They will be excluded from list_contacts, cold, and upcoming results unless explicitly requested. Use for GDPR compliance or unsubscribes.",
+      inputSchema: {
+        type: "object",
+        properties: {
+          contact_id: { type: "string" },
+          do_not_contact: { type: "boolean" },
+          reason: { type: "string", description: "Reason for DNC flag (optional)" }
+        },
+        required: ["contact_id", "do_not_contact"]
+      }
     }
   ]
 }));
@@ -4054,18 +4904,6 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
           }]
         };
       }
-      case "export_contacts": {
-        const format = a.format;
-        const contactIds = a.contact_ids;
-        let contactList;
-        if (contactIds && contactIds.length > 0) {
-          contactList = contactIds.map((id) => getContact(id));
-        } else {
-          contactList = listContacts({ limit: 1e4 }).contacts;
-        }
-        const output = await exportContacts(format, contactList);
-        return { content: [{ type: "text", text: output }] };
-      }
       case "get_stats": {
         const db = getDatabase();
         const contactCount = db.prepare("SELECT COUNT(*) as count FROM contacts").get().count;
@@ -4761,6 +5599,258 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
         const team = listCompanyRelationships({ company_id: a.company_id }, db);
         return { content: [{ type: "text", text: JSON.stringify({ company, team }, null, 2) }] };
       }
+      case "get_contact_brief": {
+        const db = getDatabase();
+        const brief = generateBrief(a.contact_id, db);
+        return { content: [{ type: "text", text: JSON.stringify({ brief }, null, 2) }] };
+      }
+      case "list_cold_contacts": {
+        const db = getDatabase();
+        const contacts = listColdContacts(a.days ?? 30, db);
+        return { content: [{ type: "text", text: JSON.stringify({ contacts }, null, 2) }] };
+      }
+      case "get_upcoming": {
+        const db = getDatabase();
+        const items = getUpcomingItems(a.days ?? 7, db);
+        return { content: [{ type: "text", text: JSON.stringify({ items }, null, 2) }] };
+      }
+      case "get_network_stats": {
+        const db = getDatabase();
+        const stats = getNetworkStats(db);
+        return { content: [{ type: "text", text: JSON.stringify(stats, null, 2) }] };
+      }
+      case "audit_contacts": {
+        const db = getDatabase();
+        const results = (await listContactAudit(db)).slice(0, a.limit ?? 20);
+        return { content: [{ type: "text", text: JSON.stringify({ results }, null, 2) }] };
+      }
+      case "create_deal": {
+        const db = getDatabase();
+        const deal = createDeal({
+          title: a.title,
+          contact_id: a.contact_id,
+          company_id: a.company_id,
+          stage: a.stage,
+          value_usd: a.value_usd,
+          currency: a.currency,
+          close_date: a.close_date,
+          notes: a.notes
+        }, db);
+        return { content: [{ type: "text", text: JSON.stringify(deal, null, 2) }] };
+      }
+      case "get_deal": {
+        const db = getDatabase();
+        const deal = getDeal(a.id, db);
+        return { content: [{ type: "text", text: JSON.stringify(deal, null, 2) }] };
+      }
+      case "list_deals": {
+        const db = getDatabase();
+        const deals = listDeals({
+          stage: a.stage,
+          contact_id: a.contact_id,
+          company_id: a.company_id
+        }, db);
+        return { content: [{ type: "text", text: JSON.stringify({ deals }, null, 2) }] };
+      }
+      case "update_deal": {
+        const db = getDatabase();
+        const { id: dealId, ...dealRest } = a;
+        const deal = updateDeal(dealId, {
+          title: dealRest.title,
+          stage: dealRest.stage,
+          value_usd: dealRest.value_usd,
+          close_date: dealRest.close_date,
+          notes: dealRest.notes
+        }, db);
+        return { content: [{ type: "text", text: JSON.stringify(deal, null, 2) }] };
+      }
+      case "delete_deal": {
+        const db = getDatabase();
+        deleteDeal(a.id, db);
+        return { content: [{ type: "text", text: JSON.stringify({ deleted: true }) }] };
+      }
+      case "log_event": {
+        const db = getDatabase();
+        const event = logEvent({
+          title: a.title,
+          type: a.type,
+          event_date: a.event_date,
+          duration_min: a.duration_min,
+          contact_ids: a.contact_ids,
+          company_id: a.company_id,
+          notes: a.notes,
+          outcome: a.outcome,
+          deal_id: a.deal_id
+        }, db);
+        return { content: [{ type: "text", text: JSON.stringify(event, null, 2) }] };
+      }
+      case "list_events": {
+        const db = getDatabase();
+        const events = listEvents({
+          contact_id: a.contact_id,
+          company_id: a.company_id,
+          type: a.type,
+          date_from: a.date_from,
+          date_to: a.date_to
+        }, db);
+        return { content: [{ type: "text", text: JSON.stringify({ events }, null, 2) }] };
+      }
+      case "delete_event": {
+        const db = getDatabase();
+        deleteEvent(a.id, db);
+        return { content: [{ type: "text", text: JSON.stringify({ deleted: true }) }] };
+      }
+      case "get_contact_timeline": {
+        const db = getDatabase();
+        const items = getContactTimeline(a.contact_id, a.limit ?? 50, db);
+        return { content: [{ type: "text", text: JSON.stringify({ items }, null, 2) }] };
+      }
+      case "enrich_contact": {
+        const db = getDatabase();
+        const contact = getContact(a.contact_id);
+        const exaKey = process.env["EXA_API_KEY"];
+        if (!exaKey) {
+          return { content: [{ type: "text", text: JSON.stringify({ error: "Set EXA_API_KEY to use enrichment", contact_id: a.contact_id, suggestions: [] }, null, 2) }] };
+        }
+        const query = `${contact.display_name} ${contact.emails?.[0]?.address ?? ""} site:linkedin.com OR site:twitter.com OR site:github.com`;
+        const res = await fetch("https://api.exa.ai/search", {
+          method: "POST",
+          headers: { "x-api-key": exaKey, "content-type": "application/json" },
+          body: JSON.stringify({ query, num_results: 5 })
+        });
+        const data = await res.json();
+        const suggestions = {};
+        const socialProfiles = contact.social_profiles;
+        for (const r of data.results ?? []) {
+          if (r.url?.includes("linkedin.com") && !socialProfiles?.find((s) => s.platform === "linkedin"))
+            suggestions["linkedin"] = r.url;
+          if (r.url?.includes("twitter.com") && !socialProfiles?.find((s) => s.platform === "twitter"))
+            suggestions["twitter"] = r.url;
+          if (r.url?.includes("github.com") && !socialProfiles?.find((s) => s.platform === "github"))
+            suggestions["github"] = r.url;
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ contact_id: a.contact_id, contact_name: contact.display_name, suggestions, raw_results: data.results?.slice(0, 3) }, null, 2) }] };
+      }
+      case "get_contacts_for_context": {
+        const db = getDatabase();
+        const { topic, limit = 10 } = a;
+        const byTitle = db.query(`SELECT c.id, c.display_name, c.job_title, 'job_title' as reason FROM contacts c WHERE c.job_title LIKE ? AND c.archived=0 LIMIT 20`).all(`%${topic}%`);
+        const byNotes = db.query(`SELECT c.id, c.display_name, c.job_title, 'notes' as reason FROM contacts c WHERE c.notes LIKE ? AND c.archived=0 LIMIT 10`).all(`%${topic}%`);
+        const byCompany = db.query(`SELECT c.id, c.display_name, c.job_title, 'company' as reason FROM contacts c JOIN companies co ON c.company_id = co.id WHERE (co.name LIKE ? OR co.industry LIKE ?) AND c.archived=0 LIMIT 10`).all(`%${topic}%`, `%${topic}%`);
+        const bySpec = db.query(`SELECT c.id, c.display_name, c.job_title, om.specialization as reason FROM contacts c JOIN org_members om ON c.id = om.contact_id WHERE om.specialization LIKE ? LIMIT 10`).all(`%${topic}%`);
+        const seen = new Set;
+        const results = [...byTitle, ...bySpec, ...byCompany, ...byNotes].filter((r) => {
+          if (seen.has(r.id))
+            return false;
+          seen.add(r.id);
+          return true;
+        }).slice(0, limit);
+        return { content: [{ type: "text", text: JSON.stringify({ topic, results }, null, 2) }] };
+      }
+      case "set_reminder": {
+        const db = getDatabase();
+        updateContact(a.contact_id, { follow_up_at: a.remind_at });
+        if (a.note) {
+          addNote(a.contact_id, `Reminder (${a.remind_at}): ${a.note}`, undefined, db);
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ set: true, contact_id: a.contact_id, remind_at: a.remind_at }, null, 2) }] };
+      }
+      case "check_and_fire_webhooks": {
+        const db = getDatabase();
+        let webhooks = [];
+        try {
+          webhooks = db.query(`SELECT id, event_type, url, secret FROM webhooks WHERE active=1`).all();
+        } catch {
+          return { content: [{ type: "text", text: JSON.stringify({ fired: [], message: "webhooks table not available" }, null, 2) }] };
+        }
+        const today = new Date().toISOString().slice(0, 10);
+        const fired = [];
+        for (const wh of webhooks) {
+          let payload = null;
+          if (wh.event_type === "contact.stale") {
+            const stale = db.query(`SELECT id, display_name, last_contacted_at FROM contacts WHERE (last_contacted_at IS NULL OR last_contacted_at < date('now', '-30 days')) AND archived=0 LIMIT 50`).all();
+            if (stale.length > 0)
+              payload = { event: "contact.stale", contacts: stale, fired_at: new Date().toISOString() };
+          } else if (wh.event_type === "task.overdue") {
+            const overdue = listOverdueTasks(db);
+            if (overdue.length > 0)
+              payload = { event: "task.overdue", tasks: overdue, fired_at: new Date().toISOString() };
+          } else if (wh.event_type === "followup.due") {
+            const due = db.query(`SELECT id, display_name, follow_up_at FROM contacts WHERE follow_up_at IS NOT NULL AND follow_up_at <= ? AND archived=0`).all(today);
+            if (due.length > 0)
+              payload = { event: "followup.due", contacts: due, fired_at: new Date().toISOString() };
+          }
+          if (payload) {
+            const headers = { "content-type": "application/json" };
+            if (wh.secret) {
+              const crypto2 = await import("crypto");
+              const sig = crypto2.createHmac("sha256", wh.secret).update(JSON.stringify(payload)).digest("hex");
+              headers["x-contacts-signature"] = `sha256=${sig}`;
+            }
+            try {
+              const resp = await fetch(wh.url, { method: "POST", headers, body: JSON.stringify(payload) });
+              fired.push({ webhook_id: wh.id, event_type: wh.event_type, status: resp.status });
+            } catch {
+              fired.push({ webhook_id: wh.id, event_type: wh.event_type, status: 0 });
+            }
+          }
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ fired }, null, 2) }] };
+      }
+      case "bulk_tag_contacts": {
+        const db = getDatabase();
+        const tagInput = a.tag_id_or_name;
+        const action = a.action;
+        const isUuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(tagInput);
+        let tagId = isUuid ? tagInput : null;
+        let tagName = tagInput;
+        if (!tagId) {
+          const tag = getTagByName(tagInput, db);
+          if (!tag)
+            return { content: [{ type: "text", text: `Tag not found: ${tagInput}` }], isError: true };
+          tagId = tag.id;
+          tagName = tag.name;
+        }
+        let contactIds = a.contact_ids ?? [];
+        if (a.query && typeof a.query === "string") {
+          const found = searchContacts(a.query);
+          contactIds = [...contactIds, ...found.map((c) => c.id)];
+        }
+        contactIds = [...new Set(contactIds)];
+        let taggedCount = 0;
+        for (const cid of contactIds) {
+          try {
+            if (action === "add") {
+              addTagToContact(cid, tagId);
+            } else {
+              removeTagFromContact(cid, tagId);
+            }
+            taggedCount++;
+          } catch {}
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ tagged_count: taggedCount, tag_name: tagName, action }, null, 2) }] };
+      }
+      case "set_do_not_contact": {
+        const db = getDatabase();
+        updateContact(a.contact_id, { do_not_contact: a.do_not_contact });
+        if (a.reason && !!a.do_not_contact) {
+          addNote(a.contact_id, `DNC: ${a.reason}`, undefined, db);
+        }
+        return { content: [{ type: "text", text: JSON.stringify({ set: true, contact_id: a.contact_id, do_not_contact: a.do_not_contact }, null, 2) }] };
+      }
+      case "export_contacts": {
+        const format = a.format;
+        const contactIds = a.contact_ids;
+        const updatedSince = a.updated_since;
+        let contactList;
+        if (contactIds && contactIds.length > 0) {
+          contactList = contactIds.map((id) => getContact(id));
+        } else {
+          contactList = listContacts({ limit: 1e4, ...updatedSince ? { last_contacted_after: updatedSince } : {} }).contacts;
+        }
+        const output = await exportContacts(format, contactList);
+        return { content: [{ type: "text", text: output }] };
+      }
       default:
         return { content: [{ type: "text", text: `Unknown tool: ${name}` }], isError: true };
     }