@hasna/contacts 0.2.9 → 0.3.1

package/dist/cli/index.js

@@ -5,43 +5,25 @@ var __getProtoOf = Object.getPrototypeOf;
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
-function __accessProp(key) {
-  return this[key];
-}
-var __toESMCache_node;
-var __toESMCache_esm;
 var __toESM = (mod, isNodeMode, target) => {
-  var canCache = mod != null && typeof mod === "object";
-  if (canCache) {
-    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
-    var cached = cache.get(mod);
-    if (cached)
-      return cached;
-  }
   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: __accessProp.bind(mod, key),
+        get: () => mod[key],
         enumerable: true
       });
-  if (canCache)
-    cache.set(mod, to);
   return to;
 };
 var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
-var __returnValue = (v) => v;
-function __exportSetter(name, newValue) {
-  this[name] = __returnValue.bind(null, newValue);
-}
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, {
       get: all[name],
       enumerable: true,
       configurable: true,
-      set: __exportSetter.bind(all, name)
+      set: (newValue) => all[name] = () => newValue
     });
 };
 var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
@@ -2387,6 +2369,85 @@ var init_database = __esm(() => {
   );
 
   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'));
+
+  ALTER TABLE company_relationships ADD COLUMN start_date TEXT;
+  ALTER TABLE company_relationships ADD COLUMN end_date TEXT;
+  ALTER TABLE company_relationships ADD COLUMN is_primary INTEGER NOT NULL DEFAULT 0;
+  ALTER TABLE company_relationships ADD COLUMN status TEXT NOT NULL DEFAULT 'active' CHECK(status IN ('active','inactive','ended'));
+
+  CREATE TABLE IF NOT EXISTS org_members (
+    id TEXT PRIMARY KEY,
+    company_id TEXT NOT NULL REFERENCES companies(id) ON DELETE CASCADE,
+    contact_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
+    title TEXT,
+    specialization TEXT,
+    office_phone TEXT,
+    response_sla_hours INTEGER,
+    notes TEXT,
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now')),
+    UNIQUE(company_id, contact_id)
+  );
+
+  CREATE TABLE IF NOT EXISTS vendor_communications (
+    id TEXT PRIMARY KEY,
+    company_id TEXT NOT NULL REFERENCES companies(id) ON DELETE CASCADE,
+    contact_id TEXT REFERENCES contacts(id) ON DELETE SET NULL,
+    comm_date TEXT NOT NULL,
+    type TEXT NOT NULL DEFAULT 'email' CHECK(type IN ('email','call','meeting','invoice_request','invoice_received','payment','dispute','other')),
+    direction TEXT NOT NULL DEFAULT 'outbound' CHECK(direction IN ('inbound','outbound')),
+    subject TEXT,
+    body TEXT,
+    status TEXT NOT NULL DEFAULT 'sent' CHECK(status IN ('sent','awaiting_response','responded','no_response','resolved')),
+    invoice_amount REAL,
+    invoice_currency TEXT,
+    invoice_ref TEXT,
+    follow_up_date TEXT,
+    follow_up_done INTEGER NOT NULL DEFAULT 0,
+    created_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS contact_tasks (
+    id TEXT PRIMARY KEY,
+    title TEXT NOT NULL,
+    description TEXT,
+    contact_id TEXT NOT NULL REFERENCES contacts(id) ON DELETE CASCADE,
+    assigned_by TEXT,
+    deadline TEXT,
+    status TEXT NOT NULL DEFAULT 'pending' CHECK(status IN ('pending','awaiting_response','in_progress','completed','cancelled','escalated')),
+    priority TEXT NOT NULL DEFAULT 'medium' CHECK(priority IN ('low','medium','high','critical')),
+    entity_id TEXT REFERENCES companies(id) ON DELETE SET NULL,
+    linked_todos_task_id TEXT,
+    escalation_rules TEXT NOT NULL DEFAULT '[]',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  CREATE TABLE IF NOT EXISTS applications (
+    id TEXT PRIMARY KEY,
+    program_name TEXT NOT NULL,
+    provider_company_id TEXT REFERENCES companies(id) ON DELETE SET NULL,
+    type TEXT NOT NULL DEFAULT 'other' CHECK(type IN ('ai_credits','grant','startup_program','visa','trademark','tax_filing','loan','other')),
+    value_usd REAL,
+    applicant_contact_id TEXT REFERENCES contacts(id) ON DELETE SET NULL,
+    primary_contact_id TEXT REFERENCES contacts(id) ON DELETE SET NULL,
+    status TEXT NOT NULL DEFAULT 'draft' CHECK(status IN ('draft','submitted','pending','approved','rejected','follow_up_needed','expired','cancelled')),
+    submitted_date TEXT,
+    decision_date TEXT,
+    follow_up_date TEXT,
+    notes TEXT,
+    method TEXT CHECK(method IN ('email','form','typeform','hubspot','manual','browser','feathery','other')),
+    form_url TEXT,
+    metadata TEXT NOT NULL DEFAULT '{}',
+    created_at TEXT NOT NULL DEFAULT (datetime('now')),
+    updated_at TEXT NOT NULL DEFAULT (datetime('now'))
+  );
+
+  ALTER TABLE contact_notes ADD COLUMN company_id TEXT REFERENCES companies(id) ON DELETE SET NULL;
   `
   ];
 });
@@ -2450,7 +2511,9 @@ function rowToCompany(row) {
     ...row,
     custom_fields: JSON.parse(row.custom_fields || "{}"),
     archived: !!row.archived,
-    project_id: row.project_id ?? null
+    project_id: row.project_id ?? null,
+    is_owned_entity: !!row.is_owned_entity,
+    entity_type: row.entity_type ?? null
   };
 }
 function insertEmails(db, contactId, companyId, emails) {
@@ -2767,7 +2830,9 @@ function rowToCompany2(row) {
     ...row,
     custom_fields: JSON.parse(row.custom_fields || "{}"),
     archived: !!row.archived,
-    project_id: row.project_id ?? null
+    project_id: row.project_id ?? null,
+    is_owned_entity: !!row.is_owned_entity,
+    entity_type: row.entity_type ?? null
   };
 }
 function insertEmails2(db, companyId, emails) {
@@ -2831,8 +2896,8 @@ function createCompany(input, db) {
   const d = db || getDatabase();
   const id = uuid();
   const timestamp = now();
-  d.run(`INSERT INTO companies (id, name, domain, logo_url, description, industry, size, founded_year, notes, custom_fields, created_at, updated_at)
-     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+  d.run(`INSERT INTO companies (id, name, domain, logo_url, description, industry, size, founded_year, notes, custom_fields, is_owned_entity, entity_type, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
     id,
     input.name,
     input.domain ?? null,
@@ -2843,6 +2908,8 @@ function createCompany(input, db) {
     input.founded_year ?? null,
     input.notes ?? null,
     JSON.stringify(input.custom_fields ?? {}),
+    input.is_owned_entity ? 1 : 0,
+    input.entity_type ?? null,
     timestamp,
     timestamp
   ]);
@@ -2879,6 +2946,7 @@ function listCompanies(opts = {}, db) {
     tag_id,
     project_id,
     archived = false,
+    is_owned_entity,
     order_by = "name",
     order_dir = "asc"
   } = opts;
@@ -2898,6 +2966,10 @@ function listCompanies(opts = {}, db) {
     conditions.push("EXISTS (SELECT 1 FROM company_tags ct WHERE ct.company_id = co.id AND ct.tag_id = ?)");
     params.push(tag_id);
   }
+  if (is_owned_entity !== undefined) {
+    conditions.push("co.is_owned_entity = ?");
+    params.push(is_owned_entity ? 1 : 0);
+  }
   const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
   const validOrderBy = ["name", "created_at", "updated_at"].includes(order_by) ? order_by : "name";
   const validOrderDir = order_dir === "desc" ? "DESC" : "ASC";
@@ -2953,6 +3025,14 @@ function updateCompany(id, input, db) {
     setClauses.push("project_id = ?");
     params.push(input.project_id);
   }
+  if (input.is_owned_entity !== undefined) {
+    setClauses.push("is_owned_entity = ?");
+    params.push(input.is_owned_entity ? 1 : 0);
+  }
+  if ("entity_type" in input && input.entity_type !== undefined) {
+    setClauses.push("entity_type = ?");
+    params.push(input.entity_type);
+  }
   params.push(id);
   d.run(`UPDATE companies SET ${setClauses.join(", ")} WHERE id = ?`, params);
   logActivity(d, { company_id: id, action: "company.updated", details: `Updated company: ${existing.name}` });
@@ -3747,9 +3827,374 @@ var {
 // src/cli/index.tsx
 init_contacts();
 init_companies();
-init_tags();
 import chalk from "chalk";
 
+// src/db/relationships.ts
+init_types();
+init_database();
+function rowToCompanyRelationship(row) {
+  return {
+    ...row,
+    relationship_type: row.relationship_type,
+    start_date: row.start_date ?? null,
+    end_date: row.end_date ?? null,
+    is_primary: !!row.is_primary,
+    status: row.status ?? "active"
+  };
+}
+function createCompanyRelationship(input, db) {
+  const d = db || getDatabase();
+  const contact = d.query(`SELECT id FROM contacts WHERE id = ?`).get(input.contact_id);
+  if (!contact)
+    throw new ContactNotFoundError(input.contact_id);
+  const company = d.query(`SELECT id FROM companies WHERE id = ?`).get(input.company_id);
+  if (!company)
+    throw new Error(`Company ${input.company_id} not found`);
+  const id = uuid();
+  d.run(`INSERT INTO company_relationships (id, contact_id, company_id, relationship_type, notes, start_date, end_date, is_primary, status) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.contact_id,
+    input.company_id,
+    input.relationship_type,
+    input.notes ?? null,
+    input.start_date ?? null,
+    input.end_date ?? null,
+    input.is_primary ? 1 : 0,
+    input.status ?? "active"
+  ]);
+  return rowToCompanyRelationship(d.query(`SELECT * FROM company_relationships WHERE id = ?`).get(id));
+}
+function listCompanyRelationships(opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  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);
+  }
+  if (opts.relationship_type) {
+    conditions.push("relationship_type = ?");
+    params.push(opts.relationship_type);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM company_relationships ${where} ORDER BY created_at DESC`).all(...params);
+  return rows.map(rowToCompanyRelationship);
+}
+
+// src/db/vendor-comms.ts
+init_database();
+function rowToVendorComm(row) {
+  return {
+    id: row.id,
+    company_id: row.company_id,
+    contact_id: row.contact_id,
+    comm_date: row.comm_date,
+    type: row.type,
+    direction: row.direction,
+    subject: row.subject,
+    body: row.body,
+    status: row.status,
+    invoice_amount: row.invoice_amount,
+    invoice_currency: row.invoice_currency,
+    invoice_ref: row.invoice_ref,
+    follow_up_date: row.follow_up_date,
+    follow_up_done: !!row.follow_up_done,
+    created_at: row.created_at
+  };
+}
+function logVendorCommunication(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  d.run(`INSERT INTO vendor_communications
+      (id, company_id, contact_id, comm_date, type, direction, subject, body, status,
+       invoice_amount, invoice_currency, invoice_ref, follow_up_date, follow_up_done)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.company_id,
+    input.contact_id ?? null,
+    input.comm_date,
+    input.type ?? "email",
+    input.direction ?? "outbound",
+    input.subject ?? null,
+    input.body ?? null,
+    input.status ?? "sent",
+    input.invoice_amount ?? null,
+    input.invoice_currency ?? null,
+    input.invoice_ref ?? null,
+    input.follow_up_date ?? null,
+    input.follow_up_done ? 1 : 0
+  ]);
+  return rowToVendorComm(d.query(`SELECT * FROM vendor_communications WHERE id = ?`).get(id));
+}
+function listVendorCommunications(companyId, opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = ["company_id = ?"];
+  const params = [companyId];
+  if (opts.type) {
+    conditions.push("type = ?");
+    params.push(opts.type);
+  }
+  if (opts.status) {
+    conditions.push("status = ?");
+    params.push(opts.status);
+  }
+  if (opts.direction) {
+    conditions.push("direction = ?");
+    params.push(opts.direction);
+  }
+  const where = conditions.join(" AND ");
+  const rows = d.query(`SELECT * FROM vendor_communications WHERE ${where} ORDER BY comm_date DESC`).all(...params);
+  return rows.map(rowToVendorComm);
+}
+function listPendingFollowUps(db) {
+  const d = db || getDatabase();
+  const today = new Date().toISOString().slice(0, 10);
+  const rows = d.query(`SELECT * FROM vendor_communications
+     WHERE follow_up_date <= ? AND follow_up_done = 0
+     ORDER BY follow_up_date ASC`).all(today);
+  return rows.map(rowToVendorComm);
+}
+function listMissingInvoices(db) {
+  const d = db || getDatabase();
+  const rows = d.query(`SELECT * FROM vendor_communications
+     WHERE type = 'invoice_request' AND status IN ('awaiting_response','no_response')
+     ORDER BY comm_date ASC`).all();
+  return rows.map(rowToVendorComm);
+}
+
+// src/db/contact-tasks.ts
+init_database();
+function rowToContactTask(row) {
+  return {
+    id: row.id,
+    title: row.title,
+    description: row.description,
+    contact_id: row.contact_id,
+    assigned_by: row.assigned_by,
+    deadline: row.deadline,
+    status: row.status,
+    priority: row.priority,
+    entity_id: row.entity_id,
+    linked_todos_task_id: row.linked_todos_task_id,
+    escalation_rules: JSON.parse(row.escalation_rules || "[]"),
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
+}
+function createContactTask(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO contact_tasks
+      (id, title, description, contact_id, assigned_by, deadline, status, priority,
+       entity_id, linked_todos_task_id, escalation_rules, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.title,
+    input.description ?? null,
+    input.contact_id,
+    input.assigned_by ?? null,
+    input.deadline ?? null,
+    input.status ?? "pending",
+    input.priority ?? "medium",
+    input.entity_id ?? null,
+    input.linked_todos_task_id ?? null,
+    JSON.stringify(input.escalation_rules ?? []),
+    timestamp,
+    timestamp
+  ]);
+  return rowToContactTask(d.query(`SELECT * FROM contact_tasks WHERE id = ?`).get(id));
+}
+function listContactTasks(opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (opts.contact_id) {
+    conditions.push("contact_id = ?");
+    params.push(opts.contact_id);
+  }
+  if (opts.entity_id) {
+    conditions.push("entity_id = ?");
+    params.push(opts.entity_id);
+  }
+  if (opts.status) {
+    conditions.push("status = ?");
+    params.push(opts.status);
+  }
+  if (opts.priority) {
+    conditions.push("priority = ?");
+    params.push(opts.priority);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM contact_tasks ${where} ORDER BY deadline ASC, priority DESC, created_at ASC`).all(...params);
+  return rows.map(rowToContactTask);
+}
+function updateContactTask(id, input, db) {
+  const d = db || getDatabase();
+  const setClauses = ["updated_at = ?"];
+  const params = [now()];
+  if (input.title !== undefined) {
+    setClauses.push("title = ?");
+    params.push(input.title);
+  }
+  if ("description" in input) {
+    setClauses.push("description = ?");
+    params.push(input.description ?? null);
+  }
+  if ("assigned_by" in input) {
+    setClauses.push("assigned_by = ?");
+    params.push(input.assigned_by ?? null);
+  }
+  if ("deadline" in input) {
+    setClauses.push("deadline = ?");
+    params.push(input.deadline ?? null);
+  }
+  if (input.status !== undefined) {
+    setClauses.push("status = ?");
+    params.push(input.status);
+  }
+  if (input.priority !== undefined) {
+    setClauses.push("priority = ?");
+    params.push(input.priority);
+  }
+  if ("entity_id" in input) {
+    setClauses.push("entity_id = ?");
+    params.push(input.entity_id ?? null);
+  }
+  if ("linked_todos_task_id" in input) {
+    setClauses.push("linked_todos_task_id = ?");
+    params.push(input.linked_todos_task_id ?? null);
+  }
+  if (input.escalation_rules !== undefined) {
+    setClauses.push("escalation_rules = ?");
+    params.push(JSON.stringify(input.escalation_rules));
+  }
+  params.push(id);
+  d.run(`UPDATE contact_tasks SET ${setClauses.join(", ")} WHERE id = ?`, params);
+  return rowToContactTask(d.query(`SELECT * FROM contact_tasks WHERE id = ?`).get(id));
+}
+function listOverdueTasks(db) {
+  const d = db || getDatabase();
+  const now_iso = new Date().toISOString();
+  const rows = d.query(`SELECT * FROM contact_tasks
+     WHERE deadline < ? AND status NOT IN ('completed','cancelled')
+     ORDER BY deadline ASC`).all(now_iso);
+  return rows.map(rowToContactTask);
+}
+
+// src/db/applications.ts
+init_database();
+function rowToApplication(row) {
+  return {
+    id: row.id,
+    program_name: row.program_name,
+    provider_company_id: row.provider_company_id,
+    type: row.type,
+    value_usd: row.value_usd,
+    applicant_contact_id: row.applicant_contact_id,
+    primary_contact_id: row.primary_contact_id,
+    status: row.status,
+    submitted_date: row.submitted_date,
+    decision_date: row.decision_date,
+    follow_up_date: row.follow_up_date,
+    notes: row.notes,
+    method: row.method ?? null,
+    form_url: row.form_url,
+    metadata: JSON.parse(row.metadata || "{}"),
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
+}
+function createApplication(input, db) {
+  const d = db || getDatabase();
+  const id = uuid();
+  const timestamp = now();
+  d.run(`INSERT INTO applications
+      (id, program_name, provider_company_id, type, value_usd, applicant_contact_id, primary_contact_id,
+       status, submitted_date, decision_date, follow_up_date, notes, method, form_url, metadata, created_at, updated_at)
+     VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`, [
+    id,
+    input.program_name,
+    input.provider_company_id ?? null,
+    input.type ?? "other",
+    input.value_usd ?? null,
+    input.applicant_contact_id ?? null,
+    input.primary_contact_id ?? null,
+    input.status ?? "draft",
+    input.submitted_date ?? null,
+    input.decision_date ?? null,
+    input.follow_up_date ?? null,
+    input.notes ?? null,
+    input.method ?? null,
+    input.form_url ?? null,
+    JSON.stringify(input.metadata ?? {}),
+    timestamp,
+    timestamp
+  ]);
+  return rowToApplication(d.query(`SELECT * FROM applications WHERE id = ?`).get(id));
+}
+function listApplications(opts = {}, db) {
+  const d = db || getDatabase();
+  const conditions = [];
+  const params = [];
+  if (opts.type) {
+    conditions.push("type = ?");
+    params.push(opts.type);
+  }
+  if (opts.status) {
+    conditions.push("status = ?");
+    params.push(opts.status);
+  }
+  if (opts.provider_company_id) {
+    conditions.push("provider_company_id = ?");
+    params.push(opts.provider_company_id);
+  }
+  if (opts.applicant_contact_id) {
+    conditions.push("applicant_contact_id = ?");
+    params.push(opts.applicant_contact_id);
+  }
+  const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+  const rows = d.query(`SELECT * FROM applications ${where} ORDER BY created_at DESC`).all(...params);
+  return rows.map(rowToApplication);
+}
+function listFollowUpDue(db) {
+  const d = db || getDatabase();
+  const today = new Date().toISOString().slice(0, 10);
+  const rows = d.query(`SELECT * FROM applications
+     WHERE follow_up_date <= ? AND status = 'follow_up_needed'
+     ORDER BY follow_up_date ASC`).all(today);
+  return rows.map(rowToApplication);
+}
+
+// src/db/org-members.ts
+init_database();
+function rowToOrgMember(row) {
+  return {
+    id: row.id,
+    company_id: row.company_id,
+    contact_id: row.contact_id,
+    title: row.title,
+    specialization: row.specialization,
+    office_phone: row.office_phone,
+    response_sla_hours: row.response_sla_hours,
+    notes: row.notes,
+    created_at: row.created_at,
+    updated_at: row.updated_at
+  };
+}
+function listOrgMembersForContact(contactId, db) {
+  const d = db || getDatabase();
+  const rows = d.query(`SELECT * FROM org_members WHERE contact_id = ? ORDER BY created_at ASC`).all(contactId);
+  return rows.map(rowToOrgMember);
+}
+
+// src/cli/index.tsx
+init_tags();
+
 // src/db/groups.ts
 init_database();
 function createGroup(db, input) {
@@ -3939,7 +4384,7 @@ async function confirm(question) {
   const answer = await prompt(question + " [y/N]");
   return answer.toLowerCase() === "y" || answer.toLowerCase() === "yes";
 }
-program.name("contacts").description("Open Contacts \u2014 contact management for AI coding agents").version("0.2.2");
+program.name("contacts").description("Open Contacts \u2014 contact management for AI coding agents").version("0.3.0");
 function collect(val, prev) {
   return [...prev, val];
 }
@@ -4655,4 +5100,436 @@ complete -F _contacts_completion contacts`);
     console.error(chalk.red("Supported shells: bash, zsh, fish"));
   }
 });
