@velaro/cli 1.4.105 → 1.4.107

package/bin/velaro.js

@@ -12,6 +12,7 @@ import { ingestCommand }     from '../lib/commands/ingest.js';
 import { indexMoveCommand }  from '../lib/commands/index-move.js';
 import { safetyCommand }     from '../lib/commands/safety.js';
 import { knowledgeAdvisorCommand } from '../lib/commands/knowledge-advisor.js';
+import { knowledgeCommand } from '../lib/commands/knowledge.js';
 import { productCommand }    from '../lib/commands/product.js';
 import { mcpKeyCommand }     from '../lib/commands/mcp-key.js';
 import { opsCommand }        from '../lib/commands/ops.js';
@@ -63,6 +64,7 @@ import { keywordIntelligenceCommand } from '../lib/commands/keyword-intelligence
 import { aiFieldExtractionCommand } from '../lib/commands/ai-field-extraction.js';
 import { sentimentCommand, qualityCommand, chatIntelligenceThemesCommand } from '../lib/commands/quality-reports.js';
 import { cannedLearningCommand } from '../lib/commands/canned-learning.js';
+import { csatOverrideUnapproveCommand } from '../lib/commands/csat-override.js';
 import { chatIntelligenceTopicsCommand } from '../lib/commands/chat-intelligence-topics.js';
 import { focusCommand }       from '../lib/commands/focus.js';
 import { triageCommand }      from '../lib/commands/triage.js';
@@ -108,6 +110,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 { skillUsageCommand }        from '../lib/commands/skill-usage.js';
 import { aiFederationCommand }       from '../lib/commands/ai-federation.js';
 import { statusPageCommand }        from '../lib/commands/status-page.js';
 import { statusNotifyCommand }      from '../lib/commands/status-notify.js';
@@ -116,6 +119,7 @@ import { emailInboxCommand }        from '../lib/commands/email-inbox.js';
 import { callbackCommand }          from '../lib/commands/callback.js';
 import { caseCommand }              from '../lib/commands/case.js';
 import { pickupCommand }            from '../lib/commands/pickup.js';
+import { visitorMonitorCommand }    from '../lib/commands/visitor-monitor.js';
 import { visitorLinkCommand }      from '../lib/commands/visitor-link.js';
 import { applePayCommand }         from '../lib/commands/apple-pay.js';
 import { siteBuilderCommand }        from '../lib/commands/site-builder.js';
@@ -126,12 +130,18 @@ import { bundleCommand }            from '../lib/commands/bundle.js';
 import { chatWindowCommand }        from '../lib/commands/chat-window.js';
 import { featureDiscoveryCommand }  from '../lib/commands/feature-discovery.js';
 import { tourPolicyCommand }  from '../lib/commands/tour-policy.js';
+import { livefluenceCommand, missedCommand, serviceCommand, pageCommand, uploadedCommand, msCommand, outlookCommand, oauthCommand, provisionCommand, sseCommand, skillCommand, v10Command, whatsappCommand, mobileCommand, signalrCommand, supportGroupCommand, pricingGroupCommand, scraperGroupCommand, tourPolicyGroupCommand } from '../lib/commands/parity-staff-tools.js';
 import { scraperCommand }      from '../lib/commands/scraper.js';
 import { usageCommand }        from '../lib/commands/usage.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 { recycleBinCommand, aiUsageCommand, siteInfoCommand, billingReceiptsCommand } from '../lib/commands/endpoint-parity.js';
+import { adminCommand, appleCommand, forceExpireSiteCommand, backfillCommand, kpiCommand, auditTrailCommand, codeCommand, crmCommand, hangfireCommand } from '../lib/commands/diag-groups.js';
+import { aiFollowupsCommand, businessActionCommand, callCommand, conversationCommand, conversionCommand, emailCommand, ivrCommand } from '../lib/commands/ops-groups.js';
+import { entitlementGroup } from '../lib/commands/entitlement.js';
+import { featureDiscoveryGroup } from '../lib/commands/feature-discovery.js';
 import { startUpdateCheck }  from '../lib/update-check.js';
 import { printBanner, printBannerIfFirstRun } from '../lib/banner.js';
 import { createRequire } from 'module';
@@ -159,6 +169,7 @@ await yargs(hideBin(process.argv))
   .command(indexMoveCommand)
   .command(safetyCommand)
   .command(knowledgeAdvisorCommand)
+  .command(knowledgeCommand)
   .command(productCommand)
   .command(mcpKeyCommand)
   .command(opsCommand)
