@velaro/cli 1.2.0 → 1.4.9

package/lib/commands/deployment.js

@@ -1,107 +1,107 @@
-import { get, post }  from '../api.js';
-import { runCommand } from '../run.js';
-
-export const deploymentCommand = {
-  command:  'deployment <subcommand>',
-  describe: 'Manage chat widget deployments',
-  builder:  (yargs) =>
-    yargs
-      .command(deploymentListCommand)
-      .command(deploymentRenameCommand)
-      .command(deploymentAssignCommand)
-      .demandCommand(1, 'Specify a subcommand: list, rename, assign-team'),
-  handler: () => {},
-};
-
-// ── list ───────────────────────────────────────────────────────────────────────
-
-const deploymentListCommand = {
-  command:  'list',
-  describe: 'List chat widget deployments',
-  handler:  runCommand(async () => {
-    const [deployments, teams] = await Promise.all([
-      get('/Deployment'),
-      get('/Teams/List'),
-    ]);
-
-    if (!deployments?.length) {
-      console.log('No deployments found.');
-      console.log('\nA deployment is a chat widget embed — one per page or team you want to serve.');
-      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('team'.length,      ...rows.map(r => r.team.length));
-
-    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'team'.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} deployment(s)`);
-    console.log('\nThe embed-key goes in your widget JavaScript snippet.');
-  }),
-};
-
-// ── rename ─────────────────────────────────────────────────────────────────────
-
-const deploymentRenameCommand = {
-  command:  'rename <id> <name>',
-  describe: 'Rename a deployment',
-  builder:  (y) =>
-    y
-      .positional('id',   { type: 'number', describe: 'Deployment numeric ID' })
-      .positional('name', { type: 'string', describe: 'New display name' }),
-  handler: runCommand(async (argv) => {
-    const dep = await get(`/Deployment/${argv.id}`);
-    if (!dep) {
-      console.error(`Deployment ${argv.id} not found.`);
-      process.exit(1);
-    }
-
-    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
-    console.log(`Deployment ${argv.id} renamed to "${argv.name}".`);
-  }),
-};
-
-// ── assign-team ────────────────────────────────────────────────────────────────
-
-const deploymentAssignCommand = {
-  command:  'assign-team <id> <team-id>',
-  describe: 'Assign a team to a deployment',
-  builder:  (y) =>
-    y
-      .positional('id',      { type: 'number', describe: 'Deployment numeric ID' })
-      .positional('team-id', { type: 'number', describe: 'Team ID to assign' }),
-  handler: runCommand(async (argv) => {
-    const [dep, teams] = await Promise.all([
-      get(`/Deployment/${argv.id}`),
-      get('/Teams/List'),
-    ]);
-
-    if (!dep) {
-      console.error(`Deployment ${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(`Deployment ${argv.id} ("${dep.displayName}") assigned to team "${team.name}".`);
-  }),
-};
+import { get, post }  from '../api.js';
+import { runCommand } from '../run.js';
+
+export const deploymentCommand = {
+  command:  'deployment <subcommand>',
+  describe: 'Manage chat widget deployments',
+  builder:  (yargs) =>
+    yargs
+      .command(deploymentListCommand)
+      .command(deploymentRenameCommand)
+      .command(deploymentAssignCommand)
+      .demandCommand(1, 'Specify a subcommand: list, rename, assign-team'),
+  handler: () => {},
+};
+
+// ── list ───────────────────────────────────────────────────────────────────────
+
+const deploymentListCommand = {
+  command:  'list',
+  describe: 'List chat widget deployments',
+  handler:  runCommand(async () => {
+    const [deployments, teams] = await Promise.all([
+      get('/Deployment'),
+      get('/Teams/List'),
+    ]);
+
+    if (!deployments?.length) {
+      console.log('No deployments found.');
+      console.log('\nA deployment is a chat widget embed — one per page or team you want to serve.');
+      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('team'.length,      ...rows.map(r => r.team.length));
+
+    console.log(`\n${'id'.padStart(idW)}  ${'embed-key'.padEnd(keyW)}  ${'team'.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} deployment(s)`);
+    console.log('\nThe embed-key goes in your widget JavaScript snippet.');
+  }),
+};
+
+// ── rename ─────────────────────────────────────────────────────────────────────
+
+const deploymentRenameCommand = {
+  command:  'rename <id> <name>',
+  describe: 'Rename a deployment',
+  builder:  (y) =>
+    y
+      .positional('id',   { type: 'number', describe: 'Deployment numeric ID' })
+      .positional('name', { type: 'string', describe: 'New display name' }),
+  handler: runCommand(async (argv) => {
+    const dep = await get(`/Deployment/${argv.id}`);
+    if (!dep) {
+      console.error(`Deployment ${argv.id} not found.`);
+      process.exit(1);
+    }
+
+    await post('/Deployment', { ...dep, id: argv.id, displayName: argv.name });
+    console.log(`Deployment ${argv.id} renamed to "${argv.name}".`);
+  }),
+};
+
+// ── assign-team ────────────────────────────────────────────────────────────────
+
+const deploymentAssignCommand = {
+  command:  'assign-team <id> <team-id>',
+  describe: 'Assign a team to a deployment',
+  builder:  (y) =>
+    y
+      .positional('id',      { type: 'number', describe: 'Deployment numeric ID' })
+      .positional('team-id', { type: 'number', describe: 'Team ID to assign' }),
+  handler: runCommand(async (argv) => {
+    const [dep, teams] = await Promise.all([
+      get(`/Deployment/${argv.id}`),
+      get('/Teams/List'),
+    ]);
+
+    if (!dep) {
+      console.error(`Deployment ${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(`Deployment ${argv.id} ("${dep.displayName}") assigned to team "${team.name}".`);
+  }),
+};

package/lib/commands/diagnostics.js

@@ -0,0 +1,298 @@
+import { get as adminGet, getCredentials } from '../api.js';
+import { readConfig, ENVS } from '../config.js';
+
+// ── helpers ───────────────────────────────────────────────────────────────────
+
+const RESET = '\x1b[0m';
+const BOLD  = '\x1b[1m';
+const DIM   = '\x1b[2m';
+const CYN   = '\x1b[36m';
+const YEL   = '\x1b[33m';
+const GRN   = '\x1b[32m';
+const RED   = '\x1b[31m';
+
+function fmtDate(ts) {
+  if (!ts) return '—';
+  return new Date(ts).toLocaleString('en-US', {
+    timeZone: 'America/Los_Angeles',
+    dateStyle: 'short',
+    timeStyle: 'short',
+  });
+}
+
+function trunc(str, len = 100) {
+  if (!str) return '';
+  return str.length > len ? str.slice(0, len - 1) + '…' : str;
+}
+
+function requireSite(argv) {
+  if (!argv.site) {
+    console.error(`\n${RED}Error:${RESET} Use --site <siteId> to specify which customer site to query.\n`);
+    process.exit(1);
+  }
+  return argv.site;
+}
+
+async function getMsgBase(argv) {
+  const cfg = readConfig();
+  const env = argv.env || cfg.env || 'staging';
+  return cfg.envs?.[env]?.messagingApiBase ?? ENVS[env]?.messagingApiBase
+    ?? 'https://velaro-messaging-api-staging.azurewebsites.net';
+}
+
+function requireAdmin(creds) {
+  if (creds.siteId !== 1032) {
+    console.error('velaro diagnostics crm-email-campaign-audit is only available to Velaro staff (site 1032).');
+    process.exit(1);
+  }
+}
+
+// ── velaro diagnostics skill-logs ─────────────────────────────────────────────
+
+const skillLogsCommand = {
+  command:  'skill-logs',
+  describe: 'Show recent AI skill invocation logs for a site',
+  builder:  (y) => y
+    .option('site', {
+      alias:    's',
+      type:     'number',
+      describe: 'Site ID to query (required)',
+    })
+    .option('errors-only', {
+      type:     'boolean',
+      default:  false,
+      describe: 'Show only failed skill calls',
+    })
+    .option('take', {
+      alias:    'n',
+      type:     'number',
+      default:  25,
+      describe: 'Number of entries to return (default 25)',
+    }),
+  handler: async (argv) => {
+    const siteId = requireSite(argv);
+    const qs = new URLSearchParams({
+      siteId:     String(siteId),
+      errorsOnly: String(argv['errors-only']),
+      take:       String(argv.take),
+    });
+
+    let items;
+    try {
+      items = await adminGet(`SuperAdmin/Diagnostics/skill-logs?${qs}`);
+    } catch (err) {
+      console.error(`\n${RED}Error:${RESET} ${err.message}\n`);
+      process.exit(1);
+    }
+
+    items = Array.isArray(items?.logs) ? items.logs : [];
+
+    console.log(`\n${BOLD}── Skill Logs — Site ${siteId} ──────────────────────────────────────────${RESET}`);
+
+    if (!items.length) {
+      console.log(`  ${DIM}No skill log entries found.${RESET}\n`);
+      return;
+    }
+
+    for (const entry of items) {
+      const ts       = fmtDate(entry.calledAt);
+      const tool     = (entry.toolName ?? '—').padEnd(32);
+      const success  = entry.success ? `${GRN}✓${RESET}` : `${RED}✗${RESET}`;
+      const duration = entry.durationMs != null ? `${entry.durationMs}ms`.padStart(7) : '      —';
+      const category = entry.category ? `${DIM}[${entry.category}]${RESET}` : '';
+
+      console.log(`  ${CYN}${ts}${RESET}  ${success}  ${BOLD}${tool}${RESET}  ${duration}  ${category}`);
+
+      if (!entry.success && entry.resultPreview) {
+        console.log(`    ${RED}${trunc(entry.resultPreview, 120)}${RESET}`);
+      }
+    }
+    console.log();
+  },
+};
+
+// ── velaro diagnostics integration-logs ──────────────────────────────────────
+
+const integrationLogsCommand = {
+  command:  'integration-logs',
+  describe: 'Show recent integration activity log entries for a site',
+  builder:  (y) => y
+    .option('site', {
+      alias:    's',
+      type:     'number',
+      describe: 'Site ID to query (required)',
+    })
+    .option('severity', {
+      type:     'string',
+      describe: 'Filter by severity: error | warning | info',
+      choices:  ['Error', 'Warning', 'Info'],
+    })
+    .option('integration', {
+      alias:    'i',
+      type:     'string',
+      describe: 'Integration slug to filter (e.g. HubSpot, Salesforce)',
+    })
+    .option('take', {
+      alias:    'n',
+      type:     'number',
+      default:  25,
+      describe: 'Number of entries to return (default 25)',
+    }),
+  handler: async (argv) => {
+    const siteId = requireSite(argv);
+    const params = { siteId: String(siteId), take: String(argv.take) };
+    if (argv.severity)    params.severity    = argv.severity;
+    if (argv.integration) params.integration = argv.integration;
+    const qs = new URLSearchParams(params);
+
+    let items;
+    try {
+      items = await adminGet(`SuperAdmin/Diagnostics/integration-logs?${qs}`);
+    } catch (err) {
+      console.error(`\n${RED}Error:${RESET} ${err.message}\n`);
+      process.exit(1);
+    }
+
+    items = Array.isArray(items?.logs) ? items.logs : [];
+
+    console.log(`\n${BOLD}── Integration Logs — Site ${siteId} ────────────────────────────────────${RESET}`);
+
+    if (!items.length) {
+      console.log(`  ${DIM}No integration log entries found.${RESET}\n`);
+      return;
+    }
+
+    for (const entry of items) {
+      const ts          = fmtDate(entry.createdAt);
+      const integration = (entry.integration ?? '—').padEnd(18);
+      const sevColor    = entry.severity === 'Error'   ? RED
+                        : entry.severity === 'Warning' ? YEL
+                        : DIM;
+      const sev         = `${sevColor}${(entry.severity ?? 'Info').padEnd(7)}${RESET}`;
+      const msg         = trunc(entry.message ?? '', 100);
+
+      console.log(`  ${CYN}${ts}${RESET}  ${sev}  ${BOLD}${integration}${RESET}  ${msg}`);
+    }
+    console.log();
+  },
+};
+
+// ── velaro diagnostics routing-decisions ─────────────────────────────────────
+
+const routingDecisionsCommand = {
+  command:  'routing-decisions',
+  describe: 'Show recent smart routing decision events for a site',
+  builder:  (y) => y
+    .option('site', {
+      alias:    's',
+      type:     'number',
+      describe: 'Site ID to query (required)',
+    })
+    .option('take', {
+      alias:    'n',
+      type:     'number',
+      default:  25,
+      describe: 'Number of entries to return (default 25)',
+    }),
+  handler: async (argv) => {
+    const siteId = requireSite(argv);
+    const qs = new URLSearchParams({ siteId: String(siteId), take: String(argv.take) });
+
+    let items;
+    try {
+      items = await adminGet(`SuperAdmin/Diagnostics/routing-decisions?${qs}`);
+    } catch (err) {
+      console.error(`\n${RED}Error:${RESET} ${err.message}\n`);
+      process.exit(1);
+    }
+
+    items = Array.isArray(items?.decisions) ? items.decisions : [];
+
+    console.log(`\n${BOLD}── Routing Decisions — Site ${siteId} ───────────────────────────────────${RESET}`);
+
+    if (!items.length) {
+      console.log(`  ${DIM}No routing decision events found.${RESET}\n`);
+      return;
+    }
+
+    for (const entry of items) {
+      const ts      = fmtDate(entry.occurredAt);
+      const trigger = (entry.trigger ?? '—').padEnd(20);
+      const rule    = entry.ruleName ? `${DIM}${entry.ruleName}${RESET} → ` : '';
+      const outcome = (entry.outcomeType ?? '—').padEnd(18);
+      const label   = entry.outcomeLabel ? `${GRN}${entry.outcomeLabel}${RESET}` : '';
+      const agentCount = entry.agentsAvailable ?? entry.agentsOnline;
+      const agents  = agentCount != null ? `  ${DIM}agents avail: ${agentCount}${RESET}` : '';
+
+      console.log(`  ${CYN}${ts}${RESET}  ${BOLD}${trigger}${RESET}  ${rule}${outcome}${label}${agents}`);
+    }
+    console.log();
+  },
+};
+
+// ── velaro diagnostics crm-email-campaign-audit ──────────────────────────────
+// Retirement-decision diagnostic for the dead/duplicate CrmEmailCampaign system
+// (velaro-messaging's server/Velaro.Messaging.Data/Data/Crm/CrmEmailCampaign*.cs) --
+// the question of "does it have real data or is it safe to delete" was blocked all
+// session on not wanting to run raw SQL against staging/prod. This calls the aggregate,
+// non-PII SuperAdmin/crm-email-campaign-audit endpoint instead. Mirrors the ai-models.js
+// --env/requireAdmin pattern exactly.
+
+const crmEmailCampaignAuditCommand = {
+  command:  'crm-email-campaign-audit',
+  describe: 'Aggregate, non-PII row counts for the dead CrmEmailCampaign system (Velaro staff only) -- answers the delete-vs-migrate retirement question without raw SQL',
+  builder:  (y) => y
+    .option('env', { describe: 'staging or prod', type: 'string' }),
+  handler: async (argv) => {
+    const creds  = await getCredentials();
+    requireAdmin(creds);
+    const msgBase = await getMsgBase(argv);
+
+    const res = await fetch(`${msgBase}/SuperAdmin/crm-email-campaign-audit`, {
+      headers: {
+        Authorization:       `Bearer ${creds.velaroToken}`,
+        'X-Internal-SiteId': String(creds.siteId),
+      },
+      signal: AbortSignal.timeout(20000),
+    });
+
+    if (!res.ok) {
+      console.error(`HTTP ${res.status}: ${await res.text().catch(() => '')}`);
+      process.exit(1);
+    }
+
+    const data = await res.json();
+    const env = argv.env || readConfig().env || 'staging';
+
+    console.log(`\n${BOLD}── CrmEmailCampaign Retirement Audit (${env}) ──────────────────────${RESET}`);
+    console.log(`  Total campaigns:             ${data.totalCampaigns}`);
+    console.log(`  Total enrollments:           ${data.totalEnrollments}`);
+    console.log(`  Distinct sites w/ campaigns: ${data.distinctSitesWithCampaigns}`);
+    console.log(`  Oldest campaign created:     ${data.oldestCampaignCreatedAt ?? '—'}`);
+    console.log(`  Newest campaign created:     ${data.newestCampaignCreatedAt ?? '—'}`);
+    console.log(`  Oldest enrollment date:      ${data.oldestEnrollmentDate ?? '—'}`);
+    console.log(`  Newest enrollment date:      ${data.newestEnrollmentDate ?? '—'}`);
+    console.log(`  Generated at (UTC):          ${data.generatedAtUtc}`);
+
+    if (data.totalCampaigns === 0 && data.totalEnrollments === 0) {
+      console.log(`\n  ${GRN}Both tables are empty -- safe to delete without a data migration.${RESET}\n`);
+    } else {
+      console.log(`\n  ${YEL}Real rows exist -- retirement needs a data migration into admin's EmailCampaign engine, not a plain delete.${RESET}\n`);
+    }
+  },
+};
+
+// ── top-level diagnostics command ─────────────────────────────────────────────
+
+export const diagnosticsCommand = {
+  command:  'diagnostics <subcommand>',
+  describe: 'Query skill logs, integration logs, routing decisions, and staff-only audits (superadmin only)',
+  builder:  (y) => y
+    .command(skillLogsCommand)
+    .command(integrationLogsCommand)
+    .command(routingDecisionsCommand)
+    .command(crmEmailCampaignAuditCommand)
+    .demandCommand(1, 'Specify a subcommand: skill-logs, integration-logs, routing-decisions, crm-email-campaign-audit')
+    .strict(),
+  handler:  () => {},
+};

package/lib/commands/email-campaign.js

@@ -0,0 +1,47 @@
+/**
+ * velaro email-campaign - Drip/trigger email campaign (EmailCampaign) commands
+ *
+ *   velaro email-campaign step-stats <id>    Per-step open/click rates for a campaign
+ */
+
+import { request } from '../api.js';
+
+const GRN  = '\x1b[32m';
+const DIM  = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RST  = '\x1b[0m';
+
+// -- step-stats ----------------------------------------------------------------------
+
+async function stepStatsHandler(argv) {
+  const id = argv.id;
+  const data = await request('GET', `/EmailCampaigns/${id}/StepStats`);
+  const steps = data?.steps ?? [];
+  if (!steps.length) {
+    console.log(`\nNo step data for campaign ${id} yet (no sends recorded).\n`);
+    return;
+  }
+  console.log(`\n${BOLD}Step stats for campaign ${id}${RST}\n`);
+  for (const s of steps) {
+    console.log(`  Step ${s.stepOrder ?? '?'} ${DIM}(step id ${s.stepId})${RST}`);
+    console.log(`    sent ${s.sentCount}, opened ${s.openedCount} (${GRN}${s.openRate}%${RST}), clicked ${s.clickedCount} (${GRN}${s.clickRate}%${RST})`);
+  }
+  console.log('');
+}
+
+// -- command export ------------------------------------------------------------------
+
+export const emailCampaignCommand = {
+  command:  'email-campaign <subcommand>',
+  describe: 'Drip/trigger email campaign (EmailCampaign) commands',
+  builder: y => y
+    .command({
+      command:  'step-stats <id>',
+      describe: 'Per-step open/click rates for a drip/trigger campaign',
+      builder: yy => yy
+        .positional('id', { describe: 'EmailCampaign ID', type: 'number' }),
+      handler: stepStatsHandler,
+    })
+    .demandCommand(1, 'Specify a subcommand. Try: velaro email-campaign --help'),
+  handler: () => {},
+};

package/lib/commands/email-inbox.js

@@ -0,0 +1,88 @@
+import { messagingGet, messagingPatch, messagingDel } from '../api.js';
+import { runCommand } from '../run.js';
+
+// ── velaro email-inbox ────────────────────────────────────────────────────────
+// Staff commands to manage Gmail/Outlook inbox mailbox connections for any site.
+// Requires a Velaro internal-staff JWT (site 1032) or vel_live_* service key bound
+// to site 1032 — same gate as every other SupportTools/sites/{siteId}/... endpoint.
+//
+// Backed by velaro-messaging SupportToolsController's email-inbox endpoints:
+//   GET    SupportTools/sites/{siteId}/email-inbox/{provider}/list
+//   GET    SupportTools/sites/{siteId}/email-inbox/gmail/config-status
+//   PATCH  SupportTools/sites/{siteId}/email-inbox/{provider}/{id}/team
+//   DELETE SupportTools/sites/{siteId}/email-inbox/{provider}/{id}
+
+function providerOption(y) {
+  return y.option('provider', {
+    type: 'string', choices: ['gmail', 'outlook'], demandOption: true,
+    describe: 'Which inbox integration',
+  });
+}
+
+function printMailboxes(provider, siteId, mailboxes) {
+  if (!Array.isArray(mailboxes) || mailboxes.length === 0) {
+    console.log(`\nSite ${siteId}: no ${provider} mailboxes connected.\n`);
+    return;
+  }
+  console.log(`\nSite ${siteId} — ${provider} mailboxes:\n`);
+  for (const m of mailboxes) {
+    const team = m.teamName ? m.teamName : (m.TeamId || m.teamId ? `team #${m.TeamId ?? m.teamId}` : '(no team — site default)');
+    const status = (m.IsEnabled ?? m.isEnabled) ? 'enabled' : 'disabled';
+    console.log(`  #${m.Id ?? m.id}  ${m.MailboxEmail ?? m.mailboxEmail}  [${status}]  ${team}`);
+  }
+  console.log('');
+}
+
+export const emailInboxCommand = {
+  command:  'email-inbox <subcommand>',
+  describe: 'Manage Gmail/Outlook inbox mailbox connections for any site (Velaro staff only)',
+  builder:  yargs => yargs
+    .command({
+      command:  'list',
+      describe: 'List mailboxes connected for a site',
+      builder:  y => providerOption(y)
+        .option('site', { type: 'number', demandOption: true, describe: 'Site ID' }),
+      handler:  runCommand(async argv => {
+        const mailboxes = await messagingGet(`/SupportTools/sites/${argv.site}/email-inbox/${argv.provider}/list`);
+        printMailboxes(argv.provider, argv.site, mailboxes);
+      }),
+    })
+    .command({
+      command:  'status',
+      describe: 'Show global Gmail OAuth/DWD/Pub-Sub config status (gmail only — Outlook has no global status endpoint, use "list")',
+      builder:  y => y.option('site', { type: 'number', demandOption: true, describe: 'Site ID (accepted for a uniform call shape; global config is not per-site)' }),
+      handler:  runCommand(async argv => {
+        const status = await messagingGet(`/SupportTools/sites/${argv.site}/email-inbox/gmail/config-status`);
+        console.log(`\nGmail global config status:`);
+        console.log(`  OAuth configured:   ${status.oauthConfigured ? 'yes' : 'no'}`);
+        console.log(`  DWD configured:     ${status.dwdConfigured ? 'yes' : 'no'}`);
+        console.log(`  Pub/Sub configured: ${status.pubSubConfigured ? 'yes' : 'no'}\n`);
+      }),
+    })
+    .command({
+      command:  'set-team',
+      describe: 'Reassign (or clear) the team a mailbox routes inbound mail to',
+      builder:  y => providerOption(y)
+        .option('site',    { type: 'number', demandOption: true, describe: 'Site ID' })
+        .option('id',      { type: 'number', demandOption: true, describe: 'Mailbox integration ID (from "list")' })
+        .option('team-id', { type: 'number', demandOption: true, describe: 'Team ID to assign, or 0 to clear (site default/catch-all)' }),
+      handler:  runCommand(async argv => {
+        await messagingPatch(`/SupportTools/sites/${argv.site}/email-inbox/${argv.provider}/${argv.id}/team`, { teamId: argv['team-id'] });
+        console.log(argv['team-id'] === 0
+          ? `\n✓ Mailbox #${argv.id} (${argv.provider}) team assignment cleared — now routes to site default.\n`
+          : `\n✓ Mailbox #${argv.id} (${argv.provider}) reassigned to team ${argv['team-id']}.\n`);
+      }),
+    })
+    .command({
+      command:  'disconnect',
+      describe: 'Disconnect and remove a mailbox connection',
+      builder:  y => providerOption(y)
+        .option('site', { type: 'number', demandOption: true, describe: 'Site ID' })
+        .option('id',   { type: 'number', demandOption: true, describe: 'Mailbox integration ID (from "list")' }),
+      handler:  runCommand(async argv => {
+        await messagingDel(`/SupportTools/sites/${argv.site}/email-inbox/${argv.provider}/${argv.id}`);
+        console.log(`\n✓ Mailbox #${argv.id} (${argv.provider}) disconnected from site ${argv.site}.\n`);
+      }),
+    })
+    .demandCommand(1, 'Specify a subcommand: list | status | set-team | disconnect'),
+};