@usenaive-sdk/cli 0.11.0 → 0.12.0

package/dist/commands/crm-app.js

@@ -0,0 +1,306 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const crmAppCmd = new Command("crm-app")
+    .description("CRM template app — agency pipeline (deals, deliverables, retainers). Distinct from 'naive crm' (vertical-agnostic primitive).")
+    .addHelpText("after", `
+Subcommands:
+  naive crm-app deals ...           Pipeline deals (lead → discovery → proposal → won → active → churned)
+  naive crm-app deliverables ...    Client deliverables (with optional kanban task mirroring)
+  naive crm-app retainers ...       Monthly retainers (linked to ext_subscriptions)
+  naive crm-app clients             Won/active deals grouped by contact + billing-profile MRR/LTV
+  naive crm-app summary             Aggregate pipeline + MRR + overdue counts
+
+Examples:
+  $ naive crm-app deals create --title "Acme Q3 implementation" --crm-contact <id>
+  $ naive crm-app deals advance <deal-id> --stage proposal
+  $ naive crm-app deliverables create --deal <id> --title "Discovery doc" --create-task --assignee delivery-lead
+`);
+// ── Deals ─────────────────────────────────────────────────────────────────
+const dealsCmd = crmAppCmd.command("deals").description("Pipeline deal management");
+dealsCmd
+    .command("list")
+    .description("List deals")
+    .option("--stage <stage>", "Filter by stage (lead|discovery|proposal|won|active|churned)")
+    .option("--crm-contact <id>", "Filter by CRM contact")
+    .option("--owner <id>", "Filter by owner agent")
+    .option("--limit <n>", "Max results (default 50)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.stage)
+        params.set("stage", opts.stage);
+    if (opts.crmContact)
+        params.set("crm_contact_id", opts.crmContact);
+    if (opts.owner)
+        params.set("owner_agent_id", opts.owner);
+    const resp = await apiRequest("GET", `/v1/crm-app/deals?${params}`);
+    handleApiError("crm-app.deals.list", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm-app.deals.list",
+        result: resp.data,
+        hints: [`${data.count} deal${data.count === 1 ? "" : "s"} returned`],
+        next_steps: data.deals.length > 0
+            ? [{ command: `naive crm-app deals advance ${data.deals[0].id} --stage discovery`, description: "Advance the first deal" }]
+            : [{ command: "naive crm-app deals create --title <title> --crm-contact <id>", description: "Create your first deal" }],
+        related_commands: ["naive crm-app deals create", "naive crm-app deals advance", "naive crm-app summary"],
+    });
+});
+dealsCmd
+    .command("create")
+    .description("Create a deal")
+    .requiredOption("--title <title>", "Deal name")
+    .requiredOption("--crm-contact <id>", "CRM contact UUID")
+    .option("--crm-company <id>", "CRM company UUID")
+    .option("--template-app-instance <id>", "CRM template app instance UUID")
+    .option("--stage <stage>", "Initial stage (default lead)")
+    .option("--value-cents <n>", "Deal value in cents")
+    .option("--currency <iso>", "ISO currency code")
+    .option("--owner <id>", "Owning agent UUID")
+    .option("--source <text>", "Where the deal came from")
+    .option("--notes <text>", "Free-form notes")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm-app/deals", {
+        title: opts.title,
+        crm_contact_id: opts.crmContact,
+        crm_company_id: opts.crmCompany,
+        template_app_instance_id: opts.templateAppInstance,
+        stage: opts.stage,
+        value_cents: opts.valueCents ? parseInt(opts.valueCents, 10) : undefined,
+        currency: opts.currency,
+        owner_agent_id: opts.owner,
+        source: opts.source,
+        notes: opts.notes,
+    });
+    handleApiError("crm-app.deals.create", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm-app.deals.create",
+        result: resp.data,
+        next_steps: [
+            { command: `naive crm-app deliverables create --deal ${data.deal.id} --title <title>`, description: "Add the first deliverable" },
+            { command: `naive crm-app deals advance ${data.deal.id} --stage discovery`, description: "Advance to discovery once a meeting is booked" },
+        ],
+        related_commands: ["naive crm-app deals advance", "naive crm-app deliverables create"],
+    });
+});
+dealsCmd
+    .command("get <deal_id>")
+    .description("Get a deal")
+    .action(async (dealId) => {
+    const resp = await apiRequest("GET", `/v1/crm-app/deals/${dealId}`);
+    handleApiError("crm-app.deals.get", resp);
+    agentOutput({
+        action: "crm-app.deals.get",
+        result: resp.data,
+        related_commands: ["naive crm-app deals advance", "naive crm-app deliverables list"],
+    });
+});
+dealsCmd
+    .command("advance <deal_id>")
+    .description("Advance a deal to a new stage")
+    .requiredOption("--stage <stage>", "New stage (lead|discovery|proposal|won|active|churned)")
+    .option("--notes <text>", "Optional notes about the transition")
+    .action(async (dealId, opts) => {
+    const resp = await apiRequest("POST", `/v1/crm-app/deals/${dealId}/advance`, {
+        stage: opts.stage,
+        notes: opts.notes,
+    });
+    handleApiError("crm-app.deals.advance", resp);
+    agentOutput({
+        action: "crm-app.deals.advance",
+        result: resp.data,
+        next_steps: [{ command: `naive crm contacts history <contact_id>`, description: "Verify the transition was logged as an interaction" }],
+        related_commands: ["naive crm-app deals list", "naive crm-app summary"],
+    });
+});
+dealsCmd
+    .command("update <deal_id>")
+    .description("Update deal fields")
+    .option("--title <title>")
+    .option("--value-cents <n>")
+    .option("--notes <text>")
+    .action(async (dealId, opts) => {
+    const body = {};
+    if (opts.title !== undefined)
+        body.title = opts.title;
+    if (opts.valueCents !== undefined)
+        body.value_cents = parseInt(opts.valueCents, 10);
+    if (opts.notes !== undefined)
+        body.notes = opts.notes;
+    const resp = await apiRequest("PATCH", `/v1/crm-app/deals/${dealId}`, body);
+    handleApiError("crm-app.deals.update", resp);
+    agentOutput({ action: "crm-app.deals.update", result: resp.data, related_commands: ["naive crm-app deals get"] });
+});
+dealsCmd
+    .command("delete <deal_id>")
+    .description("Delete a deal (cascade)")
+    .action(async (dealId) => {
+    const resp = await apiRequest("DELETE", `/v1/crm-app/deals/${dealId}`);
+    handleApiError("crm-app.deals.delete", resp);
+    agentOutput({ action: "crm-app.deals.delete", result: resp.data, related_commands: ["naive crm-app deals list"] });
+});
+// ── Deliverables ─────────────────────────────────────────────────────────
+const deliverablesCmd = crmAppCmd.command("deliverables").description("Client deliverable management");
+deliverablesCmd
+    .command("list")
+    .description("List deliverables")
+    .option("--deal <id>")
+    .option("--status <status>", "pending|in_progress|review|done|blocked")
+    .option("--owner <id>")
+    .option("--limit <n>", "Max results", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.deal)
+        params.set("deal_id", opts.deal);
+    if (opts.status)
+        params.set("status", opts.status);
+    if (opts.owner)
+        params.set("owner_agent_id", opts.owner);
+    const resp = await apiRequest("GET", `/v1/crm-app/deliverables?${params}`);
+    handleApiError("crm-app.deliverables.list", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm-app.deliverables.list",
+        result: resp.data,
+        hints: [`${data.count} deliverable${data.count === 1 ? "" : "s"} returned`],
+        related_commands: ["naive crm-app deliverables create", "naive crm-app deliverables update"],
+    });
+});
+deliverablesCmd
+    .command("create")
+    .description("Create a deliverable")
+    .requiredOption("--deal <id>", "Deal UUID")
+    .requiredOption("--title <title>", "Deliverable title")
+    .option("--description <text>")
+    .option("--status <status>", "pending|in_progress|review|done|blocked")
+    .option("--due-date <iso>")
+    .option("--owner <id>", "Owner agent UUID")
+    .option("--create-task", "Mirror as a kanban task (status will auto-sync)")
+    .option("--assignee <profile>", "Hermes profile name (when --create-task)")
+    .option("--priority <level>", "low|normal|high|critical (when --create-task)")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm-app/deliverables", {
+        deal_id: opts.deal,
+        title: opts.title,
+        description: opts.description,
+        status: opts.status,
+        due_date: opts.dueDate,
+        owner_agent_id: opts.owner,
+        create_task: opts.createTask === true,
+        assignee: opts.assignee,
+        priority: opts.priority,
+    });
+    handleApiError("crm-app.deliverables.create", resp);
+    agentOutput({
+        action: "crm-app.deliverables.create",
+        result: resp.data,
+        next_steps: [{ command: "naive tasks", description: "View the mirrored task on the kanban board" }],
+        related_commands: ["naive crm-app deliverables update", "naive tasks"],
+    });
+});
+deliverablesCmd
+    .command("update <deliverable_id>")
+    .description("Update a deliverable")
+    .option("--title <title>")
+    .option("--status <status>")
+    .option("--due-date <iso>")
+    .option("--pct-complete <n>", "0-100")
+    .option("--blockers <text>")
+    .action(async (deliverableId, opts) => {
+    const body = {};
+    if (opts.title !== undefined)
+        body.title = opts.title;
+    if (opts.status !== undefined)
+        body.status = opts.status;
+    if (opts.dueDate !== undefined)
+        body.due_date = opts.dueDate;
+    if (opts.pctComplete !== undefined)
+        body.pct_complete = parseInt(opts.pctComplete, 10);
+    if (opts.blockers !== undefined)
+        body.blockers = opts.blockers;
+    const resp = await apiRequest("PATCH", `/v1/crm-app/deliverables/${deliverableId}`, body);
+    handleApiError("crm-app.deliverables.update", resp);
+    agentOutput({ action: "crm-app.deliverables.update", result: resp.data, related_commands: ["naive crm-app deliverables list"] });
+});
+deliverablesCmd
+    .command("delete <deliverable_id>")
+    .description("Delete a deliverable")
+    .action(async (deliverableId) => {
+    const resp = await apiRequest("DELETE", `/v1/crm-app/deliverables/${deliverableId}`);
+    handleApiError("crm-app.deliverables.delete", resp);
+    agentOutput({ action: "crm-app.deliverables.delete", result: resp.data, related_commands: ["naive crm-app deliverables list"] });
+});
+// ── Retainers ────────────────────────────────────────────────────────────
+const retainersCmd = crmAppCmd.command("retainers").description("Retainer management");
+retainersCmd
+    .command("list")
+    .description("List retainers")
+    .option("--deal <id>")
+    .option("--status <status>", "active|paused|ended")
+    .option("--limit <n>", "Max results", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.deal)
+        params.set("deal_id", opts.deal);
+    if (opts.status)
+        params.set("status", opts.status);
+    const resp = await apiRequest("GET", `/v1/crm-app/retainers?${params}`);
+    handleApiError("crm-app.retainers.list", resp);
+    agentOutput({ action: "crm-app.retainers.list", result: resp.data, related_commands: ["naive crm-app retainers create"] });
+});
+retainersCmd
+    .command("create")
+    .description("Create a retainer")
+    .requiredOption("--deal <id>", "Deal UUID")
+    .requiredOption("--crm-contact <id>", "CRM contact UUID")
+    .option("--ext-subscription <id>", "Linked ext_subscription UUID")
+    .option("--mrr-cents <n>", "MRR in cents", "0")
+    .option("--currency <iso>")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm-app/retainers", {
+        deal_id: opts.deal,
+        crm_contact_id: opts.crmContact,
+        ext_subscription_id: opts.extSubscription,
+        mrr_cents: parseInt(opts.mrrCents, 10),
+        currency: opts.currency,
+    });
+    handleApiError("crm-app.retainers.create", resp);
+    agentOutput({ action: "crm-app.retainers.create", result: resp.data, related_commands: ["naive crm-app retainers list"] });
+});
+// ── Clients + summary ───────────────────────────────────────────────────
+crmAppCmd
+    .command("clients")
+    .description("List clients (won/active deals grouped by contact, with billing-profile join)")
+    .option("--limit <n>", "Max results", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    const resp = await apiRequest("GET", `/v1/crm-app/clients?${params}`);
+    handleApiError("crm-app.clients", resp);
+    agentOutput({
+        action: "crm-app.clients",
+        result: resp.data,
+        related_commands: ["naive crm-app deliverables list", "naive billing-client subscriptions list"],
+    });
+});
+crmAppCmd
+    .command("summary")
+    .description("Aggregate pipeline + MRR + overdue counts")
+    .option("--template-app-instance <id>")
+    .action(async (opts) => {
+    const params = new URLSearchParams();
+    if (opts.templateAppInstance)
+        params.set("template_app_instance_id", opts.templateAppInstance);
+    const resp = await apiRequest("GET", `/v1/crm-app/summary?${params}`);
+    handleApiError("crm-app.summary", resp);
+    agentOutput({
+        action: "crm-app.summary",
+        result: resp.data,
+        related_commands: ["naive crm-app deals list", "naive billing-client mrr"],
+    });
+});
+//# sourceMappingURL=crm-app.js.map