@@ -213,6 +224,7 @@ await yargs(hideBin(process.argv))
   .command(chatIntelligenceThemesCommand)
   .command(cannedLearningCommand)
   .command(chatIntelligenceTopicsCommand)
+  .command(csatOverrideUnapproveCommand)
   .command(focusCommand)
   .command(triageCommand)
   .command(automationDraftCommand)
@@ -250,13 +262,14 @@ await yargs(hideBin(process.argv))
   .command(signCommand)
   .command(widgetContainerCommand)
   .command(inlineWidgetConfigCommand)
-  .command({ command: 'pricing', desc: 'View and manage the pricing catalog', builder: pricingCommand, handler: () => {} })
-  .command({ command: 'entitlement', desc: 'Query and manage site feature entitlements (superadmin only)', builder: entitlementCommand, handler: () => {} })
+  .command(pricingGroupCommand)
+  .command(entitlementGroup)
   .command({ command: 'subscription', desc: 'Apply/diff SubscriptionPackage packages on a site (superadmin only)', builder: subscriptionCommand, handler: () => {} })
-  .command({ command: 'support', desc: 'Staff SupportTools actions on a site (superadmin only)', builder: supportCommand, handler: () => {} })
+  .command(supportGroupCommand)
   .command(routingCommand)
   .command(diagnosticsCommand)
   .command(aiSpendCommand)
+  .command(skillUsageCommand)
   .command(aiFederationCommand)
   .command(statusPageCommand)
   .command(statusNotifyCommand)
@@ -265,6 +278,7 @@ await yargs(hideBin(process.argv))
   .command(callbackCommand)
   .command(caseCommand)
   .command(pickupCommand)
+  .command(visitorMonitorCommand)
   .command(visitorLinkCommand)
   .command(applePayCommand)
   .command(siteBuilderCommand)
@@ -273,14 +287,49 @@ await yargs(hideBin(process.argv))
   .command(surveyCommand)
   .command(bundleCommand)
   .command(chatWindowCommand)
-  .command({ command: 'feature-discovery', desc: 'View and act on feature-discovery suggestions for this site', builder: featureDiscoveryCommand, handler: () => {} })
+  .command(featureDiscoveryGroup)
+  .command(scraperGroupCommand)
+  .command(tourPolicyGroupCommand)
+  .command(livefluenceCommand)
+  .command(missedCommand)
+  .command(serviceCommand)
+  .command(pageCommand)
+  .command(uploadedCommand)
+  .command(msCommand)
+  .command(outlookCommand)
+  .command(oauthCommand)
+  .command(provisionCommand)
+  .command(sseCommand)
+  .command(skillCommand)
+  .command(v10Command)
+  .command(whatsappCommand)
+  .command(mobileCommand)
+  .command(signalrCommand)
   .command(usageCommand)
-  .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)
+  .command(recycleBinCommand)
+  .command(aiUsageCommand)
+  .command(siteInfoCommand)
+  .command(billingReceiptsCommand)
+  .command(adminCommand)
+  .command(appleCommand)
+  .command(forceExpireSiteCommand)
+  .command(backfillCommand)
+  .command(kpiCommand)
+  .command(auditTrailCommand)
+  .command(codeCommand)
+  .command(crmCommand)
+  .command(hangfireCommand)
+  .command(aiFollowupsCommand)
+  .command(businessActionCommand)
+  .command(callCommand)
+  .command(conversationCommand)
+  .command(conversionCommand)
+  .command(emailCommand)
+  .command(ivrCommand)
   .demandCommand(1, 'Specify a command. Run "velaro --help" for options.')
   .strict()
   .help()

package/lib/commands/ai-config.js

