@velaro/cli 0.1.2 → 0.3.0

package/lib/commands/check.js

@@ -0,0 +1,163 @@
+/**
+ * velaro check — full site health and configuration summary.
+ *
+ * Shows every feature area with:
+ *   ✓  enabled and configured
+ *   ⚠  enabled but nothing configured yet
+ *   ✗  not on your plan
+ */
+
+import { get }        from '../api.js';
+import { getSubscription } from '../subscription.js';
+import { runCommand } from '../run.js';
+
+const TICK  = '✓';
+const WARN  = '⚠';
+const CROSS = '✗';
+
+export const checkCommand = {
+  command:  'check',
+  describe: 'Show full site configuration and health summary',
+  handler:  runCommand(async () => {
+    const [sub, apiStatus] = await Promise.all([
+      getSubscription().catch(() => null),
+      get('/Status').catch(() => null),
+    ]);
+
+    if (!sub) {
+      console.error('Could not retrieve subscription. Check your login: velaro whoami');
+      process.exit(1);
+    }
+
+    const ok  = (msg) => console.log(`  ${TICK}  ${msg}`);
+    const warn = (msg) => console.log(`  ${WARN}  ${msg}`);
+    const off  = (msg) => console.log(`  ${CROSS}  ${msg}`);
+
+    console.log('\n── API Health ────────────────────────────────────────────────');
+    if (apiStatus) {
+      ok(`API reachable`);
+    } else {
+      warn('API did not respond to /Status');
+    }
+
+    // ── Deployments ─────────────────────────────────────────────────────────
+    console.log('\n── Deployments ───────────────────────────────────────────────');
+    try {
+      const [deps, teams] = await Promise.all([get('/Deployment'), get('/Teams/List')]);
+      const teamMap = Object.fromEntries((teams ?? []).map(t => [t.id, t.name]));
+      if (deps?.length) {
+        for (const d of deps) {
+          ok(`[${d.id}] "${d.displayName}"  →  team: ${teamMap[d.teamId] ?? `#${d.teamId}`}  (embed key: ${d.deploymentId})`);
+        }
+      } else {
+        warn('No deployments — create one in the admin UI to get your embed snippet.');
+      }
+    } catch { warn('Could not load deployments'); }
+
+    // ── AI Bots ──────────────────────────────────────────────────────────────
+    console.log('\n── AI Bots ───────────────────────────────────────────────────');
+    if (sub.enableAI) {
+      try {
+        const bots = await get('/AIConfiguration/list');
+        if (bots?.length) {
+          for (const b of bots) ok(`[${b.id}] "${b.name}"  model=${b.aiModel ?? 'default'}`);
+        } else {
+          warn('AI enabled but no bots configured. Run: velaro bot setup --name "My Bot"');
+        }
+      } catch { warn('Could not load bot list'); }
+    } else {
+      off('AI Bots — not on your plan  (upgrade at velaro.com/pricing)');
+    }
+
+    // ── Knowledge Base ───────────────────────────────────────────────────────
+    console.log('\n── Knowledge Base ────────────────────────────────────────────');
+    if (sub.enableKnowledgeBase) {
+      try {
+        const [qna, overrides] = await Promise.all([
+          get('/api/BotQnA').catch(() => []),
+          get('/Ticket/knowledge-overrides').catch(() => []),
+        ]);
+        ok(`${qna?.length ?? 0} Q&A pair(s)  ·  ${overrides?.length ?? 0} override(s)`);
+      } catch { warn('Could not load knowledge base'); }
+    } else {
+      off('Knowledge Base — not on your plan');
+    }
+
+    // ── Workflows ────────────────────────────────────────────────────────────
+    console.log('\n── Workflows ─────────────────────────────────────────────────');
+    if (sub.enableAutomation) {
+      try {
+        const workflows = (await get('/Workflows/List') ?? []).filter(w => !w.isTemplate);
+        const enabled   = workflows.filter(w => w.enabled).length;
+        const disabled  = workflows.length - enabled;
+        if (workflows.length) {
+          ok(`${workflows.length} workflow(s)  ·  ${enabled} enabled  ·  ${disabled} disabled`);
+          for (const w of workflows) {
+            const sym = w.enabled ? TICK : WARN;
+            console.log(`       ${sym}  [${w.id}] "${w.name}"  (${w.enabled ? 'on' : 'off'})`);
+          }
+        } else {
+          warn('Automation enabled but no workflows configured.');
+        }
+      } catch { warn('Could not load workflows'); }
+    } else {
+      off('Workflows — not on your plan');
+    }
+
+    // ── Routing Rules ────────────────────────────────────────────────────────
+    console.log('\n── Routing Rules ─────────────────────────────────────────────');
+    if (sub.enableWorkflowRules) {
+      try {
+        const rules = await get('/Rules/List');
+        if (rules?.length) {
+          ok(`${rules.length} routing rule(s) configured`);
+        } else {
+          warn('Routing rules enabled but none configured.');
+        }
+      } catch { warn('Could not load rules'); }
+    } else {
+      off('Routing Rules — not on your plan');
+    }
+
+    // ── Channels ─────────────────────────────────────────────────────────────
+    console.log('\n── Channels ──────────────────────────────────────────────────');
+    const channels = [
+      ['enableWeb',       'Web Chat'],
+      ['enableSms',       'SMS'],
+      ['enableEmail',     'Email'],
+      ['enableWhatsapp',  'WhatsApp'],
+      ['enableIvr',       'IVR / Voice'],
+      ['enableFacebook',  'Facebook Messenger'],
+      ['enableInstagram', 'Instagram'],
+      ['enableRcs',       'RCS'],
+    ];
+    for (const [flag, label] of channels) {
+      if (sub[flag]) ok(label); else off(`${label} — not on your plan`);
+    }
+
+    // ── IVR detail ───────────────────────────────────────────────────────────
+    if (sub.enableIvr) {
+      try {
+        const ivr = await get('/api/ivr/config');
+        if (ivr?.phoneNumber) {
+          console.log(`\n── IVR Config ────────────────────────────────────────────────`);
+          ok(`Phone: ${ivr.phoneNumber}`);
+          if (ivr.bridgeNumber) ok(`Bridge: ${ivr.bridgeNumber}`);
+          else warn('No bridge (transfer) number set — agents cannot receive transferred calls.');
+        }
+      } catch { /* IVR config is optional */ }
+    }
+
+    // ── Agents ───────────────────────────────────────────────────────────────
+    console.log('\n── Agents ────────────────────────────────────────────────────');
+    try {
+      const agents = await get('/Users/List');
+      const online  = (agents ?? []).filter(a => a.status === 'Available').length;
+      const away    = (agents ?? []).filter(a => a.status === 'Away').length;
+      const offline = (agents ?? []).length - online - away;
+      ok(`${agents?.length ?? 0} agent(s)  ·  ${online} online  ·  ${away} away  ·  ${offline} offline`);
+    } catch { warn('Could not load agents'); }
+
+    console.log('\n──────────────────────────────────────────────────────────────\n');
+  }),
+};

package/lib/commands/deployment.js

@@ -0,0 +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}".`);
+  }),
+};

