@velaro/cli 0.7.0 → 1.4.8

package/lib/commands/magento.js

@@ -0,0 +1,210 @@
+/**
+ * velaro magento — Magento / Adobe Commerce store management
+ *
+ *   velaro magento list             List connected Magento stores
+ *   velaro magento test             Test a store connection
+ *   velaro magento customers        Search customers by email
+ *   velaro magento orders           Search orders by email or order ID
+ *   velaro magento products         Search the product catalog
+ *   velaro magento logs             View integration activity logs
+ */
+
+import { request } from '../api.js';
+
+const GRN  = '\x1b[32m';
+const RED  = '\x1b[31m';
+const CYN  = '\x1b[36m';
+const DIM  = '\x1b[2m';
+const BOLD = '\x1b[1m';
+const RST  = '\x1b[0m';
+
+// ── list ──────────────────────────────────────────────────────────────────────
+
+async function listHandler() {
+  const stores = await request('GET', '/Magento/Configs');
+  if (!Array.isArray(stores) || stores.length === 0) {
+    console.log('\nNo Magento stores connected. Set one up in the admin UI under Integrations → Magento.\n');
+    return;
+  }
+  console.log(`\n${BOLD}${stores.length} Magento store(s)${RST}\n`);
+  for (const s of stores) {
+    const status = s.isActive ? `${GRN}active${RST}` : `${DIM}inactive${RST}`;
+    const edition = [s.edition, s.magentoVersion].filter(Boolean).join(' ') || 'CE';
+    console.log(`  [${s.id}] ${BOLD}${s.displayName ?? s.storeName}${RST}  ${DIM}${s.storeUrl}${RST}`);
+    console.log(`       ${edition} | ${status}`);
+  }
+  console.log('');
+}
+
+// ── test ──────────────────────────────────────────────────────────────────────
+
+async function testHandler(argv) {
+  if (!argv.url || !argv.token) {
+    console.error(`${RED}✗ --url and --token are required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  try {
+    const r = await request('POST', '/Magento/Configs/Test', {
+      storeUrl: argv.url,
+      accessToken: argv.token,
+    });
+    console.log(`\n${GRN}✓ Connected${RST} to "${r.storeName}" (${r.edition} ${r.version})\n`);
+  } catch (e) {
+    console.error(`\n${RED}✗ Connection failed: ${e.message}${RST}\n`);
+    process.exitCode = 1;
+  }
+}
+
+// ── customers ─────────────────────────────────────────────────────────────────
+
+async function customersHandler(argv) {
+  if (!argv.email) {
+    console.error(`${RED}✗ --email is required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  const r = await request('GET', `/Magento/Customers/Search?q=${encodeURIComponent(argv.email)}`);
+  if (!r || !r.id) {
+    console.log(`\nNo customer found for ${argv.email}.\n`);
+    return;
+  }
+  console.log(`\n${BOLD}Magento Customer${RST}\n`);
+  console.log(`  ID:     ${r.id}`);
+  console.log(`  Name:   ${r.name ?? '(none)'}`);
+  console.log(`  Email:  ${CYN}${r.email}${RST}`);
+  console.log(`  Group:  ${r.group ?? r.groupId ?? 'General'}`);
+  console.log('');
+}
+
+// ── orders ────────────────────────────────────────────────────────────────────
+
+async function ordersHandler(argv) {
+  if (!argv.email && !argv.id) {
+    console.error(`${RED}✗ --email or --id is required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  const q = argv.id ?? argv.email;
+  const limit = Math.min(50, argv.limit ?? 10);
+  const orders = await request('GET', `/Magento/Orders/Search?q=${encodeURIComponent(q)}&limit=${limit}`);
+  if (!Array.isArray(orders) || orders.length === 0) {
+    console.log(`\nNo orders found for "${q}".\n`);
+    return;
+  }
+  console.log(`\n${BOLD}${orders.length} order(s)${RST}\n`);
+  for (const o of orders) {
+    const date = (o.createdAt ?? '').slice(0, 10);
+    console.log(`  [${o.incrementId ?? o.id}]  ${o.status?.padEnd(12)}  $${String(o.grandTotal ?? 0).padStart(9)}  ${DIM}${date}${RST}`);
+    if (argv.verbose && o.items?.length) {
+      console.log(`          ${DIM}${o.items.join(' · ')}${RST}`);
+    }
+  }
+  console.log('');
+}
+
+// ── products ──────────────────────────────────────────────────────────────────
+
+async function productsHandler(argv) {
+  if (!argv.query) {
+    console.error(`${RED}✗ --query is required${RST}`);
+    process.exitCode = 1;
+    return;
+  }
+  const limit = Math.min(50, argv.limit ?? 10);
+  const products = await request('GET', `/Magento/Products/Search?q=${encodeURIComponent(argv.query)}&limit=${limit}`);
+  if (!Array.isArray(products) || products.length === 0) {
+    console.log(`\nNo products found for "${argv.query}".\n`);
+    return;
+  }
+  console.log(`\n${BOLD}${products.length} product(s)${RST}\n`);
+  for (const p of products) {
+    const status = p.status === 'Enabled' ? `${GRN}enabled${RST}` : `${DIM}disabled${RST}`;
+    console.log(`  [${p.sku}]  ${BOLD}${p.name}${RST}  $${p.price}  ${status}`);
+    if (p.url) console.log(`            ${DIM}${p.url}${RST}`);
+  }
+  console.log('');
+}
+
+// ── logs ──────────────────────────────────────────────────────────────────────
+
+async function logsHandler(argv) {
+  const params = new URLSearchParams();
+  if (argv.severity) params.set('severity', argv.severity);
+  if (argv.search)   params.set('search', argv.search);
+  params.set('pageSize', String(Math.min(100, argv.pageSize ?? 25)));
+  const data = await request('GET', `/Integration/Logs/Magento?${params}`);
+  const items = data?.items ?? [];
+  if (items.length === 0) {
+    console.log('\nNo Magento activity log entries found.\n');
+    return;
+  }
+  console.log(`\n${BOLD}${items.length} of ${data.total} Magento activity entries${RST}\n`);
+  for (const item of items) {
+    const ts  = new Date(item.createdAt).toISOString().replace('T', ' ').slice(0, 19);
+    const sev = item.severity === 'Error'   ? `${RED}${item.severity}${RST}  ` :
+                item.severity === 'Warning' ? `${'\x1b[33m'}${item.severity}${RST}` :
+                `${DIM}${item.severity}${RST}  `;
+    console.log(`  ${DIM}${ts}${RST}  ${sev}  [${item.category ?? '?'}]  ${item.message ?? ''}`);
+    if (item.additionalInfo) console.log(`           ${DIM}${item.additionalInfo}${RST}`);
+  }
+  if (data.total > items.length) console.log(`\n  ${DIM}${data.total - items.length} more — use --page-size to see more${RST}`);
+  console.log('');
+}
+
+// ── command export ────────────────────────────────────────────────────────────
+
+export const magentoCommand = {
+  command:  'magento <subcommand>',
+  describe: 'Magento / Adobe Commerce store management',
+  builder: y => y
+    .command({
+      command:  'list',
+      describe: 'List connected Magento stores',
+      handler:  listHandler,
+    })
+    .command({
+      command:  'test',
+      describe: 'Test a Magento store connection',
+      builder: yy => yy
+        .option('url',   { describe: 'Magento store URL', type: 'string' })
+        .option('token', { describe: 'Admin API bearer token', type: 'string' }),
+      handler: testHandler,
+    })
+    .command({
+      command:  'customers',
+      describe: 'Search Magento customers by email',
+      builder: yy => yy
+        .option('email', { describe: 'Customer email address', type: 'string' }),
+      handler: customersHandler,
+    })
+    .command({
+      command:  'orders',
+      describe: 'Search Magento orders by email or order ID',
+      builder: yy => yy
+        .option('email',   { describe: 'Customer email address', type: 'string' })
+        .option('id',      { describe: 'Order increment ID (e.g. 000001234)', type: 'string' })
+        .option('limit',   { describe: 'Max results (default: 10)', type: 'number', default: 10 })
+        .option('verbose', { describe: 'Show order line items', type: 'boolean', default: false }),
+      handler: ordersHandler,
+    })
+    .command({
+      command:  'products',
+      describe: 'Search the Magento product catalog',
+      builder: yy => yy
+        .option('query', { describe: 'Product name search query', type: 'string' })
+        .option('limit', { describe: 'Max results (default: 10)', type: 'number', default: 10 }),
+      handler: productsHandler,
+    })
+    .command({
+      command:  'logs',
+      describe: 'View Magento integration activity logs',
+      builder: yy => yy
+        .option('severity',  { describe: 'Filter: Info, Warning, Error', type: 'string' })
+        .option('search',    { describe: 'Text to search for in messages', type: 'string' })
+        .option('page-size', { describe: 'Results per page (default: 25)', type: 'number', default: 25 }),
+      handler: logsHandler,
+    })
+    .demandCommand(1, 'Specify a subcommand. Try: velaro magento --help'),
+  handler: () => {},
+};

package/lib/commands/mcp-key.js

@@ -1,159 +1,188 @@
-import fs   from 'fs';
-import path from 'path';
-import os   from 'os';
-import { get, post, del } from '../api.js';
-import { getActiveEnv, ENVS } from '../config.js';
-import { runCommand }      from '../run.js';
-
-export const mcpKeyCommand = {
-  command:  'mcp-key <subcommand>',
-  describe: 'Manage MCP API keys (vel_live_* keys for AI skill access)',
-  builder:  (yargs) =>
-    yargs
-      .command(mcpKeyListCommand)
-      .command(mcpKeyCreateCommand)
-      .command(mcpKeyRevokeCommand)
-      .command(mcpKeyRotateCommand)
-      .command(mcpKeyInstallCommand)
-      .demandCommand(1, 'Specify a subcommand: list, create, revoke, rotate, install'),
-  handler: () => {},
-};
-
-const mcpKeyListCommand = {
-  command:  'list',
-  describe: 'List MCP API keys for your site',
-  handler:  runCommand(async () => {
-    const keys = await get('/McpApiKeys');
-    if (!keys?.length) { console.log('No MCP keys found.'); return; }
-    console.log(`Found ${keys.length} key(s):\n`);
-    for (const k of keys) {
-      const used    = k.lastUsedAt ? new Date(k.lastUsedAt).toLocaleDateString() : 'never';
-      const expires = k.expiresAt  ? `  expires ${new Date(k.expiresAt).toLocaleDateString()}` : '';
-      console.log(`  [${k.id}] ${k.label}  prefix=${k.keyPrefix}  ${k.isActive ? 'active' : 'revoked'}  last used=${used}${expires}`);
-    }
-  }),
-};
-
-const mcpKeyCreateCommand = {
-  command:  'create',
-  describe: 'Create a new MCP API key',
-  builder:  (y) =>
-    y
-      .option('label', {
-        describe:     'Human-readable label (e.g. "Claude Code")',
-        type:         'string',
-        demandOption: true,
-      })
-      .option('expires', {
-        describe: 'Expiry date in ISO 8601 format (e.g. 2027-01-01)',
-        type:     'string',
-      }),
-
-  handler: runCommand(async (argv) => {
-    const payload = { label: argv.label };
-    if (argv.expires) payload.expiresAt = new Date(argv.expires).toISOString();
-
-    const result = await post('/McpApiKeys', payload);
-    console.log(`MCP key created: ${result.label}`);
-    console.log(`\n  Key: ${result.rawKey}`);
-    console.log(`\n  ${result.warning ?? 'Copy this key now — it will not be shown again.'}`);
-  }),
-};
-
-const mcpKeyRevokeCommand = {
-  command:  'revoke <id>',
-  describe: 'Revoke an MCP API key by ID',
-  handler:  runCommand(async (argv) => {
-    await del(`/McpApiKeys/${argv.id}`);
-    console.log(`Key ${argv.id} revoked.`);
-  }),
-};
-
-const mcpKeyInstallCommand = {
-  command:  'install',
-  describe: 'Create an MCP key and write it to ~/.claude/settings.json automatically',
-  builder:  (y) =>
-    y
-      .option('label', {
-        describe: 'Label for the key',
-        type:     'string',
-      })
-      .option('staging', {
-        describe: 'Install key for the staging environment',
-        type:     'boolean',
-        default:  false,
-      }),
-
-  handler: runCommand(async (argv) => {
-    const env     = argv.staging ? 'staging' : getActiveEnv();
-    const apiBase = ENVS[env].adminApiBase;
-    const label   = argv.label || (env === 'staging' ? 'Claude Code (Staging)' : 'Claude Code');
-
-    const payload = { label };
-    const result  = await post('/McpApiKeys', payload);
-    const rawKey  = result.rawKey;
-
-    // Write to ~/.claude/settings.json
-    // prod  → entry named "velaro"
-    // staging → entry named "velaro-staging"
-    const serverName  = env === 'prod' ? 'velaro' : `velaro-${env}`;
-    const settingsPath = path.join(os.homedir(), '.claude', 'settings.json');
-    let settings = {};
-    if (fs.existsSync(settingsPath)) {
-      try { settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8')); } catch {}
-    }
-
-    settings.mcpServers = settings.mcpServers || {};
-    settings.mcpServers[serverName] = {
-      command: 'npx',
-      args:    ['-y', '@velaro/mcp-server'],
-      env:     {
-        VELARO_MCP_KEY:   rawKey,
-        VELARO_ADMIN_API: apiBase,
-      },
-    };
-
-    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-
-    console.log(`✅ MCP key created: ${label}  (${result.keyPrefix}...)`);
-    console.log(`✅ Written to settings.json as "${serverName}" → ${apiBase}`);
-    console.log(`\nRestart Claude Code to pick up the new MCP server.`);
-    console.log(`\nTo use in Claude Code: say "use ${serverName}" to target ${env}.`);
-  }),
-};
-
-const mcpKeyRotateCommand = {
-  command:  'rotate <id>',
-  describe: 'Revoke an existing key and issue a replacement in one step',
-  builder:  (y) =>
-    y
-      .positional('id', { type: 'number', describe: 'ID of the key to revoke (get it from mcp-key list)' })
-      .option('label', {
-        describe: 'Label for the replacement key (defaults to the old key\'s label)',
-        type:     'string',
-      })
-      .option('expires', {
-        describe: 'Expiry date for the new key in ISO 8601 format (e.g. 2027-01-01)',
-        type:     'string',
-      }),
-
-  handler: runCommand(async (argv) => {
-    const keys = await get('/McpApiKeys');
-    const old  = keys?.find(k => k.id === argv.id);
-    if (!old) throw new Error(`Key ID ${argv.id} not found. Run 'velaro mcp-key list' to see your keys.`);
-
-    const label = argv.label || old.label;
-
-    await del(`/McpApiKeys/${argv.id}`);
-    console.log(`Revoked:  [${argv.id}] ${old.label} (${old.keyPrefix}...)`);
-
-    const payload = { label };
-    if (argv.expires) payload.expiresAt = new Date(argv.expires).toISOString();
-    const result = await post('/McpApiKeys', payload);
-
-    console.log(`Replaced: [${result.id}] ${result.label}`);
-    console.log(`\n  New key: ${result.rawKey}`);
-    console.log(`\n  ${result.warning ?? 'Copy this key now — it will not be shown again.'}`);
-  }),
-};
+import fs   from 'fs';
+import path from 'path';
+import os   from 'os';
+import { get, post, del } from '../api.js';
+import { getActiveEnv, ENVS } from '../config.js';
+import { runCommand }      from '../run.js';
+
+export const mcpKeyCommand = {
+  command:  'mcp-key <subcommand>',
+  describe: 'Manage MCP API keys (vel_live_* keys for AI skill access)',
+  builder:  (yargs) =>
+    yargs
+      .command(mcpKeyListCommand)
+      .command(mcpKeyCreateCommand)
+      .command(mcpKeyRevokeCommand)
+      .command(mcpKeyRotateCommand)
+      .command(mcpKeyInstallCommand)
+      .demandCommand(1, 'Specify a subcommand: list, create, revoke, rotate, install'),
+  handler: () => {},
+};
+
+const mcpKeyListCommand = {
+  command:  'list',
+  describe: 'List MCP API keys for your site',
+  handler:  runCommand(async () => {
+    const keys = await get('/McpApiKeys');
+    if (!keys?.length) { console.log('No MCP keys found.'); return; }
+    console.log(`Found ${keys.length} key(s):\n`);
+    for (const k of keys) {
+      const used    = k.lastUsedAt ? new Date(k.lastUsedAt).toLocaleDateString() : 'never';
+      const expires = k.expiresAt  ? `  expires ${new Date(k.expiresAt).toLocaleDateString()}` : '';
+      console.log(`  [${k.id}] ${k.label}  prefix=${k.keyPrefix}  ${k.isActive ? 'active' : 'revoked'}  last used=${used}${expires}`);
+    }
+  }),
+};
+
+const mcpKeyCreateCommand = {
+  command:  'create',
+  describe: 'Create a new MCP API key',
+  builder:  (y) =>
+    y
+      .option('label', {
+        describe:     'Human-readable label (e.g. "Claude Code")',
+        type:         'string',
+        demandOption: true,
+      })
+      .option('expires', {
+        describe: 'Expiry date in ISO 8601 format (e.g. 2027-01-01)',
+        type:     'string',
+      }),
+
+  handler: runCommand(async (argv) => {
+    const payload = { label: argv.label };
+    if (argv.expires) payload.expiresAt = new Date(argv.expires).toISOString();
+
+    const result = await post('/McpApiKeys', payload);
+    console.log(`MCP key created: ${result.label}`);
+    console.log(`\n  Key: ${result.rawKey}`);
+    console.log(`\n  ${result.warning ?? 'Copy this key now — it will not be shown again.'}`);
+  }),
+};
+
+const mcpKeyRevokeCommand = {
+  command:  'revoke <id>',
+  describe: 'Revoke an MCP API key by ID',
+  handler:  runCommand(async (argv) => {
+    await del(`/McpApiKeys/${argv.id}`);
+    console.log(`Key ${argv.id} revoked.`);
+  }),
+};
+
+const mcpKeyInstallCommand = {
+  command:  'install',
+  describe: 'Create an MCP key and write it to ~/.claude.json automatically',
+  builder:  (y) =>
+    y
+      .option('label', {
+        describe: 'Label for the key',
+        type:     'string',
+      })
+      .option('staging', {
+        describe: 'Install key for the staging environment',
+        type:     'boolean',
+        default:  false,
+      }),
+
+  handler: runCommand(async (argv) => {
+    const env     = argv.staging ? 'staging' : getActiveEnv();
+    const apiBase = ENVS[env].adminApiBase;
+    const label   = argv.label || (env === 'staging' ? 'Claude Code (Staging)' : 'Claude Code');
+
+    const payload = { label };
+    const result  = await post('/McpApiKeys', payload);
+    const rawKey  = result.rawKey;
+
+    // Claude Code reads MCP server definitions from the top-level "mcpServers" key
+    // in ~/.claude.json (NOT ~/.claude/settings.json — that file has no effect here).
+    // This is the same shape `claude mcp add` itself writes.
+    // prod  → entry named "velaro"
+    // staging → entry named "velaro-staging"
+    const serverName  = env === 'prod' ? 'velaro' : `velaro-${env}`;
+    const configPath  = path.join(os.homedir(), '.claude.json');
+    let config = {};
+    if (fs.existsSync(configPath)) {
+      const raw = fs.readFileSync(configPath, 'utf8');
+      try {
+        config = JSON.parse(raw);
+      } catch (err) {
+        throw new Error(
+          `~/.claude.json exists but isn't valid JSON (${err.message}) — refusing to overwrite it. ` +
+          `Fix or remove the file, then re-run 'velaro mcp-key install'.`
+        );
+      }
+    }
+
+    config.mcpServers = config.mcpServers || {};
+    config.mcpServers[serverName] = {
+      type:    'stdio',
+      command: 'npx',
+      args:    ['-y', '@velaro/mcp-server'],
+      env:     {
+        VELARO_MCP_KEY:   rawKey,
+        VELARO_ADMIN_API: apiBase,
+      },
+    };
+
+    // Claude Code itself writes ~/.claude.json continuously (history, project state),
+    // so this must never be a plain in-place write: write to a temp file and rename,
+    // which is atomic on the same filesystem — a crash or concurrent write mid-save
+    // can't leave the file truncated or silently clobber a write that landed between
+    // our read and our write.
+    const tmpPath = `${configPath}.tmp-${process.pid}`;
+    fs.writeFileSync(tmpPath, JSON.stringify(config, null, 2));
+    fs.renameSync(tmpPath, configPath);
+
+    console.log(`✅ MCP key created: ${label}  (${result.keyPrefix}...)`);
+    console.log(`✅ Written to ~/.claude.json as "${serverName}" → ${apiBase}`);
+    console.log(`\nRestart Claude Code to pick up the new MCP server.`);
+    console.log(`\nTo use in Claude Code: say "use ${serverName}" to target ${env}.`);
+  }),
+};
+
+const mcpKeyRotateCommand = {
+  command:  'rotate <id|label>',
+  describe: 'Revoke an existing key and issue a replacement in one step',
+  builder:  (y) =>
+    y
+      .positional('id|label', { type: 'string', describe: 'Numeric ID or partial label of the key to rotate (e.g. "jb" or "42")' })
+      .option('label', {
+        describe: 'Label for the replacement key (defaults to the old key\'s label)',
+        type:     'string',
+      })
+      .option('expires', {
+        describe: 'Expiry date for the new key in ISO 8601 format (e.g. 2027-01-01)',
+        type:     'string',
+      }),
+
+  handler: runCommand(async (argv) => {
+    const keys = await get('/McpApiKeys');
+    const search = String(argv['id|label'] ?? argv.id ?? '');
+    const numId  = parseInt(search, 10);
+    const matches = isNaN(numId)
+      ? keys?.filter(k => k.label.toLowerCase().includes(search.toLowerCase()))
+      : keys?.filter(k => k.id === numId);
+
+    if (!matches?.length)
+      throw new Error(`No key found matching "${search}". Run 'velaro mcp-key list' to see your keys.`);
+    if (matches.length > 1) {
+      console.log(`Multiple keys match "${search}":\n`);
+      matches.forEach(k => console.log(`  [${k.id}] ${k.label}  (${k.keyPrefix}...)`));
+      throw new Error('Be more specific — provide the numeric ID or a more unique label fragment.');
+    }
+    const old = matches[0];
+
+    const label = argv.label || old.label;
+
+    await del(`/McpApiKeys/${old.id}`);
+    console.log(`Revoked:  [${old.id}] ${old.label} (${old.keyPrefix}...)`);
+
+    const payload = { label };
+    if (argv.expires) payload.expiresAt = new Date(argv.expires).toISOString();
+    const result = await post('/McpApiKeys', payload);
+
+    console.log(`Replaced: [${result.id}] ${result.label}`);
+    console.log(`\n  New key: ${result.rawKey}`);
+    console.log(`\n  ${result.warning ?? 'Copy this key now — it will not be shown again.'}`);
+  }),
+};