@velaro/cli 1.4.86 → 1.4.88

package/bin/velaro.js

@@ -29,6 +29,7 @@ import { aiConfigCommand }   from '../lib/commands/ai-config.js';
 import { deploymentCommand } from '../lib/commands/deployment.js';
 import { updateCommand }     from '../lib/commands/update.js';
 import { agentCommand }      from '../lib/commands/agent.js';
+import { linkedIdentityCommand } from '../lib/commands/linked-identity.js';
 import { notificationsCommand } from '../lib/commands/notifications.js';
 import { articleCommand }    from '../lib/commands/article.js';
 import { sharepointCommand } from '../lib/commands/sharepoint.js';
@@ -94,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';
@@ -153,6 +155,7 @@ await yargs(hideBin(process.argv))
   .command(deploymentCommand)
   .command(updateCommand)
   .command(agentCommand)
+  .command(linkedIdentityCommand)
   .command(notificationsCommand)
   .command(articleCommand)
   .command(sharepointCommand)
@@ -220,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/linked-identity.js

@@ -0,0 +1,41 @@
+import { messagingGet, messagingDel } from '../api.js';
+import { runCommand } from '../run.js';
+
+function fmtDate(value) {
+  if (!value) return '—';
+  const d = new Date(value);
+  return Number.isNaN(d.getTime()) ? String(value) : d.toISOString().replace('T', ' ').slice(0, 16) + 'Z';
+}
+
+export const linkedIdentityCommand = {
+  command: 'linked-identity <subcommand>',
+  describe: 'See and remove the Google / Microsoft / company sign-in methods linked to your site\'s users',
+  builder: (yargs) => yargs
+    .command({
+      command: 'list',
+      describe: 'List linked sign-in methods. Use when offboarding: disabling a person does not stop a linked Google sign-in.',
+      handler: runCommand(async () => {
+        const rows = await messagingGet('/admin/security/linked-identities');
+        if (!Array.isArray(rows) || rows.length === 0) {
+          console.log('No linked sign-in methods.');
+          return;
+        }
+        const emailW = Math.max(...rows.map(r => (r.userEmail ?? '').length), 5);
+        for (const r of rows) {
+          console.log(`[${String(r.id).padStart(4)}]  ${(r.userEmail ?? '—').padEnd(emailW)}  ${(r.method ?? r.idpKind).padEnd(24)}  linked ${fmtDate(r.linkedAt)}  last used ${fmtDate(r.lastLoginAt)}`);
+        }
+        console.log(`\n${rows.length} linked sign-in method(s)`);
+      }),
+    })
+    .command({
+      command: 'remove <id>',
+      describe: 'Remove one linked sign-in method by id (from `list`). The person keeps any other way they can sign in.',
+      builder: (y) => y.positional('id', { describe: 'Link id from `linked-identity list`', type: 'number' }),
+      handler: runCommand(async (argv) => {
+        if (!Number.isInteger(argv.id) || argv.id <= 0) throw new Error('id must be a positive whole number.');
+        await messagingDel(`/admin/security/linked-identities/${argv.id}`);
+        console.log(`Removed linked sign-in method ${argv.id}.`);
+      }),
+    })
+    .demandCommand(1),
+};

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.86",
+  "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": {