@velaro/cli 1.4.61 → 1.4.63

package/bin/velaro.js

@@ -39,6 +39,8 @@ import { integrationCommand } from '../lib/commands/integration.js';
 import { appointmentsCommand } from '../lib/commands/appointments.js';
 import { bookingCommand } from '../lib/commands/booking.js';
 import { reportCommand }       from '../lib/commands/report.js';
+import { scheduleAdherenceCommand } from '../lib/commands/schedule-adherence.js';
+import { experienceImpactCommand } from '../lib/commands/experience-impact.js';
 import { conversationEfficiencyCommand } from '../lib/commands/conversation-efficiency.js';
 import { dbCommand } from '../lib/commands/db.js';
 import { focusCommand }       from '../lib/commands/focus.js';
@@ -139,6 +141,8 @@ await yargs(hideBin(process.argv))
   .command(bookingCommand)
   .command(reportCommand)
   .command(conversationEfficiencyCommand)
+  .command(scheduleAdherenceCommand)
+  .command(experienceImpactCommand)
   .command(dbCommand)
   .command(focusCommand)
   .command(automationDraftCommand)

package/lib/commands/experience-impact.js

@@ -0,0 +1,33 @@
+import { messagingGet } from '../api.js';
+import { runCommand } from '../run.js';
+
+// -- velaro experience-impact ---------------------------------------------------
+// Backend: velaro-messaging GET /Reports/experience-impact?from=&to=&teamId=
+// Site scope comes from the caller's auth, never an argument.
+
+export const experienceImpactCommand = {
+  command:  'experience-impact',
+  describe: 'Experience index (0-100) tying schedule adherence, service level, missed chats and CSAT together',
+  builder:  (y) => y
+    .option('from', { type: 'string', describe: 'yyyy-MM-dd (default: 7 days ago)' })
+    .option('to', { type: 'string', describe: 'yyyy-MM-dd (default: today)' })
+    .option('team-id', { type: 'number', describe: 'Narrow to one team' })
+    .option('json', { type: 'boolean', default: false, describe: 'Raw JSON output' }),
+  handler:  runCommand(async (argv) => {
+    const qs = new URLSearchParams();
+    if (argv.from) qs.set('from', argv.from);
+    if (argv.to) qs.set('to', argv.to);
+    if (argv.teamId) qs.set('teamId', String(argv.teamId));
+    const q = qs.toString();
+    const d = await messagingGet(`/Reports/experience-impact${q ? `?${q}` : ''}`);
+    if (argv.json) { console.log(JSON.stringify(d, null, 2)); return; }
+    const s = d.summary ?? {};
+    console.log(`\nExperience Impact ${d.range?.from}..${d.range?.to}`);
+    console.log(`  Experience index: ${s.experienceIndex} / 100`);
+    console.log(`  Adherence ${s.adherencePct}% | Service level ${s.serviceLevelPct}% | Missed chats ${s.missedChats} | Avg wait ${s.avgWaitSec}s | CSAT ${s.csatAvg ?? '-'} (${s.csatResponses ?? 0})`);
+    for (const i of d.insights ?? []) console.log(`  [${i.severity}] ${i.text}`);
+    for (const a of d.agents ?? []) {
+      console.log(`  [${a.agentId}] ${a.name}: index ${a.experienceIndex} adherence ${a.adherencePct}% CSAT ${a.csatAvg ?? '-'} handled ${a.handled}`);
+    }
+  }),
+};

package/lib/commands/schedule-adherence.js

@@ -0,0 +1,33 @@
+import { messagingGet } from '../api.js';
+import { runCommand } from '../run.js';
+
+// -- velaro schedule-adherence --------------------------------------------------
+// Staff-only. siteId is an EXPLICIT argument (SupportTools-style), never derived from the caller.
+// Backend: velaro-messaging GET /Reports/sites/{siteId}/schedule-adherence-diagnostics
+// (IsSuperAdminAsync allowSupport gate; role=agent requires agentId, fails closed).
+
+export const scheduleAdherenceCommand = {
+  command:  'schedule-adherence <siteId>',
+  describe: 'Staff: schedule adherence overview/breakdown/intraday/timeline for a site as manager or agent',
+  builder:  (y) => y
+    .positional('siteId', { type: 'number', describe: 'Target customer site ID' })
+    .option('role', { type: 'string', choices: ['manager', 'agent'], default: 'manager', describe: 'Scope to apply' })
+    .option('agent-id', { type: 'number', describe: 'WorkspaceUser id (required for --role agent)' })
+    .option('start', { type: 'string', describe: 'yyyy-MM-dd' })
+    .option('end', { type: 'string', describe: 'yyyy-MM-dd' })
+    .option('tz', { type: 'string', describe: 'IANA time zone override' })
+    .option('json', { type: 'boolean', default: false, describe: 'Raw JSON output' }),
+  handler:  runCommand(async (argv) => {
+    if (argv.role === 'agent' && !argv.agentId) throw new Error('--agent-id is required with --role agent');
+    const qs = new URLSearchParams({ detail: 'true', role: argv.role });
+    if (argv.agentId) qs.set('agentId', String(argv.agentId));
+    for (const k of ['start', 'end', 'tz']) if (argv[k]) qs.set(k, argv[k]);
+    const d = await messagingGet(`/Reports/sites/${argv.siteId}/schedule-adherence-diagnostics?${qs}`);
+    if (argv.json) { console.log(JSON.stringify(d, null, 2)); return; }
+    console.log(`\nSite ${d.siteId} scope=${d.scope} ${d.range?.start}..${d.range?.end} tz=${d.timeZone} invariantsPass=${d.invariantsPass}`);
+    console.log(`  Totals: sched ${d.totals?.scheduledMinutes}m adherent ${d.totals?.adherentMinutes}m avg ${d.totals?.avgAdherencePercent}%`);
+    for (const a of d.agents ?? []) {
+      console.log(`  [${a.agentId}] ${a.agentName}: ${a.adherencePercent}% status=${a.currentStatus ?? '-'} days=${a.days?.length ?? 0} shiftsToday=${a.timeline?.shifts?.length ?? 0}`);
+    }
+  }),
+};

package/package.json

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