promptgraph-mcp 1.4.0 → 1.5.0

package/cli.js

@@ -0,0 +1,95 @@
+import chalk from 'chalk';
+import ora from 'ora';
+import boxen from 'boxen';
+
+export const colors = {
+  primary: chalk.hex('#7C3AED'),
+  success: chalk.hex('#10B981'),
+  warning: chalk.hex('#F59E0B'),
+  error: chalk.hex('#EF4444'),
+  muted: chalk.hex('#6B7280'),
+  white: chalk.white,
+  bold: chalk.bold,
+};
+
+export function banner() {
+  console.log(
+    boxen(
+      colors.primary.bold('PromptGraph') + '  ' + colors.muted('v' + (await getVersion())) + '\n' +
+      colors.muted('Semantic skill router for Claude Code'),
+      {
+        padding: { top: 0, bottom: 0, left: 2, right: 2 },
+        borderStyle: 'round',
+        borderColor: '#7C3AED',
+        dimBorder: true,
+      }
+    )
+  );
+}
+
+async function getVersion() {
+  try {
+    const { createRequire } = await import('module');
+    const require = createRequire(import.meta.url);
+    return require('./package.json').version;
+  } catch { return ''; }
+}
+
+export function spinner(text) {
+  return ora({
+    text: colors.muted(text),
+    spinner: 'dots',
+    color: 'magenta',
+  });
+}
+
+export function success(msg) {
+  console.log(colors.success('✓') + ' ' + msg);
+}
+
+export function error(msg) {
+  console.log(colors.error('✗') + ' ' + msg);
+}
+
+export function info(msg) {
+  console.log(colors.muted('·') + ' ' + msg);
+}
+
+export function section(title) {
+  console.log('\n' + colors.primary.bold(title));
+}
+
+export function progress(current, total, extra = '') {
+  const pct = Math.round(current / total * 100);
+  const bar = buildBar(pct);
+  process.stdout.write(
+    `\r  ${bar} ${colors.white.bold(pct + '%')} ${colors.muted(current + '/' + total)} ${colors.muted(extra)}  `
+  );
+}
+
+function buildBar(pct) {
+  const width = 20;
+  const filled = Math.round(pct / 100 * width);
+  const empty = width - filled;
+  return colors.primary('█'.repeat(filled)) + colors.muted('░'.repeat(empty));
+}
+
+export function table(rows) {
+  if (!rows.length) { info('No results'); return; }
+  const cols = Object.keys(rows[0]);
+  const widths = cols.map(c => Math.max(c.length, ...rows.map(r => String(r[c] ?? '').length)));
+  const header = cols.map((c, i) => colors.muted(c.toUpperCase().padEnd(widths[i]))).join('  ');
+  const divider = colors.muted(widths.map(w => '─'.repeat(w)).join('  '));
+  console.log('\n' + header);
+  console.log(divider);
+  for (const row of rows) {
+    const line = cols.map((c, i) => {
+      const val = String(row[c] ?? '');
+      if (c === 'score' || c === 'rating') return colors.primary(val.padEnd(widths[i]));
+      if (c === 'name') return colors.white.bold(val.padEnd(widths[i]));
+      return colors.muted(val.padEnd(widths[i]));
+    }).join('  ');
+    console.log(line);
+  }
+  console.log();
+}

package/index.js

@@ -10,25 +10,34 @@ import { importFromGitHub } from './github-import.js';
 import { detectPlatforms, PLATFORMS } from './platform.js';
 import { browseMarketplace, installSkill, publishSkill, getTopRated, recordUse, recordSuccess, recordFail } from './marketplace.js';
 
-const args = process.argv.slice(2);
-
-if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h') {
-  console.log(`
-PromptGraph — semantic skill router for Claude Code
-
-Usage:
-  promptgraph-mcp init                  First-time setup + index all skills
-  promptgraph-mcp reindex               Re-index all skills
-  promptgraph-mcp import <owner/repo>   Import skills from GitHub repo
-  promptgraph-mcp setup <platform>      Register MCP in platform config
-  promptgraph-mcp                       Start MCP server (used by Claude)
-  promptgraph-mcp help                  Show this help
+import { colors, banner, success, error, info, section, table } from './cli.js';
+import boxen from 'boxen';
+import chalk from 'chalk';
 
-Platforms: claude-code, claude-desktop, cline, codex, cursor, windsurf
+const args = process.argv.slice(2);
 
-GitHub: https://github.com/NeiP4n/promptgraph
-npm:    https://npmjs.com/package/promptgraph-mcp
-  `);
+if (args[0] === 'help' || args[0] === '--help' || args[0] === '-h' || !args[0]) {
+  console.log(
+    boxen(
+      chalk.hex('#7C3AED').bold('PromptGraph') + '\n' +
+      chalk.gray('Semantic skill router for Claude Code'),
+      { padding: { top: 0, bottom: 0, left: 2, right: 2 }, borderStyle: 'round', borderColor: '#7C3AED', dimBorder: true }
+    )
+  );
+  console.log(chalk.gray('\nUsage:\n'));
+  const cmds = [
+    ['init',                'First-time setup + index all skills'],
+    ['reindex',             'Re-index all skills'],
+    ['import <owner/repo>', 'Import skills from GitHub'],
+    ['setup <platform>',    'Register MCP in platform config'],
+    ['help',                'Show this help'],
+  ];
+  for (const [cmd, desc] of cmds) {
+    console.log('  ' + chalk.hex('#7C3AED')('promptgraph-mcp ' + cmd.padEnd(22)) + chalk.gray(desc));
+  }
+  console.log(chalk.gray('\nPlatforms: claude-code, claude-desktop, cline, codex, cursor, windsurf'));
+  console.log(chalk.gray('\n  github.com/NeiP4n/promptgraph  ·  npmjs.com/package/promptgraph-mcp\n'));
+  if (!args[0]) process.exit(0);
   process.exit(0);
 }
 
