@velaro/cli 0.5.0 → 0.7.0

package/bin/velaro.js

@@ -13,6 +13,8 @@ import { ruleCommand }                          from '../lib/commands/rule.js';
 import { agentCommand }                         from '../lib/commands/agent.js';
 import { ingestCommand }                        from '../lib/commands/ingest.js';
 import { mcpKeyCommand }                        from '../lib/commands/mcp-key.js';
+import { indexCommand }                          from '../lib/commands/index.js';
+import { opsCommand }                           from '../lib/commands/ops.js';
 import { statusCommand }                        from '../lib/commands/status.js';
 import { siteCommand }                          from '../lib/commands/site.js';
 import { checkCommand }                         from '../lib/commands/check.js';
@@ -41,9 +43,11 @@ await yargs(hideBin(process.argv))
   .command(workflowCommand)
   .command(ruleCommand)
   .command(agentCommand)
-  // Integrations / keys
+  // Integrations / keys / indexes
   .command(ingestCommand)
   .command(mcpKeyCommand)
+  .command(indexCommand)
+  .command(opsCommand)
   // CLI maintenance
   .command(updateCommand)
   .demandCommand(1, 'Specify a command. Run velaro --help for a list.')

package/lib/api.js

@@ -1,52 +1,52 @@
-import { readConfig, writeConfig, getActiveEnv, setEnvCredentials, ENVS } from './config.js';
-import { refreshVelaroToken } from './oauth.js';
-
-const REFRESH_BUFFER_MS = 5 * 60 * 1000;
-
-export async function getCredentials(envOverride) {
-  const cfg = readConfig();
-  const env = envOverride || cfg.activeEnv || 'prod';
-  let creds = cfg.envs?.[env];
-
-  if (!creds?.velaroToken) {
-    throw new Error(`Not logged in to ${env}. Run: velaro login${env === 'staging' ? ' --staging' : ''}`);
-  }
-
-  if (Date.now() + REFRESH_BUFFER_MS >= new Date(creds.velaroExpires).getTime()) {
-    if (!creds.entraRefreshToken) {
-      throw new Error(`Session expired for ${env}. Run: velaro login${env === 'staging' ? ' --staging' : ''}`);
-    }
-    const refreshed = await refreshVelaroToken({ ...creds, apiBase: creds.adminApiBase });
-    const updated = { ...creds, ...refreshed };
-    setEnvCredentials(env, updated);
-    creds = updated;
-  }
-
-  return { ...creds, env };
-}
-
-export async function request(method, path, body, envOverride) {
-  const creds = await getCredentials(envOverride);
-
-  const res = await fetch(`${creds.adminApiBase}${path}`, {
-    method,
-    headers: {
-      Authorization:  `Bearer ${creds.velaroToken}`,
-      'Content-Type': 'application/json',
-    },
-    body: body !== undefined ? JSON.stringify(body) : undefined,
-  });
-
-  if (!res.ok) {
-    let msg = `${method} ${path} → ${res.status}`;
-    try { const t = await res.text(); if (t) msg += `: ${t}`; } catch { /* status already captured */ }
-    throw new Error(msg);
-  }
-
-  const text = await res.text();
-  return text ? JSON.parse(text) : null;
-}
-
-export const get  = (path)       => request('GET',    path);
-export const post = (path, body) => request('POST',   path, body);
-export const del  = (path)       => request('DELETE', path);
+import { readConfig, writeConfig, getActiveEnv, setEnvCredentials, ENVS } from './config.js';
+import { refreshVelaroToken } from './oauth.js';
+
+const REFRESH_BUFFER_MS = 5 * 60 * 1000;
+
+export async function getCredentials(envOverride) {
+  const cfg = readConfig();
+  const env = envOverride || cfg.activeEnv || 'prod';
+  let creds = cfg.envs?.[env];
+
+  if (!creds?.velaroToken) {
+    throw new Error(`Not logged in to ${env}. Run: velaro login${env === 'staging' ? ' --staging' : ''}`);
+  }
+
+  if (Date.now() + REFRESH_BUFFER_MS >= new Date(creds.velaroExpires).getTime()) {
+    if (!creds.entraRefreshToken) {
+      throw new Error(`Session expired for ${env}. Run: velaro login${env === 'staging' ? ' --staging' : ''}`);
+    }
+    const refreshed = await refreshVelaroToken({ ...creds, apiBase: creds.adminApiBase });
+    const updated = { ...creds, ...refreshed };
+    setEnvCredentials(env, updated);
+    creds = updated;
+  }
+
+  return { ...creds, env };
+}
+
+export async function request(method, path, body, envOverride) {
+  const creds = await getCredentials(envOverride);
+
+  const res = await fetch(`${creds.adminApiBase}${path}`, {
+    method,
+    headers: {
+      Authorization:  `Bearer ${creds.velaroToken}`,
+      'Content-Type': 'application/json',
+    },
+    body: body !== undefined ? JSON.stringify(body) : undefined,
+  });
+
+  if (!res.ok) {
+    let msg = `${method} ${path} → ${res.status}`;
+    try { const t = await res.text(); if (t) msg += `: ${t}`; } catch { /* status already captured */ }
+    throw new Error(msg);
+  }
+
+  const text = await res.text();
+  return text ? JSON.parse(text) : null;
+}
+
+export const get  = (path)       => request('GET',    path);
+export const post = (path, body) => request('POST',   path, body);
+export const del  = (path)       => request('DELETE', path);

