@solidnumber/cli 2.11.10 → 2.11.12

package/dist/commands/sales.js

@@ -0,0 +1,896 @@
+"use strict";
+/**
+ * Sales Agent CLI — Phase 1 read-only verbs.
+ *
+ * Wraps existing CRM endpoints into a sales-focused surface for AI agents.
+ * Same verbs, different context per industry — the KB provides differentiation.
+ *
+ * Endpoints composed:
+ *   GET /api/v1/crm/pipeline/summary
+ *   GET /api/v1/crm/leads/stats
+ *   GET /api/v1/crm/leads/pipeline-sources
+ *   GET /api/v1/crm/dashboard/revenue/summary
+ *   GET /api/v1/crm/dashboard/summary
+ *   GET /api/v1/crm/sales-funnel
+ *   GET /api/v1/crm/tasks
+ *   GET /api/v1/crm/lead-scoring/high-value-contacts
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.salesCommand = void 0;
+const commander_1 = require("commander");
+const ora_1 = __importDefault(require("ora"));
+const chalk_1 = __importDefault(require("chalk"));
+const config_1 = require("../lib/config");
+const api_client_1 = require("../lib/api-client");
+const json_output_1 = require("../lib/json-output");
+const ui_1 = require("../lib/ui");
+function requireAuth() {
+    if (!config_1.config.isLoggedIn()) {
+        console.error(chalk_1.default.red('Not logged in. Run `solid auth login` first.'));
+        process.exit(1);
+    }
+}
+function fail(spinner, msg, err) {
+    spinner.fail(chalk_1.default.red(msg));
+    console.error(chalk_1.default.red(`  ${(0, api_client_1.handleApiError)(err).message}`));
+    process.exit(1);
+}
+function dollars(cents) {
+    const n = Number(cents);
+    if (!Number.isFinite(n))
+        return '$0';
+    return `$${(n / 100).toLocaleString('en-US', { minimumFractionDigits: 0, maximumFractionDigits: 0 })}`;
+}
+function dollarsDirect(val) {
+    const n = Number(val);
+    if (!Number.isFinite(n))
+        return '$0';
+    return `$${n.toLocaleString('en-US', { minimumFractionDigits: 0, maximumFractionDigits: 0 })}`;
+}
+function pct(val) {
+    const n = Number(val);
+    if (!Number.isFinite(n))
+        return '0%';
+    return `${n.toFixed(1)}%`;
+}
+function unwrapDispatch(data) {
+    if (data.ok === false) {
+        const err = (data.error || {});
+        throw new Error(String(err.message || err.reason || 'Dispatch failed'));
+    }
+    return (data.result || data);
+}
+exports.salesCommand = new commander_1.Command('sales')
+    .description('Sales pipeline, forecasting, and growth intelligence');
+// ── pipeline ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('pipeline')
+    .description('Full pipeline view: stages, values, velocity')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading pipeline...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.get('/api/v1/crm/pipeline/summary');
+        spinner.stop();
+        const data = res.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Sales Pipeline'));
+        const stages = (data.stages || []);
+        if (stages.length) {
+            console.log(ui_1.ui.table(['Stage', 'Deals', 'Value'], stages.map((s) => [
+                String(s.stage || s.name || '—'),
+                String(s.count ?? 0),
+                dollarsDirect(s.value ?? 0),
+            ])));
+        }
+        console.log('');
+        console.log(ui_1.ui.label('Total deals', String(data.total_deals ?? '—')));
+        console.log(ui_1.ui.label('Pipeline value', dollarsDirect(data.total_pipeline_value ?? 0)));
+        console.log(ui_1.ui.label('Won value', dollarsDirect(data.won_value ?? 0)));
+        console.log(ui_1.ui.label('Conversion rate', pct(data.conversion_rate)));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load pipeline', e);
+    }
+});
+// ── prospects ───────────────────────────────────────────────────────
+exports.salesCommand
+    .command('prospects')
+    .description('Unqualified leads ready for outreach, ranked by score')
+    .option('-l, --limit <n>', 'Max results', '25')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading prospects...', stream: process.stderr }).start();
+    try {
+        const [statsRes, highValueRes] = await Promise.all([
+            api_client_1.apiClient.get('/api/v1/crm/leads/stats'),
+            api_client_1.apiClient.get('/api/v1/crm/lead-scoring/high-value-contacts', {
+                params: { limit: parseInt(opts.limit, 10) },
+            }),
+        ]);
+        spinner.stop();
+        const stats = statsRes.data;
+        const contacts = (highValueRes.data.high_value_contacts || []);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify({ stats, prospects: contacts }, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Prospects'));
+        console.log(ui_1.ui.label('Total leads', String(stats.total_leads ?? '—')));
+        console.log(ui_1.ui.label('Conversion rate', pct(stats.conversion_rate)));
+        console.log(ui_1.ui.label('Avg score', String(stats.average_score ?? '—')));
+        console.log('');
+        if (contacts.length) {
+            console.log(ui_1.ui.table(['ID', 'Name', 'Score', 'Grade', 'Source', 'Spent'], contacts.map((c) => [
+                String(c.id),
+                [c.first_name, c.last_name].filter(Boolean).join(' ') || chalk_1.default.dim('—'),
+                String(c.lead_score ?? '—'),
+                String(c.lead_grade ?? '—'),
+                String(c.source || chalk_1.default.dim('—')),
+                dollarsDirect(c.total_spent ?? 0),
+            ])));
+        }
+        else {
+            console.log(chalk_1.default.yellow('  No high-value prospects found.'));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load prospects', e);
+    }
+});
+// ── sources ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('sources')
+    .description('Lead funnel performance — which sources convert best')
+    .option('--days <n>', 'Lookback period in days', '30')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading lead sources...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.get('/api/v1/crm/leads/pipeline-sources', {
+            params: { days: parseInt(opts.days, 10) },
+        });
+        spinner.stop();
+        const data = res.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header(`Lead Sources (last ${opts.days} days)`));
+        const sources = (data.sources || []);
+        if (sources.length) {
+            console.log(ui_1.ui.table(['Source', 'Leads', 'Deals', 'Won', 'Conv %', 'Avg Score'], sources.map((s) => [
+                String(s.source || '—'),
+                String(s.leads ?? 0),
+                String(s.deals ?? 0),
+                String(s.won ?? 0),
+                pct(s.conversion_rate),
+                String(s.avg_score ?? '—'),
+            ])));
+        }
+        else {
+            console.log(chalk_1.default.yellow('  No source data available for this period.'));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load lead sources', e);
+    }
+});
+// ── forecast ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('forecast')
+    .description('Revenue forecast by stage and probability')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading forecast...', stream: process.stderr }).start();
+    try {
+        const [revenueRes, pipelineRes] = await Promise.all([
+            api_client_1.apiClient.get('/api/v1/crm/dashboard/revenue/summary'),
+            api_client_1.apiClient.get('/api/v1/crm/pipeline/summary'),
+        ]);
+        spinner.stop();
+        const revenue = revenueRes.data;
+        const pipeline = pipelineRes.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify({ revenue, pipeline }, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Revenue Forecast'));
+        console.log(ui_1.ui.label('Total revenue', dollarsDirect(revenue.total_revenue ?? 0)));
+        console.log(ui_1.ui.label('Monthly revenue', dollarsDirect(revenue.monthly_revenue ?? 0)));
+        console.log(ui_1.ui.label('YTD revenue', dollarsDirect(revenue.ytd_revenue ?? 0)));
+        console.log(ui_1.ui.label('Avg deal value', dollarsDirect(revenue.average_deal_value ?? 0)));
+        console.log('');
+        const stages = (pipeline.stages || []);
+        if (stages.length) {
+            console.log(ui_1.ui.divider('Pipeline by Stage'));
+            console.log(ui_1.ui.table(['Stage', 'Deals', 'Value', 'Weighted'], stages.map((s) => {
+                const value = Number(s.value ?? s.total_value ?? 0);
+                const prob = Number(s.probability ?? s.conversion_rate ?? 0) / 100;
+                return [
+                    String(s.name || s.stage || '—'),
+                    String(s.count ?? s.deals ?? 0),
+                    dollarsDirect(value),
+                    dollarsDirect(value * (Number.isFinite(prob) ? prob : 0)),
+                ];
+            })));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load forecast', e);
+    }
+});
+// ── report ──────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('report [period]')
+    .description('Sales performance report (default: this month)')
+    .option('--json', 'Output as JSON')
+    .action(async (period, opts) => {
+    requireAuth();
+    const p = period || 'mtd';
+    const spinner = (0, ora_1.default)({ text: `Loading ${p} report...`, stream: process.stderr }).start();
+    try {
+        const [summaryRes, leadsRes, customersRes] = await Promise.all([
+            api_client_1.apiClient.get('/api/v1/crm/dashboard/summary'),
+            api_client_1.apiClient.get('/api/v1/crm/dashboard/leads/overview', { params: { period: p } }),
+            api_client_1.apiClient.get('/api/v1/crm/dashboard/customers/summary'),
+        ]);
+        spinner.stop();
+        const summary = summaryRes.data;
+        const leads = leadsRes.data;
+        const customers = customersRes.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify({ period: p, summary, leads, customers }, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header(`Sales Report — ${p.toUpperCase()}`));
+        console.log(ui_1.ui.divider('Revenue'));
+        console.log(ui_1.ui.label('Total revenue', dollarsDirect(summary.revenue ?? summary.total_revenue ?? 0)));
+        console.log(ui_1.ui.label('Total deals', String(summary.deals ?? summary.total_deals ?? 0)));
+        console.log('');
+        console.log(ui_1.ui.divider('Leads'));
+        console.log(ui_1.ui.label('New leads (period)', String(leads.mtd_leads ?? leads.new_leads ?? 0)));
+        console.log(ui_1.ui.label('Conversion rate', pct(leads.conversion_rate)));
+        console.log(ui_1.ui.label('Avg deal value', dollarsDirect(leads.avg_deal_value ?? 0)));
+        console.log('');
+        console.log(ui_1.ui.divider('Customers'));
+        console.log(ui_1.ui.label('Total customers', String(customers.total_customers ?? 0)));
+        console.log(ui_1.ui.label('New this month', String(customers.new_customers_mtd ?? 0)));
+        console.log(ui_1.ui.label('Repeat rate', pct(customers.repeat_rate)));
+        console.log(ui_1.ui.label('Churn rate', pct(customers.churn_rate)));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load sales report', e);
+    }
+});
+// ── velocity ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('velocity')
+    .description('Deal velocity metrics — how fast deals move through stages')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading velocity...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.get('/api/v1/crm/sales-funnel');
+        spinner.stop();
+        const data = res.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Deal Velocity'));
+        const stages = (data.stages || []);
+        if (stages.length) {
+            console.log(ui_1.ui.table(['Stage', 'Count', 'Conv from Prev'], stages.map((s) => [
+                String(s.stage || '—'),
+                String(s.count ?? 0),
+                s.conversion_from_previous != null ? pct(s.conversion_from_previous) : chalk_1.default.dim('—'),
+            ])));
+        }
+        console.log('');
+        if (data.lost_count != null) {
+            console.log(ui_1.ui.label('Lost deals', String(data.lost_count)));
+        }
+        if (data.total_deals != null) {
+            console.log(ui_1.ui.label('Total deals (excl. lost)', String(data.total_deals)));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load velocity', e);
+    }
+});
+// ── followup ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('followup')
+    .alias('follow-up')
+    .description('Overdue follow-ups ranked by priority')
+    .option('-l, --limit <n>', 'Max results', '25')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading follow-ups...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.get('/api/v1/crm/tasks', {
+            params: {
+                status: 'pending',
+                limit: parseInt(opts.limit, 10),
+                offset: 0,
+            },
+        });
+        spinner.stop();
+        const data = res.data;
+        const tasks = (data.tasks || data.items || []);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Overdue Follow-ups'));
+        if (tasks.length) {
+            const now = Date.now();
+            const overdue = tasks.filter((t) => {
+                const due = t.due_date ? new Date(String(t.due_date)).getTime() : Infinity;
+                return due <= now;
+            });
+            const upcoming = tasks.filter((t) => {
+                const due = t.due_date ? new Date(String(t.due_date)).getTime() : Infinity;
+                return due > now;
+            });
+            if (overdue.length) {
+                console.log(chalk_1.default.red(`  ${overdue.length} overdue`));
+                console.log(ui_1.ui.table(['ID', 'Title', 'Due', 'Priority', 'Contact'], overdue.map((t) => [
+                    String(t.id),
+                    String(t.title || '—'),
+                    t.due_date ? String(t.due_date).split('T')[0] : chalk_1.default.dim('—'),
+                    String(t.priority || chalk_1.default.dim('normal')),
+                    String(t.contact_name || t.contact_id || chalk_1.default.dim('—')),
+                ])));
+                console.log('');
+            }
+            if (upcoming.length) {
+                console.log(chalk_1.default.green(`  ${upcoming.length} upcoming`));
+                console.log(ui_1.ui.table(['ID', 'Title', 'Due', 'Priority', 'Contact'], upcoming.map((t) => [
+                    String(t.id),
+                    String(t.title || '—'),
+                    t.due_date ? String(t.due_date).split('T')[0] : chalk_1.default.dim('—'),
+                    String(t.priority || chalk_1.default.dim('normal')),
+                    String(t.contact_name || t.contact_id || chalk_1.default.dim('—')),
+                ])));
+            }
+        }
+        else {
+            console.log(chalk_1.default.green('  No pending follow-ups. Pipeline is clean.'));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load follow-ups', e);
+    }
+});
+// ── win-rate ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('win-rate')
+    .description('Win/loss analysis by source and stage')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Loading win rate...', stream: process.stderr }).start();
+    try {
+        const [funnelRes, tierRes] = await Promise.all([
+            api_client_1.apiClient.get('/api/v1/crm/sales-funnel'),
+            api_client_1.apiClient.get('/api/v1/crm/lead-scoring/tier-breakdown'),
+        ]);
+        spinner.stop();
+        const funnel = funnelRes.data;
+        const tiers = tierRes.data;
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify({ funnel, tiers }, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.header('Win Rate Analysis'));
+        const stages = (funnel.stages || []);
+        if (stages.length) {
+            console.log(ui_1.ui.divider('Funnel'));
+            console.log(ui_1.ui.table(['Stage', 'Count', 'Conv from Prev'], stages.map((s) => [
+                String(s.stage || '—'),
+                String(s.count ?? 0),
+                s.conversion_from_previous != null ? pct(s.conversion_from_previous) : chalk_1.default.dim('—'),
+            ])));
+            console.log('');
+        }
+        console.log(ui_1.ui.divider('Lead Score Distribution'));
+        console.log(ui_1.ui.label('A-grade', String(tiers.A ?? tiers.a ?? 0)));
+        console.log(ui_1.ui.label('B-grade', String(tiers.B ?? tiers.b ?? 0)));
+        console.log(ui_1.ui.label('C-grade', String(tiers.C ?? tiers.c ?? 0)));
+        console.log(ui_1.ui.label('D-grade', String(tiers.D ?? tiers.d ?? 0)));
+        console.log(ui_1.ui.label('F-grade', String(tiers.F ?? tiers.f ?? 0)));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to load win rate', e);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════
+// Phase 2 — AI-powered suggest verbs
+// ═══════════════════════════════════════════════════════════════════
+// ── score ───────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('score <lead_id>')
+    .description('AI-score a lead with industry-specific reasoning')
+    .option('--json', 'Output as JSON')
+    .action(async (leadId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Scoring lead...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.score',
+            args: { lead_id: parseInt(leadId, 10) },
+        });
+        spinner.stop();
+        const data = unwrapDispatch(res.data);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const suggestions = (data.suggestions || []);
+        const s = suggestions[0] || {};
+        const lead = (s.lead || {});
+        console.log(ui_1.ui.header(`Lead Score — ${lead.name || `#${leadId}`}`));
+        console.log(ui_1.ui.label('Score', `${s.ai_score ?? '—'}/100`));
+        console.log(ui_1.ui.label('Grade', String(s.ai_grade ?? '—')));
+        console.log(ui_1.ui.label('Confidence', `${data.confidence_band || '—'} (${((Number(data.confidence) || 0) * 100).toFixed(0)}%)`));
+        console.log('');
+        if (s.reasoning)
+            console.log(`  ${chalk_1.default.dim(String(s.reasoning))}`);
+        console.log('');
+        const signals = (s.signals || []);
+        if (signals.length) {
+            console.log(ui_1.ui.divider('Signals'));
+            for (const sig of signals)
+                console.log(`  ${chalk_1.default.green('+')} ${sig}`);
+            console.log('');
+        }
+        const risks = (s.risks || []);
+        if (risks.length) {
+            console.log(ui_1.ui.divider('Risks'));
+            for (const r of risks)
+                console.log(`  ${chalk_1.default.red('−')} ${r}`);
+            console.log('');
+        }
+        if (s.recommended_action) {
+            console.log(ui_1.ui.divider('Next Action'));
+            console.log(`  ${chalk_1.default.cyan('→')} ${s.recommended_action}`);
+            console.log('');
+        }
+    }
+    catch (e) {
+        fail(spinner, 'Failed to score lead', e);
+    }
+});
+// ── suggest ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('suggest <deal_id>')
+    .description('AI next-best-action for a deal')
+    .option('--json', 'Output as JSON')
+    .action(async (dealId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Analyzing deal...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.suggest',
+            args: { deal_id: parseInt(dealId, 10) },
+        });
+        spinner.stop();
+        const data = unwrapDispatch(res.data);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const evidence = (data.evidence || {});
+        const deal = (evidence.deal || {});
+        console.log(ui_1.ui.header(`Deal Suggestions — ${deal.title || `#${dealId}`}`));
+        if (evidence.deal_health)
+            console.log(ui_1.ui.label('Health', String(evidence.deal_health)));
+        if (evidence.insight)
+            console.log(ui_1.ui.label('Insight', String(evidence.insight)));
+        console.log(ui_1.ui.label('Confidence', `${data.confidence_band || '—'} (${((Number(data.confidence) || 0) * 100).toFixed(0)}%)`));
+        console.log('');
+        const suggestions = (data.suggestions || []);
+        if (suggestions.length) {
+            for (let i = 0; i < suggestions.length; i++) {
+                const s = suggestions[i];
+                const pri = String(s.priority || 'medium');
+                const badge = pri === 'high' ? chalk_1.default.red('[HIGH]') : pri === 'low' ? chalk_1.default.dim('[LOW]') : chalk_1.default.yellow('[MED]');
+                console.log(`  ${i + 1}. ${badge} ${s.action}`);
+                if (s.reasoning)
+                    console.log(`     ${chalk_1.default.dim(String(s.reasoning))}`);
+            }
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to get suggestions', e);
+    }
+});
+// ── outreach ────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('outreach <lead_id>')
+    .description('Generate personalized outreach copy')
+    .option('--channel <channel>', 'Channel: email, sms, call_script', 'email')
+    .option('--json', 'Output as JSON')
+    .action(async (leadId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: `Generating ${opts.channel} outreach...`, stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.outreach',
+            args: { lead_id: parseInt(leadId, 10), channel: opts.channel },
+        });
+        spinner.stop();
+        const data = unwrapDispatch(res.data);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const suggestions = (data.suggestions || []);
+        const s = suggestions[0] || {};
+        const contact = (s.contact || {});
+        console.log(ui_1.ui.header(`Outreach — ${contact.name || `Lead #${leadId}`} (${s.channel || opts.channel})`));
+        if (s.error) {
+            console.log(chalk_1.default.yellow(`  ${s.error}`));
+            console.log('');
+            return;
+        }
+        if (s.subject) {
+            console.log(ui_1.ui.label('Subject', String(s.subject)));
+            console.log('');
+        }
+        if (s.body) {
+            console.log(String(s.body));
+            console.log('');
+        }
+        if (s.cta) {
+            console.log(ui_1.ui.divider('CTA'));
+            console.log(`  ${chalk_1.default.cyan(String(s.cta))}`);
+            console.log('');
+        }
+        if (s.personalization_notes) {
+            console.log(chalk_1.default.dim(`  Personalization: ${s.personalization_notes}`));
+            console.log('');
+        }
+    }
+    catch (e) {
+        fail(spinner, 'Failed to generate outreach', e);
+    }
+});
+// ── opportunities ───────────────────────────────────────────────────
+exports.salesCommand
+    .command('opportunities')
+    .description('AI-identified growth opportunities')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Analyzing growth opportunities...', stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.opportunities',
+            args: {},
+        });
+        spinner.stop();
+        const data = unwrapDispatch(res.data);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const evidence = (data.evidence || {});
+        console.log(ui_1.ui.header('Growth Opportunities'));
+        if (evidence.health_score != null)
+            console.log(ui_1.ui.label('Health score', `${evidence.health_score}/100`));
+        if (evidence.health_summary)
+            console.log(ui_1.ui.label('Summary', String(evidence.health_summary)));
+        console.log(ui_1.ui.label('Confidence', `${data.confidence_band || '—'} (${((Number(data.confidence) || 0) * 100).toFixed(0)}%)`));
+        console.log('');
+        const opps = (data.suggestions || []);
+        for (let i = 0; i < opps.length; i++) {
+            const o = opps[i];
+            const impact = String(o.impact || 'medium');
+            const effort = String(o.effort || 'medium');
+            const badge = impact === 'high' ? chalk_1.default.green('HIGH IMPACT') : impact === 'low' ? chalk_1.default.dim('low impact') : chalk_1.default.yellow('med impact');
+            console.log(`  ${i + 1}. ${chalk_1.default.bold(String(o.title))} ${chalk_1.default.dim(`[${badge}, ${effort} effort]`)}`);
+            if (o.description)
+                console.log(`     ${chalk_1.default.dim(String(o.description))}`);
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to analyze opportunities', e);
+    }
+});
+// ── compare ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('compare [period]')
+    .description('Period-over-period comparison with AI analysis')
+    .option('--json', 'Output as JSON')
+    .action(async (period, opts) => {
+    requireAuth();
+    const p = period || 'mtd';
+    const spinner = (0, ora_1.default)({ text: `Comparing ${p.toUpperCase()} periods...`, stream: process.stderr }).start();
+    try {
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.compare',
+            args: { period: p },
+        });
+        spinner.stop();
+        const data = unwrapDispatch(res.data);
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const suggestions = (data.suggestions || []);
+        const s = suggestions[0] || {};
+        const current = (s.current || {});
+        const previous = (s.previous || {});
+        const deltas = (s.deltas || {});
+        const analysis = (s.analysis || {});
+        console.log(ui_1.ui.header(`Sales Comparison — ${p.toUpperCase()}`));
+        console.log(ui_1.ui.table(['Metric', 'Current', 'Previous', 'Change'], [
+            ['Revenue', dollarsDirect(current.revenue ?? 0), dollarsDirect(previous.revenue ?? 0), deltas.revenue != null ? `${Number(deltas.revenue) > 0 ? '+' : ''}${deltas.revenue}%` : '—'],
+            ['Deals created', String(current.deals_created ?? 0), String(previous.deals_created ?? 0), deltas.deals_created != null ? `${Number(deltas.deals_created) > 0 ? '+' : ''}${deltas.deals_created}%` : '—'],
+            ['Deals won', String(current.deals_won ?? 0), String(previous.deals_won ?? 0), deltas.deals_won != null ? `${Number(deltas.deals_won) > 0 ? '+' : ''}${deltas.deals_won}%` : '—'],
+            ['Win rate', pct(current.win_rate), pct(previous.win_rate), deltas.win_rate != null ? `${Number(deltas.win_rate) > 0 ? '+' : ''}${deltas.win_rate}%` : '—'],
+            ['New leads', String(current.new_leads ?? 0), String(previous.new_leads ?? 0), deltas.new_leads != null ? `${Number(deltas.new_leads) > 0 ? '+' : ''}${deltas.new_leads}%` : '—'],
+            ['Avg deal', dollarsDirect(current.avg_deal_value ?? 0), dollarsDirect(previous.avg_deal_value ?? 0), deltas.avg_deal_value != null ? `${Number(deltas.avg_deal_value) > 0 ? '+' : ''}${deltas.avg_deal_value}%` : '—'],
+        ]));
+        console.log('');
+        if (analysis.trend)
+            console.log(ui_1.ui.label('Trend', String(analysis.trend)));
+        if (analysis.key_change)
+            console.log(ui_1.ui.label('Key change', String(analysis.key_change)));
+        if (analysis.summary) {
+            console.log('');
+            console.log(`  ${chalk_1.default.dim(String(analysis.summary))}`);
+        }
+        if (analysis.recommendation) {
+            console.log('');
+            console.log(`  ${chalk_1.default.cyan('→')} ${analysis.recommendation}`);
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to compare periods', e);
+    }
+});
+// ═══════════════════════════════════════════════════════════════════
+// Phase 3 — Write verbs (consent-gated)
+// ═══════════════════════════════════════════════════════════════════
+// ── qualify ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('qualify <lead_id>')
+    .description('Promote a lead to a qualified deal')
+    .option('--title <title>', 'Deal title (auto-generated if omitted)')
+    .option('--value <amount>', 'Deal value in dollars')
+    .option('--stage <stage>', 'Initial stage', 'Qualified')
+    .option('--notes <notes>', 'Notes for the deal')
+    .option('--yes', 'Confirm (required in agent mode)')
+    .option('--json', 'Output as JSON')
+    .action(async (leadId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Qualifying lead...', stream: process.stderr }).start();
+    try {
+        const args = { lead_id: parseInt(leadId, 10), stage: opts.stage };
+        if (opts.title)
+            args.title = opts.title;
+        if (opts.value)
+            args.value = parseFloat(opts.value);
+        if (opts.notes)
+            args.notes = opts.notes;
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.qualify', args, confirm: true,
+        });
+        const data = unwrapDispatch(res.data);
+        spinner.succeed(chalk_1.default.green('Lead qualified'));
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.successBox('Deal Created', [
+            `Deal ID: ${data.deal_id}`,
+            `Title: ${data.title}`,
+            `Stage: ${data.stage}`,
+            `Contact: ${data.contact_name || `#${leadId}`}`,
+            data.value ? `Value: $${data.value}` : '',
+        ].filter(Boolean)));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to qualify lead', e);
+    }
+});
+// ── advance ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('advance <deal_id>')
+    .description('Move a deal to the next pipeline stage')
+    .option('--stage <stage>', 'Target stage (auto-advances if omitted)')
+    .option('--notes <notes>', 'Notes')
+    .option('--yes', 'Confirm (required in agent mode)')
+    .option('--json', 'Output as JSON')
+    .action(async (dealId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Advancing deal...', stream: process.stderr }).start();
+    try {
+        const args = { deal_id: parseInt(dealId, 10) };
+        if (opts.stage)
+            args.stage = opts.stage;
+        if (opts.notes)
+            args.notes = opts.notes;
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.advance', args, confirm: true,
+        });
+        const data = unwrapDispatch(res.data);
+        spinner.succeed(chalk_1.default.green('Deal advanced'));
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.successBox('Deal Advanced', [
+            `Deal: ${data.title || `#${dealId}`}`,
+            `${data.old_stage} → ${chalk_1.default.green(String(data.new_stage))}`,
+        ]));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to advance deal', e);
+    }
+});
+// ── close ───────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('close <deal_id>')
+    .description('Close a deal as won or lost')
+    .option('--outcome <outcome>', 'won or lost', 'won')
+    .option('--reason <reason>', 'Close reason')
+    .option('--yes', 'Confirm (required in agent mode)')
+    .option('--json', 'Output as JSON')
+    .action(async (dealId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Closing deal...', stream: process.stderr }).start();
+    try {
+        const args = { deal_id: parseInt(dealId, 10), outcome: opts.outcome };
+        if (opts.reason)
+            args.close_reason = opts.reason;
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.close', args, confirm: true,
+        });
+        const data = unwrapDispatch(res.data);
+        spinner.succeed(chalk_1.default.green(`Deal closed — ${data.outcome}`));
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        const color = String(data.outcome).toLowerCase() === 'won' ? chalk_1.default.green : chalk_1.default.red;
+        console.log(ui_1.ui.successBox('Deal Closed', [
+            `Deal: ${data.title || `#${dealId}`}`,
+            `Outcome: ${color(String(data.outcome))}`,
+            data.amount ? `Value: $${data.amount}` : '',
+        ].filter(Boolean)));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to close deal', e);
+    }
+});
+// ── nurture ─────────────────────────────────────────────────────────
+exports.salesCommand
+    .command('nurture <lead_id>')
+    .description('Send a nurture step to a contact')
+    .option('--channel <channel>', 'email, sms, call_script, or voice', 'email')
+    .option('--message <message>', 'Custom message')
+    .option('--yes', 'Confirm (required in agent mode)')
+    .option('--json', 'Output as JSON')
+    .action(async (leadId, opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: `Sending ${opts.channel} nurture...`, stream: process.stderr }).start();
+    try {
+        const args = { lead_id: parseInt(leadId, 10), channel: opts.channel };
+        if (opts.message)
+            args.message = opts.message;
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.nurture', args, confirm: true,
+        });
+        const data = unwrapDispatch(res.data);
+        spinner.succeed(chalk_1.default.green(`Nurture sent via ${data.channel}`));
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.successBox('Nurture Sent', [
+            `Contact: ${data.contact_name || `#${leadId}`}`,
+            `Channel: ${data.channel}`,
+            `Follow-up task: #${data.followup_task_id} (due ${data.followup_due ? String(data.followup_due).split('T')[0] : '3 days'})`,
+        ]));
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to nurture contact', e);
+    }
+});
+// ── sequence ────────────────────────────────────────────────────────
+const sequenceCommand = new commander_1.Command('sequence')
+    .description('Multi-step outreach sequences');
+sequenceCommand
+    .command('create')
+    .description('Create a multi-step outreach sequence')
+    .requiredOption('--name <name>', 'Sequence name')
+    .option('--leads <ids>', 'Comma-separated lead IDs')
+    .option('--yes', 'Confirm (required in agent mode)')
+    .option('--json', 'Output as JSON')
+    .action(async (opts) => {
+    requireAuth();
+    const spinner = (0, ora_1.default)({ text: 'Creating sequence...', stream: process.stderr }).start();
+    try {
+        const args = { name: opts.name };
+        if (opts.leads)
+            args.lead_ids = opts.leads.split(',').map((s) => parseInt(s.trim(), 10));
+        const res = await api_client_1.apiClient.post('/api/v1/ada/cli-dispatch', {
+            verb: 'sales.sequence_create', args, confirm: true,
+        });
+        const data = unwrapDispatch(res.data);
+        spinner.succeed(chalk_1.default.green('Sequence created'));
+        if ((0, json_output_1.isJsonOutput)(opts)) {
+            console.log(JSON.stringify(data, null, 2));
+            return;
+        }
+        console.log(ui_1.ui.successBox('Sequence Created', [
+            `Name: ${data.sequence_name}`,
+            `Contacts enrolled: ${data.contacts_enrolled}`,
+            `Steps: ${data.steps}`,
+            `Tasks scheduled: ${data.tasks_created}`,
+        ]));
+        if (data.invalid_lead_ids?.length) {
+            console.log(chalk_1.default.yellow(`  Skipped invalid IDs: ${data.invalid_lead_ids.join(', ')}`));
+        }
+        console.log('');
+    }
+    catch (e) {
+        fail(spinner, 'Failed to create sequence', e);
+    }
+});
+exports.salesCommand.addCommand(sequenceCommand);
+// ── Help ────────────────────────────────────────────────────────────
+exports.salesCommand.addHelpText('after', `
+Examples:
+  $ solid sales pipeline              Full pipeline by stage
+  $ solid sales prospects             High-value leads ranked by score
+  $ solid sales sources --days 60     Lead source performance (60-day window)
+  $ solid sales forecast              Revenue forecast with weighted pipeline
+  $ solid sales report mtd            Month-to-date performance report
+  $ solid sales velocity              Deal velocity and cycle time
+  $ solid sales followup              Overdue follow-ups
+  $ solid sales win-rate              Win/loss funnel analysis
+  $ solid sales score 42              AI-score a lead with industry reasoning
+  $ solid sales suggest 17            Next-best-action for a deal
+  $ solid sales outreach 42 --sms     Generate personalized SMS outreach
+  $ solid sales opportunities         AI growth opportunities
+  $ solid sales compare qtd           Quarter-over-quarter comparison
+  $ solid sales qualify 42            Promote lead → deal
+  $ solid sales advance 17            Move deal to next stage
+  $ solid sales close 17 --outcome won  Close a deal
+  $ solid sales nurture 42 --sms      Send SMS nurture step
+  $ solid sales sequence create --name "New Leads" --leads 42,43,44
+`);
+//# sourceMappingURL=sales.js.map