@velaro/cli 0.4.0 → 0.7.0

package/lib/commands/ops.js

@@ -0,0 +1,173 @@
+import { get, getCredentials } from '../api.js';
+import { readConfig, ENVS }   from '../config.js';
+
+// ── helpers ──────────────────────────────────────────────────────────────────
+
+function ago(dateStr) {
+  if (!dateStr) return 'unknown';
+  const diffMs = Date.now() - new Date(dateStr).getTime();
+  const mins  = Math.round(diffMs / 60000);
+  if (mins < 2)   return 'just now';
+  if (mins < 60)  return `${mins}m ago`;
+  const hrs = Math.round(mins / 60);
+  if (hrs < 24)   return `${hrs}h ago`;
+  return `${Math.round(hrs / 24)}d ago`;
+}
+
+function utcLabel(dateStr) {
+  if (!dateStr) return '';
+  const d = new Date(dateStr);
+  return d.toISOString().replace('T', ' ').slice(0, 16) + ' UTC';
+}
+
+const OK    = '\x1b[32m✓\x1b[0m';
+const WARN  = '\x1b[33m⚠\x1b[0m';
+const ERR   = '\x1b[31m✗\x1b[0m';
+const HIGH  = '\x1b[31m[high]\x1b[0m  ';
+const MED   = '\x1b[33m[med]\x1b[0m   ';
+const LOW   = '\x1b[36m[low]\x1b[0m   ';
+
+function severityPrefix(s) {
+  if (s === 'high')   return HIGH;
+  if (s === 'medium') return MED;
+  return LOW;
+}
+
+async function pingVersion(label, base) {
+  try {
+    const res = await fetch(`${base}/Version`, { signal: AbortSignal.timeout(6000) });
+    if (!res.ok) return { label, ok: false, status: res.status };
+    const data = await res.json();
+    return { label, ok: true, version: data.version, deployedAt: data.deployedAt };
+  } catch (e) {
+    return { label, ok: false, err: e.message };
+  }
+}
+
+async function pingHealth(label, url) {
+  try {
+    const res = await fetch(url, { signal: AbortSignal.timeout(6000) });
+    return { label, ok: res.ok, status: res.status };
+  } catch (e) {
+    return { label, ok: false, err: e.message };
+  }
+}
+
+// ── ops command ───────────────────────────────────────────────────────────────
+
+export const opsCommand = {
+  command:  'ops',
+  describe: 'System health: deploy times, Hangfire, API status, and active alerts (Velaro staff only)',
+  handler:  async () => {
+    const creds = await getCredentials();
+    const isAdmin = creds.siteId === 1032;
+
+    if (!isAdmin) {
+      console.error('velaro ops is only available to Velaro staff.');
+      process.exit(1);
+    }
+
+    const cfg = readConfig();
+
+    // ── 1. Deploy versions (anonymous — both envs in parallel) ───────────────
+    const prodBase    = cfg.envs?.prod?.adminApiBase    ?? ENVS.prod.adminApiBase;
+    const stagingBase = cfg.envs?.staging?.adminApiBase ?? ENVS.staging.adminApiBase;
+
+    const [prodVer, stagingVer] = await Promise.all([
+      pingVersion('prod',    prodBase),
+      pingVersion('staging', stagingBase),
+    ]);
+
+    console.log('\n\x1b[1m── Deploy ──────────────────────────────────────────────────\x1b[0m');
+    for (const v of [prodVer, stagingVer]) {
+      if (v.ok) {
+        const sym  = OK;
+        const ver  = `\x1b[36m${v.version}\x1b[0m`;
+        const time = `${ago(v.deployedAt).padEnd(12)} (${utcLabel(v.deployedAt)})`;
+        console.log(`  ${sym}  ${v.label.padEnd(8)}  ${ver.padEnd(30)}  deployed ${time}`);
+      } else {
+        const detail = v.err ?? `HTTP ${v.status}`;
+        console.log(`  ${ERR}  ${v.label.padEnd(8)}  UNREACHABLE — ${detail}`);
+      }
+    }
+
+    // ── 2. API health (admin + messaging, both envs) ──────────────────────────
+    const prodMsgBase    = cfg.envs?.prod?.messagingApiBase    ?? ENVS.prod.messagingApiBase;
+    const stagingMsgBase = cfg.envs?.staging?.messagingApiBase ?? ENVS.staging.messagingApiBase;
+
+    const [adminProdHealth, adminStagingHealth, msgProdHealth, msgStagingHealth] = await Promise.all([
+      pingHealth('admin/prod',    `${prodBase}/Status`),
+      pingHealth('admin/staging', `${stagingBase}/Status`),
+      pingHealth('msg/prod',      `${prodMsgBase}/api/health`),
+      pingHealth('msg/staging',   `${stagingMsgBase}/api/health`),
+    ]);
+
+    console.log('\n\x1b[1m── API Health ──────────────────────────────────────────────\x1b[0m');
+    for (const h of [adminProdHealth, adminStagingHealth, msgProdHealth, msgStagingHealth]) {
+      if (h.ok) {
+        console.log(`  ${OK}  ${h.label}`);
+      } else {
+        const detail = h.err ?? `HTTP ${h.status}`;
+        console.log(`  ${ERR}  ${h.label.padEnd(20)}  ${detail}`);
+      }
+    }
+
+    // ── 3. Hangfire failed jobs ───────────────────────────────────────────────
+    console.log('\n\x1b[1m── Hangfire ────────────────────────────────────────────────\x1b[0m');
+    try {
+      const jobs = await get('/DatabaseTool/FailedJobs');
+      if (!jobs?.length) {
+        console.log(`  ${OK}  0 failed jobs`);
+      } else {
+        const sym = jobs.length >= 20 ? ERR : jobs.length >= 5 ? WARN : WARN;
+        console.log(`  ${sym}  ${jobs.length} failed job(s)`);
+        for (const j of jobs.slice(0, 5)) {
+          const when = j.failedAt ? ago(j.failedAt) : '?';
+          const name = [j.typeName, j.methodName].filter(Boolean).join('.');
+          const msg  = j.exceptionMessage?.split('\n')[0]?.slice(0, 80) ?? j.reason?.slice(0, 80) ?? '';
+          console.log(`    ${WARN}  ${name.padEnd(35)} ${when.padEnd(10)}  ${msg}`);
+        }
+        if (jobs.length > 5) console.log(`    ... and ${jobs.length - 5} more`);
+        console.log('  Open /hangfire to inspect and retry.');
+      }
+    } catch (e) {
+      console.log(`  ${WARN}  Could not load Hangfire jobs: ${e.message}`);
+    }
+
+    // ── 4. Active alerts (needs-attention via messaging API) ──────────────────
+    console.log('\n\x1b[1m── Alerts ──────────────────────────────────────────────────\x1b[0m');
+    try {
+      const res = await fetch(`${prodMsgBase}/SuperAdmin/needs-attention`, {
+        headers: {
+          Authorization:      `Bearer ${creds.velaroToken}`,
+          'X-Internal-SiteId': String(creds.siteId),
+          'Content-Type':     'application/json',
+        },
+        signal: AbortSignal.timeout(15000),
+      });
+
+      if (!res.ok) {
+        console.log(`  ${WARN}  Could not reach alerts endpoint (HTTP ${res.status})`);
+      } else {
+        const items = await res.json();
+        const alertItems = Array.isArray(items)
+          ? items.filter(i => i.type !== 'hangfire_failed') // shown above
+          : [];
+        if (!alertItems.length) {
+          console.log(`  ${OK}  Nothing needs attention`);
+        } else {
+          for (const item of alertItems) {
+            console.log(`  ${severityPrefix(item.severity)}${item.title}`);
+            if (item.recommendedFix) {
+              console.log(`         \x1b[2m${item.recommendedFix.slice(0, 100)}\x1b[0m`);
+            }
+          }
+        }
+      }
+    } catch (e) {
+      console.log(`  ${WARN}  Alerts unavailable: ${e.message}`);
+    }
+
+    console.log('\n──────────────────────────────────────────────────────────────\n');
+  },
+};

