fantasia-sh 0.1.0

package/dist/index.mjs

@@ -0,0 +1,1691 @@
+#!/usr/bin/env node
+
+// src/index.ts
+import { Command } from "commander";
+
+// src/commands/login.ts
+import { createInterface } from "readline";
+
+// ../integrations/src/hubspot/client.ts
+import { Client } from "@hubspot/api-client";
+var HUBSPOT_SCOPES = [
+  "crm.objects.contacts.read",
+  "crm.objects.companies.read",
+  "crm.objects.deals.read",
+  "crm.objects.products.read",
+  "crm.objects.users.read",
+  "crm.objects.owners.read",
+  "crm.lists.read",
+  "crm.objects.leads.read"
+];
+var CONTACT_PROPERTIES = [
+  "email",
+  "firstname",
+  "lastname",
+  "company",
+  "jobtitle",
+  "phone",
+  "hs_last_activity_date",
+  "notes_last_updated",
+  "createdate"
+];
+function getHubSpotAuthUrl(opts) {
+  const clientId = opts?.clientId ?? process.env.HUBSPOT_CLIENT_ID;
+  const redirectUri = opts?.redirectUri ?? process.env.HUBSPOT_REDIRECT_URI;
+  const scope = HUBSPOT_SCOPES.join(" ");
+  const params = new URLSearchParams({
+    client_id: clientId,
+    redirect_uri: redirectUri,
+    scope,
+    response_type: "code"
+  });
+  return `https://app.hubspot.com/oauth/authorize?${params.toString()}`;
+}
+async function exchangeCodeForTokens(code, opts) {
+  const response = await fetch("https://api.hubapi.com/oauth/v1/token", {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "authorization_code",
+      client_id: opts?.clientId ?? process.env.HUBSPOT_CLIENT_ID,
+      client_secret: opts?.clientSecret ?? process.env.HUBSPOT_CLIENT_SECRET,
+      redirect_uri: opts?.redirectUri ?? process.env.HUBSPOT_REDIRECT_URI,
+      code
+    })
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`HubSpot token exchange failed: ${error}`);
+  }
+  return response.json();
+}
+async function getPortalId(accessToken) {
+  const response = await fetch(
+    `https://api.hubapi.com/oauth/v1/access-tokens/${accessToken}`
+  );
+  if (!response.ok) {
+    throw new Error("Failed to fetch HubSpot token info");
+  }
+  const info = await response.json();
+  return String(info.hub_id);
+}
+async function refreshAccessToken(refreshToken, opts) {
+  const response = await fetch("https://api.hubapi.com/oauth/v1/token", {
+    method: "POST",
+    headers: { "Content-Type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "refresh_token",
+      client_id: opts?.clientId ?? process.env.HUBSPOT_CLIENT_ID,
+      client_secret: opts?.clientSecret ?? process.env.HUBSPOT_CLIENT_SECRET,
+      refresh_token: refreshToken
+    })
+  });
+  if (!response.ok) {
+    const error = await response.text();
+    throw new Error(`HubSpot token refresh failed: ${error}`);
+  }
+  return response.json();
+}
+function getHubSpotClient(accessToken) {
+  return new Client({ accessToken });
+}
+async function fetchHubSpotContacts(accessToken) {
+  const client = getHubSpotClient(accessToken);
+  const contacts = [];
+  let after;
+  do {
+    const response = await client.crm.contacts.basicApi.getPage(
+      100,
+      // limit per page
+      after,
+      CONTACT_PROPERTIES
+    );
+    for (const contact of response.results) {
+      contacts.push({
+        id: contact.id,
+        email: contact.properties.email || null,
+        firstname: contact.properties.firstname || null,
+        lastname: contact.properties.lastname || null,
+        company: contact.properties.company || null,
+        jobtitle: contact.properties.jobtitle || null,
+        phone: contact.properties.phone || null,
+        hs_last_activity_date: contact.properties.hs_last_activity_date || null,
+        notes_last_updated: contact.properties.notes_last_updated || null,
+        createdate: contact.properties.createdate || null
+      });
+    }
+    after = response.paging?.next?.after;
+  } while (after);
+  return contacts;
+}
+
+// src/credentials.ts
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+function getCredentialsPath() {
+  return join(homedir(), ".fantasia", "credentials.json");
+}
+function readCredentials() {
+  try {
+    const raw = readFileSync(getCredentialsPath(), "utf-8");
+    return JSON.parse(raw);
+  } catch {
+    return null;
+  }
+}
+function writeCredentials(creds) {
+  const filePath = getCredentialsPath();
+  const dir = join(filePath, "..");
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(filePath, JSON.stringify(creds, null, 2), { mode: 384 });
+}
+function getHubSpotTokens() {
+  const creds = readCredentials();
+  return creds?.hubspot ?? null;
+}
+function saveHubSpotTokens(tokens) {
+  const creds = readCredentials() ?? {};
+  creds.hubspot = tokens;
+  writeCredentials(creds);
+}
+function saveAttioTokens(tokens) {
+  const creds = readCredentials() ?? {};
+  creds.attio = tokens;
+  writeCredentials(creds);
+}
+async function ensureFreshToken(opts) {
+  const tokens = getHubSpotTokens();
+  if (!tokens) return null;
+  const FIVE_MINUTES = 5 * 60 * 1e3;
+  if (tokens.expires_at - Date.now() < FIVE_MINUTES) {
+    const refreshed = await refreshAccessToken(tokens.refresh_token, {
+      clientId: opts?.clientId,
+      clientSecret: opts?.clientSecret
+    });
+    const updated = {
+      access_token: refreshed.access_token,
+      refresh_token: refreshed.refresh_token,
+      expires_at: Date.now() + refreshed.expires_in * 1e3,
+      portal_id: tokens.portal_id
+    };
+    saveHubSpotTokens(updated);
+    return updated;
+  }
+  return tokens;
+}
+
+// src/commands/login.ts
+var DEFAULT_HUBSPOT_CLIENT_ID = "6af4effd-98b7-4b3c-80b1-eab1723b37d6";
+var HUBSPOT_REDIRECT_URI = "https://fantasia.sh/api/auth/cli/hubspot/callback";
+var ATTIO_AUTHORIZE_URL = "https://app.attio.com/authorize";
+var ATTIO_TOKEN_URL = "https://app.attio.com/oauth/token";
+var ATTIO_REDIRECT_URI = "https://fantasia.sh/api/auth/cli/attio/callback";
+function prompt(question) {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+async function runLogin(options) {
+  if (!options.hubspot && !options.attio) {
+    console.log("Usage: fantasia login --hubspot");
+    console.log("       fantasia login --attio");
+    console.log("       fantasia login --attio --api-key <key>");
+    return;
+  }
+  const chalk = (await import("chalk")).default;
+  if (options.hubspot) {
+    await loginHubSpot(chalk);
+  } else if (options.attio) {
+    await loginAttio(chalk, options.apiKey);
+  }
+}
+async function loginHubSpot(chalk) {
+  const open = (await import("open")).default;
+  const clientId = process.env.HUBSPOT_CLIENT_ID ?? DEFAULT_HUBSPOT_CLIENT_ID;
+  const clientSecret = process.env.HUBSPOT_CLIENT_SECRET;
+  if (!clientSecret) {
+    console.error(
+      chalk.red("HUBSPOT_CLIENT_SECRET environment variable is required.")
+    );
+    process.exit(1);
+  }
+  const authUrl = getHubSpotAuthUrl({
+    clientId,
+    redirectUri: HUBSPOT_REDIRECT_URI
+  });
+  console.log(chalk.cyan("Opening browser to authorize with HubSpot..."));
+  console.log(chalk.dim(`(or visit: ${authUrl})`));
+  console.log();
+  open(authUrl).catch(() => {
+  });
+  const code = await prompt(
+    "Paste the authorization code from the browser here: "
+  );
+  if (!code) {
+    console.error(chalk.red("No code provided. Aborting."));
+    process.exit(1);
+  }
+  try {
+    const tokens = await exchangeCodeForTokens(code, {
+      clientId,
+      clientSecret,
+      redirectUri: HUBSPOT_REDIRECT_URI
+    });
+    const portalId = await getPortalId(tokens.access_token);
+    saveHubSpotTokens({
+      access_token: tokens.access_token,
+      refresh_token: tokens.refresh_token,
+      expires_at: Date.now() + tokens.expires_in * 1e3,
+      portal_id: portalId
+    });
+    console.log(
+      chalk.green("\n\u2713 Connected to HubSpot") + chalk.dim(` (portal ${portalId})`)
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(chalk.red(`
+Login failed: ${msg}`));
+    process.exit(1);
+  }
+}
+async function loginAttio(chalk, apiKey) {
+  if (apiKey) {
+    return saveAttioApiKey(chalk, apiKey);
+  }
+  console.log(chalk.cyan("How would you like to connect Attio?"));
+  console.log("  1. API key (from Settings \u2192 Developers \u2192 API keys)");
+  console.log("  2. OAuth (authorize via browser)");
+  console.log();
+  const choice = await prompt("Choose [1/2]: ");
+  if (choice === "1") {
+    const key = await prompt("Paste your Attio API key: ");
+    return saveAttioApiKey(chalk, key);
+  }
+  if (choice === "2") {
+    return loginAttioOAuth(chalk);
+  }
+  console.error(chalk.red("Invalid choice."));
+  process.exit(1);
+}
+async function saveAttioApiKey(chalk, apiKey) {
+  if (!apiKey) {
+    console.error(chalk.red("No API key provided. Aborting."));
+    process.exit(1);
+  }
+  const res = await fetch("https://api.attio.com/v2/self", {
+    headers: { Authorization: `Bearer ${apiKey}` }
+  });
+  if (!res.ok) {
+    console.error(chalk.red("Invalid API key. Please check and try again."));
+    process.exit(1);
+  }
+  const self = await res.json();
+  const workspace = self.data.workspace;
+  saveAttioTokens({
+    access_token: apiKey,
+    auth_type: "api_key",
+    workspace_id: workspace.id,
+    workspace_name: workspace.name
+  });
+  console.log(
+    chalk.green("\n\u2713 Connected to Attio") + chalk.dim(` (workspace: ${workspace.name})`)
+  );
+}
+async function loginAttioOAuth(chalk) {
+  const open = (await import("open")).default;
+  const clientId = process.env.ATTIO_CLIENT_ID;
+  const clientSecret = process.env.ATTIO_CLIENT_SECRET;
+  if (!clientId || !clientSecret) {
+    console.error(
+      chalk.red(
+        "ATTIO_CLIENT_ID and ATTIO_CLIENT_SECRET environment variables are required for OAuth."
+      )
+    );
+    console.log(
+      chalk.dim("Tip: use --api-key instead for a simpler setup.")
+    );
+    process.exit(1);
+  }
+  const state = Math.random().toString(36).slice(2);
+  const params = new URLSearchParams({
+    client_id: clientId,
+    response_type: "code",
+    redirect_uri: ATTIO_REDIRECT_URI,
+    state
+  });
+  const authUrl = `${ATTIO_AUTHORIZE_URL}?${params.toString()}`;
+  console.log(chalk.cyan("Opening browser to authorize with Attio..."));
+  console.log(chalk.dim(`(or visit: ${authUrl})`));
+  console.log();
+  open(authUrl).catch(() => {
+  });
+  const code = await prompt(
+    "Paste the authorization code from the browser here: "
+  );
+  if (!code) {
+    console.error(chalk.red("No code provided. Aborting."));
+    process.exit(1);
+  }
+  try {
+    const tokenRes = await fetch(ATTIO_TOKEN_URL, {
+      method: "POST",
+      headers: { "Content-Type": "application/x-www-form-urlencoded" },
+      body: new URLSearchParams({
+        grant_type: "authorization_code",
+        code,
+        client_id: clientId,
+        client_secret: clientSecret,
+        redirect_uri: ATTIO_REDIRECT_URI
+      })
+    });
+    if (!tokenRes.ok) {
+      const error = await tokenRes.text();
+      throw new Error(`Token exchange failed: ${error}`);
+    }
+    const tokens = await tokenRes.json();
+    const selfRes = await fetch("https://api.attio.com/v2/self", {
+      headers: { Authorization: `Bearer ${tokens.access_token}` }
+    });
+    const self = await selfRes.json();
+    const workspace = self.data.workspace;
+    saveAttioTokens({
+      access_token: tokens.access_token,
+      auth_type: "oauth",
+      workspace_id: workspace.id,
+      workspace_name: workspace.name
+    });
+    console.log(
+      chalk.green("\n\u2713 Connected to Attio") + chalk.dim(` (workspace: ${workspace.name})`)
+    );
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    console.error(chalk.red(`
+Login failed: ${msg}`));
+    process.exit(1);
+  }
+}
+
+// ../integrations/src/audit/checks/duplicates.ts
+function levenshtein(a, b) {
+  const m = a.length;
+  const n = b.length;
+  const dp = Array.from(
+    { length: m + 1 },
+    () => Array(n + 1).fill(0)
+  );
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      dp[i][j] = a[i - 1] === b[j - 1] ? dp[i - 1][j - 1] : 1 + Math.min(dp[i - 1][j], dp[i][j - 1], dp[i - 1][j - 1]);
+    }
+  }
+  return dp[m][n];
+}
+function normalizeName(first, last) {
+  return `${(first ?? "").trim()} ${(last ?? "").trim()}`.toLowerCase().replace(/\s+/g, " ").trim();
+}
+function stripMiddleInitials(name) {
+  return name.replace(/\b[a-z]\.?\s+/g, (match, offset) => {
+    return offset > 0 ? "" : match;
+  }).replace(/\s+/g, " ").trim();
+}
+function emailDomain(email) {
+  if (!email) return null;
+  const parts = email.toLowerCase().split("@");
+  return parts.length === 2 ? parts[1] : null;
+}
+function normalizeEmailUsername(email) {
+  if (!email) return null;
+  const atIndex = email.indexOf("@");
+  if (atIndex < 1) return null;
+  let username = email.substring(0, atIndex).toLowerCase();
+  const plusIndex = username.indexOf("+");
+  if (plusIndex >= 0) username = username.substring(0, plusIndex);
+  username = username.replace(/\./g, "");
+  return username || null;
+}
+function normalizePhone(phone) {
+  if (!phone) return null;
+  const digits = phone.replace(/\D/g, "");
+  return digits.length >= 7 ? digits : null;
+}
+var UnionFind = class {
+  constructor() {
+    this.parent = /* @__PURE__ */ new Map();
+  }
+  find(x) {
+    if (!this.parent.has(x)) this.parent.set(x, x);
+    if (this.parent.get(x) !== x) {
+      this.parent.set(x, this.find(this.parent.get(x)));
+    }
+    return this.parent.get(x);
+  }
+  union(a, b) {
+    const ra = this.find(a);
+    const rb = this.find(b);
+    if (ra !== rb) this.parent.set(ra, rb);
+  }
+};
+function getNameData(c) {
+  const name = normalizeName(c.firstname, c.lastname);
+  if (!name) return null;
+  return { name, stripped: stripMiddleInitials(name) };
+}
+function bestNameDistance(a, b) {
+  return Math.min(
+    levenshtein(a.name, b.name),
+    levenshtein(a.stripped, b.stripped)
+  );
+}
+function compareBucket(bucket, nameCache, uf, matcher) {
+  for (let i = 0; i < bucket.length; i++) {
+    for (let j = i + 1; j < bucket.length; j++) {
+      const a = bucket[i];
+      const b = bucket[j];
+      const ndA = nameCache.get(a.id);
+      const ndB = nameCache.get(b.id);
+      if (!ndA || !ndB) continue;
+      const distFn = () => bestNameDistance(ndA, ndB);
+      if (matcher(a, b, distFn)) {
+        uf.union(a.id, b.id);
+      }
+    }
+  }
+}
+function detectDuplicates(contacts) {
+  const uf = new UnionFind();
+  const nameCache = /* @__PURE__ */ new Map();
+  for (const c of contacts) {
+    nameCache.set(c.id, getNameData(c));
+  }
+  const emailIndex = /* @__PURE__ */ new Map();
+  const domainIndex = /* @__PURE__ */ new Map();
+  const usernameIndex = /* @__PURE__ */ new Map();
+  const companyIndex = /* @__PURE__ */ new Map();
+  const phoneIndex = /* @__PURE__ */ new Map();
+  for (const c of contacts) {
+    if (c.email) {
+      const key = c.email.toLowerCase();
+      const list = emailIndex.get(key) ?? [];
+      list.push(c);
+      emailIndex.set(key, list);
+      const domain = emailDomain(c.email);
+      if (domain) {
+        const dList = domainIndex.get(domain) ?? [];
+        dList.push(c);
+        domainIndex.set(domain, dList);
+      }
+      const username = normalizeEmailUsername(c.email);
+      if (username && username.length >= 3) {
+        const uList = usernameIndex.get(username) ?? [];
+        uList.push(c);
+        usernameIndex.set(username, uList);
+      }
+    }
+    const company = c.company?.toLowerCase().trim();
+    if (company) {
+      const cList = companyIndex.get(company) ?? [];
+      cList.push(c);
+      companyIndex.set(company, cList);
+    }
+    const phone = normalizePhone(c.phone);
+    if (phone) {
+      const pList = phoneIndex.get(phone) ?? [];
+      pList.push(c);
+      phoneIndex.set(phone, pList);
+    }
+  }
+  for (const bucket of emailIndex.values()) {
+    if (bucket.length > 1) {
+      for (let i = 1; i < bucket.length; i++) {
+        uf.union(bucket[0].id, bucket[i].id);
+      }
+    }
+  }
+  for (const bucket of domainIndex.values()) {
+    if (bucket.length < 2) continue;
+    compareBucket(bucket, nameCache, uf, (_a, _b, distFn) => distFn() <= 2);
+  }
+  for (const bucket of usernameIndex.values()) {
+    if (bucket.length < 2) continue;
+    compareBucket(bucket, nameCache, uf, (a, b, distFn) => {
+      const compA = a.company?.toLowerCase().trim();
+      const compB = b.company?.toLowerCase().trim();
+      const companiesDiffer = compA && compB && compA !== compB;
+      return !companiesDiffer && distFn() <= 2;
+    });
+  }
+  for (const bucket of companyIndex.values()) {
+    if (bucket.length < 2) continue;
+    compareBucket(bucket, nameCache, uf, (_a, _b, distFn) => distFn() <= 2);
+  }
+  for (const bucket of phoneIndex.values()) {
+    if (bucket.length < 2) continue;
+    compareBucket(bucket, nameCache, uf, (_a, _b, distFn) => distFn() <= 4);
+  }
+  const clusters = /* @__PURE__ */ new Map();
+  for (const c of contacts) {
+    uf.find(c.id);
+    const root = uf.find(c.id);
+    const list = clusters.get(root) ?? [];
+    list.push(c.id);
+    clusters.set(root, list);
+  }
+  const contactMap = new Map(contacts.map((c) => [c.id, c]));
+  const issues = [];
+  for (const [, members] of clusters) {
+    if (members.length < 2) continue;
+    const severity = members.length >= 4 ? "critical" : members.length >= 3 ? "high" : "medium";
+    const primaryId = members[0];
+    const primary = contactMap.get(primaryId);
+    issues.push({
+      category: "duplicate",
+      severity,
+      record_id: primaryId,
+      details: {
+        cluster_size: members.length,
+        cluster_ids: members,
+        primary_email: primary.email,
+        primary_name: normalizeName(primary.firstname, primary.lastname),
+        match_type: determineMatchType(members, contactMap)
+      }
+    });
+  }
+  return issues;
+}
+function determineMatchType(ids, contactMap) {
+  const contacts = ids.map((id) => contactMap.get(id));
+  const emails = contacts.map((c) => c.email?.toLowerCase()).filter(Boolean);
+  const uniqueEmails = new Set(emails);
+  if (uniqueEmails.size < emails.length) return "exact_email";
+  const usernames = contacts.map((c) => normalizeEmailUsername(c.email)).filter(Boolean);
+  const uniqueUsernames = new Set(usernames);
+  if (uniqueUsernames.size < usernames.length) return "email_username";
+  const companies = contacts.map((c) => c.company?.toLowerCase().trim()).filter(Boolean);
+  const uniqueCompanies = new Set(companies);
+  if (uniqueCompanies.size === 1 && companies.length > 1) return "company_name";
+  const phones = contacts.map((c) => normalizePhone(c.phone)).filter(Boolean);
+  const uniquePhones = new Set(phones);
+  if (uniquePhones.size < phones.length) return "phone_match";
+  return "fuzzy_name_domain";
+}
+function countDuplicateAffectedRecords(issues) {
+  const seen = /* @__PURE__ */ new Set();
+  for (const issue of issues) {
+    const ids = issue.details.cluster_ids ?? [];
+    for (const id of ids) seen.add(id);
+  }
+  return seen.size;
+}
+
+// ../integrations/src/audit/checks/stale.ts
+var STALE_THRESHOLD_DAYS = 90;
+function detectStaleRecords(contacts) {
+  const now = Date.now();
+  const thresholdMs = STALE_THRESHOLD_DAYS * 864e5;
+  const issues = [];
+  for (const c of contacts) {
+    if (c.createdate) {
+      const createdAt = new Date(c.createdate).getTime();
+      if (now - createdAt < thresholdMs) continue;
+    }
+    const lastActivity = c.hs_last_activity_date ? new Date(c.hs_last_activity_date).getTime() : null;
+    const lastNotes = c.notes_last_updated ? new Date(c.notes_last_updated).getTime() : null;
+    const mostRecent = Math.max(lastActivity ?? 0, lastNotes ?? 0);
+    const dataQualityNotes = [];
+    if (!c.hs_last_activity_date && !c.notes_last_updated) {
+      dataQualityNotes.push("No activity dates on record \u2014 may indicate a data import without engagement history");
+    } else {
+      if (!c.hs_last_activity_date) {
+        dataQualityNotes.push("Missing hs_last_activity_date \u2014 activity tracking may not be configured");
+      }
+      if (!c.notes_last_updated) {
+        dataQualityNotes.push("Missing notes_last_updated \u2014 no notes have been logged");
+      }
+    }
+    const twoYearsMs = 730 * 864e5;
+    if (lastActivity && now - lastActivity > twoYearsMs) {
+      dataQualityNotes.push("Last activity is over 2 years ago \u2014 consider archiving or re-engaging");
+    }
+    if (mostRecent === 0 || now - mostRecent > thresholdMs) {
+      const daysSinceActivity = mostRecent === 0 ? null : Math.floor((now - mostRecent) / 864e5);
+      issues.push({
+        category: "stale",
+        severity: daysSinceActivity === null || daysSinceActivity > 180 ? "high" : "medium",
+        record_id: c.id,
+        details: {
+          days_since_activity: daysSinceActivity,
+          last_activity_date: c.hs_last_activity_date,
+          last_notes_updated: c.notes_last_updated,
+          contact_name: [c.firstname, c.lastname].filter(Boolean).join(" "),
+          contact_email: c.email,
+          ...dataQualityNotes.length > 0 && { data_quality_notes: dataQualityNotes }
+        }
+      });
+    }
+  }
+  return issues;
+}
+
+// ../integrations/src/audit/checks/missing-fields.ts
+var REQUIRED_FIELDS = [
+  "email",
+  "company",
+  "jobtitle",
+  "phone"
+];
+function detectMissingFields(contacts) {
+  const issues = [];
+  for (const c of contacts) {
+    const missing = [];
+    for (const field of REQUIRED_FIELDS) {
+      const val = c[field];
+      if (val === null || val === void 0 || typeof val === "string" && val.trim() === "") {
+        missing.push(field);
+      }
+    }
+    if (missing.length === 0) continue;
+    const ratio = missing.length / REQUIRED_FIELDS.length;
+    const severity = ratio >= 0.75 ? "critical" : ratio >= 0.5 ? "high" : "medium";
+    issues.push({
+      category: "missing_field",
+      severity,
+      record_id: c.id,
+      details: {
+        missing_fields: missing,
+        missing_count: missing.length,
+        total_required: REQUIRED_FIELDS.length,
+        completeness_pct: Math.round((1 - ratio) * 100),
+        contact_name: [c.firstname, c.lastname].filter(Boolean).join(" "),
+        contact_email: c.email
+      }
+    });
+  }
+  return issues;
+}
+
+// ../integrations/src/audit/checks/format.ts
+function detectNameCasing(name) {
+  if (!name || name.trim() === "") return null;
+  const trimmed = name.trim();
+  if (trimmed === trimmed.toLowerCase()) return "lower_case";
+  if (trimmed === trimmed.toUpperCase()) return "upper_case";
+  if (/^([A-Z][a-z]*(?:'[A-Z][a-z]*)*\.?[-\s]*)+$/.test(trimmed)) return "title_case";
+  return "mixed";
+}
+function detectPhoneFormat(phone) {
+  if (!phone || phone.trim() === "") return null;
+  const p = phone.trim();
+  if (/^\(\d{3}\)\s?\d{3}-\d{4}$/.test(p)) return "parenthesized";
+  if (/^\d{3}-\d{3}-\d{4}$/.test(p)) return "dashed";
+  if (/^\d{3}\.\d{3}\.\d{4}$/.test(p)) return "dotted";
+  if (/^\d{10,11}$/.test(p)) return "digits_only";
+  if (/^\+/.test(p)) return "international";
+  return "other";
+}
+function majorityFormat(values) {
+  const counts = /* @__PURE__ */ new Map();
+  for (const v of values) {
+    if (v === null) continue;
+    counts.set(v, (counts.get(v) ?? 0) + 1);
+  }
+  let best = null;
+  let bestCount = 0;
+  for (const [k, c] of counts) {
+    if (c > bestCount) {
+      best = k;
+      bestCount = c;
+    }
+  }
+  return best;
+}
+function detectFormatIssues(contacts) {
+  const firstNameCasings = contacts.map((c) => detectNameCasing(c.firstname));
+  const lastNameCasings = contacts.map((c) => detectNameCasing(c.lastname));
+  const phoneFormats = contacts.map((c) => detectPhoneFormat(c.phone));
+  const majorityFirstName = majorityFormat(firstNameCasings);
+  const majorityLastName = majorityFormat(lastNameCasings);
+  const majorityPhone = majorityFormat(phoneFormats);
+  const issues = [];
+  for (let i = 0; i < contacts.length; i++) {
+    const c = contacts[i];
+    const problems = [];
+    const details = {
+      contact_name: [c.firstname, c.lastname].filter(Boolean).join(" "),
+      contact_email: c.email
+    };
+    const fnCase = firstNameCasings[i];
+    if (fnCase && majorityFirstName && fnCase !== majorityFirstName) {
+      problems.push("firstname_casing");
+      details.firstname_casing = fnCase;
+      details.expected_firstname_casing = majorityFirstName;
+    }
+    const lnCase = lastNameCasings[i];
+    if (lnCase && majorityLastName && lnCase !== majorityLastName) {
+      problems.push("lastname_casing");
+      details.lastname_casing = lnCase;
+      details.expected_lastname_casing = majorityLastName;
+    }
+    const pFmt = phoneFormats[i];
+    if (pFmt && majorityPhone && pFmt !== majorityPhone) {
+      problems.push("phone_format");
+      details.phone_format = pFmt;
+      details.expected_phone_format = majorityPhone;
+      details.phone_value = c.phone;
+    }
+    if (problems.length > 0) {
+      details.issues = problems;
+      issues.push({
+        category: "format",
+        severity: problems.length >= 2 ? "medium" : "low",
+        record_id: c.id,
+        details
+      });
+    }
+  }
+  return issues;
+}
+
+// ../integrations/src/audit/scoring.ts
+var WEIGHTS = {
+  duplicates: 0.3,
+  stale: 0.25,
+  missingFields: 0.25,
+  format: 0.2
+};
+function categoryScore(affectedCount, totalRecords) {
+  if (totalRecords === 0) return 100;
+  const pct = affectedCount / totalRecords * 100;
+  if (pct === 0) return 100;
+  if (pct <= 5) return 85;
+  if (pct <= 15) return 70;
+  if (pct <= 30) return 50;
+  if (pct <= 50) return 30;
+  return 10;
+}
+function computeCategoryScore(affectedCount, totalRecords) {
+  return {
+    score: categoryScore(affectedCount, totalRecords),
+    affectedCount,
+    totalRecords,
+    percentAffected: totalRecords === 0 ? 0 : Math.round(affectedCount / totalRecords * 1e3) / 10
+  };
+}
+function computeHealthScore(categories) {
+  const composite = Math.round(
+    categories.duplicates.score * WEIGHTS.duplicates + categories.stale.score * WEIGHTS.stale + categories.missingFields.score * WEIGHTS.missingFields + categories.format.score * WEIGHTS.format
+  );
+  const score = Math.max(0, Math.min(100, composite));
+  let grade;
+  if (score >= 90) grade = "A";
+  else if (score >= 80) grade = "B";
+  else if (score >= 70) grade = "C";
+  else if (score >= 55) grade = "D";
+  else grade = "F";
+  return { score, grade };
+}
+
+// ../integrations/src/audit/mock-data.ts
+function getMockContacts() {
+  const now = /* @__PURE__ */ new Date();
+  const daysAgo = (n) => new Date(now.getTime() - n * 864e5).toISOString();
+  return [
+    // --- Clean records ---
+    {
+      id: "101",
+      email: "alice@acme.com",
+      firstname: "Alice",
+      lastname: "Johnson",
+      company: "Acme Corp",
+      jobtitle: "VP of Sales",
+      phone: "(555) 123-4567",
+      hs_last_activity_date: daysAgo(5),
+      notes_last_updated: daysAgo(3),
+      createdate: daysAgo(200)
+    },
+    {
+      id: "102",
+      email: "bob@globex.com",
+      firstname: "Bob",
+      lastname: "Smith",
+      company: "Globex Inc",
+      jobtitle: "CTO",
+      phone: "(555) 234-5678",
+      hs_last_activity_date: daysAgo(10),
+      notes_last_updated: daysAgo(7),
+      createdate: daysAgo(180)
+    },
+    // --- Duplicates: exact email ---
+    {
+      id: "103",
+      email: "charlie@wayne.com",
+      firstname: "Charlie",
+      lastname: "Brown",
+      company: "Wayne Enterprises",
+      jobtitle: "Director of Ops",
+      phone: "(555) 345-6789",
+      hs_last_activity_date: daysAgo(15),
+      notes_last_updated: daysAgo(12),
+      createdate: daysAgo(300)
+    },
+    {
+      id: "104",
+      email: "Charlie@Wayne.com",
+      // duplicate email (case diff)
+      firstname: "Charles",
+      lastname: "Brown",
+      company: "Wayne Enterprises",
+      jobtitle: "Dir. Operations",
+      phone: "555-345-6789",
+      hs_last_activity_date: daysAgo(20),
+      notes_last_updated: daysAgo(18),
+      createdate: daysAgo(250)
+    },
+    // --- Duplicates: fuzzy name + same domain ---
+    {
+      id: "105",
+      email: "diana@stark.com",
+      firstname: "Diana",
+      lastname: "Prince",
+      company: "Stark Industries",
+      jobtitle: "Head of Marketing",
+      phone: "(555) 456-7890",
+      hs_last_activity_date: daysAgo(8),
+      notes_last_updated: daysAgo(6),
+      createdate: daysAgo(150)
+    },
+    {
+      id: "106",
+      email: "dianap@stark.com",
+      // same domain, similar name
+      firstname: "Dina",
+      // Levenshtein 1 from "Diana"
+      lastname: "Prince",
+      company: "Stark Industries",
+      jobtitle: "Marketing Lead",
+      phone: "(555) 456-7891",
+      hs_last_activity_date: daysAgo(12),
+      notes_last_updated: daysAgo(10),
+      createdate: daysAgo(140)
+    },
+    // --- Stale records (no activity in 90+ days, created > 90 days ago) ---
+    {
+      id: "107",
+      email: "edward@oldcorp.com",
+      firstname: "Edward",
+      lastname: "Norton",
+      company: "OldCorp LLC",
+      jobtitle: "Account Executive",
+      phone: "(555) 567-8901",
+      hs_last_activity_date: daysAgo(120),
+      notes_last_updated: daysAgo(150),
+      createdate: daysAgo(400)
+    },
+    {
+      id: "108",
+      email: "frank@dusty.com",
+      firstname: "Frank",
+      lastname: "Castle",
+      company: "Dusty Deals Inc",
+      jobtitle: "Sales Rep",
+      phone: "(555) 678-9012",
+      hs_last_activity_date: null,
+      notes_last_updated: null,
+      createdate: daysAgo(365)
+    },
+    {
+      id: "109",
+      email: "grace@fossil.com",
+      firstname: "Grace",
+      lastname: "Hopper",
+      company: "Fossil Data Corp",
+      jobtitle: "Analyst",
+      phone: "(555) 789-0123",
+      hs_last_activity_date: daysAgo(200),
+      notes_last_updated: daysAgo(195),
+      createdate: daysAgo(500)
+    },
+    // --- New record (created < 90 days ago, no activity — should NOT be flagged as stale) ---
+    {
+      id: "110",
+      email: "hank@newco.com",
+      firstname: "Hank",
+      lastname: "Pym",
+      company: "NewCo",
+      jobtitle: "Founder",
+      phone: "(555) 890-1234",
+      hs_last_activity_date: null,
+      notes_last_updated: null,
+      createdate: daysAgo(30)
+    },
+    // --- Missing critical fields ---
+    {
+      id: "111",
+      email: null,
+      // missing email
+      firstname: "Ivy",
+      lastname: "League",
+      company: "Mystery Inc",
+      jobtitle: null,
+      // missing jobtitle
+      phone: null,
+      // missing phone
+      hs_last_activity_date: daysAgo(5),
+      notes_last_updated: daysAgo(3),
+      createdate: daysAgo(100)
+    },
+    {
+      id: "112",
+      email: "jack@incomplete.com",
+      firstname: "Jack",
+      lastname: "Sparrow",
+      company: null,
+      // missing company
+      jobtitle: null,
+      // missing jobtitle
+      phone: null,
+      // missing phone
+      hs_last_activity_date: daysAgo(15),
+      notes_last_updated: daysAgo(10),
+      createdate: daysAgo(200)
+    },
+    {
+      id: "113",
+      email: null,
+      // missing email
+      firstname: "Karen",
+      lastname: null,
+      // missing lastname (not in required but name matters)
+      company: null,
+      // missing company
+      jobtitle: null,
+      // missing jobtitle
+      phone: null,
+      // missing phone
+      hs_last_activity_date: daysAgo(2),
+      notes_last_updated: daysAgo(1),
+      createdate: daysAgo(50)
+    },
+    // --- Format inconsistencies ---
+    {
+      id: "114",
+      email: "leo@format.com",
+      firstname: "leo",
+      // lowercase name
+      lastname: "messi",
+      company: "Format Co",
+      jobtitle: "Engineer",
+      phone: "5551234567",
+      // no formatting
+      hs_last_activity_date: daysAgo(3),
+      notes_last_updated: daysAgo(2),
+      createdate: daysAgo(100)
+    },
+    {
+      id: "115",
+      email: "maria@format.com",
+      firstname: "MARIA",
+      // ALL CAPS
+      lastname: "GARCIA",
+      company: "Format Co",
+      jobtitle: "Designer",
+      phone: "+1-555-987-6543",
+      // international format
+      hs_last_activity_date: daysAgo(7),
+      notes_last_updated: daysAgo(5),
+      createdate: daysAgo(90)
+    },
+    // --- More clean records to dilute percentages ---
+    {
+      id: "116",
+      email: "nick@clean.com",
+      firstname: "Nick",
+      lastname: "Fury",
+      company: "Shield Corp",
+      jobtitle: "Director",
+      phone: "(555) 111-2222",
+      hs_last_activity_date: daysAgo(2),
+      notes_last_updated: daysAgo(1),
+      createdate: daysAgo(300)
+    },
+    {
+      id: "117",
+      email: "olivia@clean.com",
+      firstname: "Olivia",
+      lastname: "Pope",
+      company: "OPA Consulting",
+      jobtitle: "Managing Partner",
+      phone: "(555) 222-3333",
+      hs_last_activity_date: daysAgo(1),
+      notes_last_updated: daysAgo(1),
+      createdate: daysAgo(250)
+    },
+    {
+      id: "118",
+      email: "peter@clean.com",
+      firstname: "Peter",
+      lastname: "Parker",
+      company: "Daily Bugle",
+      jobtitle: "Photographer",
+      phone: "(555) 333-4444",
+      hs_last_activity_date: daysAgo(4),
+      notes_last_updated: daysAgo(3),
+      createdate: daysAgo(180)
+    },
+    {
+      id: "119",
+      email: "quinn@clean.com",
+      firstname: "Quinn",
+      lastname: "Hughes",
+      company: "Canucks Ltd",
+      jobtitle: "Defenseman",
+      phone: "(555) 444-5555",
+      hs_last_activity_date: daysAgo(6),
+      notes_last_updated: daysAgo(4),
+      createdate: daysAgo(120)
+    },
+    {
+      id: "120",
+      email: "rachel@clean.com",
+      firstname: "Rachel",
+      lastname: "Green",
+      company: "Ralph Lauren",
+      jobtitle: "Buyer",
+      phone: "(555) 555-6666",
+      hs_last_activity_date: daysAgo(3),
+      notes_last_updated: daysAgo(2),
+      createdate: daysAgo(400)
+    }
+  ];
+}
+
+// ../integrations/src/audit/engine.ts
+function runAudit(options) {
+  const contacts = options?.contacts ?? getMockContacts();
+  const totalRecords = contacts.length;
+  const duplicateIssues = detectDuplicates(contacts);
+  const staleIssues = detectStaleRecords(contacts);
+  const missingFieldIssues = detectMissingFields(contacts);
+  const formatIssues = detectFormatIssues(contacts);
+  const duplicateAffected = countDuplicateAffectedRecords(duplicateIssues);
+  const staleAffected = staleIssues.length;
+  const missingFieldAffected = missingFieldIssues.length;
+  const formatAffected = formatIssues.length;
+  const categories = {
+    duplicates: computeCategoryScore(duplicateAffected, totalRecords),
+    stale: computeCategoryScore(staleAffected, totalRecords),
+    missingFields: computeCategoryScore(missingFieldAffected, totalRecords),
+    format: computeCategoryScore(formatAffected, totalRecords)
+  };
+  const { score, grade } = computeHealthScore(categories);
+  return {
+    healthScore: score,
+    grade,
+    categories,
+    issues: [
+      ...duplicateIssues,
+      ...staleIssues,
+      ...missingFieldIssues,
+      ...formatIssues
+    ],
+    totalRecords
+  };
+}
+
+// src/commands/audit.ts
+function renderBar(score, width = 20) {
+  const filled = Math.round(score / 100 * width);
+  return "\u2588".repeat(filled) + "\u2591".repeat(width - filled);
+}
+function severityOrder(s) {
+  switch (s) {
+    case "critical":
+      return 0;
+    case "high":
+      return 1;
+    case "medium":
+      return 2;
+    case "low":
+      return 3;
+    default:
+      return 4;
+  }
+}
+function categoryLabel(cat) {
+  switch (cat) {
+    case "duplicate":
+      return "Duplicates";
+    case "stale":
+      return "Stale";
+    case "missing_field":
+      return "Missing Fields";
+    case "format":
+      return "Format";
+    default:
+      return cat;
+  }
+}
+async function runAudit2(options) {
+  const chalk = (await import("chalk")).default;
+  const tokens = await ensureFreshToken();
+  if (!tokens) {
+    console.error(
+      chalk.red("Not logged in. Run `fantasia login --hubspot` first.")
+    );
+    process.exit(1);
+  }
+  console.log(chalk.dim("Fetching contacts..."));
+  const contacts = await fetchHubSpotContacts(tokens.access_token);
+  console.log(chalk.dim(`Running audit on ${contacts.length} contacts...`));
+  const result = runAudit({ contacts });
+  if (options.json) {
+    console.log(JSON.stringify(result, null, 2));
+    const threshold2 = parseInt(options.threshold ?? "0", 10);
+    process.exit(result.healthScore >= threshold2 ? 0 : 1);
+    return;
+  }
+  const gradeColor = (grade) => {
+    if (grade === "A" || grade === "B") return chalk.green;
+    if (grade === "C") return chalk.yellow;
+    return chalk.red;
+  };
+  const scoreColor = (n) => n >= 80 ? chalk.green : n >= 60 ? chalk.yellow : chalk.red;
+  const barColor = (n, bar2) => n >= 80 ? chalk.green(bar2) : n >= 60 ? chalk.yellow(bar2) : chalk.red(bar2);
+  console.log();
+  console.log(chalk.bold.white("  FANTASIA CRM AUDIT"));
+  console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  const bar = renderBar(result.healthScore, 30);
+  console.log(
+    `
+  Health Score   ${barColor(result.healthScore, bar)}  ${chalk.bold(
+      scoreColor(result.healthScore)(String(result.healthScore))
+    )}/100  ${gradeColor(result.grade)(result.grade)}`
+  );
+  console.log();
+  console.log(chalk.dim("  Categories:"));
+  const catEntries = [
+    {
+      label: "Duplicates",
+      score: result.categories.duplicates.score,
+      affected: result.categories.duplicates.affectedCount
+    },
+    {
+      label: "Stale",
+      score: result.categories.stale.score,
+      affected: result.categories.stale.affectedCount
+    },
+    {
+      label: "Missing Fields",
+      score: result.categories.missingFields.score,
+      affected: result.categories.missingFields.affectedCount
+    },
+    {
+      label: "Format",
+      score: result.categories.format.score,
+      affected: result.categories.format.affectedCount
+    }
+  ];
+  for (const cat of catEntries) {
+    const catBar = renderBar(cat.score, 20);
+    const label = cat.label.padEnd(18);
+    console.log(
+      `  ${chalk.dim(label)} ${barColor(cat.score, catBar)}  ${scoreColor(
+        cat.score
+      )(String(cat.score))}/100  ${chalk.dim(`(${cat.affected} affected)`)}`
+    );
+  }
+  const sortedIssues = [...result.issues].sort((a, b) => severityOrder(a.severity) - severityOrder(b.severity)).slice(0, 5);
+  if (sortedIssues.length > 0) {
+    console.log();
+    console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    console.log(chalk.bold("  Top Issues:"));
+    sortedIssues.forEach((issue, i) => {
+      const sevColor = issue.severity === "critical" || issue.severity === "high" ? chalk.red : issue.severity === "medium" ? chalk.yellow : chalk.dim;
+      console.log(
+        `  ${chalk.cyan(`${i + 1}.`)} ${sevColor(
+          `[${issue.severity.toUpperCase()}]`
+        )} ${categoryLabel(issue.category)} \u2014 record ${chalk.dim(
+          issue.record_id
+        )}`
+      );
+    });
+  }
+  console.log();
+  console.log(
+    chalk.dim(
+      `  ${result.totalRecords} records scanned | Portal ${tokens.portal_id}`
+    )
+  );
+  console.log();
+  const threshold = parseInt(options.threshold ?? "0", 10);
+  process.exit(result.healthScore >= threshold ? 0 : 1);
+}
+
+// src/commands/fix.ts
+import readline from "readline";
+
+// ../integrations/src/fix/merge.ts
+var MERGEABLE_FIELDS = [
+  "email",
+  "firstname",
+  "lastname",
+  "company",
+  "jobtitle",
+  "phone"
+];
+async function buildMergePreview(issues, hubspotClient) {
+  const clusters = [];
+  for (const issue of issues) {
+    const clusterIds = issue.details.cluster_ids ?? issue.hubspotRecordIds;
+    if (!clusterIds || clusterIds.length < 2) continue;
+    const contacts = await Promise.all(
+      clusterIds.map(async (id) => {
+        try {
+          const resp = await hubspotClient.crm.contacts.basicApi.getById(id, MERGEABLE_FIELDS);
+          return { id, properties: resp.properties };
+        } catch {
+          return { id, properties: {} };
+        }
+      })
+    );
+    const scored = contacts.map((c) => ({
+      ...c,
+      score: Object.values(c.properties).filter((v) => v && v.trim()).length
+    }));
+    scored.sort((a, b) => b.score - a.score);
+    const keepId = scored[0].id;
+    const mergeIds = scored.slice(1).map((c) => c.id);
+    const primaryProps = scored[0].properties;
+    const mergedFields = {};
+    const discardedFields = {};
+    for (const secondary of scored.slice(1)) {
+      for (const field of MERGEABLE_FIELDS) {
+        const primaryVal = primaryProps[field];
+        const secondaryVal = secondary.properties[field];
+        if (!secondaryVal || !secondaryVal.trim()) continue;
+        if (!primaryVal || !primaryVal.trim()) {
+          if (!mergedFields[field]) {
+            mergedFields[field] = { from: secondary.id, value: secondaryVal };
+          }
+        } else if (primaryVal.trim() !== secondaryVal.trim()) {
+          if (!discardedFields[field]) discardedFields[field] = [];
+          discardedFields[field].push({
+            from: secondary.id,
+            value: secondaryVal,
+            primaryValue: primaryVal
+          });
+        }
+      }
+    }
+    clusters.push({
+      issueId: issue._id,
+      contactIds: clusterIds,
+      keepId,
+      mergeIds,
+      mergedFields,
+      discardedFields: Object.keys(discardedFields).length > 0 ? discardedFields : void 0
+    });
+  }
+  return { type: "merge_duplicates", clusters };
+}
+async function executeMerge(preview, hubspotClient, accessToken) {
+  const entries = [];
+  for (const cluster of preview.clusters) {
+    for (const contactId of cluster.contactIds) {
+      try {
+        const resp = await hubspotClient.crm.contacts.basicApi.getById(
+          contactId,
+          MERGEABLE_FIELDS
+        );
+        entries.push({
+          contactId,
+          originalValues: { ...resp.properties }
+        });
+      } catch {
+        entries.push({ contactId, originalValues: {} });
+      }
+    }
+    if (Object.keys(cluster.mergedFields).length > 0) {
+      const updateProps = {};
+      for (const [field, info] of Object.entries(cluster.mergedFields)) {
+        updateProps[field] = info.value;
+      }
+      await hubspotClient.crm.contacts.basicApi.update(cluster.keepId, {
+        properties: updateProps
+      });
+    }
+    for (const mergeId of cluster.mergeIds) {
+      await fetch("https://api.hubapi.com/crm/v3/objects/contacts/merge", {
+        method: "POST",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: `Bearer ${accessToken}`
+        },
+        body: JSON.stringify({
+          primaryObjectId: cluster.keepId,
+          objectIdToMerge: mergeId
+        })
+      });
+    }
+  }
+  return {
+    type: "merge_duplicates",
+    timestamp: Date.now(),
+    entries
+  };
+}
+
+// ../integrations/src/fix/normalize.ts
+function toTitleCase(name) {
+  return name.trim().toLowerCase().replace(/\b\w/g, (c) => c.toUpperCase());
+}
+function normalizePhone2(phone) {
+  const digits = phone.replace(/\D/g, "");
+  if (digits.length === 10) {
+    return `(${digits.slice(0, 3)}) ${digits.slice(3, 6)}-${digits.slice(6)}`;
+  }
+  if (digits.length === 11 && digits.startsWith("1")) {
+    return `(${digits.slice(1, 4)}) ${digits.slice(4, 7)}-${digits.slice(7)}`;
+  }
+  if (digits.length > 10) {
+    return `+${digits}`;
+  }
+  return phone.trim();
+}
+async function buildNormalizePreview(issues, hubspotClient) {
+  const changes = [];
+  for (const issue of issues) {
+    const contactId = issue.hubspotRecordIds[0];
+    if (!contactId) continue;
+    const issueList = issue.details.issues ?? [];
+    if (issueList.length === 0) continue;
+    let currentProps;
+    try {
+      const resp = await hubspotClient.crm.contacts.basicApi.getById(contactId, [
+        "firstname",
+        "lastname",
+        "phone"
+      ]);
+      currentProps = resp.properties;
+    } catch {
+      continue;
+    }
+    const fields = [];
+    for (const issueName of issueList) {
+      const firstname = currentProps.firstname;
+      const lastname = currentProps.lastname;
+      const phone = currentProps.phone;
+      if (issueName === "firstname_casing" && firstname) {
+        const newVal = toTitleCase(firstname);
+        if (newVal !== firstname) {
+          fields.push({ field: "firstname", currentValue: firstname, newValue: newVal });
+        }
+      }
+      if (issueName === "lastname_casing" && lastname) {
+        const newVal = toTitleCase(lastname);
+        if (newVal !== lastname) {
+          fields.push({ field: "lastname", currentValue: lastname, newValue: newVal });
+        }
+      }
+      if (issueName === "phone_format" && phone) {
+        const newVal = normalizePhone2(phone);
+        if (newVal !== phone) {
+          fields.push({ field: "phone", currentValue: phone, newValue: newVal });
+        }
+      }
+    }
+    if (fields.length > 0) {
+      changes.push({ issueId: issue._id, contactId, fields });
+    }
+  }
+  return { type: "normalize_format", changes };
+}
+async function executeNormalize(preview, hubspotClient) {
+  const entries = [];
+  for (const change of preview.changes) {
+    const originalValues = {};
+    for (const f of change.fields) {
+      originalValues[f.field] = f.currentValue;
+    }
+    entries.push({ contactId: change.contactId, originalValues });
+    const updateProps = {};
+    for (const f of change.fields) {
+      updateProps[f.field] = f.newValue;
+    }
+    await hubspotClient.crm.contacts.basicApi.update(change.contactId, {
+      properties: updateProps
+    });
+  }
+  return {
+    type: "normalize_format",
+    timestamp: Date.now(),
+    entries
+  };
+}
+
+// src/commands/fix.ts
+function askConfirmation(question) {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y");
+    });
+  });
+}
+async function runFix(options) {
+  const chalk = (await import("chalk")).default;
+  const tokens = await ensureFreshToken();
+  if (!tokens) {
+    console.error(
+      chalk.red("Not logged in. Run `fantasia login --hubspot` first.")
+    );
+    process.exit(1);
+  }
+  console.log(chalk.dim("Fetching contacts..."));
+  const contacts = await fetchHubSpotContacts(tokens.access_token);
+  console.log(chalk.dim(`Running audit on ${contacts.length} contacts...`));
+  const auditResult = runAudit({ contacts });
+  if (auditResult.issues.length === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ fixes: [], message: "No issues found!" }, null, 2));
+    } else {
+      console.log(chalk.green("No issues found!"));
+    }
+    process.exit(0);
+  }
+  const duplicateIssues = auditResult.issues.filter((i) => i.category === "duplicate").map((i) => ({
+    _id: `${i.category}-${i.record_id}`,
+    hubspotRecordIds: [i.record_id],
+    details: i.details
+  }));
+  const formatIssues = auditResult.issues.filter((i) => i.category === "format").map((i) => ({
+    _id: `${i.category}-${i.record_id}`,
+    hubspotRecordIds: [i.record_id],
+    details: i.details
+  }));
+  const hubspotClient = getHubSpotClient(tokens.access_token);
+  console.log(chalk.dim("Building fix previews..."));
+  let mergePreview = null;
+  let normalizePreview = null;
+  if (duplicateIssues.length > 0) {
+    mergePreview = await buildMergePreview(duplicateIssues, hubspotClient);
+  }
+  if (formatIssues.length > 0) {
+    normalizePreview = await buildNormalizePreview(formatIssues, hubspotClient);
+  }
+  const totalFixes = (mergePreview?.clusters.length ?? 0) + (normalizePreview?.changes.length ?? 0);
+  if (totalFixes === 0) {
+    if (options.json) {
+      console.log(JSON.stringify({ fixes: [], message: "No actionable fixes found." }, null, 2));
+    } else {
+      console.log(chalk.green("No actionable fixes found."));
+    }
+    process.exit(0);
+  }
+  if (options.json) {
+    const preview = {
+      merges: mergePreview?.clusters ?? [],
+      normalizations: normalizePreview?.changes ?? [],
+      totalFixes
+    };
+    if (!options.execute) {
+      console.log(JSON.stringify(preview, null, 2));
+      return;
+    }
+  } else {
+    console.log();
+    console.log(chalk.bold.white("  FANTASIA CRM FIX PREVIEW"));
+    console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    if (mergePreview && mergePreview.clusters.length > 0) {
+      console.log();
+      console.log(
+        chalk.bold(`  Duplicate Merges: ${mergePreview.clusters.length}`)
+      );
+      for (const cluster of mergePreview.clusters) {
+        console.log(
+          `    ${chalk.cyan("Keep:")} ${cluster.keepId}  ${chalk.dim(
+            "Merge:"
+          )} ${cluster.mergeIds.join(", ")}`
+        );
+        if (Object.keys(cluster.mergedFields).length > 0) {
+          for (const [field, info] of Object.entries(cluster.mergedFields)) {
+            console.log(
+              chalk.dim(`      + ${field}: "${info.value}" from ${info.from}`)
+            );
+          }
+        }
+      }
+    }
+    if (normalizePreview && normalizePreview.changes.length > 0) {
+      console.log();
+      console.log(
+        chalk.bold(
+          `  Format Normalizations: ${normalizePreview.changes.length}`
+        )
+      );
+      for (const change of normalizePreview.changes) {
+        console.log(`    ${chalk.cyan("Contact:")} ${change.contactId}`);
+        for (const f of change.fields) {
+          console.log(
+            `      ${chalk.dim(f.field)}: ${chalk.red(
+              `"${f.currentValue}"`
+            )} ${chalk.dim("->")} ${chalk.green(`"${f.newValue}"`)}`
+          );
+        }
+      }
+    }
+    console.log();
+    console.log(chalk.dim(`  Total fixes: ${totalFixes}`));
+    console.log();
+  }
+  if (!options.execute) {
+    if (!options.json) {
+      console.log(
+        chalk.dim("  Run with --execute to apply fixes.")
+      );
+      console.log();
+    }
+    return;
+  }
+  if (!options.yes) {
+    const confirmed = await askConfirmation(
+      `  Execute ${totalFixes} fixes? (y/N) `
+    );
+    if (!confirmed) {
+      console.log(chalk.dim("  Aborted."));
+      return;
+    }
+  }
+  console.log(chalk.dim("  Executing fixes..."));
+  const results = {};
+  if (mergePreview && mergePreview.clusters.length > 0) {
+    const snapshot = await executeMerge(
+      mergePreview,
+      hubspotClient,
+      tokens.access_token
+    );
+    results.mergeSnapshot = snapshot;
+    if (!options.json) {
+      console.log(
+        chalk.green(
+          `  Merged ${mergePreview.clusters.length} duplicate cluster(s).`
+        )
+      );
+    }
+  }
+  if (normalizePreview && normalizePreview.changes.length > 0) {
+    const snapshot = await executeNormalize(normalizePreview, hubspotClient);
+    results.normalizeSnapshot = snapshot;
+    if (!options.json) {
+      console.log(
+        chalk.green(
+          `  Normalized ${normalizePreview.changes.length} contact(s).`
+        )
+      );
+    }
+  }
+  if (options.json) {
+    console.log(
+      JSON.stringify(
+        { executed: true, totalFixes, ...results },
+        null,
+        2
+      )
+    );
+  } else {
+    console.log();
+    console.log(chalk.bold.green(`  Done! ${totalFixes} fix(es) applied.`));
+    console.log();
+  }
+}
+
+// src/commands/status.ts
+async function runStatus(options) {
+  const chalk = (await import("chalk")).default;
+  const creds = readCredentials();
+  const hubspot = creds?.hubspot ?? null;
+  const attio = creds?.attio ?? null;
+  if (options.json) {
+    console.log(
+      JSON.stringify(
+        {
+          integrations: {
+            hubspot: hubspot ? {
+              connected: true,
+              portal_id: hubspot.portal_id,
+              expires_at: hubspot.expires_at
+            } : { connected: false },
+            attio: attio ? {
+              connected: true,
+              auth_type: attio.auth_type,
+              workspace_id: attio.workspace_id,
+              workspace_name: attio.workspace_name
+            } : { connected: false }
+          }
+        },
+        null,
+        2
+      )
+    );
+    return;
+  }
+  console.log();
+  console.log(chalk.bold.white("  Integrations:"));
+  console.log(chalk.dim("  \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  if (hubspot) {
+    const expiresIn = hubspot.expires_at - Date.now();
+    const expiresMinutes = Math.round(expiresIn / 6e4);
+    const expiryText = expiresIn > 0 ? `token expires in ${expiresMinutes} min` : "token expired";
+    console.log(
+      `  HubSpot: ${chalk.green("Connected")} ${chalk.dim(
+        `(portal ${hubspot.portal_id}, ${expiryText})`
+      )}`
+    );
+  } else {
+    console.log(`  HubSpot: ${chalk.dim("Not connected")}`);
+  }
+  if (attio) {
+    console.log(
+      `  Attio:   ${chalk.green("Connected")} ${chalk.dim(
+        `(${attio.workspace_name}, ${attio.auth_type})`
+      )}`
+    );
+  } else {
+    console.log(`  Attio:   ${chalk.dim("Not connected")}`);
+  }
+  console.log();
+  if (!hubspot && !attio) {
+    console.log(chalk.dim("  Run `fantasia login --hubspot` or `fantasia login --attio` to connect."));
+  }
+  console.log();
+}
+
+// src/index.ts
+var pkg = { name: "fantasia", version: "0.1.0" };
+var program = new Command();
+program.name(pkg.name).description("CLI-first CRM data enrichment & hygiene").version(pkg.version);
+program.command("login").description("Authenticate with a CRM integration").option("--hubspot", "Connect to HubSpot via OAuth").option("--attio", "Connect to Attio (API key or OAuth)").option("--api-key <key>", "Attio API key (skip interactive prompt)").action(async (options) => {
+  await runLogin(options);
+});
+program.command("audit").description("Run a CRM data-quality audit").option("--json", "Output results as JSON").option("--threshold <score>", "Minimum passing health score (exit 1 if below)").action(async (options) => {
+  await runAudit2(options);
+});
+program.command("fix").description("Preview and apply auto-fixes for CRM data issues").option("--execute", "Apply the fixes (default: dry-run preview)").option("--json", "Output results as JSON").option("-y, --yes", "Skip confirmation prompt").action(
+  async (options) => {
+    await runFix(options);
+  }
+);
+program.command("status").description("Show connection status for integrations").option("--json", "Output results as JSON").action(async (options) => {
+  await runStatus(options);
+});
+program.parse(process.argv);