@velaro/cli 1.4.61 → 1.4.62

package/bin/velaro.js

@@ -39,6 +39,7 @@ 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 { conversationEfficiencyCommand } from '../lib/commands/conversation-efficiency.js';
 import { dbCommand } from '../lib/commands/db.js';
 import { focusCommand }       from '../lib/commands/focus.js';
@@ -139,6 +140,7 @@ await yargs(hideBin(process.argv))
   .command(bookingCommand)
   .command(reportCommand)
   .command(conversationEfficiencyCommand)
+  .command(scheduleAdherenceCommand)
   .command(dbCommand)
   .command(focusCommand)
   .command(automationDraftCommand)

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.62",
   "description": "Velaro Workspace v20 — command-line interface for managing bots, knowledge base ingestion, MCP API keys, search indexes, and ops health.",
   "type": "module",
   "bin": {