@@ -84,7 +84,7 @@ const aiConfigCreateCommand = {
     y
       .option('name',        { type: 'string',  describe: 'Configuration name' })
       .option('prompt',      { type: 'string',  describe: 'System prompt text' })
-      .option('model',       { type: 'string',  describe: 'Model (e.g. gpt-4o-mini, claude-haiku-4-5)' })
+      .option('model',       { type: 'string',  describe: 'Model (e.g. gpt-4o-mini, claude-haiku-5-5)' })
       .option('tone',        { type: 'string',  describe: 'Tone (e.g. friendly, professional)' })
       .option('language',    { type: 'string',  default: 'en', describe: 'Language code' })
       .option('reply-length',{ type: 'string',  describe: 'Reply length (e.g. short, medium, long)' })

package/lib/commands/billing-automation.js

@@ -35,7 +35,7 @@ async function listRules() {
 async function setGlobal(appliesTo, mode) {
   if (!GATES.includes(appliesTo)) fail(`appliesTo must be one of: ${GATES.join(', ')}`);
   if (!MODES.includes(mode)) fail(`mode must be one of: ${MODES.join(', ')}`);
-  await request('PUT', `/api/BillingAutomation/global/${appliesTo}`, { mode });
+  await request('PUT', `/api/BillingAutomation/global/${appliesTo}`, { mode }); // controller action: SaveGlobal
   console.log(`Global ${appliesTo} set to ${mode}.`);
 }
 

package/lib/commands/csat-override.js

@@ -0,0 +1,14 @@
+import { messagingPost } from '../api.js';
+import { runCommand } from '../run.js';
+
+// velaro csat-override-unapprove <id>
+// REST: messaging POST /api/intelligence/csat-override-candidates/{id}/unapprove (site comes from the CLI session)
+export const csatOverrideUnapproveCommand = {
+  command: 'csat-override-unapprove <id>',
+  describe: 'Return an approved Chat Intelligence improvement candidate to Pending (deactivates the override, removes any vectorized copy)',
+  builder: (y) => y.positional('id', { type: 'number', describe: 'Approved override candidate id' }),
+  handler: runCommand(async (a) => {
+    if (!Number.isInteger(a.id) || a.id <= 0) throw new Error('id must be a positive integer');
+    console.log(JSON.stringify(await messagingPost(`/api/intelligence/csat-override-candidates/${a.id}/unapprove`, {}), null, 2));
+  }),
+};

package/lib/commands/diag-groups.js

@@ -0,0 +1,108 @@
+// MCP parity command groups: admin, apple, force-expire-site, backfill, kpi, audit-trail, code, crm, hangfire.
+// Each subcommand calls the same REST route as the MCP tool of the same name (mcp/server.js, mcp/staff-server.js).
+// Staff-only routes are enforced by the backend.
+import { get, post, del, messagingGet, messagingPost } from '../api.js';
+import { show, qs, needYes, group } from '../parity-util.js';
+
+export const adminCommand = { command: 'admin', ...group('Velaro staff: admin API diagnostics', [
+  ['startup-diagnostics', 'Recent AdminStartupDiagnostics rows (migrations, startup exceptions)',
+    (y) => y.option('context-label', { type: 'string' }).option('count', { type: 'number' }),
+    async (a) => show(await get(`/SuperAdmin/StartupDiagnostics${qs({ contextLabel: a['context-label'], count: a.count })}`))],
+]) };
+
+export const appleCommand = { command: 'apple', ...group('Velaro staff: Apple Messages for Business diagnostics', [
+  ['health <siteId>', 'Apple Messages health for a site',
+    (y) => y.positional('siteId', { type: 'number' }),
+    async (a) => show(await messagingGet(`/SupportTools/sites/${a.siteId}/apple/health`))],
+  ['test-control <siteId>', 'Send an Apple test-control action to a conversation',
+    (y) => y.positional('siteId', { type: 'number' })
+      .option('control', { type: 'string', demandOption: true, describe: 'Control name' })
+      .option('conversation-id', { type: 'number' }),
+    async (a) => show(await messagingPost(`/SupportTools/sites/${a.siteId}/apple/test-control`, { control: a.control, conversationId: a['conversation-id'] }))],
+]) };
+
+export const forceExpireSiteCommand = {
+  command: 'force-expire-site <siteId>',
+  describe: 'Velaro staff: force-expire a site subscription (destructive, needs --yes)',
+  builder: (y) => y.positional('siteId', { type: 'number' }).option('yes', { type: 'boolean', describe: 'Confirm' }),
+  handler: async (a) => {
+    needYes(a, `force-expire site ${a.siteId}`);
+    show(await messagingPost(`/SuperAdmin/subscription/${a.siteId}/force-expire`));
+  },
+};
+
+export const backfillCommand = { command: 'backfill', ...group('Velaro staff: per-site data backfills (preview unless --apply --yes)', [
+  ['types', 'List backfill types', null, async () => show(await messagingGet('/SuperAdmin/backfill-types'))],
+  ['run <siteId>', 'Preview or apply a backfill for a site',
+    (y) => y.positional('siteId', { type: 'number' })
+      .option('type', { type: 'string', demandOption: true })
+      .option('from', { type: 'string', demandOption: true, describe: 'yyyy-MM-dd' })
+      .option('to', { type: 'string', demandOption: true, describe: 'yyyy-MM-dd' })
+      .option('apply', { type: 'boolean', describe: 'Write the backfill (default is a preview)' })
+      .option('yes', { type: 'boolean', describe: 'Confirm --apply' }),
+    async (a) => {
+      if (a.apply) needYes(a, 'apply a backfill');
+      show(await messagingPost(`/SuperAdmin/sites/${encodeURIComponent(a.siteId)}/backfill`, { type: a.type, from: a.from, to: a.to, apply: a.apply === true }));
+    }],
+]) };
+
+export const kpiCommand = { command: 'kpi', ...group('Live operations KPIs', [
+  ['snapshot', 'Real-time ops snapshot: agents, queues, waits, channels, teams', null, async () => show(await get('/LiveDashboard/snapshot'))],
+]) };
+
+export const auditTrailCommand = { command: 'audit-trail', ...group('Audit trail of configuration changes', [
+  ['list', 'List audit entries',
+    (y) => y.option('entity-type', { type: 'string' }).option('entity-id', { type: 'string' }).option('take', { type: 'number', default: 200 }),
+    async (a) => show(await get(`/AuditTrail${qs({ entityType: a['entity-type'], entityId: a['entity-id'], take: Math.min(500, a.take ?? 200) })}`))],
+]) };
+
+export const codeCommand = { command: 'code', ...group('Push files to a Velaro repo branch (needs GITHUB_TOKEN)', [
+  ['push-files', 'Create one commit with files on dev/main/master (destructive, needs --yes)',
+    (y) => y.option('message', { type: 'string', demandOption: true })
+      .option('file', { type: 'array', demandOption: true, describe: 'repoPath=localPath, repeatable' })
+      .option('repo', { type: 'string', default: 'velaro-admin' })
+      .option('branch', { type: 'string', default: 'dev' })
+      .option('yes', { type: 'boolean' }),
+    async (a) => {
+      needYes(a, 'push a commit');
+      const token = process.env.GITHUB_TOKEN;
+      if (!token) throw new Error('GITHUB_TOKEN env var is not set.');
+      const { readFileSync } = await import('node:fs');
+      const files = a.file.map((f) => { const [p, l] = String(f).split('='); return { path: p, content: readFileSync(l || p, 'utf8') }; });
+      const REPOS = ['velaro-admin', 'velaro-messaging', 'velaro-shared', 'velaro-shared-frontend'];
+      if (!REPOS.includes(a.repo)) throw new Error(`Repo not allowed. Allowed: ${REPOS.join(', ')}`);
+      if (!['dev', 'master', 'main'].includes(a.branch)) throw new Error('Branch must be dev, master or main.');
+      const norm = (p) => p.replace(/\\/g, '/').replace(/^\.\//, '').replace(/^\//, '');
+      if (files.some((f) => norm(f.path) === '.github' || norm(f.path).startsWith('.github/'))) throw new Error('Cannot push to .github/ paths.');
+      const base = `https://api.github.com/repos/velaro/${a.repo}`;
+      const headers = { Authorization: `Bearer ${token}`, Accept: 'application/vnd.github+json', 'X-GitHub-Api-Version': '2022-11-28', 'Content-Type': 'application/json' };
+      const gh = async (path, opts = {}) => {
+        const r = await fetch(base + path, { headers, ...opts });
+        if (!r.ok) throw new Error(`GitHub API ${path} -> ${r.status}: ${await r.text()}`);
+        return r.json();
+      };
+      const head = (await gh(`/git/refs/heads/${a.branch}`)).object.sha;
+      const baseTree = (await gh(`/git/commits/${head}`)).tree.sha;
+      const tree = await Promise.all(files.map(async (f) => {
+        const b = await gh('/git/blobs', { method: 'POST', body: JSON.stringify({ content: f.content, encoding: 'utf-8' }) });
+        return { path: f.path, mode: '100644', type: 'blob', sha: b.sha };
+      }));
+      const nt = await gh('/git/trees', { method: 'POST', body: JSON.stringify({ base_tree: baseTree, tree }) });
+      const c = await gh('/git/commits', { method: 'POST', body: JSON.stringify({ message: a.message, tree: nt.sha, parents: [head] }) });
+      await gh(`/git/refs/heads/${a.branch}`, { method: 'PATCH', body: JSON.stringify({ sha: c.sha }) });
+      console.log(`Pushed to velaro/${a.repo}@${a.branch} commit ${c.sha.slice(0, 8)}\n${files.map((f) => '  ' + f.path).join('\n')}`);
+    }],
+]) };
+
+export const crmCommand = { command: 'crm', ...group('Velaro staff: CRM email-campaign engine audit', [
+  ['email-campaign-audit', 'Row counts for the legacy CRM email-campaign tables (safe-to-retire check)', null,
+    async () => show(await messagingGet('/SuperAdmin/crm-email-campaign-audit'))],
+]) };
+
+export const hangfireCommand = { command: 'hangfire', ...group('Velaro staff: failed Hangfire jobs', [
+  ['list-failed', 'List failed jobs', null, async () => show(await get('/DatabaseTool/FailedJobs'))],
+  ['retry <id>', 'Requeue one failed job', (y) => y.positional('id', { type: 'string' }),
+    async (a) => show(await post(`/DatabaseTool/FailedJobs/${a.id}/retry`))],
+  ['delete-failed <id>', 'Delete one failed job (needs --yes)', (y) => y.positional('id', { type: 'string' }).option('yes', { type: 'boolean' }),
+    async (a) => { needYes(a, `delete failed job ${a.id}`); show(await del(`/DatabaseTool/FailedJobs/${a.id}`)); }],
+]) };

package/lib/commands/endpoint-parity.js

@@ -0,0 +1,58 @@
+// CLI halves of the MCP parity tools in mcp/parity/endpoints.customer.js and endpoints.staff.js.
+// Each handler names the controller action it calls.
+import { request } from '../api.js';
+
+const show = (r) => console.log(JSON.stringify(r, null, 2));
+const int = (y, k, d) => y.option(k, { type: 'number', demandOption: true, describe: d });
+
+export const recycleBinCommand = {
+  command: 'recycle-bin',
+  describe: 'List and restore soft-deleted contact lists, members, segments and KB articles/topics (one id at a time)',
+  builder: (y) => y
+    .command({ command: 'contact-lists', describe: 'List deleted contact lists', handler: async () => show(await request('GET', '/ContactLists/deleted')) }) // controller action: GetDeletedLists
+    .command({ command: 'restore-contact-list', describe: 'Restore one contact list', builder: (z) => int(z, 'id', 'List id'), handler: async (a) => show(await request('POST', `/ContactLists/${a.id}/restore`)) }) // controller action: RestoreList
+    .command({ command: 'members', describe: 'List deleted members of a list', builder: (z) => int(z, 'list', 'List id'), handler: async (a) => show(await request('GET', `/ContactLists/${a.list}/Members/deleted`)) }) // controller action: GetDeletedMembers
+    .command({ command: 'restore-member', describe: 'Restore one list member', builder: (z) => int(int(z, 'list', 'List id'), 'member', 'Member id'), handler: async (a) => show(await request('POST', `/ContactLists/${a.list}/Members/${a.member}/restore`)) }) // controller action: RestoreMember
+    .command({ command: 'segments', describe: 'List deleted segments', handler: async () => show(await request('GET', '/ContactSegments/deleted')) }) // controller action: ListDeleted (ContactSegments)
+    .command({ command: 'kb-articles', describe: 'List deleted KB articles', handler: async () => show(await request('GET', '/api/kb/articles/deleted')) }) // controller action: ListDeleted (KBArticles)
+    .command({ command: 'restore-kb-article', describe: 'Restore one KB article', builder: (z) => int(z, 'id', 'Article id'), handler: async (a) => show(await request('POST', `/api/kb/articles/${a.id}/restore`)) }) // controller action: RestoreDeleted (KBArticles)
+    .command({ command: 'kb-topics', describe: 'List deleted KB topics', handler: async () => show(await request('GET', '/api/kb/topics/deleted')) }) // controller action: ListDeleted (KBTopics)
+    .command({ command: 'restore-kb-topic', describe: 'Restore one KB topic', builder: (z) => int(z, 'id', 'Topic id'), handler: async (a) => show(await request('POST', `/api/kb/topics/${a.id}/restore`)) }) // controller action: RestoreDeleted (KBTopics)
+    .demandCommand(1),
+  handler: () => {},
+};
+
+export const aiUsageCommand = {
+  command: 'ai-usage',
+  describe: 'Your site AI usage summary and budget alert',
+  builder: (y) => y
+    .command({ command: 'summary', describe: 'AI usage summary', handler: async () => show(await request('GET', '/AiUsageReport/summary')) }) // controller action: GetSummary
+    .command({
+      command: 'budget-alert-set', describe: 'Update the budget alert',
+      builder: (z) => z.option('enabled', { type: 'boolean' }).option('threshold-percent', { type: 'number' }).option('recipients', { type: 'string', describe: 'Comma-separated emails' }),
+      handler: async (a) => show(await request('PUT', '/AiUsageReport/budget-alert', { enabled: a.enabled, thresholdPercent: a.thresholdPercent, recipientEmails: a.recipients })), // controller action: UpdateBudgetAlert
+    })
+    .command({ command: 'budget-alert-delete', describe: 'Delete the budget alert', handler: async () => show(await request('DELETE', '/AiUsageReport/budget-alert')) }) // controller action: DeleteBudgetAlert
+    .demandCommand(1),
+  handler: () => {},
+};
+
+export const siteInfoCommand = {
+  command: 'site-info',
+  describe: 'Read-only site settings, entitlements and platform uptime for your site',
+  builder: (y) => y
+    .command({ command: 'settings', describe: 'Site settings', handler: async () => show(await request('GET', '/api/SiteSettings')) }) // controller action: GetSiteSettings
+    .command({ command: 'entitlements', describe: 'Your resolved entitlements', handler: async () => show(await request('GET', '/Entitlements/my')) }) // controller action: GetMyEntitlements
+    .command({ command: 'uptime', describe: 'Platform uptime', handler: async () => show(await request('GET', '/PlatformUptime')) }) // controller action: GetAsync (PlatformUptime)
+    .command({ command: 'last-copilot-session', describe: 'Your last Copilot session summary', handler: async () => show(await request('GET', '/Copilot/LastSession')) }) // controller action: LastSession
+    .command({ command: 'sender-domain-health', describe: 'Sender domain health', handler: async () => show(await request('GET', '/SenderDomains/Health')) }) // controller action: GetHealth
+    .command({ command: 'netsuite-interaction-summary', describe: 'NetSuite AI interaction summary for a conversation', builder: (z) => int(z, 'conversation', 'Conversation id'), handler: async (a) => show(await request('POST', `/NetSuite/interaction-summary?conversationId=${a.conversation}`)) }) // controller action: GetInteractionSummary
+    .demandCommand(1),
+  handler: () => {},
+};
+
+export const billingReceiptsCommand = {
+  command: 'billing-receipts-run',
+  describe: 'Staff only: run the payment receipt job now',
+  handler: async () => show(await request('POST', '/api/BillingNotifications/receipts/run-now')), // controller action: RunReceiptsNow
+};

package/lib/commands/entitlement.js

@@ -1,6 +1,19 @@
 // velaro entitlement — query and manage site feature entitlements (superadmin only)
 import { request } from '../api.js';
 
+async function syncStripe(a) {
+  const r = await request('PUT', `Entitlements/admin/sync-stripe/${a.site}`, {
+    planKey: a.plan,
+    status: a.status,
+    cancelAtPeriodEnd: a['cancel-at-period-end'] ?? false,
+    currentPeriodEnd: a['current-period-end'] ?? null,
+    trialEndAt: a['trial-end-at'] ?? null,
+    stripeCustomerId: a['stripe-customer-id'],
+    stripeSubscriptionId: a['stripe-subscription-id'],
+  });
+  console.log(`Site ${a.site} synced: status=${r.status} plan=${r.planKey || 'unchanged'}`);
+}
+
 async function getSite(args) {
   if (!args.site) { console.error('Usage: velaro entitlement get --site 1032'); process.exit(1); }
   const result = await request('GET', `Entitlements/${args.site}`);
@@ -289,6 +302,16 @@ export function entitlementCommand(yargs) {
       .option('at',     { type: 'string',  desc: 'ISO 8601 timestamp to lock entitlement resolution to' })
       .option('unlock', { type: 'boolean', desc: 'Clear an existing lock (resolves against current plan version again)' })
     , a => setLock(a))
+    .command('sync-stripe', 'Sync the Stripe subscription state into its entitlement record (superadmin only)', y => y
+      .option('site',   { type: 'number', demandOption: true, desc: 'Site ID' })
+      .option('status', { type: 'string', demandOption: true, desc: 'Stripe subscription status, e.g. active, trialing, canceled' })
+      .option('plan',   { type: 'string', desc: 'Plan key, e.g. plan.professional' })
+      .option('cancel-at-period-end', { type: 'boolean', desc: 'Subscription cancels at period end' })
+      .option('current-period-end',   { type: 'string', desc: 'ISO 8601 current period end' })
+      .option('trial-end-at',         { type: 'string', desc: 'ISO 8601 trial end' })
+      .option('stripe-customer-id',      { type: 'string', desc: 'Stripe customer id' })
+      .option('stripe-subscription-id',  { type: 'string', desc: 'Stripe subscription id' })
+    , a => syncStripe(a))
     .command('trial <action>', 'Trial governance (superadmin): get | recommend | not-paying | grant | hold | reactivate | set-limit | approve-limit | deny-limit | set-text', y => y
       .option('site',    { type: 'number', desc: 'Site ID' })
       .option('feature', { type: 'string', desc: 'Feature key, e.g. EnableIvr' })
@@ -305,5 +328,8 @@ 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 | enterprise-reports | report-packages | set-override | remove-override | seed | seed-plans | backfill | backfill-sap-tiers | backfill-legacy-write-tiers | reconcile | comp | set-lock | trial | list-cutover | set-cutover');
+    .demandCommand(1, 'Specify a subcommand: get | list-features | enterprise-reports | report-packages | set-override | remove-override | seed | seed-plans | backfill | backfill-sap-tiers | backfill-legacy-write-tiers | reconcile | comp | set-lock | sync-stripe | trial | list-cutover | set-cutover');
 }
+
+// Registered group object (the CLI/MCP parity validator reads `command:` from a named const).
+export const entitlementGroup = { command: 'entitlement', desc: 'Query and manage site feature entitlements (superadmin only)', builder: entitlementCommand, handler: () => {} };

package/lib/commands/feature-discovery.js

@@ -38,3 +38,6 @@ export function featureDiscoveryCommand(yargs) {
     , a => requestFeature(a))
     .demandCommand(1, 'Specify a subcommand: list | request');
 }
+
+// Registered group object (the CLI/MCP parity validator reads `command:` from a named const).
+export const featureDiscoveryGroup = { command: 'feature-discovery', desc: 'View and act on feature-discovery suggestions for this site', builder: featureDiscoveryCommand, handler: () => {} };

package/lib/commands/knowledge.js

@@ -0,0 +1,114 @@
+// velaro knowledge clinical-text get|set -- emergency and safety wording per channel and language.
+// Backend: velaro-messaging KnowledgeSetupController. Customer routes take the site from auth
+// (GET KnowledgeSetup/state, PUT KnowledgeSetup/clinical-text); --site switches to the staff twins
+// (GET/PUT KnowledgeSetup/Staff/{siteId}/...), Velaro super admin only.
+import fs from 'node:fs';
+import { messagingGet, messagingPut } from '../api.js';
+import { runCommand } from '../run.js';
+
+const CHANNELS = ['chat', 'voice', 'sms', 'whatsapp', 'email'];
+
+export function basePath(site) {
+  return site ? `/KnowledgeSetup/Staff/${encodeURIComponent(site)}` : '/KnowledgeSetup';
+}
+
+/** Key is default | channel | lang | lang.channel (es.voice). Value is the wording. */
+export function parseEntries(list) {
+  const out = {};
+  for (const raw of [].concat(list ?? [])) {
+    const i = String(raw).indexOf('=');
+    if (i < 1) throw new Error(`Expected key=text (for example es.voice="..."), got: ${raw}`);
+    out[String(raw).slice(0, i).trim().toLowerCase()] = String(raw).slice(i + 1);
+  }
+  return out;
+}
+
+export function buildBody(argv) {
+  if (argv.reset) return { resetToDefault: true };
+  let body = {};
+  if (argv.file) body = JSON.parse(fs.readFileSync(argv.file, 'utf8'));
+  const em = parseEntries(argv.emergency);
+  const rf = parseEntries(argv.referral);
+  if (Object.keys(em).length) body.emergency = { ...(body.emergency ?? {}), ...em };
+  if (Object.keys(rf).length) body.referral = { ...(body.referral ?? {}), ...rf };
+  if (argv['emergency-number'] !== undefined) body.emergencyNumber = argv['emergency-number'];
+  if (argv['service-mode'] !== undefined || argv['service-mode-text'] !== undefined) {
+    body.emergencyServiceMode = {};
+    if (argv['service-mode'] !== undefined) body.emergencyServiceMode.enabled = argv['service-mode'];
+    if (argv['service-mode-text'] !== undefined) body.emergencyServiceMode.text = argv['service-mode-text'];
+    if (argv.confirm) body.emergencyServiceMode.confirm = true;
+  }
+  return body;
+}
+
+export function printState(ct) {
+  console.log(`\nEmergency number: ${ct.overrides?.emergencyNumber || `(default) ${ct.defaultEmergencyNumber}`}`);
+  console.log(`Limits: ${ct.limits?.minLength}-${ct.limits?.maxLength} characters. Emergency text must keep ${ct.placeholder}.`);
+  console.log(`Supported languages: ${(ct.supportedLanguages ?? []).join(', ') || '-'}`);
+  const m = ct.emergencyServiceMode;
+  console.log(`Emergency-service mode: ${m?.enabled ? 'ON' : 'off'}${m?.text ? ` | text: ${m.text}` : ''} (staff only)`);
+  console.log('Custom wording (key = text):');
+  for (const kind of ['emergency', 'referral']) {
+    const e = Object.entries(ct.overrides?.[kind] ?? {});
+    if (!e.length) console.log(`  ${kind}: none, built-in wording`);
+    for (const [k, v] of e) console.log(`  ${kind}.${k} = ${v}`);
+  }
+  console.log('Effective English wording per channel:');
+  for (const c of CHANNELS) {
+    const x = ct.effective?.[c];
+    if (x) console.log(`  ${c}: emergency "${x.emergency}" | referral "${x.referral}"`);
+  }
+}
+
+const clinicalGet = {
+  command: 'get',
+  describe: 'Show emergency/safety wording, supported languages and emergency-service mode',
+  builder: (y) => y
+    .option('site', { type: 'number', describe: 'Target site ID (Velaro staff only; omit for your own site)' })
+    .option('json', { type: 'boolean', default: false }),
+  handler: runCommand(async (argv) => {
+    const state = await messagingGet(`${basePath(argv.site)}/state`);
+    const ct = state?.clinicalText;
+    if (!ct) throw new Error('The setup state did not include clinicalText (backend too old?).');
+    if (argv.json) { console.log(JSON.stringify(ct, null, 2)); return; }
+    printState(ct);
+  }),
+};
+
+const clinicalSet = {
+  command: 'set',
+  describe: 'Set emergency/safety wording. Entries replace the stored set: pass every override you want to keep (use get --json).',
+  builder: (y) => y
+    .option('site', { type: 'number', describe: 'Target site ID (Velaro staff only)' })
+    .option('emergency', { type: 'array', string: true, describe: 'key=text, key is default|chat|voice|sms|whatsapp|email|<lang>|<lang>.<channel>; must contain {emergencyNumber}' })
+    .option('referral', { type: 'array', string: true, describe: 'key=text, same keys as --emergency' })
+    .option('emergency-number', { type: 'string', describe: 'Replaces {emergencyNumber}' })
+    .option('file', { type: 'string', describe: 'JSON body { emergency, referral, emergencyNumber }' })
+    .option('reset', { type: 'boolean', default: false, describe: 'Clear all custom wording' })
+    .option('service-mode', { type: 'boolean', describe: 'Staff only (--site): turn emergency-service mode on/off' })
+    .option('service-mode-text', { type: 'string', describe: 'Staff only: required emergency text for service mode (20-600 chars)' })
+    .option('confirm', { type: 'boolean', default: false, describe: 'Required to turn service mode on' })
+    .option('json', { type: 'boolean', default: false }),
+  handler: runCommand(async (argv) => {
+    const body = buildBody(argv);
+    if (body.emergencyServiceMode && !argv.site) throw new Error('Emergency-service mode is staff only: pass --site <id>.');
+    const r = await messagingPut(`${basePath(argv.site)}/clinical-text`, body);
+    if (argv.json) { console.log(JSON.stringify(r, null, 2)); return; }
+    console.log(r.changed ? 'Saved.' : 'No change.');
+    if (r.clinicalText) printState(r.clinicalText);
+  }),
+};
+
+export const knowledgeCommand = {
+  command: 'knowledge <subcommand>',
+  describe: 'Knowledge setup safety settings',
+  builder: (y) => y
+    .command({
+      command: 'clinical-text <action>',
+      describe: 'Emergency and safety messages per channel and language',
+      builder: (yy) => yy.command(clinicalGet).command(clinicalSet).demandCommand(1, 'Specify get or set'),
+      handler: () => {},
+    })
+    .demandCommand(1, 'Specify a subcommand: clinical-text'),
+  handler: () => {},
+};