@velaro/cli 1.4.73 → 1.4.74

package/bin/velaro.js

@@ -46,6 +46,7 @@ import { reportBackfillCommand } from '../lib/commands/report-backfill.js';
 import { staffCommand } from '../lib/commands/staff.js';
 import { reportExplainCommand } from '../lib/commands/report-explain.js';
 import { conversationEfficiencyCommand } from '../lib/commands/conversation-efficiency.js';
+import { executiveInsightsCommand } from '../lib/commands/executive-insights.js';
 import { dbCommand } from '../lib/commands/db.js';
 import { focusCommand }       from '../lib/commands/focus.js';
 import { triageCommand }      from '../lib/commands/triage.js';
@@ -147,6 +148,7 @@ await yargs(hideBin(process.argv))
   .command(bookingCommand)
   .command(reportCommand)
   .command(conversationEfficiencyCommand)
+  .command(executiveInsightsCommand)
   .command(scheduleAdherenceCommand)
   .command(experienceImpactCommand)
   .command(reportSubscriptionCommand)

package/lib/commands/executive-insights.js

@@ -0,0 +1,91 @@
+import { writeFileSync } from 'node:fs';
+import { messagingGet, messagingPost } from '../api.js';
+import { runCommand } from '../run.js';
+
+// -- velaro executive-insights ---------------------------------------------------
+// CLI for the Friction Radar, the Executive Brief and the CSV data export. Endpoints live in
+// velaro-messaging at /api/executive-insights/*; the site always comes from the login, never from
+// CLI args. Gated on the Chat Intelligence entitlement (403 when not entitled).
+// Scheduling reuses report subscriptions: `velaro executive-insights subscribe`.
+
+function rangeArgs(argv) {
+  const days = Math.min(Math.max(Number(argv.days) || 7, 1), 92);
+  const to = argv.to ? new Date(argv.to) : new Date();
+  const from = argv.from ? new Date(argv.from) : new Date(to.getTime() - days * 86400000);
+  return new URLSearchParams({ from: from.toISOString(), to: to.toISOString() });
+}
+
+const rangeOptions = (y) => y
+  .option('days', { type: 'number', default: 7, describe: 'Look-back window in days (max 92)' })
+  .option('from', { type: 'string', describe: 'ISO start (overrides --days)' })
+  .option('to', { type: 'string', describe: 'ISO end (default now)' });
+
+const frictionCommand = {
+  command: 'friction-radar',
+  describe: 'Topics ranked by estimated agent cost with week-over-week growth and example chats',
+  builder: (y) => rangeOptions(y).option('limit', { type: 'number', default: 20 }),
+  handler: runCommand(async (argv) => {
+    const qs = rangeArgs(argv);
+    qs.set('limit', String(argv.limit ?? 20));
+    const r = await messagingGet(`/executive-insights/friction-radar?${qs}`);
+    console.log(`Friction radar: ${r.conversationsScanned} conversations scanned${r.truncated ? ' (truncated)' : ''}`);
+    for (const t of r.topics ?? []) {
+      const growth = t.isNew ? 'new' : t.growthPct == null ? 'n/a' : `${t.growthPct}%`;
+      console.log(`  #${t.costRank} ${t.topic}: ${t.volume} chats (volume rank ${t.volumeRank}, ${growth}), ${t.escalations} escalated, ${t.abandoned} abandoned, ~${Math.round(t.estimatedCostMinutes)} agent min, examples ${t.exampleConversationIds.join(', ') || '-'}`);
+    }
+  }),
+};
+
+const briefCommand = {
+  command: 'brief',
+  describe: 'Executive brief: volume, sentiment, QA, Experience Impact, rising keywords, top friction',
+  builder: rangeOptions,
+  handler: runCommand(async (argv) => {
+    const r = await messagingGet(`/executive-insights/brief?${rangeArgs(argv)}`);
+    console.log(JSON.stringify(r.brief, null, 2));
+  }),
+};
+
+const exportCommand = {
+  command: 'export',
+  describe: 'CSV of conversations with sentiment, QA score, tag, escalations, handle time and keywords',
+  builder: (y) => rangeOptions(y).option('out', { type: 'string', describe: 'Write the CSV to this file (default: stdout)' }),
+  handler: runCommand(async (argv) => {
+    const r = await messagingGet(`/executive-insights/export?${rangeArgs(argv)}`);
+    if (argv.out) {
+      writeFileSync(argv.out, r.csv, 'utf8');
+      console.log(`Wrote ${r.rows} rows to ${argv.out}${r.truncated ? ' (truncated at the row cap)' : ''}`);
+    } else {
+      process.stdout.write(r.csv);
+    }
+  }),
+};
+
+const subscribeCommand = {
+  command: 'subscribe <type>',
+  describe: 'Email yourself the executive-brief (Monday 7 AM site time by default) or data-export on a schedule',
+  builder: (y) => y
+    .positional('type', { choices: ['executive-brief', 'data-export'] })
+    .option('frequency', { type: 'string', default: 'weekly', choices: ['daily', 'biweekly', 'weekly', 'monthly'] })
+    .option('hour', { type: 'number', default: 7, describe: 'Site-local delivery hour 0-23' }),
+  handler: runCommand(async (argv) => {
+    await messagingPost('/report-subscriptions', {
+      reportType: argv.type,
+      frequency: argv.frequency,
+      deliveryHour: argv.hour,
+    });
+    console.log(`Subscribed to ${argv.type} (${argv.frequency}, ${argv.hour}:00 site time).`);
+  }),
+};
+
+export const executiveInsightsCommand = {
+  command: 'executive-insights',
+  describe: 'Friction radar, executive brief and data export (Chat Intelligence)',
+  builder: (y) => y
+    .command(frictionCommand)
+    .command(briefCommand)
+    .command(exportCommand)
+    .command(subscribeCommand)
+    .demandCommand(1, 'Specify a subcommand. Run "velaro executive-insights --help" for options.'),
+  handler: () => {},
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/cli",
-  "version": "1.4.73",
+  "version": "1.4.74",
   "description": "Velaro Workspace v20 — command-line interface for managing bots, knowledge base ingestion, MCP API keys, search indexes, and ops health.",
   "type": "module",
   "bin": {