@velaro/cli 1.4.69 → 1.4.70

package/bin/velaro.js

@@ -51,6 +51,7 @@ import { notionCommand }        from '../lib/commands/notion.js';
 import { callrailCommand }      from '../lib/commands/callrail.js';
 import { emailCampaignCommand } from '../lib/commands/email-campaign.js';
 import { outboundActivityCommand } from '../lib/commands/outbound-activity.js';
+import { klaviyoMigrationCommand } from '../lib/commands/klaviyo-migration.js';
 import { telephonyCommand }     from '../lib/commands/telephony.js';
 import { teamsPhoneCommand }    from '../lib/commands/teams-phone.js';
 import { teamsCommand }         from '../lib/commands/teams.js';
@@ -152,6 +153,7 @@ await yargs(hideBin(process.argv))
   .command(callrailCommand)
   .command(emailCampaignCommand)
   .command(outboundActivityCommand)
+  .command(klaviyoMigrationCommand)
   .command(telephonyCommand)
   .command(teamsPhoneCommand)
   .command(teamsCommand)

package/lib/commands/agent.js

@@ -1,4 +1,4 @@
-import { get, post }  from '../api.js';
+import { get, post, messagingPost, getCredentials }  from '../api.js';
 import { runCommand }  from '../run.js';
 
 const VALID_STATUSES = ['Available', 'Away', 'Offline'];
@@ -55,6 +55,48 @@ export const agentCommand = {
         console.log(`\n${rows.length} agent(s)`);
       }),
     })
