@velaro/cli 1.4.79 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@velaro/cli",
-  "version": "1.4.79",
+  "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": {