+var entities = program.command("entities").description("Manage your owned legal entities");
+entities.command("list").description("List all owned legal entities").action(() => {
+  const db = getDatabase();
+  const result = listCompanies({ limit: 200 }, db);
+  const owned = result.companies.filter((c) => c.is_owned_entity);
+  if (!owned.length) {
+    console.log(chalk.yellow("No owned entities found. Add one with: contacts companies add"));
+    return;
+  }
+  console.log();
+  renderTable(["Name", "Type", "Industry", "Description"], owned.map((e) => ({
+    Name: e.name,
+    Type: e.entity_type || "operating",
+    Industry: e.industry || "",
+    Description: e.description || ""
+  })));
+  console.log(chalk.gray(`
+${owned.length} owned entity/entities
+`));
+});
+entities.command("show <id>").description("Show entity with full team").action((id) => {
+  const db = getDatabase();
+  const company = getCompany(id);
+  if (!company) {
+    console.error(chalk.red(`
+Entity not found: ${id}
+`));
+    process.exit(1);
+  }
+  console.log(`
+` + chalk.bold.blue("\u2501\u2501\u2501 Entity: ") + chalk.bold(company.name) + chalk.bold.blue(" \u2501\u2501\u2501"));
+  console.log();
+  if (company.industry)
+    console.log(chalk.gray("  Industry:    ") + company.industry);
+  if (company.description)
+    console.log(chalk.gray("  Description: ") + company.description);
+  console.log(chalk.gray(`  ID: ${company.id}`));
+  console.log();
+  const team = listCompanyRelationships({ company_id: id }, db);
+  if (team.length === 0) {
+    console.log(chalk.gray(`  No team members assigned.
+`));
+    return;
+  }
+  console.log(chalk.yellow(`  Team (${team.length}):
+`));
+  const rows = team.map((r) => {
+    let name = r.contact_id;
+    try {
+      const c = getContact(r.contact_id);
+      name = c.display_name;
+    } catch {}
+    return {
+      Contact: name,
+      Role: r.relationship_type,
+      Primary: r.is_primary ? "yes" : "",
+      Status: r.status
+    };
+  });
+  renderTable(["Contact", "Role", "Primary", "Status"], rows);
+  console.log();
+});
+entities.command("add-contact <entity-id> <contact-id>").description("Link a contact to an entity with a role").option("--role <role>", "Role (tax_preparer|bank_manager|attorney|registered_agent|accountant|payroll_provider|insurance_broker|advisor|other)", "other").option("--primary", "Mark as primary contact for this role").action((entityId, contactId, opts) => {
+  const db = getDatabase();
+  const contact = getContact(contactId);
+  const company = getCompany(entityId);
+  if (!company) {
+    console.error(chalk.red(`
+Entity not found: ${entityId}
+`));
+    process.exit(1);
+  }
+  const rel = createCompanyRelationship({
+    contact_id: contactId,
+    company_id: entityId,
+    relationship_type: opts.role || "other",
+    is_primary: opts.primary || false
+  }, db);
+  console.log(chalk.green(`
+\u2713 Linked ${contact.display_name} to ${company.name} as ${rel.relationship_type}
+`));
+});
+entities.command("team <id>").description("Show full team matrix for an entity").action((id) => {
+  const db = getDatabase();
+  const company = getCompany(id);
+  if (!company) {
+    console.error(chalk.red(`
+Entity not found: ${id}
+`));
+    process.exit(1);
+  }
+  const team = listCompanyRelationships({ company_id: id }, db);
+  if (team.length === 0) {
+    console.log(chalk.yellow(`
+No team members for ${company.name}.
+`));
+    return;
+  }
+  console.log(`
+` + chalk.bold(`Team: ${company.name}`) + `
+`);
+  const rows = team.map((r) => {
+    let name = r.contact_id;
+    try {
+      const c = getContact(r.contact_id);
+      name = c.display_name;
+    } catch {}
+    return {
+      Contact: name,
+      Role: r.relationship_type,
+      Primary: r.is_primary ? "yes" : "",
+      Status: r.status
+    };
+  });
+  renderTable(["Contact", "Role", "Primary", "Status"], rows);
+  console.log();
+});
+program.command("workload <id>").description("Show workload summary for a contact").action((id) => {
+  const db = getDatabase();
+  const contact = getContact(id);
+  const companyRels = listCompanyRelationships({ contact_id: id }, db);
+  const overdue = listOverdueTasks(db).filter((t) => t.contact_id === id);
+  const orgMemberships = listOrgMembersForContact(id, db);
+  console.log(chalk.bold(`
+${contact.display_name}`));
+  if (contact.job_title)
+    console.log(chalk.gray(`  ${contact.job_title}`));
+  console.log();
+  if (companyRels.length) {
+    console.log(chalk.cyan(`  Manages/linked to ${companyRels.length} company relationship(s):`));
+    for (const r of companyRels.slice(0, 5)) {
+      console.log(chalk.gray(`    \u2022 ${r.relationship_type}${r.notes ? ` \u2014 ${r.notes}` : ""}`));
+    }
+  }
+  if (orgMemberships.length) {
+    console.log(chalk.cyan(`  Org memberships: ${orgMemberships.length}`));
+  }
+  if (overdue.length) {
+    console.log(chalk.red(`  \u26A0 Overdue tasks: ${overdue.length}`));
+  } else {
+    console.log(chalk.green("  No overdue tasks"));
+  }
+  if (contact.last_contacted_at) {
+    const days = Math.floor((Date.now() - new Date(contact.last_contacted_at).getTime()) / 86400000);
+    const color = days > 30 ? chalk.red : days > 14 ? chalk.yellow : chalk.green;
+    console.log(color(`  Last contact: ${days} day(s) ago`));
+  } else {
+    console.log(chalk.gray("  Never contacted"));
+  }
+  console.log();
+});
+var vendor = program.command("vendor").description("Track vendor communications and invoices");
+vendor.command("log <company-id>").description("Log a vendor communication").option("--type <type>", "Type: email|invoice_request|invoice_received|call|payment|dispute|other", "email").option("--subject <subject>", "Subject").option("--body <body>", "Body/notes").option("--amount <n>", "Invoice amount").option("--currency <c>", "Currency", "USD").option("--ref <ref>", "Invoice reference").option("--follow-up <date>", "Follow-up date (YYYY-MM-DD)").option("--status <status>", "Status: sent|awaiting_response|responded|no_response|resolved", "sent").option("--contact <id>", "Contact ID (optional)").option("--direction <dir>", "Direction: inbound|outbound", "outbound").action((companyId, opts) => {
+  const db = getDatabase();
+  const company = getCompany(companyId);
+  if (!company) {
+    console.error(chalk.red(`
+Company not found: ${companyId}
+`));
+    process.exit(1);
+  }
+  const comm = logVendorCommunication({
+    company_id: companyId,
+    contact_id: opts.contact,
+    comm_date: new Date().toISOString().slice(0, 10),
+    type: opts.type || "email",
+    direction: opts.direction || "outbound",
+    subject: opts.subject,
+    body: opts.body,
+    status: opts.status || "sent",
+    invoice_amount: opts.amount ? parseFloat(opts.amount) : undefined,
+    invoice_currency: opts.currency,
+    invoice_ref: opts.ref,
+    follow_up_date: opts.followUp
+  }, db);
+  console.log(chalk.green(`
+\u2713 Logged ${comm.type} communication with ${company.name} (${comm.id})
+`));
+});
+vendor.command("missing-invoices").description("Show all invoice requests with no response").action(() => {
+  const db = getDatabase();
+  const missing = listMissingInvoices(db);
+  if (!missing.length) {
+    console.log(chalk.green(`
+No missing invoices.
+`));
+    return;
+  }
+  console.log(chalk.yellow(`
+${missing.length} missing invoice(s):
+`));
+  renderTable(["Company", "Date", "Subject", "Status"], missing.map((m) => ({
+    Company: m.company_id,
+    Date: m.comm_date,
+    Subject: m.subject || "",
+    Status: m.status
+  })));
+  console.log();
+});
+vendor.command("pending-followups").description("Show vendor follow-ups due today or overdue").action(() => {
+  const db = getDatabase();
+  const pending = listPendingFollowUps(db);
+  if (!pending.length) {
+    console.log(chalk.green(`
+No pending follow-ups.
+`));
+    return;
+  }
+  console.log(chalk.yellow(`
+${pending.length} pending follow-up(s):
+`));
+  renderTable(["Company", "Type", "Follow-up", "Subject"], pending.map((p) => ({
+    Company: p.company_id,
+    Type: p.type,
+    "Follow-up": p.follow_up_date || "",
+    Subject: p.subject || ""
+  })));
+  console.log();
+});
+vendor.command("history <company-id>").description("Show vendor communication history for a company").action((id) => {
+  const db = getDatabase();
+  const company = getCompany(id);
+  if (!company) {
+    console.error(chalk.red(`
+Company not found: ${id}
+`));
+    process.exit(1);
+  }
+  const comms = listVendorCommunications(id, {}, db);
+  if (!comms.length) {
+    console.log(chalk.gray(`
+No communications logged for ${company.name}.
+`));
+    return;
+  }
+  console.log(chalk.bold(`
+Communications: ${company.name} (${comms.length})
+`));
+  renderTable(["Date", "Type", "Direction", "Subject", "Status"], comms.map((c) => ({
+    Date: c.comm_date,
+    Type: c.type,
+    Direction: c.direction,
+    Subject: c.subject || "",
+    Status: c.status
+  })));
+  console.log();
+});
+var taskCmd = program.command("task").description("Contact-assigned tasks with escalation");
+taskCmd.command("create").description("Create a contact task").option("--contact <id>", "Contact ID (required)").option("--title <title>", "Task title (required)").option("--deadline <date>", "Deadline (YYYY-MM-DD)").option("--priority <p>", "Priority: low|medium|high|critical", "medium").option("--entity <id>", "Entity/company this task is for").option("--escalate <rule>", "Escalation rule: contactId:afterDays (repeatable)", collect, []).action(async (opts) => {
+  const db = getDatabase();
+  let contactId = opts.contact;
+  let title = opts.title;
+  if (!contactId) {
+    contactId = await prompt("Contact ID (required):");
+    if (!contactId) {
+      console.error(chalk.red("Contact ID is required."));
+      process.exit(1);
+    }
+  }
+  if (!title) {
+    title = await prompt("Task title (required):");
+    if (!title) {
+      console.error(chalk.red("Task title is required."));
+      process.exit(1);
+    }
+  }
+  const escalationRules = opts.escalate.map((rule) => {
+    const [contactIdPart, daysPart] = rule.split(":");
+    return {
+      escalate_to_contact_id: contactIdPart || "",
+      after_days: parseInt(daysPart || "7", 10),
+      method: "email"
+    };
+  });
+  const contact = getContact(contactId);
+  const task = createContactTask({
+    title,
+    contact_id: contactId,
+    deadline: opts.deadline,
+    priority: opts.priority || "medium",
+    entity_id: opts.entity,
+    escalation_rules: escalationRules.length ? escalationRules : undefined
+  }, db);
+  console.log(chalk.green(`
+\u2713 Task created for ${contact.display_name}: ${task.title} (${task.id})
+`));
+});
+taskCmd.command("list [contact-id]").description("List contact tasks").option("--overdue", "Show only overdue tasks").option("--status <s>", "Filter by status").action((contactId, opts) => {
+  const db = getDatabase();
+  let tasks;
+  if (opts.overdue) {
+    tasks = listOverdueTasks(db);
+    if (contactId)
+      tasks = tasks.filter((t) => t.contact_id === contactId);
+  } else {
+    tasks = listContactTasks({
+      contact_id: contactId,
+      status: opts.status
+    }, db);
+  }
+  if (!tasks.length) {
+    console.log(chalk.gray(`
+No tasks found.
+`));
+    return;
+  }
+  console.log();
+  renderTable(["Title", "Contact", "Priority", "Status", "Deadline"], tasks.map((t) => {
+    let contactName = t.contact_id;
+    try {
+      contactName = getContact(t.contact_id).display_name;
+    } catch {}
+    return {
+      Title: t.title,
+      Contact: contactName,
+      Priority: t.priority,
+      Status: t.status,
+      Deadline: t.deadline ? t.deadline.slice(0, 10) : ""
+    };
+  }));
+  console.log(chalk.gray(`
+${tasks.length} task(s)
+`));
+});
+taskCmd.command("done <id>").description("Mark a contact task as completed").action((id) => {
+  const db = getDatabase();
+  const updated = updateContactTask(id, { status: "completed" }, db);
+  console.log(chalk.green(`
+\u2713 Task completed: ${updated.title}
+`));
+});
+var appsCmd = program.command("applications").description("Track grant/credit/program applications");
+appsCmd.command("list").description("List applications").option("--status <s>", "Filter by status").option("--type <t>", "Filter by type").action((opts) => {
+  const db = getDatabase();
+  const apps = listApplications({
+    status: opts.status,
+    type: opts.type
+  }, db);
+  if (!apps.length) {
+    console.log(chalk.gray(`
+No applications found.
+`));
+    return;
+  }
+  console.log();
+  renderTable(["Program", "Type", "Status", "Value", "Follow-up"], apps.map((a) => ({
+    Program: a.program_name,
+    Type: a.type,
+    Status: a.status,
+    Value: a.value_usd ? `$${a.value_usd.toLocaleString()}` : "",
+    "Follow-up": a.follow_up_date ? a.follow_up_date.slice(0, 10) : ""
+  })));
+  console.log(chalk.gray(`
+${apps.length} application(s)
+`));
+});
+appsCmd.command("add").description("Add a new application").option("--name <name>", "Program name (required)").option("--type <type>", "Type: ai_credits|grant|startup_program|other", "other").option("--value <usd>", "Value in USD").option("--status <status>", "Status: draft|submitted|pending|approved|rejected|follow_up_needed|expired|cancelled", "draft").option("--follow-up <date>", "Follow-up date (YYYY-MM-DD)").option("--provider <id>", "Provider company ID").option("--contact <id>", "Primary contact ID").option("--method <method>", "Application method: email|form|typeform|hubspot|manual|browser|feathery|other").option("--url <url>", "Form URL").action(async (opts) => {
+  const db = getDatabase();
+  let name = opts.name;
+  if (!name) {
+    name = await prompt("Program name (required):");
+    if (!name) {
+      console.error(chalk.red("Program name is required."));
+      process.exit(1);
+    }
+  }
+  const app = createApplication({
+    program_name: name,
+    type: opts.type || "other",
+    value_usd: opts.value ? parseFloat(opts.value) : undefined,
+    status: opts.status || "draft",
+    follow_up_date: opts.followUp,
+    provider_company_id: opts.provider,
+    primary_contact_id: opts.contact,
+    method: opts.method,
+    form_url: opts.url
+  }, db);
+  console.log(chalk.green(`
+\u2713 Application created: ${app.program_name} (${app.id})
+`));
+});
+appsCmd.command("followup").description("Show applications with follow-up due").action(() => {
+  const db = getDatabase();
+  const apps = listFollowUpDue(db);
+  if (!apps.length) {
+    console.log(chalk.green(`
+No follow-ups due.
+`));
+    return;
+  }
+  console.log(chalk.yellow(`
+${apps.length} application(s) need follow-up:
+`));
+  renderTable(["Program", "Type", "Status", "Follow-up"], apps.map((a) => ({
+    Program: a.program_name,
+    Type: a.type,
+    Status: a.status,
+    "Follow-up": a.follow_up_date ? a.follow_up_date.slice(0, 10) : ""
+  })));
+  console.log();
+});
+program.command("seed").description("Seed demo contacts, companies, and relationships").option("--demo", "Seed demo data (professional services example)").option("--clear", "Clear existing demo data first").action(async (opts) => {
+  if (!opts.demo) {
+    console.log("Use --demo flag to seed demo data");
+    return;
+  }
+  const db = getDatabase();
+  console.log(chalk.cyan("Seeding demo contacts..."));
+  const kpmg = createCompany({ name: "KPMG Romania", industry: "Accounting", description: "Romanian accounting, tax, and payroll firm" }, db);
+  const escalon = createCompany({ name: "Escalon Services", industry: "Tax & Finance", description: "US tax preparation for multi-entity businesses", domain: "escalon.services" }, db);
+  const revisionLegal = createCompany({ name: "Revision Legal PLLC", industry: "Legal", description: "Trademark and IP law firm", domain: "revisionlegal.com" }, db);
+  createCompany({ name: "RAW Financial", industry: "Tax & Finance", description: "US tax preparation for dissolution entities" }, db);
+  const svb = createCompany({ name: "Silicon Valley Bank", industry: "Banking", domain: "svb.com" }, db);
+  const hasnaInc = createCompany({ name: "Hasna, Inc.", is_owned_entity: true, entity_type: "operating", industry: "AI/Software", description: "Primary US operating entity (C-Corp, Delaware)" }, db);
+  const beepMedia = createCompany({ name: "Beep Media International LLC", is_owned_entity: true, entity_type: "operating", industry: "Media/Technology" }, db);
+  createCompany({ name: "Hasna Global SRL", is_owned_entity: true, entity_type: "operating", industry: "AI/Software", description: "Romanian operating entity" }, db);
+  const alina = createContact({ display_name: "Alina Turlea", first_name: "Alina", last_name: "Turlea", job_title: "Tax Consultant", emails: [{ address: "alinaturlea@kpmg.com", type: "work", is_primary: true }], source: "manual" });
+  const lucia = createContact({ display_name: "Lucia Grecu", first_name: "Lucia", last_name: "Grecu", job_title: "Compliance & Billing", emails: [{ address: "lsipos@kpmg.com", type: "work", is_primary: true }], source: "manual" });
+  const elizabeth = createContact({ display_name: "Elizabeth Robles", first_name: "Elizabeth", last_name: "Robles", job_title: "Tax Manager", emails: [{ address: "elizabeth.robles@escalon.services", type: "work", is_primary: true }], source: "manual" });
+  const drew = createContact({ display_name: "Andrew Jurgensen", first_name: "Andrew", last_name: "Jurgensen", job_title: "Partner", emails: [{ address: "drew@revisionlegal.com", type: "work", is_primary: true }], source: "manual" });
+  const donna = createContact({ display_name: "Donna Yang", first_name: "Donna", last_name: "Yang", job_title: "Relationship Manager", emails: [{ address: "DYang@svb.com", type: "work", is_primary: true }], source: "manual" });
+  createCompanyRelationship({ contact_id: alina.id, company_id: kpmg.id, relationship_type: "accountant", is_primary: true }, db);
+  createCompanyRelationship({ contact_id: lucia.id, company_id: kpmg.id, relationship_type: "accountant" }, db);
+  createCompanyRelationship({ contact_id: elizabeth.id, company_id: escalon.id, relationship_type: "tax_preparer", is_primary: true }, db);
+  createCompanyRelationship({ contact_id: drew.id, company_id: revisionLegal.id, relationship_type: "attorney", is_primary: true }, db);
+  createCompanyRelationship({ contact_id: donna.id, company_id: svb.id, relationship_type: "bank_manager", is_primary: true }, db);
+  createCompanyRelationship({ contact_id: alina.id, company_id: hasnaInc.id, relationship_type: "tax_preparer", is_primary: true }, db);
+  createCompanyRelationship({ contact_id: alina.id, company_id: beepMedia.id, relationship_type: "tax_preparer", is_primary: true }, db);
+  console.log(chalk.green(`\u2713 Seeded: 5 companies, 3 owned entities, 5 key contacts`));
+  console.log(chalk.gray("  Try: contacts entities list"));
+  console.log(chalk.gray("  Try: contacts workload " + alina.id));
+});
 program.parse(process.argv);