package/dist/commands/crm-app.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crm-app.js","sourceRoot":"","sources":["../../src/commands/crm-app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE3C,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,OAAO,CAAC,SAAS,CAAC;KAC5C,WAAW,CAAC,+HAA+H,CAAC;KAC5I,WAAW,CAAC,OAAO,EAAE;;;;;;;;;;;;CAYvB,CAAC,CAAC;AAEH,6EAA6E;AAE7E,MAAM,QAAQ,GAAG,SAAS,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,WAAW,CAAC,0BAA0B,CAAC,CAAC;AAEpF,QAAQ;KACL,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,YAAY,CAAC;KACzB,MAAM,CAAC,iBAAiB,EAAE,8DAA8D,CAAC;KACzF,MAAM,CAAC,oBAAoB,EAAE,uBAAuB,CAAC;KACrD,MAAM,CAAC,cAAc,EAAE,uBAAuB,CAAC;KAC/C,MAAM,CAAC,aAAa,EAAE,0BAA0B,EAAE,IAAI,CAAC;KACvD,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,UAAU;QAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;IACpE,cAAc,CAAC,oBAAoB,EAAE,IAAI,CAAC,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAqF,CAAC;IACxG,WAAW,CAAC;QACV,MAAM,EAAE,oBAAoB;QAC5B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;QACpE,UAAU,EACR,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC;YACnB,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,+BAA+B,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,EAAE,oBAAoB,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;YAC5H,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,+DAA+D,EAAE,WAAW,EAAE,wBAAwB,EAAE,CAAC;QAC3H,gBAAgB,EAAE,CAAC,4BAA4B,EAAE,6BAA6B,EAAE,uBAAuB,CAAC;KACzG,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,QAAQ;KACL,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,eAAe,CAAC;KAC5B,cAAc,CAAC,iBAAiB,EAAE,WAAW,CAAC;KAC9C,cAAc,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KACxD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KAChD,MAAM,CAAC,8BAA8B,EAAE,gCAAgC,CAAC;KACxE,MAAM,CAAC,iBAAiB,EAAE,8BAA8B,CAAC;KACzD,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;KAClD,MAAM,CAAC,kBAAkB,EAAE,mBAAmB,CAAC;KAC/C,MAAM,CAAC,cAAc,EAAE,mBAAmB,CAAC;KAC3C,MAAM,CAAC,iBAAiB,EAAE,0BAA0B,CAAC;KACrD,MAAM,CAAC,gBAAgB,EAAE,iBAAiB,CAAC;KAC3C,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,mBAAmB,EAAE;QACzD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,wBAAwB,EAAE,IAAI,CAAC,mBAAmB;QAClD,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;QACxE,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,cAAc,EAAE,IAAI,CAAC,KAAK;QAC1B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IACH,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC7C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAgC,CAAC;IACnD,WAAW,CAAC;QACV,MAAM,EAAE,sBAAsB;QAC9B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,UAAU,EAAE;YACV,EAAE,OAAO,EAAE,4CAA4C,IAAI,CAAC,IAAI,CAAC,EAAE,kBAAkB,EAAE,WAAW,EAAE,2BAA2B,EAAE;YACjI,EAAE,OAAO,EAAE,+BAA+B,IAAI,CAAC,IAAI,CAAC,EAAE,oBAAoB,EAAE,WAAW,EAAE,+CAA+C,EAAE;SAC3I;QACD,gBAAgB,EAAE,CAAC,6BAA6B,EAAE,mCAAmC,CAAC;KACvF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,QAAQ;KACL,OAAO,CAAC,eAAe,CAAC;KACxB,WAAW,CAAC,YAAY,CAAC;KACzB,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;IAC/B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;IACpE,cAAc,CAAC,mBAAmB,EAAE,IAAI,CAAC,CAAC;IAC1C,WAAW,CAAC;QACV,MAAM,EAAE,mBAAmB;QAC3B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,gBAAgB,EAAE,CAAC,6BAA6B,EAAE,iCAAiC,CAAC;KACrF,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,QAAQ;KACL,OAAO,CAAC,mBAAmB,CAAC;KAC5B,WAAW,CAAC,+BAA+B,CAAC;KAC5C,cAAc,CAAC,iBAAiB,EAAE,wDAAwD,CAAC;KAC3F,MAAM,CAAC,gBAAgB,EAAE,qCAAqC,CAAC;KAC/D,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;IACrC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,qBAAqB,MAAM,UAAU,EAAE;QAC3E,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;KAClB,CAAC,CAAC;IACH,cAAc,CAAC,uBAAuB,EAAE,IAAI,CAAC,CAAC;IAC9C,WAAW,CAAC;QACV,MAAM,EAAE,uBAAuB;QAC/B,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,yCAAyC,EAAE,WAAW,EAAE,oDAAoD,EAAE,CAAC;QACvI,gBAAgB,EAAE,CAAC,0BAA0B,EAAE,uBAAuB,CAAC;KACxE,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,QAAQ;KACL,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,oBAAoB,CAAC;KACjC,MAAM,CAAC,iBAAiB,CAAC;KACzB,MAAM,CAAC,mBAAmB,CAAC;KAC3B,MAAM,CAAC,gBAAgB,CAAC;KACxB,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,IAAI,EAAE,EAAE;IACrC,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtD,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpF,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,qBAAqB,MAAM,EAAE,EAAE,IAAI,CAAC,CAAC;IAC5E,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;AACpH,CAAC,CAAC,CAAC;AAEL,QAAQ;KACL,OAAO,CAAC,kBAAkB,CAAC;KAC3B,WAAW,CAAC,yBAAyB,CAAC;KACtC,MAAM,CAAC,KAAK,EAAE,MAAc,EAAE,EAAE;IAC/B,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;IACvE,cAAc,CAAC,sBAAsB,EAAE,IAAI,CAAC,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,0BAA0B,CAAC,EAAE,CAAC,CAAC;AACrH,CAAC,CAAC,CAAC;AAEL,4EAA4E;AAE5E,MAAM,eAAe,GAAG,SAAS,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,WAAW,CAAC,+BAA+B,CAAC,CAAC;AAEvG,eAAe;KACZ,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,mBAAmB,CAAC;KAChC,MAAM,CAAC,aAAa,CAAC;KACrB,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;KACtE,MAAM,CAAC,cAAc,CAAC;KACtB,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;KAC1C,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,IAAI,IAAI,CAAC,KAAK;QAAE,MAAM,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,4BAA4B,MAAM,EAAE,CAAC,CAAC;IAC3E,cAAc,CAAC,2BAA2B,EAAE,IAAI,CAAC,CAAC;IAClD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAyB,CAAC;IAC5C,WAAW,CAAC;QACV,MAAM,EAAE,2BAA2B;QACnC,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC,KAAK,eAAe,IAAI,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,WAAW,CAAC;QAC3E,gBAAgB,EAAE,CAAC,mCAAmC,EAAE,mCAAmC,CAAC;KAC7F,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,eAAe;KACZ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,sBAAsB,CAAC;KACnC,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC;KAC1C,cAAc,CAAC,iBAAiB,EAAE,mBAAmB,CAAC;KACtD,MAAM,CAAC,sBAAsB,CAAC;KAC9B,MAAM,CAAC,mBAAmB,EAAE,yCAAyC,CAAC;KACtE,MAAM,CAAC,kBAAkB,CAAC;KAC1B,MAAM,CAAC,cAAc,EAAE,kBAAkB,CAAC;KAC1C,MAAM,CAAC,eAAe,EAAE,iDAAiD,CAAC;KAC1E,MAAM,CAAC,sBAAsB,EAAE,0CAA0C,CAAC;KAC1E,MAAM,CAAC,oBAAoB,EAAE,+CAA+C,CAAC;KAC7E,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,0BAA0B,EAAE;QAChE,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,WAAW,EAAE,IAAI,CAAC,WAAW;QAC7B,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,QAAQ,EAAE,IAAI,CAAC,OAAO;QACtB,cAAc,EAAE,IAAI,CAAC,KAAK;QAC1B,WAAW,EAAE,IAAI,CAAC,UAAU,KAAK,IAAI;QACrC,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,cAAc,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC;QACV,MAAM,EAAE,6BAA6B;QACrC,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,UAAU,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,4CAA4C,EAAE,CAAC;QACnG,gBAAgB,EAAE,CAAC,mCAAmC,EAAE,aAAa,CAAC;KACvE,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,eAAe;KACZ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,iBAAiB,CAAC;KACzB,MAAM,CAAC,mBAAmB,CAAC;KAC3B,MAAM,CAAC,kBAAkB,CAAC;KAC1B,MAAM,CAAC,oBAAoB,EAAE,OAAO,CAAC;KACrC,MAAM,CAAC,mBAAmB,CAAC;KAC3B,MAAM,CAAC,KAAK,EAAE,aAAqB,EAAE,IAAI,EAAE,EAAE;IAC5C,MAAM,IAAI,GAA4B,EAAE,CAAC;IACzC,IAAI,IAAI,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACtD,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;QAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACzD,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC;IAC7D,IAAI,IAAI,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACvF,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS;QAAE,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;IAC/D,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,OAAO,EAAE,4BAA4B,aAAa,EAAE,EAAE,IAAI,CAAC,CAAC;IAC1F,cAAc,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,6BAA6B,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;AACnI,CAAC,CAAC,CAAC;AAEL,eAAe;KACZ,OAAO,CAAC,yBAAyB,CAAC;KAClC,WAAW,CAAC,sBAAsB,CAAC;KACnC,MAAM,CAAC,KAAK,EAAE,aAAqB,EAAE,EAAE;IACtC,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,QAAQ,EAAE,4BAA4B,aAAa,EAAE,CAAC,CAAC;IACrF,cAAc,CAAC,6BAA6B,EAAE,IAAI,CAAC,CAAC;IACpD,WAAW,CAAC,EAAE,MAAM,EAAE,6BAA6B,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,iCAAiC,CAAC,EAAE,CAAC,CAAC;AACnI,CAAC,CAAC,CAAC;AAEL,4EAA4E;AAE5E,MAAM,YAAY,GAAG,SAAS,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,WAAW,CAAC,qBAAqB,CAAC,CAAC;AAEvF,YAAY;KACT,OAAO,CAAC,MAAM,CAAC;KACf,WAAW,CAAC,gBAAgB,CAAC;KAC7B,MAAM,CAAC,aAAa,CAAC;KACrB,MAAM,CAAC,mBAAmB,EAAE,qBAAqB,CAAC;KAClD,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;KAC1C,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,IAAI,IAAI,CAAC,IAAI;QAAE,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,IAAI,CAAC,MAAM;QAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IACnD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,yBAAyB,MAAM,EAAE,CAAC,CAAC;IACxE,cAAc,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;IAC/C,WAAW,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,gCAAgC,CAAC,EAAE,CAAC,CAAC;AAC7H,CAAC,CAAC,CAAC;AAEL,YAAY;KACT,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,mBAAmB,CAAC;KAChC,cAAc,CAAC,aAAa,EAAE,WAAW,CAAC;KAC1C,cAAc,CAAC,oBAAoB,EAAE,kBAAkB,CAAC;KACxD,MAAM,CAAC,yBAAyB,EAAE,8BAA8B,CAAC;KACjE,MAAM,CAAC,iBAAiB,EAAE,cAAc,EAAE,GAAG,CAAC;KAC9C,MAAM,CAAC,kBAAkB,CAAC;KAC1B,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,MAAM,EAAE,uBAAuB,EAAE;QAC7D,OAAO,EAAE,IAAI,CAAC,IAAI;QAClB,cAAc,EAAE,IAAI,CAAC,UAAU;QAC/B,mBAAmB,EAAE,IAAI,CAAC,eAAe;QACzC,SAAS,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC;QACtC,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IACH,cAAc,CAAC,0BAA0B,EAAE,IAAI,CAAC,CAAC;IACjD,WAAW,CAAC,EAAE,MAAM,EAAE,0BAA0B,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;AAC7H,CAAC,CAAC,CAAC;AAEL,2EAA2E;AAE3E,SAAS;KACN,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,+EAA+E,CAAC;KAC5F,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,IAAI,CAAC;KAC1C,MAAM,CAAC,cAAc,EAAE,mBAAmB,EAAE,GAAG,CAAC;KAChD,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/E,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,uBAAuB,MAAM,EAAE,CAAC,CAAC;IACtE,cAAc,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACxC,WAAW,CAAC;QACV,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,gBAAgB,EAAE,CAAC,iCAAiC,EAAE,yCAAyC,CAAC;KACjG,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEL,SAAS;KACN,OAAO,CAAC,SAAS,CAAC;KAClB,WAAW,CAAC,2CAA2C,CAAC;KACxD,MAAM,CAAC,8BAA8B,CAAC;KACtC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;IACrB,MAAM,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;IACrC,IAAI,IAAI,CAAC,mBAAmB;QAAE,MAAM,CAAC,GAAG,CAAC,0BAA0B,EAAE,IAAI,CAAC,mBAAmB,CAAC,CAAC;IAC/F,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,uBAAuB,MAAM,EAAE,CAAC,CAAC;IACtE,cAAc,CAAC,iBAAiB,EAAE,IAAI,CAAC,CAAC;IACxC,WAAW,CAAC;QACV,MAAM,EAAE,iBAAiB;QACzB,MAAM,EAAE,IAAI,CAAC,IAAI;QACjB,gBAAgB,EAAE,CAAC,0BAA0B,EAAE,0BAA0B,CAAC;KAC3E,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/commands/crm.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare const crmCmd: Command;