package/lib/commands/agent.js

@@ -1,50 +1,50 @@
-import { get, post }  from '../api.js';
-import { runCommand }  from '../run.js';
-
-const VALID_STATUSES = ['Available', 'Away', 'Offline'];
-
-export const agentCommand = {
-  command:  'agent <subcommand>',
-  describe: 'View and manage agents',
-  builder:  (yargs) => yargs
-    .command({
-      command:  'list',
-      describe: 'List agents and their current availability',
-      handler:  runCommand(async () => {
-        const [agents, teams] = await Promise.all([
-          get('/Users/List'),
-          get('/Teams/List'),
-        ]);
-
-        const teamMap = Object.fromEntries(teams.map(t => [t.id, t.name]));
-
-        if (!agents.length) { console.log('No agents found.'); return; }
-
-        const rows = agents.map(a => ({
-          id:     `[${a.id}]`,
-          status: (a.status ?? 'Offline').padEnd(9),
-          name:   a.displayName || `${a.firstName} ${a.lastName}`.trim() || a.email,
-          teams:  (a.teamIds ?? []).map(id => teamMap[id] ?? `team ${id}`).join(', ') || '—',
-        }));
-
-        const idW = Math.max(...rows.map(r => r.id.length));
-
-        for (const r of rows) {
-          console.log(`${r.id.padStart(idW)}  ${r.status}  ${r.name.padEnd(30)}  ${r.teams}`);
-        }
-        console.log(`\n${rows.length} agent(s)`);
-      }),
-    })
-    .command({
-      command:  'set-status',
-      describe: 'Set an agent\'s availability status (admin only)',
-      builder:  (y) => y
-        .option('id',     { type: 'number', demandOption: true, describe: 'Agent user ID' })
-        .option('status', { type: 'string', demandOption: true, describe: 'Available | Away | Offline', choices: VALID_STATUSES }),
-      handler: runCommand(async (argv) => {
-        await post('/UserStatus/admin', { userId: argv.id, status: argv.status });
-        console.log(`Agent ${argv.id} set to ${argv.status}.`);
-      }),
-    })
-    .demandCommand(1, 'Specify a subcommand: list | set-status'),
-};
+import { get, post }  from '../api.js';
+import { runCommand }  from '../run.js';
+
+const VALID_STATUSES = ['Available', 'Away', 'Offline'];
+
+export const agentCommand = {
+  command:  'agent <subcommand>',
+  describe: 'View and manage agents',
+  builder:  (yargs) => yargs
+    .command({
+      command:  'list',
+      describe: 'List agents and their current availability',
+      handler:  runCommand(async () => {
+        const [agents, teams] = await Promise.all([
+          get('/Users/List'),
+          get('/Teams/List'),
+        ]);
+
+        const teamMap = Object.fromEntries(teams.map(t => [t.id, t.name]));
+
+        if (!agents.length) { console.log('No agents found.'); return; }
+
+        const rows = agents.map(a => ({
+          id:     `[${a.id}]`,
+          status: (a.status ?? 'Offline').padEnd(9),
+          name:   a.displayName || `${a.firstName} ${a.lastName}`.trim() || a.email,
+          teams:  (a.teamIds ?? []).map(id => teamMap[id] ?? `team ${id}`).join(', ') || '—',
+        }));
+
+        const idW = Math.max(...rows.map(r => r.id.length));
+
+        for (const r of rows) {
+          console.log(`${r.id.padStart(idW)}  ${r.status}  ${r.name.padEnd(30)}  ${r.teams}`);
+        }
+        console.log(`\n${rows.length} agent(s)`);
+      }),
+    })
+    .command({
+      command:  'set-status',
+      describe: 'Set an agent\'s availability status (admin only)',
+      builder:  (y) => y
+        .option('id',     { type: 'number', demandOption: true, describe: 'Agent user ID' })
+        .option('status', { type: 'string', demandOption: true, describe: 'Available | Away | Offline', choices: VALID_STATUSES }),
+      handler: runCommand(async (argv) => {
+        await post('/UserStatus/admin', { userId: argv.id, status: argv.status });
+        console.log(`Agent ${argv.id} set to ${argv.status}.`);
+      }),
+    })
+    .demandCommand(1, 'Specify a subcommand: list | set-status'),
+};

