@velaro/cli 1.4.82 → 1.4.83

package/bin/velaro.js

@@ -93,6 +93,7 @@ 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 { statusNotifyCommand }      from '../lib/commands/status-notify.js';
 import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -212,6 +213,7 @@ await yargs(hideBin(process.argv))
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
   .command(statusPageCommand)
+  .command(statusNotifyCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)

package/lib/commands/status-notify.js

@@ -0,0 +1,98 @@
+import { messagingRequest } from '../api.js';
+
+// Staff "Notify subscribers" for the public status page (velaro-messaging StatusNotificationsController).
+// Only major incidents and scheduled maintenance are ever emailed. `send` is guarded: it re-runs the preview,
+// refuses unless --confirm-count equals the live recipient count, and needs an --idempotency-key.
+
+function buildRequest(argv) {
+  const body = {};
+  if (argv.incident !== undefined) body.incidentId = argv.incident;
+  if (argv.title) {
+    body.announcement = {
+      title: argv.title,
+      impact: argv.impact ?? null,
+      components: argv.components ? String(argv.components).split(',').map((s) => s.trim()).filter(Boolean) : null,
+      windowStart: argv.windowStart ?? null,
+      windowEnd: argv.windowEnd ?? null,
+    };
+  }
+  if (argv.subject) body.subject = argv.subject;
+  if (argv.body) body.body = argv.body;
+  return body;
+}
+
+const draftOptions = (y) => y
+  .option('incident', { type: 'number', describe: 'Status incident id (use this OR --title)' })
+  .option('title', { type: 'string', describe: 'Announcement title (no incident)' })
+  .option('impact', { type: 'string' })
+  .option('components', { type: 'string', describe: 'CSV of component names' })
+  .option('window-start', { type: 'string', describe: 'ISO timestamp' })
+  .option('window-end', { type: 'string', describe: 'ISO timestamp' })
+  .option('subject', { type: 'string', describe: 'Edited subject (default: generated)' })
+  .option('body', { type: 'string', describe: 'Edited plain-text body (default: generated)' });
+
+const out = (data) => console.log(JSON.stringify(data, null, 2));
+
+const settingsCommand = {
+  command: 'settings',
+  describe: 'Show send switch, recipient cap and subscriber counts',
+  builder: (y) => y,
+  handler: async () => out(await messagingRequest('GET', '/StatusNotifications/settings')),
+};
+
+const subscribersCommand = {
+  command: 'subscribers',
+  describe: 'Confirmed / pending / unsubscribed subscriber counts',
+  builder: (y) => y,
+  handler: async () => {
+    const s = await messagingRequest('GET', '/StatusNotifications/settings');
+    console.log(`confirmed=${s.confirmedSubscribers} pending=${s.pendingSubscribers} unsubscribed=${s.unsubscribed}`);
+  },
+};
+
+const previewCommand = {
+  command: 'preview',
+  describe: 'Draft the notice and show the live recipient count. Sends nothing.',
+  builder: draftOptions,
+  handler: async (argv) => out(await messagingRequest('POST', '/StatusNotifications/preview', buildRequest(argv))),
+};
+
+const testSendCommand = {
+  command: 'test-send',
+  describe: 'Send the draft to the signed-in staff member only',
+  builder: draftOptions,
+  handler: async (argv) => out(await messagingRequest('POST', '/StatusNotifications/test-send', buildRequest(argv))),
+};
+
+const sendCommand = {
+  command: 'send',
+  describe: 'Send the notice to ALL confirmed subscribers. Requires --confirm-count (must equal the preview recipient count) and --idempotency-key.',
+  builder: (y) => draftOptions(y)
+    .option('confirm-count', { type: 'number', demandOption: true, describe: 'Recipient count from `status-notify preview`' })
+    .option('idempotency-key', { type: 'string', demandOption: true, describe: 'One key per announcement; retries never double-send' }),
+  handler: async (argv) => {
+    const req = buildRequest(argv);
+    const preview = await messagingRequest('POST', '/StatusNotifications/preview', req);
+    if (preview.recipientCount !== argv.confirmCount) {
+      console.error(`Refusing to send: --confirm-count ${argv.confirmCount} does not match live recipient count ${preview.recipientCount}. Re-run preview.`);
+      process.exitCode = 1;
+      return;
+    }
+    out(await messagingRequest('POST', '/StatusNotifications/send', { ...req, expectedRecipientCount: argv.confirmCount, idempotencyKey: argv.idempotencyKey }));
+  },
+};
+
+const auditCommand = {
+  command: 'audit',
+  describe: 'Recent send audit rows',
+  builder: (y) => y.option('take', { type: 'number', default: 50 }),
+  handler: async (argv) => out(await messagingRequest('GET', `/StatusNotifications/audit?take=${argv.take}`)),
+};
+
+export const statusNotifyCommand = {
+  command: 'status-notify <subcommand>',
+  describe: 'Status page email alerts: settings, preview, test-send, send, audit, subscribers (staff only)',
+  builder: (y) => y.command(settingsCommand).command(subscribersCommand).command(previewCommand).command(testSendCommand).command(sendCommand).command(auditCommand)
+    .demandCommand(1, 'Specify a subcommand: settings, subscribers, preview, test-send, send, audit').strict(),
+  handler: () => {},
+};

package/package.json

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