@velaro/cli 1.4.81 → 1.4.82

package/bin/velaro.js

@@ -105,6 +105,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';
@@ -223,6 +224,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/package.json

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