package/lib/commands/kb.js

@@ -0,0 +1,241 @@
+import { readFileSync }    from 'fs';
+import { basename }        from 'path';
+import { get, post, del }  from '../api.js';
+import { requireFeature }  from '../subscription.js';
+import { runCommand }      from '../run.js';
+import { articleCommand }  from './article.js';
+
+export const kbCommand = {
+  command:  'kb <subcommand>',
+  describe: 'Manage knowledge base — articles, Q&A pairs, bot overrides, and custom content',
+  builder:  (yargs) =>
+    yargs
+      .command(articleCommand)
+      .command(qnaCommand)
+      .command(overrideCommand)
+      .command(contentCommand)
+      .demandCommand(1, 'Specify a subcommand: article, qna, override, content'),
+  handler: () => {},
+};
+
+// ────────────────────────────────────────────────────────────────────────────
+// Q&A
+// ────────────────────────────────────────────────────────────────────────────
+
+const qnaCommand = {
+  command:  'qna <subcommand>',
+  describe: 'Manage Q&A knowledge pairs',
+  builder:  (yargs) =>
+    yargs
+      .command({
+        command:  'list',
+        describe: 'List Q&A pairs',
+        builder:  (y) => y.option('bot-id', { type: 'number', describe: 'Filter by bot ID' }),
+        handler:  runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          const params = argv['bot-id'] ? `?aiConfigurationId=${argv['bot-id']}` : '';
+          const items  = await get(`/api/BotQnA${params}`);
+          if (!items?.length) { console.log('No Q&A pairs found.'); return; }
+
+          console.log(`\nFound ${items.length} Q&A pair(s):\n`);
+          for (const item of items) {
+            console.log(`  [${item.id}] Q: ${truncate(item.question, 70)}`);
+            console.log(`       A: ${truncate(item.answer, 70)}\n`);
+          }
+        }),
+      })
+      .command({
+        command:  'add',
+        describe: 'Add a Q&A pair',
+        builder:  (y) =>
+          y
+            .option('bot-id',   { type: 'number', demandOption: true, describe: 'Bot ID' })
+            .option('question', { type: 'string', demandOption: true, describe: 'Question text' })
+            .option('answer',   { type: 'string', demandOption: true, describe: 'Answer text' }),
+        handler: runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          const result = await post('/api/BotQnA', {
+            aiConfigurationId: argv['bot-id'],
+            question:          argv.question,
+            answer:            argv.answer,
+          });
+          console.log(`Q&A pair added: [${result.id}]`);
+        }),
+      })
+      .command({
+        command:  'delete <id>',
+        describe: 'Delete a Q&A pair',
+        builder:  (y) => y.positional('id', { type: 'number', describe: 'Q&A pair ID' }),
+        handler: runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          await del(`/api/BotQnA/${argv.id}`);
+          console.log(`Q&A pair ${argv.id} deleted.`);
+        }),
+      })
+      .demandCommand(1, 'Specify a subcommand: list, add, delete'),
+  handler: () => {},
+};
+
+// ────────────────────────────────────────────────────────────────────────────
+// Overrides — authoritative facts that take priority over KB search
+// ────────────────────────────────────────────────────────────────────────────
+
+const overrideCommand = {
+  command:  'override <subcommand>',
+  describe: 'Manage bot knowledge overrides (authoritative facts)',
+  builder:  (yargs) =>
+    yargs
+      .command({
+        command:  'list',
+        describe: 'List knowledge overrides',
+        handler:  runCommand(async () => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          const items = await get('/Ticket/knowledge-overrides');
+          if (!items?.length) { console.log('No overrides found.'); return; }
+
+          console.log(`\nFound ${items.length} override(s):\n`);
+          for (const item of items) {
+            const status = item.isActive ? 'active  ' : 'inactive';
+            const expiry = item.expiresAt ? `  expires ${new Date(item.expiresAt).toLocaleDateString()}` : '';
+            console.log(`  [${item.id}] ${status}  ${truncate(item.title ?? item.content, 60)}${expiry}`);
+          }
+        }),
+      })
+      .command({
+        command:  'add',
+        describe: 'Add a knowledge override',
+        builder:  (y) =>
+          y
+            .option('title',   { type: 'string', demandOption: true, describe: 'Override title' })
+            .option('content', { type: 'string', demandOption: true, describe: 'Authoritative content' })
+            .option('expires', { type: 'string',                     describe: 'Expiry date (ISO 8601, e.g. 2026-12-31)' }),
+        handler: runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          const payload = { title: argv.title, content: argv.content, isActive: true };
+          if (argv.expires) payload.expiresAt = new Date(argv.expires).toISOString();
+          const result = await post('/Ticket/knowledge-overrides', payload);
+          console.log(`Override added: [${result.id}] "${argv.title}"`);
+        }),
+      })
+      .command({
+        command:  'delete <id>',
+        describe: 'Delete a knowledge override',
+        builder:  (y) => y.positional('id', { type: 'number', describe: 'Override ID' }),
+        handler: runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          await del(`/Ticket/knowledge-overrides/${argv.id}`);
+          console.log(`Override ${argv.id} deleted.`);
+        }),
+      })
+      .demandCommand(1, 'Specify a subcommand: list, add, delete'),
+  handler: () => {},
+};
+
+// ────────────────────────────────────────────────────────────────────────────
+// Custom content — push arbitrary text/files into the site's KB index
+// ────────────────────────────────────────────────────────────────────────────
+// Note: content goes into the site's default index (determined server-side by
+// SiteId). Index selection is not yet supported by this API endpoint.
+
+const contentCommand = {
+  command:  'content <subcommand>',
+  describe: 'Push custom text or files into the knowledge base index',
+  builder:  (yargs) =>
+    yargs
+      .command({
+        command:  'ingest',
+        describe: 'Push a file or text snippet into the KB index',
+        builder:  (y) =>
+          y
+            .option('file', {
+              describe: 'Path to a .txt or .md file to ingest',
+              type:     'string',
+            })
+            .option('text', {
+              describe: 'Inline text content to ingest (alternative to --file)',
+              type:     'string',
+            })
+            .option('content-id', {
+              describe: 'Stable ID for this document (used for dedup/updates). Defaults to filename.',
+              type:     'string',
+            })
+            .option('title', {
+              describe: 'Document title shown when bot attributes this content. Defaults to filename.',
+              type:     'string',
+            })
+            .option('source-url', {
+              describe: 'Canonical URL to show when bot cites this content',
+              type:     'string',
+            })
+            .check((argv) => {
+              if (!argv.file && !argv.text) throw new Error('Provide either --file or --text');
+              if (argv.file && argv.text)   throw new Error('Use --file or --text, not both');
+              return true;
+            }),
+        handler: runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+
+          let text, defaultId, defaultTitle;
+          if (argv.file) {
+            text         = readFileSync(argv.file, 'utf8');
+            defaultId    = basename(argv.file);
+            defaultTitle = basename(argv.file);
+          } else {
+            text         = argv.text;
+            defaultId    = `inline-${Date.now()}`;
+            defaultTitle = defaultId;
+          }
+
+          const contentId = argv['content-id'] || defaultId;
+          const title     = argv.title          || defaultTitle;
+
+          const result = await post('/AzureIndexes/IngestContent', {
+            contentId,
+            title,
+            text,
+            sourceUrl: argv['source-url'] || undefined,
+          });
+
+          if (result.unchanged) {
+            console.log(`Unchanged: "${title}" — content hash matches, no re-embedding needed.`);
+          } else {
+            console.log(`Indexed:   "${title}"  [${contentId}]`);
+            console.log(`           ${result.chunks} chunk(s) embedded and searchable immediately.`);
+          }
+        }),
+      })
+      .command({
+        command:  'list',
+        describe: 'List all custom content documents in the KB index',
+        handler:  runCommand(async () => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          const items = await get('/AzureIndexes/IngestContent');
+          if (!items?.length) { console.log('No custom content found.'); return; }
+
+          console.log(`\nFound ${items.length} document(s):\n`);
+          for (const item of items) {
+            const indexed = item.lastIndexedAt ? new Date(item.lastIndexedAt).toLocaleDateString() : 'never';
+            const status  = item.lastError ? `  error: ${item.lastError}` : '';
+            console.log(`  [${item.contentId}]  chunks=${item.chunkCount ?? '?'}  indexed=${indexed}${status}`);
+            if (item.title && item.title !== item.contentId) console.log(`    "${item.title}"`);
+          }
+        }),
+      })
+      .command({
+        command:  'remove <content-id>',
+        describe: 'Remove a custom content document from the KB index',
+        builder:  (y) => y.positional('content-id', { type: 'string', describe: 'Content ID to remove' }),
+        handler:  runCommand(async (argv) => {
+          await requireFeature('enableKnowledgeBase', 'Knowledge Base');
+          await del(`/AzureIndexes/IngestContent/${encodeURIComponent(argv['content-id'])}`);
+          console.log(`Removed "${argv['content-id']}" from the index.`);
+        }),
+      })
+      .demandCommand(1, 'Specify a subcommand: ingest, list, remove'),
+  handler: () => {},
+};
+
+function truncate(str, max) {
+  if (!str) return '—';
+  return str.length <= max ? str : str.slice(0, max - 1) + '…';
+}