package/lib/commands/site.js

@@ -1,62 +1,62 @@
-import { get }       from '../api.js';
-import { runCommand } from '../run.js';
-
-const FEATURE_MAP = {
-  enableWeb:                'Web Chat',
-  enableSms:                'SMS',
-  enableEmail:              'Email',
-  enableWhatsapp:           'WhatsApp',
-  enableIvr:                'IVR / Voice',
-  enableFacebook:           'Facebook Messenger',
-  enableInstagram:          'Instagram',
-  enableAI:                 'AI Bots',
-  enableKnowledgeBase:      'Knowledge Base',
-  enableAutomation:         'Workflows',
-  enableWorkflowRules:      'Routing Rules',
-  enableChatTranslations:   'Chat Translation',
-  enableVideoChat:          'Video Chat',
-  enableTicketing:          'Ticketing',
-  enableAgentDashboard:     'Agent Dashboard',
-  enableMcpApi:             'MCP API Gateway',
-  enableOutboundCampaigns:  'Email Campaigns',
-  enableRcs:                'RCS Messaging',
-  enablePageWidgets:        'Page Widgets',
-  enableVisitorTracking:    'Visitor Tracking',
-};
-
-const STATUS_LABEL = { Available: 'online', Away: 'away', Offline: 'offline' };
-
-export const siteCommand = {
-  command:  'site',
-  describe: 'Show site overview: active features and agent availability',
-  handler:  runCommand(async () => {
-    const [sub, agents] = await Promise.all([
-      get('/Subscription'),
-      get('/Users/List'),
-    ]);
-
-    // Active features — friendly names only, no internal flag names
-    const active = Object.entries(FEATURE_MAP)
-      .filter(([key]) => sub[key] === true)
-      .map(([, label]) => label);
-
-    console.log('\nActive features:');
-    if (active.length) {
-      console.log('  ' + active.join('  ·  '));
-    } else {
-      console.log('  (none)');
-    }
-
-    if (sub.maxCreatedUsers) {
-      console.log(`\nAgent seats: ${sub.maxCreatedUsers} licensed`);
-    }
-
-    // Agent availability summary
-    const counts = { online: 0, away: 0, offline: 0 };
-    for (const a of agents) {
-      const key = STATUS_LABEL[a.status] ?? 'offline';
-      counts[key]++;
-    }
-    console.log(`Agent status: ${counts.online} online · ${counts.away} away · ${counts.offline} offline\n`);
-  }),
-};
+import { get }       from '../api.js';
+import { runCommand } from '../run.js';
+
+const FEATURE_MAP = {
+  enableWeb:                'Web Chat',
+  enableSms:                'SMS',
+  enableEmail:              'Email',
+  enableWhatsapp:           'WhatsApp',
+  enableIvr:                'IVR / Voice',
+  enableFacebook:           'Facebook Messenger',
+  enableInstagram:          'Instagram',
+  enableAI:                 'AI Bots',
+  enableKnowledgeBase:      'Knowledge Base',
+  enableAutomation:         'Workflows',
+  enableWorkflowRules:      'Routing Rules',
+  enableChatTranslations:   'Chat Translation',
+  enableVideoChat:          'Video Chat',
+  enableTicketing:          'Ticketing',
+  enableAgentDashboard:     'Agent Dashboard',
+  enableMcpApi:             'MCP API Gateway',
+  enableOutboundCampaigns:  'Email Campaigns',
+  enableRcs:                'RCS Messaging',
+  enablePageWidgets:        'Page Widgets',
+  enableVisitorTracking:    'Visitor Tracking',
+};
+
+const STATUS_LABEL = { Available: 'online', Away: 'away', Offline: 'offline' };
+
+export const siteCommand = {
+  command:  'site',
+  describe: 'Show site overview: active features and agent availability',
+  handler:  runCommand(async () => {
+    const [sub, agents] = await Promise.all([
+      get('/Subscription'),
+      get('/Users/List'),
+    ]);
+
+    // Active features — friendly names only, no internal flag names
+    const active = Object.entries(FEATURE_MAP)
+      .filter(([key]) => sub[key] === true)
+      .map(([, label]) => label);
+
+    console.log('\nActive features:');
+    if (active.length) {
+      console.log('  ' + active.join('  ·  '));
+    } else {
+      console.log('  (none)');
+    }
+
+    if (sub.maxCreatedUsers) {
+      console.log(`\nAgent seats: ${sub.maxCreatedUsers} licensed`);
+    }
+
+    // Agent availability summary
+    const counts = { online: 0, away: 0, offline: 0 };
+    for (const a of agents) {
+      const key = STATUS_LABEL[a.status] ?? 'offline';
+      counts[key]++;
+    }
+    console.log(`Agent status: ${counts.online} online · ${counts.away} away · ${counts.offline} offline\n`);
+  }),
+};

