@startanaicompany/crm 2.7.0 → 2.10.0

package/index.js

@@ -398,6 +398,10 @@ leadsCmd
   .option('--source <source>', 'Source: api|import|referral|linkedin|cold_email|website|inbound|partner|event|other', 'api')
   .option('--deal-value <amount>', 'Deal value (numeric)')
   .option('--pipeline-stage <stage>', 'Pipeline stage: new|prospecting|discovery|qualified|demo_scheduled|demo_completed|proposal_sent|negotiation|contract_sent|closed_won|closed_lost|no_decision|dormant')
+  .option('--score <n>', 'Lead score (0-100 integer). Conventions: 0-19 Cold, 20-39 Warm, 40-59 Developing, 60-79 Qualified, 80-100 Hot')
+  .option('--score-reason <text>', 'Score reason/explanation')
+  .option('--close-probability <n>', 'Close probability 0-100 integer')
+  .option('--close-reason <reason>', `Close reason (${['price','timing','competition','no_budget','no_decision','fit','other'].join('|')})`)
   .option('--notes <notes>', 'Notes')
   .option('--assigned-to <assignedTo>', 'Assigned to')
   .option('--tag <tag>', 'Tag (repeatable)', (v, prev) => prev.concat([v]), [])
@@ -419,6 +423,11 @@ leadsCmd
       source: opts.source,
       ...(opts.dealValue !== undefined && { deal_value: parseFloat(opts.dealValue) }),
       ...(opts.pipelineStage && { pipeline_stage: opts.pipelineStage }),
+      // --score 0 is valid — use !== undefined not falsy check
+      ...(opts.score !== undefined && { score: parseInt(opts.score) }),
+      ...(opts.scoreReason && { score_reason: opts.scoreReason }),
+      ...(opts.closeProbability !== undefined && { close_probability: parseInt(opts.closeProbability) }),
+      ...(opts.closeReason && { close_reason: opts.closeReason }),
       ...(opts.notes && { notes: opts.notes }),
       ...(opts.assignedTo && { assigned_to: opts.assignedTo }),
       ...(opts.tag.length > 0 && { tags: opts.tag }),
@@ -444,8 +453,13 @@ leadsCmd
   .option('--tag <tag>', 'Filter by tag — repeatable, AND logic', (v, prev) => prev.concat([v]), [])
   .option('--api-key-id <id>', 'Filter by the API key ID that created the lead')
   .option('--self', 'Filter leads created by the current API key (shorthand for --api-key-id self)')
-  .option('--sort-by <field>', 'Sort field: created_at|updated_at|deal_value|name|company|last_activity_at|status_changed_at')
+  .option('--sort-by <field>', 'Sort field: created_at|updated_at|deal_value|name|company|last_activity_at|status_changed_at|score')
   .option('--order <dir>', 'Sort direction: asc|desc', 'desc')
+  .option('--score-min <n>', 'Filter leads with score >= n (0-100)')
+  .option('--score-max <n>', 'Filter leads with score <= n (0-100)')
+  .option('--close-probability-min <n>', 'Filter leads with close_probability >= n')
+  .option('--close-probability-max <n>', 'Filter leads with close_probability <= n')
+  .option('--not-contacted-since-days <n>', 'Filter stale leads not contacted in N days (excludes converted/lost)')
   .option('--created-after <date>', 'Filter leads created after this ISO8601 date (e.g. 2026-01-01T00:00:00Z)')
   .option('--created-before <date>', 'Filter leads created before this ISO8601 date')
   .option('--updated-after <date>', 'Filter leads updated after this ISO8601 date')
@@ -467,6 +481,11 @@ leadsCmd
       ...(apiKeyIdFilter && { api_key_id: apiKeyIdFilter }),
       ...(opts.sortBy && { sort_by: opts.sortBy }),
       ...(opts.order && { order: opts.order }),
+      ...(opts.scoreMin !== undefined && { score_min: opts.scoreMin }),
+      ...(opts.scoreMax !== undefined && { score_max: opts.scoreMax }),
+      ...(opts.closeProbabilityMin !== undefined && { close_probability_min: opts.closeProbabilityMin }),
+      ...(opts.closeProbabilityMax !== undefined && { close_probability_max: opts.closeProbabilityMax }),
+      ...(opts.notContactedSinceDays !== undefined && { not_contacted_since_days: opts.notContactedSinceDays }),
       ...(opts.createdAfter && { created_after: opts.createdAfter }),
       ...(opts.createdBefore && { created_before: opts.createdBefore }),
       ...(opts.updatedAfter && { updated_after: opts.updatedAfter }),
@@ -514,9 +533,30 @@ leadsCmd
     }
   });
 
+leadsCmd
+  .command('score')
+  .description('Set lead score (0-100). Conventions: 0-19 Cold, 20-39 Warm, 40-59 Developing, 60-79 Qualified, 80-100 Hot')
+  .requiredOption('--id <uuid>', 'Lead UUID')
+  .requiredOption('--score <n>', 'Score value (0-100 integer)')
+  .option('--reason <text>', 'Score reason/explanation')
+  .action(async (opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    const body = {
+      score: parseInt(opts.score),
+      ...(opts.reason && { score_reason: opts.reason })
+    };
+    try {
+      const res = await client.patch(`/leads/${opts.id}/score`, body);
+      printJSON(res.data);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
 leadsCmd
   .command('get <id>')
-  .description('Get a single lead by ID')
+  .description('Get a single lead by ID (includes activity_summary)')
   .action(async (id) => {
     const globalOpts = program.opts();
     const client = getClient(globalOpts);
@@ -1319,7 +1359,42 @@ emailsCmd
     }
   });
 
+emailsCmd
+  .command('sync')
+  .description('Sync Gmail inbox into CRM (deduped by Gmail message ID)')
+  .option('--max-results <n>', 'Max number of messages to fetch (default 100, max 500)', '100')
+  .action(async (opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.post('/emails/sync', { max_results: parseInt(opts.maxResults) || 100 });
+      printJSON(res.data);
+    } catch (err) {
+      handleError(err);
+    }
+  });
 
+emailsCmd
+  .command('send')
+  .description('Send an email via Gmail (rate-limited: 1/30min, 30/day per workspace)')
+  .requiredOption('--to <email>', 'Recipient email address')
+  .requiredOption('--subject <subject>', 'Email subject')
+  .requiredOption('--body <text>', 'Email body text')
+  .option('--lead-id <id>', 'Link sent email to a lead ID')
+  .option('--dry-run', 'Validate only — do not send or consume rate limit quota')
+  .action(async (opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const body = { to: opts.to, subject: opts.subject, body: opts.body };
+      if (opts.leadId) body.lead_id = opts.leadId;
+      if (opts.dryRun) body.dry_run = true;
+      const res = await client.post('/emails/send', body);
+      printJSON(res.data);
+    } catch (err) {
+      handleError(err);
+    }
+  });
 
 // ============================================================
 // QUOTES commands

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@startanaicompany/crm",
-  "version": "2.7.0",
-  "description": "AI-first CRM CLI \u2014 manage leads and API keys from the terminal",
+  "version": "2.10.0",
+  "description": "AI-first CRM CLI — manage leads and API keys from the terminal",
   "main": "index.js",
   "bin": {
     "saac_crm": "./index.js"