+    .command({
+      command:  'create',
+      describe: 'Provision a new licensed agent/admin on an EXISTING site (Velaro staff only) -- ' +
+                'closes the gap where site-provision only creates brand-new sites and Users/List ' +
+                'requires an existing site admin, which a zero-agent site can never have',
+      builder:  (y) => y
+        .option('site-id', { type: 'number', demandOption: true, describe: 'Target site ID (must already exist)' })
+        .option('email',   { type: 'string', demandOption: true, describe: 'New agent email' })
+        .option('first-name', { type: 'string', describe: 'First name' })
+        .option('last-name',  { type: 'string', describe: 'Last name' })
+        .option('roles',     { type: 'array',  describe: 'Roles to grant, e.g. --roles Administrator (default: Administrator). "Velaro Admin"/"Velaro Support" are always stripped server-side.' })
+        .option('team-ids',  { type: 'array',  describe: 'Team IDs on the target site (default: the site\'s first team)' })
+        .option('max-chats', { type: 'number', describe: 'Concurrent chat capacity (default: site ceiling, usually 4)' }),
+      handler: runCommand(async (argv) => {
+        const creds = await getCredentials();
+        if (creds.siteId !== 1032) {
+          console.error('This command is only available to Velaro staff.');
+          process.exit(1);
+        }
+
+        const body = {
+          email:     argv.email,
+          firstName: argv['first-name'],
+          lastName:  argv['last-name'],
+          roles:     argv.roles,
+          teamIds:   argv['team-ids']?.map(Number),
+          maxChats:  argv['max-chats'] ?? 0,
+        };
+
+        console.log(`\nCreating agent ${argv.email} on site ${argv['site-id']}...`);
+        // Non-2xx (existing email, seat limit reached, site not found) throws via
+        // messagingRequest and is reported by runCommand's own catch -- no separate
+        // success/error branch needed here, unlike site-provision's payload-level flag.
+        const result = await messagingPost(`/SupportTools/sites/${argv['site-id']}/agents`, body);
+
+        console.log(`\x1b[32mOK: agent created on site ${argv['site-id']}\x1b[0m`);
+        console.log(`  Email: ${result.user?.email ?? argv.email}`);
+        console.log(`  Roles: ${(result.user?.roles ?? []).join(', ')}`);
+        if (result.temporaryPassword) console.log(`  Temp password: ${result.temporaryPassword}`);
+        console.log(`  ${result.message ?? ''}`);
+      }),
+    })
     .command({
       command:  'set-status',
       describe: 'Set an agent\'s availability status (admin only)',

package/lib/commands/ai-models.js

@@ -114,6 +114,29 @@ async function clearTierDefault(argv) {
   console.log(`\n${GREEN}OK${RESET} Cleared tier '${argv.tier}' role '${argv.role}'. Reverts to global default.\n`);
 }
 
+// -- per-site thinking + version pin -------------------------------------------
+
+async function setSiteThinking(argv) {
+  const data = await callResolver(argv, `site/${argv.site}/thinking`, {
+    method: 'POST',
+    body: { effort: argv.effort, ...(argv.role ? { role: argv.role } : {}) },
+  });
+  console.log(`
+${GREEN}OK${RESET} Site ${data.siteId}: ${data.key} = ${data.effort}`);
+  console.log(`${DIM}Thinking bills as output tokens; only active if the site holds EnableAiThinking.${RESET}
+`);
+}
+
+async function setSitePin(argv) {
+  const data = await callResolver(argv, `site/${argv.site}`, {
+    method: 'POST',
+    body: { role: argv.role, model: argv.model, pinVersion: argv.pin === true, updatedBy: 'velaro-cli' },
+  });
+  console.log(`
+${GREEN}OK${RESET} Site ${data.siteId} role '${data.role}' -> ${data.model} (pinVersion=${data.pinVersion})
+`);
+}
+
 // -- command export -------------------------------------------------------------
 
 export const aiModelsCommand = {
@@ -155,5 +178,26 @@ export const aiModelsCommand = {
         .option('env', { describe: 'staging or prod', type: 'string' }),
       handler: clearTierDefault,
     })
-    .demandCommand(1, 'Specify a subcommand: resolver, effective, set-tier, or clear-tier'),
+    .command({
+      command:  'set-thinking',
+      describe: 'Set the extended-thinking level for a site (off default; needs EnableAiThinking entitlement)',
+      builder:  y => y
+        .option('site',   { describe: 'Site ID', type: 'number', demandOption: true })
+        .option('effort', { describe: 'off, low, medium, or high', type: 'string', choices: ['off', 'low', 'medium', 'high'], demandOption: true })
+        .option('role',   { describe: 'Scope to one role (omit for site-wide)', type: 'string' })
+        .option('env',    { describe: 'staging or prod', type: 'string' }),
+      handler: setSiteThinking,
+    })
+    .command({
+      command:  'set-site-model',
+      describe: 'Set a site role override, optionally pinned to its exact version (--pin), e.g. velaro ai-models set-site-model --site 1032 --role chatbot --model claude-opus-5 --pin',
+      builder:  y => y
+        .option('site',  { describe: 'Site ID', type: 'number', demandOption: true })
+        .option('role',  { describe: 'e.g. chatbot, ivr, skill_synthesis', type: 'string', demandOption: true })
+        .option('model', { describe: 'Model alias/ID', type: 'string', demandOption: true })
+        .option('pin',   { describe: 'Keep this exact model, do not auto-upgrade', type: 'boolean', default: false })
+        .option('env',   { describe: 'staging or prod', type: 'string' }),
+      handler: setSitePin,
+    })
+    .demandCommand(1, 'Specify a subcommand: resolver, effective, set-tier, clear-tier, set-thinking, or set-site-model'),
 };

package/lib/commands/article.js

@@ -198,7 +198,7 @@ const pushCommand = {
 
 const deleteCommand = {
   command:  'delete <id>',
-  describe: 'Delete a KB article',
+  describe: 'Delete a KB article (restorable for 30 days)',
   builder:  (y) => y.positional('id', { type: 'number', describe: 'Article ID' }),
   handler: runCommand(async (argv) => {
     await adminRequest('DELETE', `/api/kb/articles?id=${argv.id}`);
@@ -206,6 +206,48 @@ const deleteCommand = {
   }),
 };
 
+// ── recycle bin (soft delete) ────────────────────────────────────────────────
+
+const deletedCommand = {
+  command:  'deleted',
+  describe: 'List recently deleted KB articles (restorable for 30 days)',
+  handler: runCommand(async () => {
+    const rows = await adminRequest('GET', '/api/kb/articles/deleted');
+    (rows || []).forEach(r => console.log(`#${r.id} ${r.name} (purges in ${r.daysUntilPurge} day(s))`));
+    if (!rows || !rows.length) console.log('Nothing in Recently deleted.');
+  }),
+};
+
+const restoreCommand = {
+  command:  'restore <id>',
+  describe: 'Restore a deleted KB article (re-indexes it)',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Article ID' }),
+  handler: runCommand(async (argv) => {
+    await adminRequest('POST', `/api/kb/articles/${argv.id}/restore`);
+    console.log(`Article ${argv.id} restored.`);
+  }),
+};
+
+const deletedTopicsCommand = {
+  command:  'deleted-topics',
+  describe: 'List recently deleted KB topics',
+  handler: runCommand(async () => {
+    const rows = await adminRequest('GET', '/api/kb/topics/deleted');
+    (rows || []).forEach(r => console.log(`#${r.id} ${r.name} (purges in ${r.daysUntilPurge} day(s))`));
+    if (!rows || !rows.length) console.log('Nothing in Recently deleted.');
+  }),
+};
+
+const restoreTopicCommand = {
+  command:  'restore-topic <id>',
+  describe: 'Restore a deleted KB topic',
+  builder:  (y) => y.positional('id', { type: 'number', describe: 'Topic ID' }),
+  handler: runCommand(async (argv) => {
+    await adminRequest('POST', `/api/kb/topics/${argv.id}/restore`);
+    console.log(`Topic ${argv.id} restored.`);
+  }),
+};
+
 // ── seed-views ────────────────────────────────────────────────────────────────
 
 const seedViewsCommand = {
@@ -461,6 +503,10 @@ export const articleCommand = {
       .command(pushCommand)
       .command(previewCommand)
       .command(deleteCommand)
+      .command(deletedCommand)
+      .command(restoreCommand)
+      .command(deletedTopicsCommand)
+      .command(restoreTopicCommand)
       .command(seedViewsCommand)
       .command(improveCommand)
       .command(screenshotCommand)

package/lib/commands/booking.js

@@ -1,12 +1,15 @@
 import { messagingGet, messagingPost, messagingPut, messagingDel } from '../api.js';
 import { runCommand } from '../run.js';
 
-// ── velaro booking ────────────────────────────────────────────────────────────
-// CLI surface for the generic booking engine (Phase 1b) -- see velaro-admin
-// memory project_2026_09_06_generic_booking_engine_schema_plan.md. Backend:
+// -- velaro booking --------------------------------------------------------------
+// CLI surface for the generic booking engine (Phase 1b config CRUD + Phase 1c
+// booking write path) -- see velaro-admin memory
+// project_2026_09_06_generic_booking_engine_schema_plan.md. Backend:
 // server/Velaro.Messaging/Controllers/{BookableResourcesController,
 // BookableServicesController,ResourceAvailabilityRulesController}.cs, routed
-// at /BookableResources, /BookableServices, /ResourceAvailabilityRules.
+// at /BookableResources, /BookableServices, /ResourceAvailabilityRules
+// (Phase 1b, config); server/Velaro.Messaging/Controllers/Bookings/BookingsController.cs,
+// routed at /Bookings (Phase 1c, staff-facing list/get/cancel of actual bookings).
 // Mirrors the booking_* MCP tools. SiteId always derives from the caller's
 // JWT server-side -- never accepted as a CLI argument.
 
@@ -17,9 +20,9 @@ function fmtTime(t) { return t == null ? '-' : String(t); }
 
 export const bookingCommand = {
   command:  'booking <subcommand>',
-  describe: 'Generic booking engine -- bookable resources, services, and availability rules',
+  describe: 'Generic booking engine -- bookable resources, services, availability rules, and bookings',
   builder:  yargs => yargs
-    // ── resource ────────────────────────────────────────────────────────────
+    // -- resource --------------------------------------------------------------
     .command({
       command:  'resource <action>',
       describe: 'Manage bookable resources (staff / room / equipment / virtual)',
@@ -93,7 +96,7 @@ export const bookingCommand = {
         })
         .demandCommand(1, 'Specify a resource action: list | get | create | update | delete'),
     })
-    // ── service ─────────────────────────────────────────────────────────────
+    // -- service -----------------------------------------------------------------
     .command({
       command:  'service <action>',
       describe: 'Manage bookable services (the "thing" a customer books)',
@@ -179,7 +182,7 @@ export const bookingCommand = {
         })
         .demandCommand(1, 'Specify a service action: list | get | create | update | delete'),
     })
-    // ── availability ────────────────────────────────────────────────────────
+    // -- availability --------------------------------------------------------------
     .command({
       command:  'availability <action>',
       describe: 'Manage weekly-recurring resource availability rules',
@@ -275,5 +278,55 @@ export const bookingCommand = {
         })
         .demandCommand(1, 'Specify an availability action: list | get | create | update | delete'),
     })
-    .demandCommand(1, 'Specify a subcommand: resource | service | availability'),
-};
+    // -- appointment (Phase 1c: real bookings, staff-facing) ------------------------
+    .command({
+      command:  'appointment <action>',
+      describe: 'View and cancel actual bookings made against the booking engine (staff-facing)',
+      builder:  y => y
+        .command({
+          command:  'list',
+          describe: 'List bookings for this site, optionally filtered by date range or service',
+          builder:  y2 => y2
+            .option('from',       { type: 'string', describe: 'Only bookings starting at or after this ISO 8601 timestamp' })
+            .option('to',         { type: 'string', describe: 'Only bookings starting at or before this ISO 8601 timestamp' })
+            .option('service-id', { type: 'number', describe: 'Only bookings for this bookable service id' }),
+          handler:  runCommand(async argv => {
+            const params = new URLSearchParams();
+            if (argv.from != null) params.set('fromUtc', argv.from);
+            if (argv.to != null) params.set('toUtc', argv.to);
+            if (argv.serviceId != null) params.set('bookableServiceId', String(argv.serviceId));
+            const qs = params.toString();
+            const bookings = await messagingGet(`/Bookings${qs ? `?${qs}` : ''}`);
+            if (!Array.isArray(bookings) || !bookings.length) {
+              console.log('\n  No bookings found.\n');
+              return;
+            }
+            console.log('\nBookings\n');
+            for (const b of bookings) {
+              console.log(`  id:${b.id}  service:${b.bookableServiceId}  resource:${b.resourceId ?? '-'}  ${fmtDate(b.startUtc)}-${fmtDate(b.endUtc)}  party:${b.partySize}  status:${b.status}  customer:${b.customerName} (${b.customerPhone})`);
+            }
+            console.log('');
+          }),
+        })
+        .command({
+          command:  'get <id>',
+          describe: 'Get a single booking by id',
+          builder:  y2 => y2.positional('id', { type: 'number', describe: 'Booking id' }),
+          handler:  runCommand(async argv => {
+            const booking = await messagingGet(`/Bookings/${argv.id}`);
+            console.log(JSON.stringify(booking, null, 2));
+          }),
+        })
+        .command({
+          command:  'cancel <id>',
+          describe: 'Cancel a booking (staff-initiated)',
+          builder:  y2 => y2.positional('id', { type: 'number', describe: 'Booking id' }),
+          handler:  runCommand(async argv => {
+            const result = await messagingPost(`/Bookings/${argv.id}/cancel`, {});
+            console.log(`\n✓ Cancelled booking id:${result.bookingId} (status: ${result.status})\n`);
+          }),
+        })
+        .demandCommand(1, 'Specify an appointment action: list | get | cancel'),
+    })
+    .demandCommand(1, 'Specify a subcommand: resource | service | availability | appointment'),
+};

package/lib/commands/contact-list.js

@@ -277,6 +277,52 @@ export const contactListCommand = {
   describe: 'Marketing contact lists: CRUD, members, export, resync, quota, segments, CRM import',
   builder:  (y) => y
     .command({ command: 'list', describe: 'List all contact lists for this site', handler: runCommand(listsHandler) })
+    .command({
+      command:  'deleted',
+      describe: 'List recently deleted contact lists (restorable for 30 days)',
+      handler: runCommand(async () => {
+        const rows = await request('GET', 'ContactLists/deleted');
+        (rows || []).forEach(r => console.log(`#${r.id} ${r.name} (purges in ${r.daysUntilPurge} day(s))`));
+        if (!rows || !rows.length) console.log('Nothing in Recently deleted.');
+      }),
+    })
+    .command({
+      command:  'restore <id>',
+      describe: 'Restore a deleted contact list',
+      builder:  (y2) => y2.positional('id', { type: 'number' }),
+      handler: runCommand(async (argv) => { await request('POST', `ContactLists/${argv.id}/restore`); console.log(`List #${argv.id} restored.`); }),
+    })
+    .command({
+      command:  'deleted-members <listId>',
+      describe: 'List members recently removed from a list',
+      builder:  (y2) => y2.positional('listId', { type: 'number' }),
+      handler: runCommand(async (argv) => {
+        const rows = await request('GET', `ContactLists/${argv.listId}/Members/deleted`);
+        (rows || []).forEach(r => console.log(`#${r.id} ${r.name} (purges in ${r.daysUntilPurge} day(s))`));
+        if (!rows || !rows.length) console.log('Nothing in Recently deleted.');
+      }),
+    })
+    .command({
+      command:  'restore-member <listId> <memberId>',
+      describe: 'Restore a member removed from a list',
+      builder:  (y2) => y2.positional('listId', { type: 'number' }).positional('memberId', { type: 'number' }),
+      handler: runCommand(async (argv) => { await request('POST', `ContactLists/${argv.listId}/Members/${argv.memberId}/restore`); console.log(`Member #${argv.memberId} restored.`); }),
+    })
+    .command({
+      command:  'deleted-segments',
+      describe: 'List recently deleted contact segments',
+      handler: runCommand(async () => {
+        const rows = await request('GET', 'ContactSegments/deleted');
+        (rows || []).forEach(r => console.log(`#${r.id} ${r.name} (purges in ${r.daysUntilPurge} day(s))`));
+        if (!rows || !rows.length) console.log('Nothing in Recently deleted.');
+      }),
+    })
+    .command({
+      command:  'restore-segment <id>',
+      describe: 'Restore a deleted contact segment',
+      builder:  (y2) => y2.positional('id', { type: 'number' }),
+      handler: runCommand(async (argv) => { await request('POST', `ContactSegments/${argv.id}/restore`); console.log(`Segment #${argv.id} restored.`); }),
+    })
     .command({
       command:  'create',
       describe: 'Create a new contact list',

package/lib/commands/klaviyo-migration.js

@@ -0,0 +1,84 @@
+/**
+ * velaro klaviyo-migration - Klaviyo -> Velaro importer + savings calculator
+ *
+ *   velaro klaviyo-migration preview                 Dry run: what would be imported (writes nothing)
+ *   velaro klaviyo-migration apply                   Import lists, segments, flows (idempotent)
+ *   velaro klaviyo-migration savings --profiles N --bill USD [--plan plan.professional]
+ *
+ * Uses the API key stored by the Klaviyo integration. Site scoping is server-side.
+ */
+
+import { request } from '../api.js';
+
+const BOLD = '\x1b[1m';
+const YEL = '\x1b[33m';
+const RED = '\x1b[31m';
+const DIM = '\x1b[2m';
+const RST = '\x1b[0m';
+
+function body(argv) {
+  const split = v => (v ? String(v).split(',').map(s => s.trim()).filter(Boolean) : undefined);
+  return {
+    listIds: split(argv.lists),
+    segmentIds: split(argv.segments),
+    flowIds: split(argv.flows),
+    includeFlows: argv['no-flows'] ? false : true,
+    maxProfilesPerGroup: argv.max,
+  };
+}
+
+function render(r) {
+  console.log(`\n${BOLD}${r.dryRun ? 'Klaviyo import preview (nothing written)' : 'Klaviyo import applied'}${RST}\n`);
+  for (const e of r.errors ?? []) console.log(`${RED}  ! ${e}${RST}`);
+  for (const i of r.items ?? []) {
+    const n = i.kind === 'flow' ? `${i.stepCount} steps` : `${i.profileCount ?? 0} contacts`;
+    console.log(`  ${i.kind.padEnd(8)} ${i.name}  ${DIM}${i.action}, ${n}, skipped not-subscribed ${i.skippedNotSubscribed}${i.truncated ? ', capped' : ''}${RST}`);
+    for (const w of i.warnings ?? []) console.log(`${YEL}           ${w}${RST}`);
+  }
+  if (!r.dryRun) {
+    console.log(`\n  Created: ${r.listsCreated} lists, ${r.segmentsCreated} segments, ${r.flowsCreated} flows; ${r.contactsUpserted} contacts upserted.`);
+  }
+  console.log('');
+}
+
+const sharedOptions = yy => yy
+  .option('lists', { describe: 'Comma-separated Klaviyo list ids (default all)', type: 'string' })
+  .option('segments', { describe: 'Comma-separated Klaviyo segment ids (default all)', type: 'string' })
+  .option('flows', { describe: 'Comma-separated Klaviyo flow ids (default all)', type: 'string' })
+  .option('no-flows', { describe: 'Skip flows', type: 'boolean' })
+  .option('max', { describe: 'Max profiles per list/segment', type: 'number', default: 5000 });
+
+export const klaviyoMigrationCommand = {
+  command: 'klaviyo-migration <subcommand>',
+  describe: 'Import lists, segments and flows from Klaviyo; compare cost',
+  builder: y => y
+    .command({
+      command: 'preview',
+      describe: 'Dry run, writes nothing',
+      builder: sharedOptions,
+      handler: async argv => render(await request('POST', '/KlaviyoMigration/Preview', body(argv))),
+    })
+    .command({
+      command: 'apply',
+      describe: 'Run the import (idempotent)',
+      builder: sharedOptions,
+      handler: async argv => render(await request('POST', '/KlaviyoMigration/Apply', body(argv))),
+    })
+    .command({
+      command: 'savings',
+      describe: 'Compare your Klaviyo bill to a Velaro plan catalog price',
+      builder: yy => yy
+        .option('profiles', { describe: 'Klaviyo profile count', type: 'number', demandOption: true })
+        .option('bill', { describe: 'Klaviyo monthly bill in USD', type: 'number', demandOption: true })
+        .option('plan', { describe: 'Velaro plan key (default plan.professional)', type: 'string' }),
+      handler: async argv => {
+        const qs = new URLSearchParams({ profiles: String(argv.profiles), klaviyoMonthlyBill: String(argv.bill) });
+        if (argv.plan) qs.set('planKey', argv.plan);
+        const r = (await request('GET', `/KlaviyoMigration/SavingsCalculator?${qs}`)).result;
+        console.log(`\nVelaro ${r.planName}: $${r.velaroMonthly}/mo vs Klaviyo $${r.klaviyoMonthly}/mo`);
+        console.log(`Difference: $${r.monthlySavings}/mo, $${r.annualSavings}/yr\n${DIM}${r.note}${RST}\n`);
+      },
+    })
+    .demandCommand(1, 'Specify a subcommand. Try: velaro klaviyo-migration --help'),
+  handler: () => {},
+};

package/lib/commands/report.js

@@ -448,6 +448,57 @@ const workedHoursCommand = {
   },
 };
 
+// -- visitor-traffic command ------------------------------------------------
+// Visitor Traffic report (velaro-messaging): daily visit trend, top countries,
+// chat-channel breakdown. Backend: server/Velaro.Messaging/Controllers/ReportsController.cs
+// POST reports/visitor-traffic-overview { start, end } -> { kpis, dailySeries, countryBreakdown, channelBreakdown }
+const visitorTrafficCommand = {
+  command:  'visitor-traffic',
+  describe: 'Visitor Traffic report: daily visit trend, top countries and chat-channel breakdown for a date range',
+  builder:  (y) => y
+    .option('start', { type: 'string', describe: 'Start date (ISO 8601 or YYYY-MM-DD). Default: 30 days ago' })
+    .option('end',   { type: 'string', describe: 'End date (ISO 8601 or YYYY-MM-DD). Default: now' }),
+  handler: async (argv) => {
+    const end   = argv.end   ? new Date(argv.end)   : new Date();
+    const start = argv.start ? new Date(argv.start) : new Date(end.getTime() - 30 * 24 * 60 * 60 * 1000);
+    if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) {
+      console.error('--start and --end must be valid dates (ISO 8601 or YYYY-MM-DD).');
+      process.exit(1);
+    }
+
+    const data = await messagingRequest('POST', '/reports/visitor-traffic-overview', {
+      start: start.toISOString(),
+      end:   end.toISOString(),
+    });
+
+    section('Visitor Traffic');
+    console.log(`  Period: ${data?.start ?? start.toISOString().slice(0, 10)} -> ${data?.end ?? end.toISOString().slice(0, 10)}`);
+
+    const k = data?.kpis ?? {};
+    fmtRow('Total visits',       fmtNum(k.totalVisits));
+    fmtRow('Avg daily visits',   fmtNum(k.avgDailyVisits));
+    fmtRow('Countries reached',  fmtNum(k.countriesReached));
+    fmtRow('Chats started',      fmtNum(k.chatsStarted));
+
+    const countries = Array.isArray(data?.countryBreakdown) ? data.countryBreakdown : [];
+    section('Top Countries');
+    if (!countries.length) {
+      console.log('  (no data)');
+    } else {
+      for (const c of countries) console.log(`  ${(c.country ?? '?').padEnd(6)} ${fmtNum(c.count)}`);
+    }
+
+    const channels = Array.isArray(data?.channelBreakdown) ? data.channelBreakdown : [];
+    section('By Channel');
+    if (!channels.length) {
+      console.log('  (no data)');
+    } else {
+      for (const c of channels) console.log(`  ${(c.name ?? '?').padEnd(16)} ${fmtNum(c.count)}  (${fmtNum(c.pct)}%)`);
+    }
+    console.log('');
+  },
+};
+
 // ── scheduled reports (Reports/Schedules) ──────────────────────────────────────
 // Backend: server/Velaro.Admin/Controllers/ReportsController.cs
 //   GET  Reports/Schedules -> scheduledReport[]
@@ -638,6 +689,7 @@ export const reportCommand = {
     .command(conversationsCommand)
     .command(callactivityCommand)
     .command(workedHoursCommand)
+    .command(visitorTrafficCommand)
     .command(schedulesCommand)
     .command(exportCommand)
     .demandCommand(1, 'Specify a report type. Run "velaro report --help" for options.'),

package/package.json

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