package/lib/commands/login.js

@@ -1,53 +1,60 @@
-import { requestDeviceCode, pollForToken, exchangeForVelaroToken } from '../oauth.js';
-import { readConfig, writeConfig, DEFAULT_API_BASE }               from '../config.js';
-import { runCommand }                                               from '../run.js';
-
-export const loginCommand = {
-  command:  'login',
-  describe: 'Authenticate with Velaro using your browser',
-  builder:  (y) =>
-    y.option('api', {
-      describe: 'Velaro Messaging API base URL',
-      default:  DEFAULT_API_BASE,
-      type:     'string',
-    }),
-
-  handler: runCommand(async (argv) => {
-    const apiBase = argv.api;
-
-    console.log('Starting Velaro login...\n');
-
-    const deviceData = await requestDeviceCode();
-
-    console.log(`  Open:  ${deviceData.verification_uri}`);
-    console.log(`  Enter: ${deviceData.user_code}\n`);
-    console.log('Waiting for you to complete login in your browser...');
-
-    const entraTokens  = await pollForToken(deviceData.device_code, deviceData.interval ?? 5);
-    const velaroResult = await exchangeForVelaroToken(entraTokens.access_token, apiBase);
-
-    writeConfig({
-      ...readConfig(),
-      apiBase,
-      velaroToken:       velaroResult.token.token,
-      velaroExpires:     velaroResult.token.expires,
-      entraRefreshToken: entraTokens.refresh_token,
-      siteId:            velaroResult.profile?.SiteId,
-      userName:          velaroResult.profile?.Name,
-    });
-
-    console.log(`\nLogged in as ${velaroResult.profile?.Name ?? velaroResult.profile?.UserName}`);
-    console.log(`Site ID: ${velaroResult.profile?.SiteId}`);
-    console.log('Credentials saved to ~/.velaro/config.json');
-  }),
-};
-
-export const logoutCommand = {
-  command:  'logout',
-  describe: 'Clear stored credentials',
-  handler:  runCommand(async () => {
-    const { clearConfig } = await import('../config.js');
-    clearConfig();
-    console.log('Logged out. Credentials removed from ~/.velaro/config.json');
-  }),
-};
+import { requestDeviceCode, pollForToken, exchangeForVelaroToken } from '../oauth.js';
+import { readConfig, writeConfig, DEFAULT_API_BASE, STAGING_API_BASE } from '../config.js';
+import { runCommand }                                               from '../run.js';
+
+export const loginCommand = {
+  command:  'login',
+  describe: 'Authenticate with Velaro using your browser',
+  builder:  (y) =>
+    y
+      .option('staging', {
+        describe: 'Connect to the Velaro staging environment',
+        type:     'boolean',
+        default:  false,
+      })
+      .option('api', {
+        describe: 'Override the Velaro API base URL. Set VELARO_API_BASE env var to make it permanent. ' +
+                  'Production cutover: set this to your production API URL before going live.',
+        type:     'string',
+      }),
+
+  handler: runCommand(async (argv) => {
+    const apiBase = argv.api ?? (argv.staging ? STAGING_API_BASE : DEFAULT_API_BASE);
+
+    console.log('Starting Velaro login...\n');
+
+    const deviceData = await requestDeviceCode();
+
+    console.log(`  Open:  ${deviceData.verification_uri}`);
+    console.log(`  Enter: ${deviceData.user_code}\n`);
+    console.log('Waiting for you to complete login in your browser...');
+
+    const entraTokens  = await pollForToken(deviceData.device_code, deviceData.interval ?? 5);
+    const velaroResult = await exchangeForVelaroToken(entraTokens.access_token, apiBase);
+
+    writeConfig({
+      ...readConfig(),
+      apiBase,
+      velaroToken:       velaroResult.token.token,
+      velaroExpires:     velaroResult.token.expires,
+      entraRefreshToken: entraTokens.refresh_token,
+      siteId:            velaroResult.profile?.SiteId,
+      userName:          velaroResult.profile?.Name,
+    });
+
+    const envLabel = argv.staging || argv.api ? ` (${apiBase})` : '';
+    console.log(`\nLogged in as ${velaroResult.profile?.Name ?? velaroResult.profile?.UserName}${envLabel}`);
+    console.log(`Site ID: ${velaroResult.profile?.SiteId}`);
+    console.log('Credentials saved to ~/.velaro/config.json');
+  }),
+};
+
+export const logoutCommand = {
+  command:  'logout',
+  describe: 'Clear stored credentials',
+  handler:  runCommand(async () => {
+    const { clearConfig } = await import('../config.js');
+    clearConfig();
+    console.log('Logged out. Credentials removed from ~/.velaro/config.json');
+  }),
+};