@velaro/cli 1.4.81 → 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';
@@ -105,6 +106,7 @@ import { featureDiscoveryCommand }  from '../lib/commands/feature-discovery.js';
 import { tourPolicyCommand }  from '../lib/commands/tour-policy.js';
 import { scraperCommand }      from '../lib/commands/scraper.js';
 import { campaignsCommand }         from '../lib/commands/campaigns.js';
+import { senderDomainHealthCommand } from '../lib/commands/sender-domain-health.js';
 import { contactsCommand }          from '../lib/commands/contacts.js';
 import { contactListCommand }       from '../lib/commands/contact-list.js';
 import { startUpdateCheck }  from '../lib/update-check.js';
@@ -211,6 +213,7 @@ await yargs(hideBin(process.argv))
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
   .command(statusPageCommand)
+  .command(statusNotifyCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)
@@ -223,6 +226,7 @@ await yargs(hideBin(process.argv))
   .command({ command: 'scraper', desc: 'Velaro staff: scraper / upload / chunk usage for any site', builder: scraperCommand, handler: () => {} })
   .command({ command: 'tour-policy', desc: 'Velaro staff: guided-tour auto-open policy (versioned, rollback-able)', builder: tourPolicyCommand, handler: () => {} })
   .command(campaignsCommand)
+  .command(senderDomainHealthCommand)
   .command(contactsCommand)
   .command(contactListCommand)
   .demandCommand(1, 'Specify a command. Run "velaro --help" for options.')

package/lib/commands/sender-domain-health.js

@@ -0,0 +1,58 @@
+/**
+ * velaro sender-domain-health - registration expiry, DNS and email-provider state for your sending domains
+ *
+ *   velaro sender-domain-health show        Health + plain-language history
+ *   velaro sender-domain-health settings    View or change warning days / grace days
+ */
+import { request } from '../api.js';
+import { runCommand } from '../run.js';
+
+async function showHandler() {
+  const r = await request('GET', '/SenderDomains/Health');
+  const domains = r.domains ?? [];
+  if (domains.length === 0) { console.log('No sender domains.'); return; }
+  for (const d of domains) {
+    const exp = d.registrationExpiresOn ? `${d.registrationExpiresOn.slice(0, 10)} (${d.daysToExpiry} days)` : 'unknown';
+    console.log(`${d.domainName}  [${d.healthStatus}]  status=${d.status}  registration expires: ${exp}`);
+    if (d.healthDetail) console.log(`   ${d.healthDetail}`);
+  }
+  const open = r.notices ?? [];
+  if (open.length) {
+    console.log('\nAction needed:');
+    for (const n of open) console.log(` - ${n.domainName}: ${n.message}\n     What to do: ${n.remedy}`);
+  }
+  console.log(`\nWarnings start at ${r.settings.thresholds.join('/')} days; sending pauses ${r.settings.graceDays} days after expiry${r.settings.usingAccountDefault ? ' (account default)' : ''}.`);
+}
+
+async function settingsHandler(argv) {
+  if (argv.reset) { console.log(JSON.stringify(await request('PUT', '/SenderDomains/Health/Settings', { reset: true }))); return; }
+  if (argv.thresholds === undefined && argv.graceDays === undefined) {
+    const r = await request('GET', '/SenderDomains/Health');
+    console.log(JSON.stringify(r.settings, null, 2));
+    return;
+  }
+  console.log(JSON.stringify(await request('PUT', '/SenderDomains/Health/Settings', { thresholds: argv.thresholds, graceDays: argv.graceDays })));
+}
+
+async function dismissHandler(argv) {
+  console.log(JSON.stringify(await request('POST', `/SenderDomains/Health/Events/${argv.id}/Dismiss`, {})));
+}
+
+export const senderDomainHealthCommand = {
+  command: 'sender-domain-health <subcommand>',
+  describe: 'Sender domain health: registration expiry, DNS, email-provider state',
+  builder: y => y
+    .command({ command: 'show', describe: 'Health and history for your sender domains', handler: runCommand(showHandler) })
+    .command({
+      command: 'settings', describe: 'View or change warning days and grace days',
+      builder: yy => yy
+        .option('thresholds', { type: 'string', describe: 'Comma-separated days before expiry, e.g. 60,30,14,7,3,1' })
+        .option('grace-days', { type: 'number', describe: 'Days after expiry before sending pauses (0-90)' })
+        .option('reset', { type: 'boolean', describe: 'Go back to the account default' }),
+      handler: runCommand(settingsHandler),
+    })
+    .command({ command: 'dismiss <id>', describe: 'Dismiss a notice (do not remind me)', handler: runCommand(dismissHandler) })
+    .demandCommand(1, 'Specify a subcommand: show | settings | dismiss')
+    .strict(),
+  handler: () => {},
+};

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