legacyver 2.1.0 → 2.1.2

package/src/cli/commands/init.js

@@ -1,125 +1,81 @@
-/**
- * Init command — interactive wizard to configure legacyver.
- * Saves API key to OS user config using `conf`.
- * Creates example .legacyverrc file.
- */
+'use strict';
 
-import { createInterface } from 'node:readline';
-import { existsSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import Conf from 'conf';
-import picocolors from 'picocolors';
-import { logger } from '../../utils/logger.js';
-
-const userConfig = new Conf({ projectName: 'legacyver' });
-
-const PROVIDERS = ['anthropic', 'openai', 'google', 'groq', 'ollama'];
-
-const ENV_VAR_MAP = {
-  anthropic: 'ANTHROPIC_API_KEY',
-  openai: 'OPENAI_API_KEY',
-  google: 'GOOGLE_API_KEY',
-  groq: 'GROQ_API_KEY',
-};
+const { existsSync, writeFileSync } = require('fs');
+const { join } = require('path');
+const readline = require('readline');
+const pc = require('picocolors');
 
 function ask(rl, question) {
-  return new Promise((resolve) => {
-    rl.question(question, resolve);
-  });
+  return new Promise((resolve) => rl.question(question, resolve));
 }
 
-async function runInitWizard() {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
-  console.log('');
-  console.log(picocolors.bold('Legacyver Setup Wizard'));
-  console.log('');
-
-  // Select provider
-  console.log('Available LLM providers:');
-  PROVIDERS.forEach((p, i) => {
-    console.log(`  ${i + 1}. ${p}${p === 'ollama' ? ' (no API key needed)' : ''}`);
-  });
-  console.log('');
+module.exports = async function initCommand() {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
 
-  const providerChoice = await ask(rl, 'Select provider (1-5) [1]: ');
-  const providerIndex = parseInt(providerChoice, 10) - 1;
-  const provider = PROVIDERS[providerIndex >= 0 && providerIndex < PROVIDERS.length ? providerIndex : 0];
+  console.log(pc.bold('\nWelcome to Legacyver setup wizard!\n'));
 
-  console.log(`Selected: ${picocolors.cyan(provider)}`);
-
-  // API key (skip for ollama)
-  if (provider !== 'ollama') {
-    const envVar = ENV_VAR_MAP[provider];
-    const existingKey = process.env[envVar] || userConfig.get(`apiKeys.${provider}`);
-
-    if (existingKey) {
-      console.log(`  API key found ${process.env[envVar] ? '(from environment)' : '(from saved config)'}`);
-      const overwrite = await ask(rl, '  Overwrite? (y/N): ');
-      if (overwrite.toLowerCase() === 'y') {
-        const newKey = await ask(rl, `  Enter ${envVar}: `);
-        if (newKey.trim()) {
-          userConfig.set(`apiKeys.${provider}`, newKey.trim());
-          logger.success('API key saved to user config');
-        }
-      }
-    } else {
-      const newKey = await ask(rl, `  Enter ${envVar}: `);
-      if (newKey.trim()) {
-        userConfig.set(`apiKeys.${provider}`, newKey.trim());
-        logger.success('API key saved to user config');
-      } else {
-        logger.warn(`No API key set. Set ${envVar} environment variable before running.`);
-      }
-    }
-  }
-
-  // Save default provider
-  userConfig.set('defaultProvider', provider);
-
-  // Create .legacyverrc
   const rcPath = join(process.cwd(), '.legacyverrc');
   if (existsSync(rcPath)) {
-    const overwrite = await ask(rl, `.legacyverrc already exists. Overwrite? (y/N): `);
-    if (overwrite.toLowerCase() !== 'y') {
+    const overwrite = await ask(rl, pc.yellow('⚠ .legacyverrc already exists. Overwrite? [y/N] '));
+    if (overwrite.trim().toLowerCase() !== 'y') {
+      console.log('Aborted.');
       rl.close();
-      logger.info('Setup complete (existing .legacyverrc preserved).');
       return;
     }
   }
 
-  const rcContent = JSON.stringify({
-    provider,
-    format: 'markdown',
-    output: './legacyver-docs',
-    concurrency: 5,
-    maxFileSizeKb: 500,
-    ignore: ['test/**', '**/*.test.*', '**/node_modules/**'],
-  }, null, 2);
+  const providerRaw = await ask(rl, `LLM provider [openrouter/gemini/groq/ollama] (default: openrouter): `);
+  const providerChoice = providerRaw.trim() || 'openrouter';
+  const isOllama = providerChoice === 'ollama';
+  const isGroq = providerChoice === 'groq';
+  const isGemini = providerChoice === 'gemini';
+
+  const defaultModel = isOllama
+    ? 'llama3.2'
+    : isGroq
+      ? 'llama-3.3-70b-versatile'
+      : isGemini
+        ? 'gemini-2.0-flash'
+        : 'meta-llama/llama-3.3-70b-instruct:free';
+
+  let apiKey = '';
+  if (!isOllama) {
+    const keyLabel = isGemini ? 'Google Gemini' : isGroq ? 'Groq' : 'OpenRouter';
+    const keyHint = isGemini ? 'https://aistudio.google.com/apikey' : isGroq ? 'https://console.groq.com/keys' : 'https://openrouter.ai/keys';
+    apiKey = await ask(rl, `${keyLabel} API key (leave blank to set via env var — see ${keyHint}): `);
+  }
 
-  writeFileSync(rcPath, rcContent + '\n', 'utf-8');
-  logger.success(`Created ${rcPath}`);
+  const modelRaw = await ask(rl, `Default model (default: ${defaultModel}): `);
+  const formatRaw = await ask(rl, `Default output format [markdown/html/json] (default: markdown): `);
 
   rl.close();
-  console.log('');
-  console.log(picocolors.green('Setup complete!'));
-  console.log(`Run ${picocolors.cyan('legacyver analyze ./src')} to generate documentation.`);
-  console.log('');
-}
 
-export function registerInitCommand(program) {
-  program
-    .command('init')
-    .description('Interactive setup wizard to configure legacyver')
-    .action(async () => {
-      try {
-        await runInitWizard();
-      } catch (err) {
-        logger.error('Init failed:', err.message);
-        process.exit(1);
-      }
-    });
-}
+  const config = {
+    provider: providerChoice,
+    model: modelRaw.trim() || defaultModel,
+    format: formatRaw.trim() || 'markdown',
+    out: './legacyver-docs',
+  };
+
+  if (apiKey.trim()) {
+    if (isGemini) {
+      config.geminiApiKey = apiKey.trim();
+    } else if (isGroq) {
+      config.groqApiKey = apiKey.trim();
+    } else {
+      config.apiKey = apiKey.trim();
+    }
+  }
+
+  writeFileSync(rcPath, JSON.stringify(config, null, 2), 'utf8');
+  console.log(pc.green('\n✓ Created .legacyverrc'));
+
+  const exampleCmd = isOllama
+    ? 'legacyver analyze --provider ollama'
+    : isGroq
+      ? 'legacyver analyze --provider groq'
+      : isGemini
+        ? 'legacyver analyze --provider gemini'
+        : 'legacyver analyze';
+  console.log(pc.cyan(`\nRun \`${exampleCmd}\` to generate documentation.`));
+};

package/src/cli/commands/providers.js

@@ -1,83 +1,58 @@
-/**
- * Providers subcommand — lists all supported LLM providers,
- * API key status (detected/missing), and cost per 1000 tokens.
- */
-
-import picocolors from 'picocolors';
-import Conf from 'conf';
-
-const userConfig = new Conf({ projectName: 'legacyver' });
-
-const PROVIDERS = [
-  {
-    name: 'anthropic',
-    envVar: 'ANTHROPIC_API_KEY',
-    defaultModel: 'claude-haiku-3-5',
-    costPer1kInput: 0.00025,
-    costPer1kOutput: 0.00125,
-  },
-  {
-    name: 'openai',
-    envVar: 'OPENAI_API_KEY',
-    defaultModel: 'gpt-4o-mini',
-    costPer1kInput: 0.00015,
-    costPer1kOutput: 0.0006,
-  },
-  {
-    name: 'google',
-    envVar: 'GOOGLE_API_KEY',
-    defaultModel: 'gemini-1.5-flash',
-    costPer1kInput: 0.000075,
-    costPer1kOutput: 0.0003,
-  },
-  {
-    name: 'groq',
-    envVar: 'GROQ_API_KEY',
-    defaultModel: 'llama-3.3-70b-versatile',
-    costPer1kInput: 0.00059,
-    costPer1kOutput: 0.00079,
-  },
-  {
-    name: 'ollama',
-    envVar: null,
-    defaultModel: 'llama3.2',
-    costPer1kInput: 0,
-    costPer1kOutput: 0,
-  },
+'use strict';
+
+const pc = require('picocolors');
+const logger = require('../../utils/logger');
+
+const RECOMMENDED_MODELS = [
+  { id: 'meta-llama/llama-3.3-70b-instruct:free', context: '128k', inputCost: 0, outputCost: 0, free: true },
+  { id: 'anthropic/claude-haiku-3-5', context: '200k', inputCost: 0.80, outputCost: 4.00, free: false },
+  { id: 'anthropic/claude-sonnet-4-5', context: '200k', inputCost: 3.00, outputCost: 15.00, free: false },
+  { id: 'openai/gpt-4o-mini', context: '128k', inputCost: 0.15, outputCost: 0.60, free: false },
+  { id: 'openai/gpt-4o', context: '128k', inputCost: 5.00, outputCost: 15.00, free: false },
+  { id: 'google/gemini-flash-1.5', context: '1M', inputCost: 0.075, outputCost: 0.30, free: false },
+  { id: 'mistralai/mistral-7b-instruct:free', context: '32k', inputCost: 0, outputCost: 0, free: true },
 ];
 
-function detectApiKey(provider) {
-  if (!provider.envVar) return 'N/A (local)';
-
-  if (process.env[provider.envVar]) return picocolors.green('detected (env)');
-  if (userConfig.get(`apiKeys.${provider.name}`)) return picocolors.green('detected (config)');
-  return picocolors.red('missing');
-}
-
-export function registerProvidersCommand(program) {
-  program
-    .command('providers')
-    .description('List supported LLM providers and their status')
-    .action(() => {
-      console.log('');
-      console.log(picocolors.bold('Supported LLM Providers'));
-      console.log('');
-
-      const header = `  ${'Provider'.padEnd(12)} ${'Default Model'.padEnd(28)} ${'API Key'.padEnd(22)} ${'Cost/1k input'.padEnd(14)} Cost/1k output`;
-      console.log(picocolors.dim(header));
-      console.log(picocolors.dim('  ' + '─'.repeat(90)));
-
-      for (const p of PROVIDERS) {
-        const status = detectApiKey(p);
-        const inputCost = p.costPer1kInput === 0 ? 'free' : `$${p.costPer1kInput.toFixed(5)}`;
-        const outputCost = p.costPer1kOutput === 0 ? 'free' : `$${p.costPer1kOutput.toFixed(5)}`;
-        console.log(`  ${p.name.padEnd(12)} ${p.defaultModel.padEnd(28)} ${status.padEnd(22)} ${inputCost.padEnd(14)} ${outputCost}`);
-      }
-
-      console.log('');
-      console.log(`  Configure API keys with: ${picocolors.cyan('legacyver init')}`);
-      console.log('');
-    });
-}
-
-export { PROVIDERS };
+module.exports = async function providersCommand() {
+  const { loadConfig } = require('../../utils/config');
+  const config = loadConfig({});
+
+  console.log(pc.bold('\nLegacyver — Supported LLM Providers\n'));
+  console.log(pc.bold('OpenRouter') + '  (https://openrouter.ai)');
+  console.log('  Unified gateway to 200+ models. Set OPENROUTER_API_KEY env variable.');
+  console.log('  Status: ' + (process.env.OPENROUTER_API_KEY ? pc.green('API key detected') : pc.yellow('No API key found')));
+  console.log('');
+  console.log(pc.bold('Ollama') + '       (https://ollama.ai)');
+  console.log('  Local offline LLM. No API key required. Run `ollama serve` first.');
+  console.log('');
+  console.log(pc.bold('Groq') + '         (https://groq.com)');
+  console.log('  Fastest free LLM inference. Set GROQ_API_KEY env variable.');
+  console.log('  Status: ' + (process.env.GROQ_API_KEY ? pc.green('API key detected') : pc.yellow('No API key found')));
+  console.log('  Get a free key at: https://console.groq.com/keys');
+  console.log('');
+  console.log(pc.bold('Google Gemini') + ' (https://ai.google.dev)');
+  console.log('  Free tier: 15 req/min, 1,500 req/day. Set GEMINI_API_KEY env variable.');
+  console.log('  Status: ' + (process.env.GEMINI_API_KEY ? pc.green('API key detected') : pc.yellow('No API key found')));
+  console.log('  Get a free key at: https://aistudio.google.com/apikey');
+  console.log('');
+
+  console.log(pc.bold('Recommended Models (via OpenRouter):'));
+  console.log('');
+  const header = `  ${'Model ID'.padEnd(48)} ${'Context'.padEnd(8)} ${'Input $/1M'.padEnd(12)} ${'Output $/1M'.padEnd(12)}`;
+  console.log(pc.dim(header));
+  console.log(pc.dim('  ' + '-'.repeat(84)));
+
+  for (const m of RECOMMENDED_MODELS) {
+    const badge = m.free ? pc.green(' [FREE]') : '';
+    const selected = m.id === config.model ? pc.cyan(' ◀ selected') : '';
+    const inputCostStr = m.free ? 'FREE' : `$${m.inputCost.toFixed(3)}`;
+    const outputCostStr = m.free ? 'FREE' : `$${m.outputCost.toFixed(3)}`;
+    console.log(
+      `  ${m.id.padEnd(48)} ${m.context.padEnd(8)} ${inputCostStr.padEnd(12)} ${outputCostStr.padEnd(12)}${badge}${selected}`
+    );
+  }
+
+  console.log('');
+  console.log(pc.dim('Fetch live model list from OpenRouter: https://openrouter.ai/api/v1/models'));
+  console.log('');
+};

package/src/cli/commands/version.js

@@ -1,12 +1,9 @@
-/**
- * Version command — reads version from package.json and prints it.
- */
+'use strict';
 
-import { createRequire } from 'node:module';
+const { readFileSync } = require('fs');
+const { join } = require('path');
 
-const require = createRequire(import.meta.url);
-
-export function printVersion() {
-  const pkg = require('../../../package.json');
-  console.log(`legacyver v${pkg.version}`);
-}
+module.exports = function versionCommand() {
+  const pkg = JSON.parse(readFileSync(join(__dirname, '../../../package.json'), 'utf8'));
+  console.log(pkg.version);
+};

package/src/cli/ui.js

@@ -1,104 +1,85 @@
-/**
- * CLI UI helpers: spinners, progress bars, prompts, summary.
- */
+'use strict';
 
-import ora from 'ora';
-import cliProgress from 'cli-progress';
-import picocolors from 'picocolors';
-import { createInterface } from 'node:readline';
-import { isCIMode } from '../utils/logger.js';
+const ora = require('ora');
+const { SingleBar, Presets } = require('cli-progress');
+const readline = require('readline');
+const pc = require('picocolors');
 
-/**
- * Create a spinner (disabled in CI mode).
- * @param {string} text - Spinner text
- * @returns {object} Spinner-like object with start/stop/succeed/fail
- */
-export function createSpinner(text) {
-  if (isCIMode()) {
+const isCI = !process.stdout.isTTY;
+
+function createSpinner(text) {
+  if (isCI) {
+    console.log(`[spinner] ${text}`);
     return {
-      start() { console.log(`... ${text}`); return this; },
-      stop() { return this; },
-      succeed(msg) { console.log(`OK: ${msg || text}`); return this; },
-      fail(msg) { console.error(`FAIL: ${msg || text}`); return this; },
-      text,
+      start: (t) => t && console.log(`[spinner] ${t}`),
+      succeed: (t) => console.log(`[done] ${t || text}`),
+      fail: (t) => console.error(`[fail] ${t || text}`),
+      warn: (t) => console.warn(`[warn] ${t || text}`),
+      stop: () => {},
+      text: text,
     };
   }
   return ora({ text, spinner: 'dots' });
 }
 
-/**
- * Create a progress bar (plain log lines in CI mode).
- * @param {number} total - Total items
- * @returns {object} Progress bar with start/increment/stop methods
- */
-export function createProgressBar(total) {
-  if (isCIMode()) {
+function createProgressBar(total) {
+  if (isCI) {
     let current = 0;
     return {
-      start() { console.log(`Processing 0/${total} files...`); },
-      increment(amount = 1) {
-        current += amount;
-        if (current % 10 === 0 || current === total) {
-          console.log(`Processing ${current}/${total} files...`);
-        }
+      start: () => {},
+      increment: () => {
+        current++;
+        process.stdout.write(`Progress: ${current}/${total}\n`);
       },
-      stop() { console.log(`Processed ${current}/${total} files.`); },
+      stop: () => {},
     };
   }
-
-  const bar = new cliProgress.SingleBar({
-    format: `${picocolors.cyan('{bar}')} {percentage}% | {value}/{total} files | ETA: {eta}s`,
-    barCompleteChar: '\u2588',
-    barIncompleteChar: '\u2591',
-    hideCursor: true,
-  });
-
+  const bar = new SingleBar(
+    {
+      format: `${pc.cyan('Analyzing')} [{bar}] {percentage}% | {value}/{total} files`,
+      clearOnComplete: false,
+      hideCursor: true,
+    },
+    Presets.shades_classic
+  );
   return {
-    start() { bar.start(total, 0); },
-    increment(amount = 1) { bar.increment(amount); },
-    stop() { bar.stop(); },
+    start: () => bar.start(total, 0),
+    increment: () => bar.increment(),
+    stop: () => bar.stop(),
   };
 }
 
-/**
- * Prompt user for confirmation.
- * @param {string} message - Question to display
- * @returns {Promise<boolean>} true if user confirmed
- */
-export async function confirmPrompt(message) {
-  if (isCIMode()) {
-    return false; // CI mode requires --no-confirm
+async function confirmPrompt(message) {
+  if (isCI) {
+    console.error(`[confirm] ${message} — non-interactive mode, aborting. Use --no-confirm to skip.`);
+    process.exit(4);
   }
-
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-
   return new Promise((resolve) => {
-    rl.question(`${message} (y/N) `, (answer) => {
+    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+    rl.question(`${pc.yellow('?')} ${message} [y/N] `, (answer) => {
       rl.close();
-      resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+      resolve(answer.trim().toLowerCase() === 'y' || answer.trim().toLowerCase() === 'yes');
     });
   });
 }
 
-/**
- * Print analysis summary.
- * @param {object} stats - Summary statistics
- */
-export function printSummary(stats) {
+function printSummary(stats) {
   console.log('');
-  console.log(picocolors.bold('─── Analysis Summary ───'));
-  console.log(`  Files analyzed:  ${stats.filesAnalyzed || 0}`);
-  console.log(`  Files skipped:   ${stats.filesSkipped || 0}`);
-  console.log(`  Files cached:    ${stats.filesCached || 0}`);
-  console.log(`  Errors:          ${stats.errors || 0}`);
-  console.log(`  Input tokens:    ${stats.inputTokens || 0}`);
-  console.log(`  Output tokens:   ${stats.outputTokens || 0}`);
-  console.log(`  Estimated cost:  $${(stats.estimatedCost || 0).toFixed(4)}`);
-  console.log(`  Output:          ${stats.outputDir || 'N/A'}`);
-  console.log(`  Duration:        ${stats.duration || 'N/A'}`);
-  console.log(picocolors.bold('────────────────────────'));
+  console.log(pc.bold('=== Legacyver Summary ==='));
+  console.log(`  Files analyzed:   ${pc.green(stats.filesAnalyzed)}`);
+  console.log(`  Files cached:     ${pc.cyan(stats.filesCached || 0)}`);
+  console.log(`  Files skipped:    ${pc.yellow(stats.filesSkipped || 0)}`);
+  console.log(`  Tokens used:      ${stats.tokensUsed !== undefined ? stats.tokensUsed : 'n/a'}`);
+  console.log(`  Estimated cost:   ${stats.estimatedCost !== undefined ? '$' + stats.estimatedCost.toFixed(4) : 'n/a'}`);
+  if (stats.qualityWarnings > 0) {
+    console.log(`  Quality warnings: ${pc.yellow(stats.qualityWarnings)}`);
+  }
+  if (stats.errors && stats.errors.length > 0) {
+    console.log(`  Errors:           ${pc.red(stats.errors.length)}`);
+    stats.errors.forEach((e) => console.log(`    - ${e}`));
+  }
+  console.log(`  Output:           ${stats.outputDir}`);
   console.log('');
 }
+
+module.exports = { createSpinner, createProgressBar, confirmPrompt, printSummary };

package/src/crawler/filters.js

@@ -1,57 +1,58 @@
-/**
- * Language extension map and default ignore patterns.
- */
+'use strict';
 
-export const LANGUAGE_EXTENSIONS = {
-  javascript: ['.js', '.jsx', '.mjs'],
+const LANGUAGE_EXTENSIONS = {
+  javascript: ['.js', '.jsx', '.mjs', '.cjs'],
   typescript: ['.ts', '.tsx'],
   python: ['.py'],
   java: ['.java'],
   go: ['.go'],
+  php: ['.php', '.blade.php'],
 };
 
-/**
- * Reverse map: extension -> language
- */
-export const EXTENSION_TO_LANGUAGE = {};
-for (const [lang, exts] of Object.entries(LANGUAGE_EXTENSIONS)) {
-  for (const ext of exts) {
-    EXTENSION_TO_LANGUAGE[ext] = lang;
-  }
-}
+const ALL_EXTENSIONS = Object.values(LANGUAGE_EXTENSIONS).flat();
 
-/**
- * All supported file extensions as glob patterns.
- */
-export const SUPPORTED_EXTENSIONS = Object.values(LANGUAGE_EXTENSIONS).flat();
-
-/**
- * Default ignore patterns (always applied).
- */
-export const DEFAULT_IGNORE_PATTERNS = [
+const DEFAULT_IGNORE_PATTERNS = [
   '**/node_modules/**',
   '**/.git/**',
   '**/dist/**',
   '**/build/**',
-  '**/.next/**',
-  '**/.nuxt/**',
+  '**/vendor/**',
   '**/coverage/**',
   '**/__pycache__/**',
-  '**/.pytest_cache/**',
-  '**/venv/**',
-  '**/.venv/**',
-  '**/env/**',
-  '**/.env/**',
-  '**/vendor/**',
-  '**/.idea/**',
-  '**/.vscode/**',
-  '**/*.min.js',
-  '**/*.min.css',
-  '**/*.map',
-  '**/*.lock',
-  '**/package-lock.json',
-  '**/yarn.lock',
-  '**/pnpm-lock.yaml',
+  '**/storage/**',
+  '**/bootstrap/cache/**',
   '**/.legacyver-cache/**',
   '**/legacyver-docs/**',
+  '**/test/**',
+  '**/tests/**',
+  '**/spec/**',
+  '**/openspec/**',
+  '**/*.test.js',
+  '**/*.test.ts',
+  '**/*.spec.js',
+  '**/*.spec.ts',
+  '**/*.test.py',
 ];
+
+function detectLanguage(ext) {
+  for (const [lang, exts] of Object.entries(LANGUAGE_EXTENSIONS)) {
+    if (exts.includes(ext)) return lang;
+  }
+  return null;
+}
+
+function detectPrimaryLanguage(files) {
+  const counts = {};
+  for (const f of files) {
+    const lang = f.language;
+    if (lang) counts[lang] = (counts[lang] || 0) + 1;
+  }
+  let max = 0;
+  let primary = null;
+  for (const [lang, cnt] of Object.entries(counts)) {
+    if (cnt > max) { max = cnt; primary = lang; }
+  }
+  return primary;
+}
+
+module.exports = { LANGUAGE_EXTENSIONS, ALL_EXTENSIONS, DEFAULT_IGNORE_PATTERNS, detectLanguage, detectPrimaryLanguage };