@startanaicompany/crm 2.5.1 → 2.6.0

package/index.js

@@ -438,6 +438,8 @@ leadsCmd
   .option('--status <status>', 'Filter by status')
   .option('--email <email>', 'Filter by email (partial match)')
   .option('--company <company>', 'Filter by company (partial match)')
+  .option('--name <name>', 'Search by name or company (partial match)')
+  .option('--pipeline-stage <stage>', 'Filter by pipeline stage (exact match)')
   .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)')
@@ -456,6 +458,8 @@ leadsCmd
       ...(opts.status && { status: opts.status }),
       ...(opts.email && { email: opts.email }),
       ...(opts.company && { company: opts.company }),
+      ...(opts.name && { name: opts.name }),
+      ...(opts.pipelineStage && { pipeline_stage: opts.pipelineStage }),
       ...(apiKeyIdFilter && { api_key_id: apiKeyIdFilter }),
       ...(opts.createdAfter && { created_after: opts.createdAfter }),
       ...(opts.createdBefore && { created_before: opts.createdBefore }),
@@ -501,27 +505,46 @@ leadsCmd
   .option('--deal-value <amount>', 'Deal value (numeric)')
   .option('--notes <notes>', 'New notes')
   .option('--assigned-to <assignedTo>', 'New assigned-to')