package/lib/commands/status.js

@@ -1,22 +1,24 @@
-import { readConfig, DEFAULT_API_BASE } from '../config.js';
-
-export const statusCommand = {
-  command:  'status',
-  describe: 'Check Velaro API health',
-  handler:  async () => {
-    const apiBase = readConfig()?.apiBase ?? DEFAULT_API_BASE;
-    process.stdout.write(`Checking ${apiBase}/Status ... `);
-    try {
-      const res = await fetch(`${apiBase}/Status`);
-      if (res.ok) {
-        console.log('OK');
-      } else {
-        console.log(`DEGRADED (HTTP ${res.status})`);
-        process.exit(1);
-      }
-    } catch (err) {
-      console.log(`UNREACHABLE: ${err.message}`);
-      process.exit(1);
-    }
-  },
-};
+import { readConfig, getActiveEnv, ENVS } from '../config.js';
+
+export const statusCommand = {
+  command:  'status',
+  describe: 'Check Velaro API health',
+  handler:  async () => {
+    const cfg     = readConfig();
+    const env     = getActiveEnv();
+    const apiBase = cfg.envs?.[env]?.adminApiBase ?? ENVS[env].adminApiBase;
+    process.stdout.write(`Checking ${apiBase}/Status ... `);
+    try {
+      const res = await fetch(`${apiBase}/Status`);
+      if (res.ok) {
+        console.log('OK');
+      } else {
+        console.log(`DEGRADED (HTTP ${res.status})`);
+        process.exit(1);
+      }
+    } catch (err) {
+      console.log(`UNREACHABLE: ${err.message}`);
+      process.exit(1);
+    }
+  },
+};