@@ -40,37 +49,34 @@ if (args[0] === 'import') {
 if (args[0] === 'setup') {
   const platformId = args[1];
   if (!platformId) {
-    const detected = detectPlatforms();
-    console.log('Detected platforms:');
-    detected.forEach(p => console.log(`  - ${p.id}: ${p.name}`));
-    console.log('\nUsage: promptgraph-mcp setup <platform-id>');
+    section('Detected platforms');
+    detectPlatforms().forEach(p => info(`${chalk.white(p.id.padEnd(16))} ${chalk.gray(p.name)}`));
+    console.log(chalk.gray('\n  Usage: promptgraph-mcp setup <platform-id>\n'));
   } else {
     const platform = PLATFORMS[platformId];
-    if (!platform) { console.error(`Unknown platform: ${platformId}`); process.exit(1); }
+    if (!platform) { error(`Unknown platform: ${platformId}`); process.exit(1); }
     platform.addMcp(platform);
-    console.log(`✓ Registered promptgraph MCP in ${platform.name} (${platform.configPath})`);
+    success(`Registered in ${chalk.white(platform.name)}`);
+    info(chalk.gray(platform.configPath));
   }
   process.exit(0);
 }
 
 if (args[0] === 'init') {
   const config = await promptConfig();
-  console.log('\nIndexing skills...');
   await indexAll();
-  console.log('\nDone! Add to Claude Code settings.json:');
-  console.log(JSON.stringify({
-    mcpServers: {
-      promptgraph: {
-        command: 'npx',
-        args: ['promptgraph-mcp'],
-      }
-    }
-  }, null, 2));
+  console.log();
+  console.log(
+    boxen(
+      chalk.white.bold('Add to Claude Code settings.json:') + '\n\n' +
+      chalk.gray(JSON.stringify({ mcpServers: { promptgraph: { command: 'npx', args: ['promptgraph-mcp'] } } }, null, 2)),
+      { padding: 1, borderStyle: 'round', borderColor: '#7C3AED', dimBorder: true }
+    )
+  );
   process.exit(0);
 }
 
 if (args[0] === 'reindex') {
-  console.log('[PromptGraph] Reindexing...');
   await indexAll();
   process.exit(0);
 }

package/indexer.js

@@ -7,6 +7,8 @@ import { getDb, skillId } from './db.js';
 import { loadConfig } from './config.js';
 import { chunkText } from './chunker.js';
 import { buildAnnIndex } from './ann.js';
+import { progress, success, info, spinner } from './cli.js';
+import chalk from 'chalk';
 
 function fileHash(filePath) {
   const content = fs.readFileSync(filePath);
@@ -74,7 +76,7 @@ export async function indexAll() {
     files.forEach(f => allFiles.push({ file: f, source }));
     total += files.length;
   }
-  console.log(`  Total files: ${total}`);
+  info(`Found ${chalk.white.bold(total)} files`);
 
   let count = 0;
   let errors = 0;
@@ -93,9 +95,9 @@ export async function indexAll() {
       if (existing?.hash === hash) {
         skipped++;
         count++;
-        if (count % 100 === 0) {
-          const pct = Math.round(count / total * 100);
-          process.stdout.write(`\r  [${pct}%] ${count}/${total} | skipped: ${skipped} | errors: ${errors}  `);
+        if (count % 50 === 0) {
+          const eta = count > 0 ? Math.round((total - count) * (Date.now() - start) / count / 1000) : '?';
+          progress(count, total, `skipped: ${skipped}  eta: ${eta}s`);
         }
         continue;
       }
@@ -120,9 +122,15 @@ export async function indexAll() {
     count += batch.length;
   }
 
-  process.stdout.write('\r  Building ANN index...');
+  progress(total, total, 'done');
+  console.log();
+  const spin = spinner('Building ANN index...');
+  spin.start();
   await buildAnnIndex();
-  console.log(`\n  Done. ${count} skills indexed.`);
+  spin.stop();
+  success(`Indexed ${chalk.white.bold(count)} skills  ${chalk.gray(`(${errors} errors, ${skipped} skipped)`)}`);
+  const elapsed = ((Date.now() - start) / 1000).toFixed(1);
+  info(chalk.gray(`Time: ${elapsed}s`));
 }
 
 export async function indexFile(filePath, source) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "promptgraph-mcp",
-  "version": "1.4.0",
+  "version": "1.5.0",
   "main": "index.js",
   "type": "module",
   "bin": {
@@ -34,10 +34,13 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "better-sqlite3": "^12.10.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
     "chokidar": "^5.0.0",
     "fastembed": "^2.1.0",
     "glob": "^13.0.6",
     "gray-matter": "^4.0.3",
+    "ora": "^9.4.0",
     "vectra": "^0.15.0"
   }
 }