@velaro/cli 1.4.79 → 1.4.81

package/bin/velaro.js

@@ -92,6 +92,7 @@ import { supportCommand }           from '../lib/commands/support.js';
 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 { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
@@ -209,6 +210,7 @@ await yargs(hideBin(process.argv))
   .command(routingCommand)
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
+  .command(statusPageCommand)
   .command(emailInboxCommand)
   .command(callbackCommand)
   .command(caseCommand)

package/lib/commands/article.js

@@ -106,6 +106,48 @@ const topicsCommand = {
   }),
 };
 
+const categoriesCommand = {
+  command:  'categories',
+  describe: 'List KB categories (topics hang under a category)',
+  handler: runCommand(async () => {
+    const data = await adminRequest('GET', '/api/kb/categories');
+    const cats = data?.categories ?? [];
+    if (!cats.length) { console.log('No categories found.'); return; }
+    for (const c of cats) console.log(`  [${c.id}] ${c.name}  (priority ${c.displayPriority})`);
+  }),
+};
+
+const categoryCreateCommand = {
+  command:  'category-create',
+  describe: 'Create a KB category (seed the v20 topic tree before pushing articles)',
+  builder:  (y) =>
+    y
+      .option('name',     { type: 'string', demandOption: true, describe: 'Category name' })
+      .option('priority', { type: 'number', default: 0,         describe: 'Display priority (lower sorts first)' })
+      .option('icon',     { type: 'string',                     describe: 'Optional icon name' }),
+  handler: runCommand(async (argv) => {
+    const c = await adminRequest('POST', '/api/kb/categories', { name: argv.name, displayPriority: argv.priority, icon: argv.icon });
+    console.log(`Category created: [${c.id}] ${c.name}`);
+  }),
+};
+
+const topicCreateCommand = {
+  command:  'topic-create',
+  describe: 'Create a KB topic under a category and print its ID for `article push --topic-id`',
+  builder:  (y) =>
+    y
+      .option('name',        { type: 'string', demandOption: true, describe: 'Topic name' })
+      .option('slug',        { type: 'string', demandOption: true, describe: 'URL slug' })
+      .option('category-id', { type: 'string',                     describe: 'Category ID from `kb article categories`' })
+      .option('priority',    { type: 'number', default: 0,         describe: 'Display priority (lower sorts first)' }),
+  handler: runCommand(async (argv) => {
+    const t = await adminRequest('POST', '/api/kb/topics', {
+      name: argv.name, slug: argv.slug, categoryId: argv.categoryId, displayPriority: argv.priority,
+    });
+    console.log(`Topic created: [${t.id}] ${t.name} (slug ${t.slug})`);
+  }),
+};
+
 // ── push ──────────────────────────────────────────────────────────────────────
 
 const pushCommand = {
@@ -500,6 +542,9 @@ export const articleCommand = {
       .command(listCommand)
       .command(getCommand)
       .command(topicsCommand)
+      .command(categoriesCommand)
+      .command(categoryCreateCommand)
+      .command(topicCreateCommand)
       .command(pushCommand)
       .command(previewCommand)
       .command(deleteCommand)

package/lib/commands/entitlement.js

@@ -96,6 +96,18 @@ async function backfill() {
   console.log(`✅ Backfill: ${result.inserted} inserted, ${result.skipped} already existed, ${result.unknownPlan} skipped (unknown plan).`);
 }
 
+async function backfillSapTiers(args) {
+  const result = await request('POST', `Entitlements/admin/backfill-sap-tiers?dryRun=${args.apply ? 'false' : 'true'}`);
+  if (result.error) { console.error(`❌ ${result.error}`); process.exit(1); }
+  console.log(`${args.apply ? '✅ APPLIED' : '🔍 DRY RUN'}: ${JSON.stringify(result, null, 2)}`);
+}
+
+async function backfillLegacyWriteTiers(args) {
+  const result = await request('POST', `Entitlements/admin/backfill-legacy-write-tiers?dryRun=${args.apply ? 'false' : 'true'}`);
+  if (result.error) { console.error(`❌ ${result.error}`); process.exit(1); }
+  console.log(`${args.apply ? '✅ APPLIED' : '🔍 DRY RUN'}: ${JSON.stringify(result, null, 2)}`);
+}
+
 async function reconcile(args) {
   if (!args.site) {
     console.error('Usage: velaro entitlement reconcile --site 1032');
@@ -175,6 +187,8 @@ export function entitlementCommand(yargs) {
     , a => removeOverride(a))
     .command('seed', 'Seed the EntitlementFeature registry (idempotent, superadmin only)', () => {}, () => seed())
     .command('seed-plans', 'Seed PlanEntitlement rows from live PackageVersions in messaging DB (idempotent, superadmin only)', () => {}, () => seedPlans())
+    .command('backfill-sap-tiers', 'Grant the four SAP add-on packages to existing SAP sites (dry run unless --apply; superadmin only)', (y) => y.option('apply', { type: 'boolean', default: false, describe: 'Write the grants (default is a dry run)' }), (a) => backfillSapTiers(a))
+    .command('backfill-legacy-write-tiers', 'Grant EnableServiceNowWrite/AccelaWrite/QuickBooksWrite to existing sites after the OR-gate sweep (dry run unless --apply; superadmin only)', (y) => y.option('apply', { type: 'boolean', default: false, describe: 'Write the grants (default is a dry run)' }), (a) => backfillLegacyWriteTiers(a))
     .command('backfill', 'Backfill SiteSubscription rows from active Subscription rows in messaging DB (idempotent, superadmin only)', () => {}, () => backfill())
     .command('reconcile', 'Diff Subscription.cs vs Entitlements API for a site — zero deltas = ready for cutover', y => y
       .option('site', { type: 'number', demandOption: true, desc: 'Site ID' })
@@ -195,5 +209,5 @@ export function entitlementCommand(yargs) {
       .option('key',      { type: 'string',  demandOption: true, desc: 'Feature key, e.g. EnableIvr' })
       .option('rollback', { type: 'boolean', desc: 'Pass to roll back this flag to Subscription.cs (default: go live)' })
     , a => setCutover(a))
-    .demandCommand(1, 'Specify a subcommand: get | list-features | set-override | remove-override | seed | seed-plans | backfill | reconcile | comp | set-lock | list-cutover | set-cutover');
+    .demandCommand(1, 'Specify a subcommand: get | list-features | set-override | remove-override | seed | seed-plans | backfill | backfill-sap-tiers | backfill-legacy-write-tiers | reconcile | comp | set-lock | list-cutover | set-cutover');
 }

package/lib/commands/status-page.js

@@ -0,0 +1,95 @@
+import { messagingRequest } from '../api.js';
+
+const COMPONENTS = 'Messaging, Voice & Calls, AI Assistant, Database, API, Integrations, Email Campaigns, Velaro Sign, Velaro Forms, Agent Console, Core API, Chat Engagement';
+const TOKENS = 'AffectedServices is a comma-separated list of component names (' + COMPONENTS + ') plus optional uptime tokens: "counts-uptime" forces the incident to count against uptime, "no-uptime-impact" forces it not to. Default: only a core chat outage counts.';
+
+const listCommand = {
+  command: 'list',
+  describe: 'List status incidents (SuperAdmin, velaro-messaging GET /superadmin/status-incidents)',
+  builder: (y) => y.option('filter', { type: 'string', default: 'active', choices: ['active', 'resolved', 'all'] }).option('json', { type: 'boolean', default: false }),
+  handler: async (argv) => {
+    const rows = await messagingRequest('GET', `/superadmin/status-incidents?filter=${argv.filter}`);
+    if (argv.json) { console.log(JSON.stringify(rows, null, 2)); return; }
+    for (const r of rows ?? []) console.log(`#${r.id}  ${r.status}  ${r.incidentType}/${r.severity}  ${r.title}  [${r.affectedServices ?? ''}]`);
+  },
+};
+
+const createCommand = {
+  command: 'create',
+  describe: 'Create a status incident. ' + TOKENS,
+  builder: (y) => y
+    .option('title', { type: 'string', demandOption: true })
+    .option('description', { type: 'string', default: '' })
+    .option('status', { type: 'string', default: 'Investigating', describe: 'Investigating, Identified, Monitoring, Resolved' })
+    .option('type', { type: 'string', default: 'Incident', describe: 'Incident or Maintenance' })
+    .option('severity', { type: 'string', default: 'Minor', describe: 'Minor or Major' })
+    .option('services', { type: 'string', default: '', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string', default: '' })
+    .option('exclude-from-uptime', { type: 'boolean', default: false })
+    .option('hidden', { type: 'boolean', default: false, describe: 'Hide from the public page' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-incidents', {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, excludeFromUptime: argv.excludeFromUptime, isVisibleToCustomers: !argv.hidden,
+    });
+    console.log(`Created incident #${r.id}: ${r.title}`);
+  },
+};
+
+const updateCommand = {
+  command: 'update <id>',
+  describe: 'Update a status incident (pass every field you want kept). ' + TOKENS,
+  builder: (y) => y
+    .positional('id', { type: 'number' })
+    .option('title', { type: 'string' }).option('description', { type: 'string' })
+    .option('status', { type: 'string' }).option('type', { type: 'string' }).option('severity', { type: 'string' })
+    .option('services', { type: 'string', describe: 'AffectedServices CSV. ' + TOKENS })
+    .option('regions', { type: 'string' })
+    .option('end-time', { type: 'string', describe: 'ISO timestamp the incident ended' })
+    .option('exclude-from-uptime', { type: 'boolean' })
+    .option('hidden', { type: 'boolean' }),
+  handler: async (argv) => {
+    const body = {
+      title: argv.title, description: argv.description, status: argv.status, incidentType: argv.type, severity: argv.severity,
+      affectedServices: argv.services, affectedRegions: argv.regions, endTime: argv.endTime,
+      excludeFromUptime: argv.excludeFromUptime ?? false, isVisibleToCustomers: argv.hidden === undefined ? true : !argv.hidden,
+    };
+    const r = await messagingRequest('PUT', `/superadmin/status-incidents/${argv.id}`, body);
+    console.log(`Updated incident #${r?.id ?? argv.id}`);
+  },
+};
+
+const deleteCommand = {
+  command: 'delete <id>',
+  describe: 'Delete a status incident or clear an override',
+  builder: (y) => y.positional('id', { type: 'number' }),
+  handler: async (argv) => {
+    await messagingRequest('DELETE', `/superadmin/status-incidents/${argv.id}`);
+    console.log(`Deleted incident #${argv.id}`);
+  },
+};
+
+const overrideCommand = {
+  command: 'override',
+  describe: 'Force a public status page component to a status (POST /superadmin/status-overrides). Components: ' + COMPONENTS + '. Clear with: velaro status-page delete <id>',
+  builder: (y) => y
+    .option('component', { type: 'string', demandOption: true, describe: COMPONENTS })
+    .option('status', { type: 'string', demandOption: true, choices: ['operational', 'degraded', 'outage', 'maintenance'] })
+    .option('note', { type: 'string', default: '' })
+    .option('expires-at', { type: 'string', describe: 'ISO timestamp the override auto-clears' })
+    .option('counts-against-uptime', { type: 'boolean', describe: 'true adds counts-uptime, false adds no-uptime-impact; omit for default' }),
+  handler: async (argv) => {
+    const r = await messagingRequest('POST', '/superadmin/status-overrides', {
+      component: argv.component, status: argv.status, note: argv.note, expiresAt: argv.expiresAt ?? null, countsAgainstUptime: argv.countsAgainstUptime ?? null,
+    });
+    console.log(`Override #${r.id} created: ${r.title}`);
+  },
+};
+
+export const statusPageCommand = {
+  command: 'status-page <subcommand>',
+  describe: 'Public status page incidents and component overrides (SuperAdmin only)',
+  builder: (y) => y.command(listCommand).command(createCommand).command(updateCommand).command(deleteCommand).command(overrideCommand)
+    .demandCommand(1, 'Specify a subcommand: list, create, update, delete, override').strict(),
+  handler: () => {},
+};

package/package.json

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