@velaro/cli 1.4.56 → 1.4.57

package/lib/commands/logs.js

@@ -18,6 +18,16 @@ function parseDuration(s) {
   return n * 24 * 3600 * 1000;
 }
 
+// FIXED 2026-09-24: velaro-messaging's /superadmin/logs/search used to return a bare JSON array
+// for some queries and {entries, nextCursor} for others, depending on which internal code path
+// served the request. It now always returns {entries, nextCursor} -- this helper also accepts a
+// bare array so the CLI degrades gracefully rather than crashing if pointed at an older deploy.
+function extractLogEntries(response) {
+  if (Array.isArray(response)) return response;
+  if (response && Array.isArray(response.entries)) return response.entries;
+  return [];
+}
+
 function printEntry(e) {
   const ts      = new Date(e.timestamp ?? e.LogTimestamp).toISOString().replace('T', ' ').slice(0, 19);
   const lvl     = (e.Level ?? e.level ?? '?').padEnd(5);
@@ -52,12 +62,15 @@ async function searchLogs(argv) {
 
   const from = new Date(Date.now() - parseDuration(argv.last ?? '2h'));
   const params = new URLSearchParams({ from: from.toISOString(), take: String(argv.take ?? 50) });
-  if (argv.query)       params.set('q',           argv.query);
-  if (argv.level)       params.set('level',        argv.level.toUpperCase());
-  if (argv.integration) params.set('integration',  argv.integration);
-  if (argv.site)        params.set('siteId',        String(argv.site));
-  if (argv.source)      params.set('source',        argv.source);
-  if (argv.regex)       params.set('regex',         'true');
+  if (argv.query)         params.set('q',             argv.query);
+  if (argv.level)         params.set('level',         argv.level.toUpperCase());
+  if (argv.integration)   params.set('integration',   argv.integration);
+  if (argv.site)          params.set('siteId',        String(argv.site));
+  if (argv.source)        params.set('source',        argv.source);
+  if (argv.platform)      params.set('platform',      argv.platform);
+  if (argv.environment)   params.set('environment',   argv.environment);
+  if (argv.correlationId) params.set('correlationId', argv.correlationId);
+  if (argv.regex)         params.set('regex',         'true');
 
   const res = await fetch(`${msgBase}/superadmin/logs/search?${params}`, {
     headers: {
@@ -72,8 +85,8 @@ async function searchLogs(argv) {
     process.exit(1);
   }
 
-  const entries = await res.json();
-  if (!Array.isArray(entries) || !entries.length) {
+  const entries = extractLogEntries(await res.json());
+  if (!entries.length) {
     console.log('No results.');
     return;
   }
@@ -210,8 +223,7 @@ async function diagnoseLogs(argv) {
       signal: AbortSignal.timeout(15000),
     });
     if (!r.ok) return [];
-    const d = await r.json();
-    return Array.isArray(d) ? d : [];
+    return extractLogEntries(await r.json());
   }
 
   const [errors, perfAndRouting] = await Promise.all([
@@ -675,14 +687,17 @@ export const logsCommand = {
       describe: 'Search application logs',
       builder:  y => y
         .positional('query', { describe: 'Text to search for (or regex with --regex)', type: 'string' })
-        .option('level',       { describe: 'Filter by level: ERROR, WARN, INFO, DEBUG', type: 'string' })
-        .option('integration', { describe: 'Integration tag (HubSpot, NetSuite, [Skill], etc.)', type: 'string' })
-        .option('site',        { describe: 'Filter by site ID', type: 'number' })
-        .option('source',      { describe: 'App source (velaro-messaging-Staging, etc.)', type: 'string' })
-        .option('last',        { describe: 'Time window: 30m, 2h, 1d', default: '2h', type: 'string' })
-        .option('regex',       { describe: 'Treat query as regex', boolean: true, default: false })
-        .option('take',        { describe: 'Max results (max 500)', default: 50, type: 'number' })
-        .option('env',         { describe: 'staging or prod', type: 'string' }),
+        .option('level',         { describe: 'Filter by level: ERROR, WARN, INFO, DEBUG', type: 'string' })
+        .option('integration',   { describe: 'Integration tag (HubSpot, NetSuite, [Skill], etc.)', type: 'string' })
+        .option('site',          { describe: 'Filter by site ID', type: 'number' })
+        .option('source',        { describe: 'App source (velaro-messaging-Staging, etc.)', type: 'string' })
+        .option('platform',      { describe: 'Filter by platform: v10, v20, admin', type: 'string' })
+        .option('environment',   { describe: 'Filter by environment: Production, Staging, Development', type: 'string' })
+        .option('correlationId', { describe: 'Exact correlation/trace ID filter', type: 'string' })
+        .option('last',          { describe: 'Time window: 30m, 2h, 1d', default: '2h', type: 'string' })
+        .option('regex',         { describe: 'Treat query as regex', boolean: true, default: false })
+        .option('take',          { describe: 'Max results (max 500)', default: 50, type: 'number' })
+        .option('env',           { describe: 'staging or prod', type: 'string' }),
       handler: searchLogs,
     })
     .command({

package/lib/commands/ops.js

@@ -14,6 +14,17 @@ function ago(dateStr) {
   return `${Math.round(hrs / 24)}d ago`;
 }
 
+// FIXED 2026-09-24: velaro-messaging's /superadmin/logs/search used to return a bare JSON array
+// for some queries and {entries, nextCursor} for others, depending on which internal code path
+// served the request. It now always returns {entries, nextCursor} -- this helper also accepts a
+// bare array so this command degrades gracefully rather than crashing if pointed at an older
+// deploy.
+function extractLogEntries(response) {
+  if (Array.isArray(response)) return response;
+  if (response && Array.isArray(response.entries)) return response.entries;
+  return [];
+}
+
 function utcLabel(dateStr) {
   if (!dateStr) return '';
   const d = new Date(dateStr);
@@ -236,8 +247,8 @@ export const opsCommand = {
         }),
       ]);
 
-      const errors   = errRes.ok  ? (await errRes.json().catch(() => [])) : [];
-      const perfLogs = perfRes.ok ? (await perfRes.json().catch(() => [])) : [];
+      const errors   = errRes.ok  ? extractLogEntries(await errRes.json().catch(() => [])) : [];
+      const perfLogs = perfRes.ok ? extractLogEntries(await perfRes.json().catch(() => [])) : [];
 
       const perfCount  = perfLogs.filter(e => (e.Message ?? e.message ?? '').includes('PERF-SLOW')).length;
       const routeCount = perfLogs.filter(e => (e.Message ?? e.message ?? '').includes('WF-AI-ROUTE')).length;

package/package.json

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