@velaro/cli 1.4.80 → 1.4.81

package/bin/velaro.js

@@ -92,6 +92,7 @@ import { supportCommand }           from '../lib/commands/support.js';
 import { routingCommand }           from '../lib/commands/routing.js';
 import { diagnosticsCommand }       from '../lib/commands/diagnostics.js';
 import { aiSpendCommand }           from '../lib/commands/ai-spend.js';
+import { statusPageCommand }        from '../lib/commands/status-page.js';
 import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -209,6 +210,7 @@ await yargs(hideBin(process.argv))
   .command(routingCommand)
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
+  .command(statusPageCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)

package/lib/commands/status-page.js

@@ -0,0 +1,95 @@
+import { messagingRequest } from '../api.js';
+
+const COMPONENTS = 'Messaging, Voice & Calls, AI Assistant, Database, API, Integrations, Email Campaigns, Velaro Sign, Velaro Forms, Agent Console, Core API, Chat Engagement';
+const TOKENS = 'AffectedServices is a comma-separated list of component names (' + COMPONENTS + ') plus optional uptime tokens: "counts-uptime" forces the incident to count against uptime, "no-uptime-impact" forces it not to. Default: only a core chat outage counts.';
+
+const listCommand = {
+  command: 'list',
+  describe: 'List status incidents (SuperAdmin, velaro-messaging GET /superadmin/status-incidents)',
+  builder: (y) => y.option('filter', { type: 'string', default: 'active', choices: ['active', 'resolved', 'all'] }).option('json', { type: 'boolean', default: false }),
+  handler: async (argv) => {
+    const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${argv.filter}`);
+    if (argv.json) { console.log(JSON.stringify(rows, null, 2)); return; }
+    for (const r of rows ?? []) console.log(`#${r.id}  ${r.status}  ${r.incidentType}/${r.severity}  ${r.title}  [${r.affectedServices ?? ''}]`);
+  },
+};
+
+const createCommand = {
+  command: 'create',
+  describe: 'Create a status incident. ' + TOKENS,
+  builder: (y) => y
+    .option('title', { type: 'string', demandOption: true })
+    .option('description', { type: 'string', default: '' })
+    .option('status', { type: 'string', default: 'Investigating', describe: 'Investigating, Identified, Monitoring, Resolved' })
+    .option('type', { type: 'string', default: 'Incident', describe: 'Incident or Maintenance' })
+    .option('severity', { type: 'string', default: 'Minor', describe: 'Minor or Major' })
+    .option('services', { type: 'string', default: '', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string', default: '' })
+    .option('exclude-from-uptime', { type: 'boolean', default: false })
+    .option('hidden', { type: 'boolean', default: false, describe: 'Hide from the public page' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-incidents', {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, excludeFromUptime: argv.excludeFromUptime, isVisibleToCustomers: !argv.hidden,
+    });
+    console.log(`Created incident #${r.id}: ${r.title}`);
+  },
+};
+
+const updateCommand = {
+  command: 'update <id>',
+  describe: 'Update a status incident (pass every field you want kept). ' + TOKENS,
+  builder: (y) => y
+    .positional('id', { type: 'number' })
+    .option('title', { type: 'string' }).option('description', { type: 'string' })
+    .option('status', { type: 'string' }).option('type', { type: 'string' }).option('severity', { type: 'string' })
+    .option('services', { type: 'string', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string' })
+    .option('end-time', { type: 'string', describe: 'ISO timestamp the incident ended' })
+    .option('exclude-from-uptime', { type: 'boolean' })
+    .option('hidden', { type: 'boolean' }),
+  handler: async (argv) => {
+    const body = {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, endTime: argv.endTime,
+      excludeFromUptime: argv.excludeFromUptime ?? false, isVisibleToCustomers: argv.hidden === undefined ? true : !argv.hidden,
+    };
+    const r = await messagingRequest('PUT', `/superadmin/status-incidents/${argv.id}`, body);
+    console.log(`Updated incident #${r?.id ?? argv.id}`);
+  },
+};
+
+const deleteCommand = {
+  command: 'delete <id>',
+  describe: 'Delete a status incident or clear an override',
+  builder: (y) => y.positional('id', { type: 'number' }),
+  handler: async (argv) => {
+    await messagingRequest('DELETE', `/superadmin/status-incidents/${argv.id}`);
+    console.log(`Deleted incident #${argv.id}`);
+  },
+};
+
+const overrideCommand = {
+  command: 'override',
+  describe: 'Force a public status page component to a status (POST /superadmin/status-overrides). Components: ' + COMPONENTS + '. Clear with: velaro status-page delete <id>',
+  builder: (y) => y
+    .option('component', { type: 'string', demandOption: true, describe: COMPONENTS })
+    .option('status', { type: 'string', demandOption: true, choices: ['operational', 'degraded', 'outage', 'maintenance'] })
+    .option('note', { type: 'string', default: '' })
+    .option('expires-at', { type: 'string', describe: 'ISO timestamp the override auto-clears' })
+    .option('counts-against-uptime', { type: 'boolean', describe: 'true adds counts-uptime, false adds no-uptime-impact; omit for default' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-overrides', {
+      component: argv.component, status: argv.status, note: argv.note, expiresAt: argv.expiresAt ?? null, countsAgainstUptime: argv.countsAgainstUptime ?? null,
+    });
+    console.log(`Override #${r.id} created: ${r.title}`);
+  },
+};
+
+export const statusPageCommand = {
+  command: 'status-page <subcommand>',
+  describe: 'Public status page incidents and component overrides (SuperAdmin only)',
+  builder: (y) => y.command(listCommand).command(createCommand).command(updateCommand).command(deleteCommand).command(overrideCommand)
+    .demandCommand(1, 'Specify a subcommand: list, create, update, delete, override').strict(),
+  handler: () => {},
+};

package/package.json

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