package/lib/commands/article.js

@@ -178,6 +178,30 @@ const deleteCommand = {
   }),
 };
 
+// ── seed-views ────────────────────────────────────────────────────────────────
+
+const seedViewsCommand = {
+  command:  'seed-views <id>',
+  describe: 'Seed an article with random view counts (for new article submissions)',
+  builder:  (y) =>
+    y
+      .positional('id', { type: 'number', describe: 'Article ID to seed' })
+      .option('hits', { type: 'number', default: 0, describe: 'Hit count (0 = random 1000-1999)' }),
+  handler: runCommand(async (argv) => {
+    const hitCount = argv.hits === 0 ? (Math.floor(Math.random() * 1000) + 1000) : argv.hits;
+    const payload = { articleId: argv.id, hitCount };
+
+    try {
+      // Call API endpoint using stored OAuth token — no credentials in code
+      await adminRequest('POST', '/api/kb/articles/seed-views', payload);
+      console.log(`✅ Article [${argv.id}] seeded with ${hitCount} views.`);
+    } catch (e) {
+      console.error(`❌ Failed to seed article: ${e.message}`);
+      throw e;
+    }
+  }),
+};
+
 // ── improve ───────────────────────────────────────────────────────────────────
 
 const improveCommand = {
@@ -230,8 +254,9 @@ export const articleCommand = {
       .command(topicsCommand)
       .command(pushCommand)
       .command(deleteCommand)
+      .command(seedViewsCommand)
       .command(improveCommand)
-      .demandCommand(1, 'Specify a subcommand: list, get, topics, push, delete, improve'),
+      .demandCommand(1, 'Specify a subcommand: list, get, topics, push, delete, seed-views, improve'),
   handler: () => {},
 };
 
@@ -260,18 +285,101 @@ function parseFrontmatter(raw) {
   return { ...fm, body };
 }
 
-function markdownToHtml(md) {
-  // Minimal markdown-to-HTML — headings, bold, inline code, paragraphs.
-  // For rich content use an .html file or the admin UI.
-  return md
-    .replace(/^### (.+)$/gm, '<h3>$1</h3>')
-    .replace(/^## (.+)$/gm,  '<h2>$1</h2>')
-    .replace(/^# (.+)$/gm,   '<h1>$1</h1>')
+// help.velaro.com kb.css styles .kb-article-body table/th/td natively (header #1e3a5f,
+// rounded corners, shadow, horizontal-scroll wrapper). Admin editor preview uses the same class.
+// Inline fallback styles cover any external renderer that doesn't ship our CSS.
+const TABLE_STYLE  = 'border-collapse:collapse;width:100%;margin:16px 0;font-size:14px;';
+const TH_STYLE     = 'border:1px solid #1e3a5f;padding:11px 16px;background:#1e3a5f;color:#fff;text-align:left;font-weight:600;';
+const TD_STYLE     = 'border:1px solid #e2e8f0;padding:10px 14px;vertical-align:top;color:#1e293b;';
+
+function inlineMd(s) {
+  return s
     .replace(/\*\*(.+?)\*\*/g, '<strong>$1</strong>')
-    .replace(/`([^`]+)`/g,    '<code>$1</code>')
-    .replace(/\n\n+/g,        '</p><p>')
-    .replace(/^(?!<[hup])/gm, '')
-    .replace(/^(.+)(?!>)$/gm, (m) => m.startsWith('<') ? m : `<p>${m}</p>`);
+    .replace(/(^|[^*])\*([^*\n]+)\*/g, '$1<em>$2</em>')
+    .replace(/`([^`]+)`/g, '<code>$1</code>')
+    .replace(/\[([^\]]+)\]\(([^)]+)\)/g, '<a href="$2">$1</a>');
+}
+
+function markdownToHtml(md) {
+  const lines = md.replace(/\r\n/g, '\n').split('\n');
+  const out = [];
+  let i = 0;
+  let para = [];
+  let list = null; // { type: 'ul'|'ol', items: [] }
+
+  const flushPara = () => {
+    if (para.length) {
+      out.push(`<p>${inlineMd(para.join(' '))}</p>`);
+      para = [];
+    }
+  };
+  const flushList = () => {
+    if (list) {
+      out.push(`<${list.type}>` + list.items.map(x => `<li>${inlineMd(x)}</li>`).join('') + `</${list.type}>`);
+      list = null;
+    }
+  };
+  const flushAll = () => { flushPara(); flushList(); };
+
+  const isTableSep = (s) => /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)+\|?\s*$/.test(s);
+  const splitRow = (s) => {
+    let t = s.trim();
+    if (t.startsWith('|')) t = t.slice(1);
+    if (t.endsWith('|')) t = t.slice(0, -1);
+    return t.split('|').map(c => c.trim());
+  };
+
+  while (i < lines.length) {
+    const line = lines[i];
+
+    if (/^\s*$/.test(line)) { flushAll(); i++; continue; }
+
+    const h = line.match(/^(#{1,6})\s+(.+)$/);
+    if (h) { flushAll(); out.push(`<h${h[1].length}>${inlineMd(h[2])}</h${h[1].length}>`); i++; continue; }
+
+    // Pipe table
+    if (line.includes('|') && i + 1 < lines.length && isTableSep(lines[i + 1])) {
+      flushAll();
+      const header = splitRow(line);
+      i += 2;
+      const rows = [];
+      while (i < lines.length && lines[i].includes('|') && lines[i].trim() !== '') {
+        rows.push(splitRow(lines[i]));
+        i++;
+      }
+      const thead = `<thead><tr>${header.map(c => `<th style="${TH_STYLE}">${inlineMd(c)}</th>`).join('')}</tr></thead>`;
+      const tbody = `<tbody>${rows.map(r => `<tr>${r.map(c => `<td style="${TD_STYLE}">${inlineMd(c)}</td>`).join('')}</tr>`).join('')}</tbody>`;
+      out.push(`<table class="velaro-kb-table" style="${TABLE_STYLE}">${thead}${tbody}</table>`);
+      continue;
+    }
+
+    const ul = line.match(/^\s*[-*]\s+(.+)$/);
+    if (ul) {
+      flushPara();
+      if (!list || list.type !== 'ul') { flushList(); list = { type: 'ul', items: [] }; }
+      list.items.push(ul[1]);
+      i++; continue;
+    }
+    const ol = line.match(/^\s*\d+\.\s+(.+)$/);
+    if (ol) {
+      flushPara();
+      if (!list || list.type !== 'ol') { flushList(); list = { type: 'ol', items: [] }; }
+      list.items.push(ol[1]);
+      i++; continue;
+    }
+
+    if (/^<(h[1-6]|table|ul|ol|p|div|pre|blockquote)/i.test(line.trim())) {
+      flushAll();
+      out.push(line);
+      i++; continue;
+    }
+
+    flushList();
+    para.push(line.trim());
+    i++;
+  }
+  flushAll();
+  return out.join('\n');
 }
 
 function truncate(str, max) {