package/lib/commands/team.js

@@ -1,144 +1,144 @@
-import { get, post }  from '../api.js';
-import { runCommand } from '../run.js';
-
-export const teamCommand = {
-  command:  'team <subcommand>',
-  describe: 'View teams and manage widget placements (deployments)',
-  builder:  (yargs) =>
-    yargs
-      .command(teamListCommand)
-      .command(widgetListCommand)
-      .command(widgetRenameCommand)
-      .command(widgetAssignCommand)
-      .demandCommand(1, 'Specify a subcommand: list, widget'),
-  handler: () => {},
-};
-
-// ── team list ──────────────────────────────────────────────────────────────────
-// Shows teams and their widget placements inline — the mental model is:
-//   team = who handles conversations
-//   widget = which pages route to that team
-
-const teamListCommand = {
-  command:  'list',
-  describe: 'List teams and their widget placements',
-  handler:  runCommand(async () => {
-    const [teams, deployments] = await Promise.all([
-      get('/Teams/List'),
-      get('/Deployment'),
-    ]);
-
-    if (!teams?.length) {
-      console.log('No teams found.');
-      return;
-    }
-
-    // Group deployments by team
-    const byTeam = {};
-    for (const d of (deployments ?? [])) {
-      if (!byTeam[d.teamId]) byTeam[d.teamId] = [];
-      byTeam[d.teamId].push(d);
-    }
-
-    for (const t of teams) {
-      const widgets = byTeam[t.id] ?? [];
-      const routing = t.routingAction ? `  routing=${t.routingAction}` : '';
-      console.log(`\n[${t.id}] ${t.name}${routing}`);
-
-      if (widgets.length) {
-        for (const w of widgets) {
-          console.log(`     widget [${w.id}] "${w.displayName ?? 'unnamed'}"  key: ${w.deploymentId}`);
-        }
-      } else {
-        console.log(`     (no widgets assigned — conversations can reach this team via routing rules)`);
-      }
-    }
-
-    console.log(`\n${teams.length} team(s)  ·  ${(deployments ?? []).length} widget(s)`);
-    console.log('\nPaste a widget key into your page\'s embed snippet to route that page to its team.');
-  }),
-};
-
-// ── widget subcommands ─────────────────────────────────────────────────────────
-// "Widget" is the user-facing term. Internally these are deployments.
-// A widget is a snippet you paste on a page. The page routes to the widget's team.
-
-const widgetListCommand = {
-  command:  'widget list',
-  describe: 'List all widgets (embed snippets) and which team each routes to',
-  handler:  runCommand(async () => {
-    const [deployments, teams] = await Promise.all([
-      get('/Deployment'),
-      get('/Teams/List'),
-    ]);
-
-    if (!deployments?.length) {
-      console.log('No widgets found.');
-      console.log('\nCreate a widget in the Velaro admin under Deployments,');
-      console.log('then paste its embed snippet on the pages you want chat on.');
-      return;
-    }
-
-    const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
-    const rows    = deployments.map(d => ({
-      id:   `[${d.id}]`,
-      key:  d.deploymentId ?? '—',
-      team: teamMap[d.teamId] ?? `team ${d.teamId}`,
-      name: d.displayName ?? '(unnamed)',
-    }));
-
-    const idW   = Math.max(...rows.map(r => r.id.length));
-    const keyW  = Math.max('embed-key'.length, ...rows.map(r => r.key.length));
-    const teamW = Math.max('routes-to'.length, ...rows.map(r => r.team.length));
-
-    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'routes-to'.padEnd(teamW)}  name`);
-    console.log(`${'-'.repeat(idW)}  ${'-'.repeat(keyW)}  ${'-'.repeat(teamW)}  ----`);
-    for (const r of rows) {
-      console.log(`${r.id.padStart(idW)}  ${r.key.padEnd(keyW)}  ${r.team.padEnd(teamW)}  ${r.name}`);
-    }
-    console.log(`\n${rows.length} widget(s)`);
-  }),
-};
-
-const widgetRenameCommand = {
-  command:  'widget rename <id> <name>',
-  describe: 'Rename a widget',
-  builder:  (y) =>
-    y
-      .positional('id',   { type: 'number', describe: 'Widget ID' })
-      .positional('name', { type: 'string', describe: 'New name' }),
-  handler: runCommand(async (argv) => {
-    const dep = await get(`/Deployment/${argv.id}`);
-    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
-    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
-    console.log(`Widget ${argv.id} renamed to "${argv.name}".`);
-  }),
-};
-
-const widgetAssignCommand = {
-  command:  'widget assign <id> <team-id>',
-  describe: 'Point a widget at a different team (embed code stays the same)',
-  builder:  (y) =>
-    y
-      .positional('id',      { type: 'number', describe: 'Widget ID' })
-      .positional('team-id', { type: 'number', describe: 'Team ID to route to' }),
-  handler: runCommand(async (argv) => {
-    const [dep, teams] = await Promise.all([
-      get(`/Deployment/${argv.id}`),
-      get('/Teams/List'),
-    ]);
-
-    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
-
-    const team = (teams ?? []).find(t => t.id === argv['team-id']);
-    if (!team) {
-      console.error(`Team ${argv['team-id']} not found.`);
-      console.error('Run: velaro team list');
-      process.exit(1);
-    }
-
-    await post('/Deployment', { ...dep, id: argv.id, teamId: argv['team-id'] });
-    console.log(`Widget "${dep.displayName ?? dep.id}" now routes to team "${team.name}".`);
-    console.log('Your embed snippet is unchanged — no website edits needed.');
-  }),
-};
+import { get, post }  from '../api.js';
+import { runCommand } from '../run.js';
+
+export const teamCommand = {
+  command:  'team <subcommand>',
+  describe: 'View teams and manage widget placements (deployments)',
+  builder:  (yargs) =>
+    yargs
+      .command(teamListCommand)
+      .command(widgetListCommand)
+      .command(widgetRenameCommand)
+      .command(widgetAssignCommand)
+      .demandCommand(1, 'Specify a subcommand: list, widget'),
+  handler: () => {},
+};
+
+// ── team list ──────────────────────────────────────────────────────────────────
+// Shows teams and their widget placements inline — the mental model is:
+//   team = who handles conversations
+//   widget = which pages route to that team
+
+const teamListCommand = {
+  command:  'list',
+  describe: 'List teams and their widget placements',
+  handler:  runCommand(async () => {
+    const [teams, deployments] = await Promise.all([
+      get('/Teams/List'),
+      get('/Deployment'),
+    ]);
+
+    if (!teams?.length) {
+      console.log('No teams found.');
+      return;
+    }
+
+    // Group deployments by team
+    const byTeam = {};
+    for (const d of (deployments ?? [])) {
+      if (!byTeam[d.teamId]) byTeam[d.teamId] = [];
+      byTeam[d.teamId].push(d);
+    }
+
+    for (const t of teams) {
+      const widgets = byTeam[t.id] ?? [];
+      const routing = t.routingAction ? `  routing=${t.routingAction}` : '';
+      console.log(`\n[${t.id}] ${t.name}${routing}`);
+
+      if (widgets.length) {
+        for (const w of widgets) {
+          console.log(`     widget [${w.id}] "${w.displayName ?? 'unnamed'}"  key: ${w.deploymentId}`);
+        }
+      } else {
+        console.log(`     (no widgets assigned — conversations can reach this team via routing rules)`);
+      }
+    }
+
+    console.log(`\n${teams.length} team(s)  ·  ${(deployments ?? []).length} widget(s)`);
+    console.log('\nPaste a widget key into your page\'s embed snippet to route that page to its team.');
+  }),
+};
+
+// ── widget subcommands ─────────────────────────────────────────────────────────
+// "Widget" is the user-facing term. Internally these are deployments.
+// A widget is a snippet you paste on a page. The page routes to the widget's team.
+
+const widgetListCommand = {
+  command:  'widget list',
+  describe: 'List all widgets (embed snippets) and which team each routes to',
+  handler:  runCommand(async () => {
+    const [deployments, teams] = await Promise.all([
+      get('/Deployment'),
+      get('/Teams/List'),
+    ]);
+
+    if (!deployments?.length) {
+      console.log('No widgets found.');
+      console.log('\nCreate a widget in the Velaro admin under Deployments,');
+      console.log('then paste its embed snippet on the pages you want chat on.');
+      return;
+    }
+
+    const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
+    const rows    = deployments.map(d => ({
+      id:   `[${d.id}]`,
+      key:  d.deploymentId ?? '—',
+      team: teamMap[d.teamId] ?? `team ${d.teamId}`,
+      name: d.displayName ?? '(unnamed)',
+    }));
+
+    const idW   = Math.max(...rows.map(r => r.id.length));
+    const keyW  = Math.max('embed-key'.length, ...rows.map(r => r.key.length));
+    const teamW = Math.max('routes-to'.length, ...rows.map(r => r.team.length));
+
+    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'routes-to'.padEnd(teamW)}  name`);
+    console.log(`${'-'.repeat(idW)}  ${'-'.repeat(keyW)}  ${'-'.repeat(teamW)}  ----`);
+    for (const r of rows) {
+      console.log(`${r.id.padStart(idW)}  ${r.key.padEnd(keyW)}  ${r.team.padEnd(teamW)}  ${r.name}`);
+    }
+    console.log(`\n${rows.length} widget(s)`);
+  }),
+};
+
+const widgetRenameCommand = {
+  command:  'widget rename <id> <name>',
+  describe: 'Rename a widget',
+  builder:  (y) =>
+    y
+      .positional('id',   { type: 'number', describe: 'Widget ID' })
+      .positional('name', { type: 'string', describe: 'New name' }),
+  handler: runCommand(async (argv) => {
+    const dep = await get(`/Deployment/${argv.id}`);
+    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
+    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
+    console.log(`Widget ${argv.id} renamed to "${argv.name}".`);
+  }),
+};
+
+const widgetAssignCommand = {
+  command:  'widget assign <id> <team-id>',
+  describe: 'Point a widget at a different team (embed code stays the same)',
+  builder:  (y) =>
+    y
+      .positional('id',      { type: 'number', describe: 'Widget ID' })
+      .positional('team-id', { type: 'number', describe: 'Team ID to route to' }),
+  handler: runCommand(async (argv) => {
+    const [dep, teams] = await Promise.all([
+      get(`/Deployment/${argv.id}`),
+      get('/Teams/List'),
+    ]);
+
+    if (!dep) { console.error(`Widget ${argv.id} not found.`); process.exit(1); }
+
+    const team = (teams ?? []).find(t => t.id === argv['team-id']);
+    if (!team) {
+      console.error(`Team ${argv['team-id']} not found.`);
+      console.error('Run: velaro team list');
+      process.exit(1);
+    }
+
+    await post('/Deployment', { ...dep, id: argv.id, teamId: argv['team-id'] });
+    console.log(`Widget "${dep.displayName ?? dep.id}" now routes to team "${team.name}".`);
+    console.log('Your embed snippet is unchanged — no website edits needed.');
+  }),
+};