@startanaicompany/crm 2.14.0 → 2.15.0

package/index.js

@@ -1120,6 +1120,38 @@ leadsCmd
     } catch (err) { handleError(err); }
   });
 
+// Sprint 52 T2: leads escalate + leads unassign
+leadsCmd
+  .command('escalate <lead-id>')
+  .description('Manually escalate a lead — sets escalated=true and fires lead.escalated webhook (Sprint 52 T2)')
+  .option('--reason <text>', 'Reason for escalation')
+  .option('--to <agent>', 'Reassign to this agent/user on escalation')
+  .action(async (leadId, opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const body = {};
+      if (opts.reason) body.reason = opts.reason;
+      if (opts.to) body.to = opts.to;
+      const res = await client.post(`/leads/${leadId}/escalate`, body);
+      console.log(`Lead ${leadId} escalated.`);
+      printJSON(res.data);
+    } catch (err) { handleError(err); }
+  });
+
+leadsCmd
+  .command('unassign <lead-id>')
+  .description('Remove assignment from a lead (sets assigned_to to null) (Sprint 52 T2)')
+  .action(async (leadId) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.patch(`/leads/${leadId}`, { assigned_to: null });
+      console.log(`Lead ${leadId} unassigned.`);
+      printJSON(res.data);
+    } catch (err) { handleError(err); }
+  });
+
 // Sprint 51 T3: leads export / leads import
 leadsCmd
   .command('export')
@@ -1187,11 +1219,14 @@ const contactsCmd = program
 contactsCmd
   .command('create')
   .description('Create a new contact')
-  .requiredOption('--first-name <name>', 'First name')
+  .option('--name <name>', 'Full name (alias for --first-name)')
+  .option('--first-name <name>', 'First name')
   .option('--last-name <name>', 'Last name')
-  .option('--email <email>', 'Email address (unique)')
+  .requiredOption('--email <email>', 'Email address (unique)')
   .option('--phone <phone>', 'Phone number')
-  .option('--company <company>', 'Company name')
+  .option('--company <company>', 'Company name (text)')
+  .option('--company-id <uuid>', 'Company UUID (links to companies table)')
+  .option('--lead-id <uuid>', 'Lead UUID to link to this contact on creation')
   .option('--title <title>', 'Job title')
   .option('--tags <tags>', 'Comma-separated tags')
   .option('--do-not-contact', 'Mark as do not contact')
