@velaro/cli 1.4.78 → 1.4.80

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/support.js

@@ -12,6 +12,20 @@ async function toggleFlag(args) {
   console.log(`✅ Site ${args.site}: ${result.flag} ${result.oldValue} → ${result.newValue}`);
 }
 
+async function setLimit(args) {
+  const n = Number(args.value);
+  if (!args.site || !args.key || !Number.isInteger(n) || n < 0) {
+    console.error('Usage: velaro support set-limit --site 1032 --key maxBotTurnsPerMonth --value 10000');
+    process.exit(1);
+  }
+  const result = await request('POST', `SupportTools/sites/${args.site}/subscription/bulk-flags`, { flags: { [args.key]: n } });
+  console.log(`Site ${args.site}: applied ${(result.applied || []).join(', ') || '(none)'}`);
+  if ((result.skipped || []).length) {
+    console.error(`Skipped: ${result.skipped.join(', ')}`);
+    process.exit(1);
+  }
+}
+
 async function scraperCreateJob(args) {
   if (!args.site || !args.urls) {
     console.error('Usage: velaro support scraper-create-job --site 1032 --urls "https://example.com" [--maxPages 30] [--crawlDepth 2] [--name "job name"]');
@@ -197,6 +211,11 @@ export function supportCommand(yargs) {
       .option('flag',    { type: 'string',  demandOption: true, desc: 'Flag name, e.g. EnableScraperBotIndexing (must be on SupportToolsController.AllowedFeatureFlags)' })
       .option('enabled', { type: 'string',  demandOption: true, desc: 'true or false' })
     , a => toggleFlag(a))
+    .command('set-limit', 'Set a numeric Subscription cap on a site, e.g. maxBotTurnsPerMonth (superadmin only; 0 = plan value, never unlimited)', y => y
+      .option('site',  { type: 'number', demandOption: true, desc: 'Site ID' })
+      .option('key',   { type: 'string', demandOption: true, desc: 'Cap name, e.g. maxBotTurnsPerMonth' })
+      .option('value', { type: 'number', demandOption: true, desc: 'Whole number >= 0' })
+    , a => setLimit(a))
     .command('scraper-create-job', 'Trigger a scraper job on behalf of any site (superadmin only — no need to be logged in as that site\'s own user)', y => y
       .option('site',       { type: 'number', demandOption: true, desc: 'Target site ID' })
       .option('urls',       { type: 'string', demandOption: true, desc: 'Comma-separated URLs to crawl' })
@@ -211,5 +230,5 @@ export function supportCommand(yargs) {
       .option('channel',         { type: 'string', desc: 'Conversation source, e.g. Web, TwilioSms (default Web)' })
       .option('overrideIndexes', { type: 'string', desc: 'Comma-separated index names to override the config\'s own IndexName for this query' })
     , a => chatQuery(a))
-    .demandCommand(1, 'Specify a subcommand: deployments | impersonate | agent-lookup | add-site-user | toggle-flag | scraper-create-job | chat-query | send-email | tour-insights | connection-timeline | connection-evidence');
+    .demandCommand(1, 'Specify a subcommand: deployments | impersonate | agent-lookup | add-site-user | toggle-flag | set-limit | scraper-create-job | chat-query | send-email | tour-insights | connection-timeline | connection-evidence');
 }

package/package.json

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