@velaro/cli 1.4.87 → 1.4.88

package/bin/velaro.js

@@ -95,6 +95,7 @@ import { diagnosticsCommand }       from '../lib/commands/diagnostics.js';
 import { aiSpendCommand }           from '../lib/commands/ai-spend.js';
 import { statusPageCommand }        from '../lib/commands/status-page.js';
 import { statusNotifyCommand }      from '../lib/commands/status-notify.js';
+import { statusSlaCommand }         from '../lib/commands/status-sla.js';
 import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -222,6 +223,7 @@ await yargs(hideBin(process.argv))
   .command(aiSpendCommand)
   .command(statusPageCommand)
   .command(statusNotifyCommand)
+  .command(statusSlaCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)

package/lib/api.js

@@ -90,3 +90,18 @@ export const messagingPost  = (path, body) => messagingRequest('POST', path, bod
 export const messagingPut   = (path, body) => messagingRequest('PUT',  path, body);
 export const messagingPatch = (path, body) => messagingRequest('PATCH', path, body);
 export const messagingDel   = (path)       => messagingRequest('DELETE', path);
+
+// Same as messagingRequest but returns the raw response text (for CSV downloads).
+export async function messagingRequestText(method, path, envOverride) {
+  const creds = await getCredentials(envOverride);
+  const res = await fetch(joinUrl(creds.messagingApiBase, path), {
+    method,
+    headers: {
+      Authorization: `Bearer ${creds.velaroToken}`,
+      ...(creds.siteId ? { 'vmsg-siteId': String(creds.siteId) } : {}),
+    },
+  });
+  const text = await res.text();
+  if (!res.ok) throw new Error(`${method} ${path} -> ${res.status}${text ? `: ${text}` : ''}`);
+  return text;
+}

package/lib/commands/status-sla.js

@@ -0,0 +1,47 @@
+import { writeFileSync } from 'node:fs';
+import { messagingRequest, messagingRequestText } from '../api.js';
+
+// Staff SLA report for the public status page (velaro-messaging SuperAdmin/status-sla).
+// Endpoint is live only after velaro-messaging PR 2223 is deployed.
+
+export function buildStatusSlaQuery(argv) {
+  const p = new URLSearchParams();
+  if (argv.from) p.set('from', argv.from);
+  if (argv.to) p.set('to', argv.to);
+  p.set('platform', argv.platform || 'v20');
+  if (argv.includeMaintenance) p.set('includeMaintenance', 'true');
+  if (argv.includeDeployments) p.set('includeDeployments', 'true');
+  if (argv.includeExcludedChecks) p.set('includeExcludedChecks', 'true');
+  if (argv.degradedDown) p.set('degradedCountsAsDown', 'true');
+  if (argv.slowMs !== undefined) p.set('slowResponseMs', String(argv.slowMs));
+  p.set('format', argv.csv ? 'csv' : 'json');
+  return p.toString();
+}
+
+export const statusSlaCommand = {
+  command: 'status-sla',
+  describe: 'SLA / uptime report for the status page, per component (staff only)',
+  builder: (y) => y
+    .option('from', { type: 'string', demandOption: true, describe: 'Start date (YYYY-MM-DD)' })
+    .option('to', { type: 'string', demandOption: true, describe: 'End date (YYYY-MM-DD)' })
+    .option('platform', { type: 'string', default: 'v20', choices: ['v20', 'v11'] })
+    .option('include-maintenance', { type: 'boolean', default: false, describe: 'Count scheduled maintenance as downtime' })
+    .option('include-deployments', { type: 'boolean', default: false, describe: 'Count deployment windows as downtime' })
+    .option('include-excluded-checks', { type: 'boolean', default: false })
+    .option('degraded-down', { type: 'boolean', default: false, describe: 'Degraded counts as down' })
+    .option('slow-ms', { type: 'number', describe: 'Responses slower than this many ms count as slow' })
+    .option('csv', { type: 'boolean', default: false, describe: 'CSV output (stdout, or --out file)' })
+    .option('out', { type: 'string', describe: 'Write CSV to this file' })
+    .option('staging', { type: 'boolean', default: false, describe: 'Use the staging messaging API' }),
+  handler: async (argv) => {
+    const path = `SuperAdmin/status-sla?${buildStatusSlaQuery(argv)}`;
+    const env = argv.staging ? 'staging' : undefined;
+    if (argv.csv) {
+      const csv = await messagingRequestText('GET', path, env);
+      if (argv.out) { writeFileSync(argv.out, csv); console.error(`Wrote ${argv.out}`); }
+      else process.stdout.write(csv);
+      return;
+    }
+    console.log(JSON.stringify(await messagingRequest('GET', path, undefined, env), null, 2));
+  },
+};

package/lib/status-sla.test.js

@@ -0,0 +1,23 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { buildStatusSlaQuery } from './commands/status-sla.js';
+
+test('status-sla query maps flags to endpoint params', () => {
+  const q = new URLSearchParams(buildStatusSlaQuery({
+    from: '2026-09-01', to: '2026-09-30', platform: 'v11', includeMaintenance: true,
+    degradedDown: true, slowMs: 1500, csv: true,
+  }));
+  assert.equal(q.get('from'), '2026-09-01');
+  assert.equal(q.get('platform'), 'v11');
+  assert.equal(q.get('includeMaintenance'), 'true');
+  assert.equal(q.get('degradedCountsAsDown'), 'true');
+  assert.equal(q.get('slowResponseMs'), '1500');
+  assert.equal(q.get('format'), 'csv');
+  assert.equal(q.get('includeDeployments'), null);
+});
+
+test('status-sla query defaults to v20 json', () => {
+  const q = new URLSearchParams(buildStatusSlaQuery({ from: 'a', to: 'b' }));
+  assert.equal(q.get('platform'), 'v20');
+  assert.equal(q.get('format'), 'json');
+});

package/package.json

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