-  .option('--tag <tag>', 'Replace tags (repeatable)', (v, prev) => prev.concat([v]), [])
+  .option('--tag <tag>', 'Replace ALL tags (repeatable). Use --add-tag / --remove-tag for surgical edits.', (v, prev) => prev.concat([v]), [])
+  .option('--add-tag <tag>', 'Add a single tag without replacing others (repeatable)', (v, prev) => prev.concat([v]), [])
+  .option('--remove-tag <tag>', 'Remove a single tag (repeatable)', (v, prev) => prev.concat([v]), [])
   .option('--external-id <externalId>', 'New external ID')
   .option('--version <version>', 'Optimistic lock version')
   .action(async (id, opts) => {
     const globalOpts = program.opts();
     const client = getClient(globalOpts);
-    const body = {
-      ...(opts.name && { name: opts.name }),
-      ...(opts.email && { email: opts.email }),
-      ...(opts.phone !== undefined && { phone: opts.phone }),
-      ...(opts.company !== undefined && { company: opts.company }),
-      ...(opts.status && { status: opts.status }),
-      ...(opts.source && { source: opts.source }),
-      ...(opts.dealValue !== undefined && { deal_value: parseFloat(opts.dealValue) }),
-      ...(opts.notes !== undefined && { notes: opts.notes }),
-      ...(opts.assignedTo !== undefined && { assigned_to: opts.assignedTo }),
-      ...(opts.tag.length > 0 && { tags: opts.tag }),
-      ...(opts.externalId !== undefined && { external_id: opts.externalId }),
-      ...(opts.version !== undefined && { version: parseInt(opts.version) })
-    };
     try {
+      // Surgical tag ops: call PATCH /leads/:id/tags first if add/remove specified
+      if (opts.addTag.length > 0 || opts.removeTag.length > 0) {
+        const tagRes = await client.patch(`/leads/${id}/tags`, {
+          ...(opts.addTag.length > 0 && { add_tags: opts.addTag }),
+          ...(opts.removeTag.length > 0 && { remove_tags: opts.removeTag })
+        });
+        // If no other fields to update, return tag result
+        const hasOtherFields = opts.name || opts.email || opts.phone !== undefined ||
+          opts.company !== undefined || opts.status || opts.source ||
+          opts.dealValue !== undefined || opts.notes !== undefined ||
+          opts.assignedTo !== undefined || opts.tag.length > 0 ||
+          opts.externalId !== undefined;
+        if (!hasOtherFields) {
+          printJSON(tagRes.data);
+          return;
+        }
+      }
+      const body = {
+        ...(opts.name && { name: opts.name }),
+        ...(opts.email && { email: opts.email }),
+        ...(opts.phone !== undefined && { phone: opts.phone }),
+        ...(opts.company !== undefined && { company: opts.company }),
+        ...(opts.status && { status: opts.status }),
+        ...(opts.source && { source: opts.source }),
+        ...(opts.dealValue !== undefined && { deal_value: parseFloat(opts.dealValue) }),
+        ...(opts.notes !== undefined && { notes: opts.notes }),
+        ...(opts.assignedTo !== undefined && { assigned_to: opts.assignedTo }),
+        ...(opts.tag.length > 0 && { tags: opts.tag }),
+        ...(opts.externalId !== undefined && { external_id: opts.externalId }),
+        ...(opts.version !== undefined && { version: parseInt(opts.version) })
+      };
       const res = await client.put(`/leads/${id}`, body);
       printJSON(res.data);
     } catch (err) {
@@ -1825,6 +1848,61 @@ contractsCmd
   });
 
 
+contractsCmd
+  .command('esign <id>')
+  .description('Send e-signing email(s) to all pending signatories on a contract')
+  .action(async (id) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.post(`/contracts/${id}/sign`, {});
+      const d = res.data.data;
+      console.log(`Signing emails sent to ${d.sent_to} signatory(ies).`);
+      printJSON(res.data);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+contractsCmd
+  .command('esign-status <id>')
+  .description('Check e-signing status for a contract')
+  .action(async (id) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.get(`/contracts/${id}/sign/status`);
+      printJSON(res.data);
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
+contractsCmd
+  .command('export <id>')
+  .description('Export a contract as PDF and get a download URL')
+  .option('--format <format>', 'Export format (pdf)', 'pdf')
+  .option('--output <file>', 'Save PDF to local file (optional)')
+  .action(async (id, opts) => {
+    const globalOpts = program.opts();
+    const client = getClient(globalOpts);
+    try {
+      const res = await client.get(`/contracts/${id}/export`, { params: { format: opts.format } });
+      const d = res.data.data;
+      console.log(`Download URL: ${d.download_url}`);
+      console.log(`Expires: ${d.expires_at}`);
+      if (opts.output) {
+        // Download the PDF and save locally
+        const baseUrl = globalOpts.apiUrl || process.env.SAAC_CRM_API_URL || loadConfig().apiUrl;
+        const dlRes = await axios.get(`${baseUrl.replace('/api/v1', '')}${d.download_url}`, { responseType: 'arraybuffer' });
+        fs.writeFileSync(opts.output, dlRes.data);
+        console.log(`Saved to ${opts.output}`);
+      }
+    } catch (err) {
+      handleError(err);
+    }
+  });
+
 // ============================================================
 // BUDGETS commands — Sprint 5
 // ============================================================
@@ -2162,14 +2240,27 @@ const supportCmd = program.command('support').description('Submit and manage bug
     .description(`Submit a new ${singular} report`)
     .requiredOption('--title <title>', `${singular} title (max 200 chars)`)
     .requiredOption('--description <desc>', 'Full description (max 2000 chars)')
+    .option('--priority <p>', 'Priority: low|medium|high|critical (default: medium)', 'medium')
+    .option('--cli-version <v>', 'Your CLI version (e.g. 2.5.1)')
+    .option('--tags <tags>', 'Comma-separated tags (e.g. auth,login,ui)')
+    .option('--severity <s>', type === 'bugs' ? 'Severity: cosmetic|minor|major|critical (bugs only)' : '(ignored for features)')
+    .option('--from-agent-name <name>', 'Agent name for attribution (falls back to config defaultAgentName)')
     .action(async (opts) => {
       const globalOpts = program.opts();
-      const client = getClient(globalOpts);
+      const agentName = resolveAgentName(opts.fromAgentName);
+      const client = getClient(globalOpts, agentName);
       try {
-        const res = await client.post(`/support/${type}`, {
+        const body = {
           title: opts.title,
-          description: opts.description
-        });
+          description: opts.description,
+          priority: opts.priority
+        };
+        if (opts.cliVersion) body.cli_version = opts.cliVersion;
+        if (opts.tags) body.tags = opts.tags.split(',').map(t => t.trim()).filter(Boolean);
+        if (opts.severity && type === 'bugs') body.severity = opts.severity;
+        // GAP-S10-2: send agent_name in body as well (belt-and-suspenders alongside X-Agent-Name header)
+        if (agentName) body.agent_name = agentName;
+        const res = await client.post(`/support/${type}`, body);
         console.log(`${singular.charAt(0).toUpperCase() + singular.slice(1)} submitted. ID: ${res.data.data.id}`);
         printJSON(res.data);
       } catch (err) {
@@ -2206,6 +2297,21 @@ const supportCmd = program.command('support').description('Submit and manage bug
       }
     });
 
+  typeCmd
+    .command('comments')
+    .description(`List all comments on your ${singular} ticket`)
+    .requiredOption('--id <id>', 'Ticket ID')
+    .action(async (opts) => {
+      const globalOpts = program.opts();
+      const client = getClient(globalOpts);
+      try {
+        const res = await client.get(`/support/${type}/${opts.id}/comments`);
+        printJSON(res.data);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
   typeCmd
     .command('comment')
     .description(`Add a comment to your own ${singular} ticket`)
@@ -2224,6 +2330,57 @@ const supportCmd = program.command('support').description('Submit and manage bug
         handleError(err);
       }
     });
+
+  typeCmd
+    .command('close')
+    .description(`Close/withdraw your own ${singular} ticket (requires reason)`)
+    .requiredOption('--id <id>', 'Ticket ID')
+    .requiredOption('--reason <reason>', 'Reason for closing')
+    .action(async (opts) => {
+      const globalOpts = program.opts();
+      const client = getClient(globalOpts);
+      try {
+        const res = await client.patch(`/support/${type}/${opts.id}/close`, { reason: opts.reason });
+        console.log('Ticket closed.');
+        printJSON(res.data);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  typeCmd
+    .command('reopen')
+    .description(`Reopen a resolved ${singular} ticket (requires note)`)
+    .requiredOption('--id <id>', 'Ticket ID')
+    .requiredOption('--note <note>', 'Explanation for reopening')
+    .action(async (opts) => {
+      const globalOpts = program.opts();
+      const client = getClient(globalOpts);
+      try {
+        const res = await client.patch(`/support/${type}/${opts.id}/reopen`, { note: opts.note });
+        console.log('Ticket reopened.');
+        printJSON(res.data);
+      } catch (err) {
+        handleError(err);
+      }
+    });
+
+  typeCmd
+    .command('update')
+    .description(`Add a note to your ${singular} ticket (use when status is needs_more_info)`)
+    .requiredOption('--id <id>', 'Ticket ID')
+    .requiredOption('--note <note>', 'Additional information')
+    .action(async (opts) => {
+      const globalOpts = program.opts();
+      const client = getClient(globalOpts);
+      try {
+        const res = await client.patch(`/support/${type}/${opts.id}/update`, { note: opts.note });
+        console.log('Note added.');
+        printJSON(res.data);
+      } catch (err) {
+        handleError(err);
+      }
+    });
 });
 
 program.parse(process.argv);

package/package.json

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