@velaro/cli 1.4.105 → 1.4.107

package/lib/log-search.test.js

@@ -321,7 +321,7 @@ test('fetchRetry429 retries only 429 and returns the final response after the re
 });
 
 test('bot_full_diagnostic: errors use the server-side level=ERROR filter, patterns are a separate read; neither is the old text regex', () => {
-  for (const rel of ['../../mcp/staff-server.js', '../../mcp/server.js']) {
+  for (const rel of ['../../mcp/staff-server.js']) { // bot_full_diagnostic is staff-only since MCP 2.0.0
     const src = fs.readFileSync(path.join(here, rel), 'utf8');
     const a = src.indexOf('const velaroLoggerP = safeJson');
     const body = src.slice(a, a + 2600);

package/lib/parity-util.js

@@ -0,0 +1,27 @@
+// Shared helpers for the MCP-parity command groups (diag-groups.js, ops-groups.js).
+export const show = (r) => console.log(typeof r === 'string' ? r : JSON.stringify(r, null, 2));
+export const qs = (o) => {
+  const p = new URLSearchParams();
+  for (const [k, v] of Object.entries(o)) if (v !== undefined && v !== null && v !== '') p.set(k, String(v));
+  const s = p.toString();
+  return s ? `?${s}` : '';
+};
+export const run = (fn) => async (argv) => {
+  try { await fn(argv); } catch (e) { console.error(`Error: ${e.message}`); process.exit(1); }
+};
+export const needYes = (argv, what) => {
+  if (!argv.yes) { console.error(`Refusing to ${what} without --yes.`); process.exit(1); }
+};
+// Build a yargs group body (spread into `{ command: 'name', ...group(...) }` so the parity validator sees the command name): subs = [[command, describe, builderFn|null, handler]]
+export function group(describe, subs) {
+  return {
+    describe,
+    builder: (y) => {
+      for (const [command, desc, b, handler] of subs) {
+        y.command({ command, describe: desc, builder: b || ((x) => x), handler: run(handler) });
+      }
+      return y.demandCommand(1, `Specify a subcommand: ${subs.map((s) => s[0].split(' ')[0]).join(' | ')}`);
+    },
+    handler: () => {},
+  };
+}

package/lib/sign-versions.test.js

@@ -42,7 +42,7 @@ import { readFileSync } from 'node:fs';
 import { fileURLToPath } from 'node:url';
 import { dirname, join as pjoin } from 'node:path';
 const root = pjoin(dirname(fileURLToPath(import.meta.url)), '..', '..');
-for (const f of ['mcp/server.js', 'mcp/staff-server.js', 'server/Velaro.Admin/Controllers/StaffMcpController.cs']) {
+for (const f of ['mcp/staff-server.js', 'server/Velaro.Admin/Controllers/StaffMcpController.cs']) {
   test(`${f} registers sign_versions tools`, () => {
     const s = readFileSync(pjoin(root, f), 'utf8');
     for (const t of ['sign_versions_list', 'sign_versions_diff', 'sign_versions_upload']) assert.ok(s.includes(t), `${t} missing in ${f}`);

package/lib/skill-usage.test.js

@@ -0,0 +1,36 @@
+import { test } from 'node:test';
+import assert from 'node:assert/strict';
+import { formatSkillUsage } from './commands/skill-usage.js';
+
+const sample = {
+  siteId: 1032,
+  month: '2026-10',
+  isTrial: true,
+  overageBehavior: 'block',
+  usage: [
+    { metric: 'ai_tool_calls', name: 'AI Tool Calls', used: 120, limit: 500, unlimited: false, percent: 24, mode: 'Enforce' },
+    { metric: 'api_calls', name: 'REST API Calls', used: 9, limit: 0, unlimited: true, percent: 0, mode: 'Observe' },
+  ],
+  callsBySurface: [{ surface: 'McpStaff', calls: 4 }],
+  llmCostThisMonth: [{ keySource: 'byok', costUsd: 1.5, calls: 3 }],
+};
+
+test('shows usage against the limit with the gate mode, and marks unlimited metrics', () => {
+  const out = formatSkillUsage(sample);
+  assert.match(out, /Site 1032, 2026-10 \(trial\), overage: block/);
+  assert.match(out, /AI Tool Calls\s+120 \/\s+500\s+24%\s+gate: Enforce/);
+  assert.match(out, /REST API Calls\s+9 \/\s+unlimited/);
+});
+
+test('lists calls by surface and the LLM cost split, saying BYOK removes LLM cost only', () => {
+  const out = formatSkillUsage(sample);
+  assert.match(out, /McpStaff\s+4/);
+  assert.match(out, /byok\s+\$1\.50 \/ 3 calls/);
+  assert.match(out, /BYOK removes this cost only/);
+});
+
+test('handles a site with no recorded usage without throwing', () => {
+  const out = formatSkillUsage({ siteId: 5, month: '2026-10', overageBehavior: 'warn' });
+  assert.match(out, /\(none recorded\)/);
+  assert.match(out, /\(none logged\)/);
+});

package/package.json

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