@@ -1203,11 +1238,14 @@ contactsCmd
     const client = getClient(globalOpts, agentName);
     try {
       const body = {
-        first_name: opts.firstName,
+        name: opts.name || opts.firstName,
+        first_name: opts.firstName || opts.name,
         last_name: opts.lastName,
         email: opts.email,
         phone: opts.phone,
         company: opts.company,
+        company_id: opts.companyId,
+        lead_id: opts.leadId,
         title: opts.title,
         notes: opts.notes,
         do_not_contact: opts.doNotContact === true,
@@ -1224,8 +1262,10 @@ contactsCmd
   .command('list')
   .description('List contacts')
   .option('--email <email>', 'Filter by email (partial match)')
-  .option('--company <company>', 'Filter by company (partial match)')
+  .option('--company <company>', 'Filter by company name (partial match)')
+  .option('--company-id <uuid>', 'Filter by company UUID')
   .option('--tag <tag>', 'Filter by tag')
+  .option('--limit <n>', 'Max results per page (default 20)')
   .option('--page <n>', 'Page number', '1')
   .option('--per-page <n>', 'Results per page', '20')
   .action(async (opts) => {
@@ -1233,8 +1273,10 @@ contactsCmd
     const client = getClient(globalOpts);
     try {
       const params = { page: opts.page, per_page: opts.perPage };
+      if (opts.limit) params.limit = opts.limit;
       if (opts.email) params.email = opts.email;
       if (opts.company) params.company = opts.company;
+      if (opts.companyId) params.company_id = opts.companyId;
       if (opts.tag) params.tag = opts.tag;
       const res = await client.get('/contacts', { params });
       printJSON(res.data);
@@ -1260,11 +1302,13 @@ contactsCmd
 contactsCmd
   .command('update <id>')
   .description('Update a contact')
+  .option('--name <name>', 'Full name (alias for --first-name)')
   .option('--first-name <name>', 'First name')
   .option('--last-name <name>', 'Last name')
   .option('--email <email>', 'Email address')
   .option('--phone <phone>', 'Phone number')
-  .option('--company <company>', 'Company name')
+  .option('--company <company>', 'Company name (text)')
+  .option('--company-id <uuid>', 'Company UUID (links to companies table)')
   .option('--title <title>', 'Job title')
   .option('--role <role>', 'Role: champion|economic_buyer|technical_buyer|gatekeeper|influencer|end_user')
   .option('--tags <tags>', 'Comma-separated tags')
@@ -1274,11 +1318,13 @@ contactsCmd
     const client = getClient(globalOpts);
     try {
       const body = {};
+      if (opts.name !== undefined) body.name = opts.name;
       if (opts.firstName !== undefined) body.first_name = opts.firstName;
       if (opts.lastName !== undefined) body.last_name = opts.lastName;
       if (opts.email !== undefined) body.email = opts.email;
       if (opts.phone !== undefined) body.phone = opts.phone;
       if (opts.company !== undefined) body.company = opts.company;
+      if (opts.companyId !== undefined) body.company_id = opts.companyId;
       if (opts.title !== undefined) body.title = opts.title;
       if (opts.role !== undefined) body.role = opts.role;
       if (opts.tags !== undefined) body.tags = opts.tags.split(',').map(t => t.trim());
@@ -3442,4 +3488,81 @@ gdprCmd
     }
   });
 
+// ============================================================
+// REPORTS COMMANDS — Sprint 52 T3
+// ============================================================
+const reportsCmd = program.command('reports').description('Manage and run saved CRM reports (Sprint 52 T3)');
+
+reportsCmd
+  .command('list')
+  .description('List all saved reports')
+  .action(async () => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.get('/reports');
+      const reports = res.data.data || res.data;
+      if (!reports || reports.length === 0) { console.log('No reports found.'); return; }
+      reports.forEach(r => console.log(`[${r.id}] ${r.name} — type: ${r.dimension}/${r.metric}, period: ${r.period}`));
+    } catch (err) { handleError(err); }
+  });
+
+reportsCmd
+  .command('create')
+  .description('Create and save a report definition')
+  .requiredOption('--name <name>', 'Report name')
+  .option('--type <type>', 'Report type: leads (count by stage) | pipeline (deal value by pipeline) | revenue (deal value by stage)', 'leads')
+  .option('--period <period>', 'Time period: 7d | 30d | 90d | 365d | all', '30d')
+  .option('--filter-status <status>', 'Filter leads by status')
+  .option('--filter-stage <stage>', 'Filter leads by pipeline stage')
+  .option('--chart-type <type>', 'Chart type: bar | line | pie | table', 'bar')
+  .action(async (opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const body = {
+        name: opts.name,
+        type: opts.type,
+        period: opts.period,
+        chart_type: opts.chartType,
+      };
+      if (opts.filterStatus) body.filter_status = opts.filterStatus;
+      if (opts.filterStage) body.filter_stage = opts.filterStage;
+      const res = await client.post('/reports', body);
+      const r = res.data.data || res.data;
+      console.log(`Report created: [${r.id}] ${r.name}`);
+      printJSON(res.data);
+    } catch (err) { handleError(err); }
+  });
+
+reportsCmd
+  .command('run <report-id>')
+  .description('Run a saved report and display or save results')
+  .option('--output <file>', 'Save results to this JSON file')
+  .action(async (reportId, opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.get(`/reports/${reportId}/run`);
+      if (opts.output) {
+        fs.writeFileSync(opts.output, JSON.stringify(res.data, null, 2));
+        console.log(`Report results saved to ${opts.output}`);
+      } else {
+        printJSON(res.data);
+      }
+    } catch (err) { handleError(err); }
+  });
+
+reportsCmd
+  .command('delete <report-id>')
+  .description('Delete a saved report')
+  .action(async (reportId) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      await client.delete(`/reports/${reportId}`);
+      console.log(`Report ${reportId} deleted.`);
+    } catch (err) { handleError(err); }
+  });
+
 program.parse(process.argv);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@startanaicompany/crm",
-  "version": "2.14.0",
+  "version": "2.15.0",
   "description": "AI-first CRM CLI — manage leads and API keys from the terminal",
   "main": "index.js",
   "bin": {