package/dist/commands/crm.js

@@ -0,0 +1,319 @@
+import { Command } from "commander";
+import { apiRequest, handleApiError } from "../client.js";
+import { agentOutput } from "../output.js";
+export const crmCmd = new Command("crm")
+    .description("naive/crm primitive — contacts, companies, and interaction history")
+    .addHelpText("after", `
+Subcommands:
+  naive crm contacts ...     Manage CRM contacts (create, list, find, get, update, merge, log, history)
+  naive crm companies ...    Manage CRM companies (external organizations)
+
+The CRM primitive is the vertical-agnostic identity graph. Pipelines/deals
+live in the CRM template app (naive crm-app). Use this primitive any time
+an agent needs to:
+  - Look up a contact before sending email (dedupe by email/phone)
+  - Log activity history on a contact (calls, notes, payments)
+  - Find or create external companies (clients, prospects)
+
+Examples:
+  $ naive crm contacts find --email lead@example.com
+  $ naive crm contacts create --name "Jane Smith" --email jane@acme.com --company Acme
+  $ naive crm contacts log-interaction <contact-id> --type note --content "Discovery call went well"
+  $ naive crm contacts history <contact-id> --limit 20
+`);
+// ── Contacts ──────────────────────────────────────────────────────────────
+const contactsCmd = crmCmd.command("contacts").description("CRM contact management");
+contactsCmd
+    .command("list")
+    .description("List CRM contacts")
+    .option("--search <term>", "Free-text search on name and emails")
+    .option("--crm-company <id>", "Filter to a specific CRM company")
+    .option("--sort <field>", "Sort field: created_at | name", "created_at")
+    .option("--limit <n>", "Max results (default 50, max 200)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset, sort: opts.sort });
+    if (opts.search)
+        params.set("search", opts.search);
+    if (opts.crmCompany)
+        params.set("crm_company_id", opts.crmCompany);
+    const resp = await apiRequest("GET", `/v1/crm/contacts?${params}`);
+    handleApiError("crm.contacts.list", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.contacts.list",
+        result: resp.data,
+        next_steps: [
+            ...(data.contacts.length > 0
+                ? [{ command: `naive crm contacts get ${data.contacts[0].id}`, description: "Inspect the first contact" }]
+                : [{ command: "naive crm contacts create --name <name> --email <email>", description: "Create your first contact" }]),
+            { command: "naive crm contacts find --email <email>", description: "Find a contact by email before creating to dedupe" },
+        ],
+        hints: [`${data.count} contact${data.count === 1 ? "" : "s"} returned`],
+        related_commands: ["naive crm contacts create", "naive crm contacts find", "naive crm contacts get"],
+    });
+});
+contactsCmd
+    .command("create")
+    .description("Create a CRM contact (idempotent on email/phone)")
+    .option("--name <name>", "Contact full name")
+    .option("--email <email>", "Primary email address")
+    .option("--phone <phone>", "Primary phone number")
+    .option("--company <name>", "Company name (auto-creates if no --crm-company-id is provided)")
+    .option("--crm-company-id <id>", "Existing CRM company UUID to link to")
+    .option("--source <source>", "Where this contact came from")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm/contacts", {
+        name: opts.name,
+        email: opts.email,
+        phone: opts.phone,
+        company: opts.company,
+        crm_company_id: opts.crmCompanyId,
+        source: opts.source,
+    });
+    handleApiError("crm.contacts.create", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.contacts.create",
+        result: resp.data,
+        next_steps: [
+            { command: `naive crm contacts log-interaction ${data.contact.id} --type note --content "..."`, description: "Log activity on this contact" },
+            { command: `naive crm contacts history ${data.contact.id}`, description: "View full activity history" },
+        ],
+        hints: [
+            data.created ? "Created new contact" : "Returned existing contact (matched by email/phone)",
+            `Contact ID: ${data.contact.id}`,
+        ],
+        related_commands: ["naive crm contacts find", "naive crm contacts log-interaction"],
+    });
+});
+contactsCmd
+    .command("find")
+    .description("Find a contact by email, phone, or fuzzy name match — use this BEFORE creating to dedupe")
+    .option("--email <email>", "Exact match (case-insensitive)")
+    .option("--phone <phone>", "Exact match (digits-only)")
+    .option("--name <name>", "Fuzzy match (trigram)")
+    .option("--limit <n>", "Max results (default 10, max 50)", "10")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm/contacts/find", {
+        email: opts.email,
+        phone: opts.phone,
+        name: opts.name,
+        limit: parseInt(opts.limit, 10),
+    });
+    handleApiError("crm.contacts.find", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.contacts.find",
+        result: resp.data,
+        next_steps: data.contacts.length > 0
+            ? [
+                { command: `naive crm contacts get ${data.contacts[0].id}`, description: "Get full contact details" },
+                { command: `naive crm contacts log-interaction ${data.contacts[0].id} --type note --content "..."`, description: "Log activity on this contact" },
+            ]
+            : [{ command: "naive crm contacts create --name <name> --email <email>", description: "Create a new contact" }],
+        hints: [
+            data.contacts.length === 0 ? "No match — safe to create a new contact" : `Match type: ${data.match_type}`,
+        ],
+        related_commands: ["naive crm contacts create", "naive crm contacts merge"],
+    });
+});
+contactsCmd
+    .command("get <contact_id>")
+    .description("Get full contact details")
+    .action(async (contactId) => {
+    const resp = await apiRequest("GET", `/v1/crm/contacts/${contactId}`);
+    handleApiError("crm.contacts.get", resp);
+    agentOutput({
+        action: "crm.contacts.get",
+        result: resp.data,
+        next_steps: [
+            { command: `naive crm contacts history ${contactId}`, description: "View interaction history" },
+            { command: `naive crm contacts update ${contactId} --name <name>`, description: "Update contact" },
+        ],
+        related_commands: ["naive crm contacts history", "naive crm contacts update"],
+    });
+});
+contactsCmd
+    .command("update <contact_id>")
+    .description("Update a contact")
+    .option("--name <name>", "New name")
+    .option("--emails <list>", "Comma-separated list of emails (replaces existing)")
+    .option("--phones <list>", "Comma-separated list of phones (replaces existing)")
+    .option("--crm-company-id <id>", "Link to a CRM company (use 'null' to clear)")
+    .action(async (contactId, opts) => {
+    const body = {};
+    if (opts.name !== undefined)
+        body.name = opts.name;
+    if (opts.emails !== undefined)
+        body.emails = opts.emails.split(",").map((s) => s.trim()).filter(Boolean);
+    if (opts.phones !== undefined)
+        body.phones = opts.phones.split(",").map((s) => s.trim()).filter(Boolean);
+    if (opts.crmCompanyId !== undefined)
+        body.crm_company_id = opts.crmCompanyId === "null" ? null : opts.crmCompanyId;
+    const resp = await apiRequest("PATCH", `/v1/crm/contacts/${contactId}`, body);
+    handleApiError("crm.contacts.update", resp);
+    agentOutput({
+        action: "crm.contacts.update",
+        result: resp.data,
+        next_steps: [{ command: `naive crm contacts get ${contactId}`, description: "Verify the update" }],
+        related_commands: ["naive crm contacts get", "naive crm contacts history"],
+    });
+});
+contactsCmd
+    .command("delete <contact_id>")
+    .description("Delete a CRM contact (cascade-deletes interactions)")
+    .action(async (contactId) => {
+    const resp = await apiRequest("DELETE", `/v1/crm/contacts/${contactId}`);
+    handleApiError("crm.contacts.delete", resp);
+    agentOutput({
+        action: "crm.contacts.delete",
+        result: resp.data,
+        next_steps: [{ command: "naive crm contacts list", description: "Verify removal" }],
+        related_commands: ["naive crm contacts list"],
+    });
+});
+contactsCmd
+    .command("merge <primary_id>")
+    .description("Merge a duplicate contact into the primary contact")
+    .requiredOption("--duplicate <id>", "The duplicate contact ID to merge into the primary")
+    .action(async (primaryId, opts) => {
+    const resp = await apiRequest("POST", `/v1/crm/contacts/${primaryId}/merge`, {
+        duplicate_id: opts.duplicate,
+    });
+    handleApiError("crm.contacts.merge", resp);
+    agentOutput({
+        action: "crm.contacts.merge",
+        result: resp.data,
+        next_steps: [{ command: `naive crm contacts get ${primaryId}`, description: "Inspect the merged contact" }],
+        hints: ["All interactions moved to primary, duplicate deleted"],
+        related_commands: ["naive crm contacts get", "naive crm contacts history"],
+    });
+});
+contactsCmd
+    .command("log-interaction <contact_id>")
+    .description("Log an interaction (email | call | note | task | payment) on a contact")
+    .requiredOption("--type <type>", "email | call | note | task | payment")
+    .option("--direction <dir>", "inbound | outbound | internal", "internal")
+    .option("--content <text>", "Free-text body")
+    .option("--refs <json>", "Cross-references as JSON, e.g. '{\"message_id\":\"abc\"}'")
+    .option("--occurred-at <iso>", "ISO timestamp; defaults to now")
+    .action(async (contactId, opts) => {
+    const body = {
+        type: opts.type,
+        direction: opts.direction,
+    };
+    if (opts.content !== undefined)
+        body.content = opts.content;
+    if (opts.refs !== undefined) {
+        try {
+            body.refs = JSON.parse(opts.refs);
+        }
+        catch {
+            agentOutput({
+                action: "crm.contacts.log-interaction",
+                result: { error: "invalid_input", message: "--refs must be valid JSON" },
+                hints: ["Wrap in single quotes: --refs '{\"key\":\"value\"}'"],
+                related_commands: ["naive crm contacts log-interaction"],
+            });
+            process.exit(1);
+        }
+    }
+    if (opts.occurredAt !== undefined)
+        body.occurred_at = opts.occurredAt;
+    const resp = await apiRequest("POST", `/v1/crm/contacts/${contactId}/interactions`, body);
+    handleApiError("crm.contacts.log-interaction", resp);
+    agentOutput({
+        action: "crm.contacts.log-interaction",
+        result: resp.data,
+        next_steps: [{ command: `naive crm contacts history ${contactId}`, description: "View updated history" }],
+        related_commands: ["naive crm contacts history", "naive crm contacts get"],
+    });
+});
+contactsCmd
+    .command("history <contact_id>")
+    .description("Get interaction history (most recent first)")
+    .option("--types <list>", "Comma-separated types to filter: email,call,note,task,payment")
+    .option("--since <iso>", "Lower bound ISO timestamp")
+    .option("--until <iso>", "Upper bound ISO timestamp")
+    .option("--limit <n>", "Max results (default 50, max 200)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (contactId, opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.types)
+        params.set("types", opts.types);
+    if (opts.since)
+        params.set("since", opts.since);
+    if (opts.until)
+        params.set("until", opts.until);
+    const resp = await apiRequest("GET", `/v1/crm/contacts/${contactId}/interactions?${params}`);
+    handleApiError("crm.contacts.history", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.contacts.history",
+        result: resp.data,
+        hints: [`${data.count} interaction${data.count === 1 ? "" : "s"} returned`],
+        next_steps: [{ command: `naive crm contacts log-interaction ${contactId} --type note --content "..."`, description: "Log a new interaction" }],
+        related_commands: ["naive crm contacts log-interaction", "naive crm contacts get"],
+    });
+});
+// ── Companies ────────────────────────────────────────────────────────────
+const companiesSubCmd = crmCmd.command("companies").description("CRM company (external organization) management");
+companiesSubCmd
+    .command("list")
+    .description("List CRM companies")
+    .option("--search <term>", "Free-text search on name/domain")
+    .option("--limit <n>", "Max results (default 50, max 200)", "50")
+    .option("--offset <n>", "Pagination offset", "0")
+    .action(async (opts) => {
+    const params = new URLSearchParams({ limit: opts.limit, offset: opts.offset });
+    if (opts.search)
+        params.set("search", opts.search);
+    const resp = await apiRequest("GET", `/v1/crm/companies?${params}`);
+    handleApiError("crm.companies.list", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.companies.list",
+        result: resp.data,
+        hints: [`${data.count} compan${data.count === 1 ? "y" : "ies"} returned`],
+        next_steps: [{ command: "naive crm companies create --name <name> --domain <domain>", description: "Create a new CRM company" }],
+        related_commands: ["naive crm companies create", "naive crm companies get"],
+    });
+});
+companiesSubCmd
+    .command("create")
+    .description("Create a CRM company (idempotent on lower(domain))")
+    .requiredOption("--name <name>", "Company name")
+    .option("--domain <domain>", "Primary web domain (e.g. acme.com)")
+    .option("--source <source>", "Where this record came from")
+    .action(async (opts) => {
+    const resp = await apiRequest("POST", "/v1/crm/companies", {
+        name: opts.name,
+        domain: opts.domain,
+        source: opts.source,
+    });
+    handleApiError("crm.companies.create", resp);
+    const data = resp.data;
+    agentOutput({
+        action: "crm.companies.create",
+        result: resp.data,
+        hints: [data.created ? "Created new company" : "Returned existing company (matched by domain)"],
+        next_steps: [
+            { command: `naive crm contacts create --crm-company-id ${data.company.id} --name <name> --email <email>`, description: "Link a contact to this company" },
+        ],
+        related_commands: ["naive crm contacts create", "naive crm companies get"],
+    });
+});
+companiesSubCmd
+    .command("get <company_id>")
+    .description("Get CRM company details")
+    .action(async (companyId) => {
+    const resp = await apiRequest("GET", `/v1/crm/companies/${companyId}`);
+    handleApiError("crm.companies.get", resp);
+    agentOutput({
+        action: "crm.companies.get",
+        result: resp.data,
+        related_commands: ["naive crm companies list", "naive crm contacts list"],
+    });
+});
+//# sourceMappingURL=crm.js.map