legacyver 3.0.0 → 3.1.0

package/src/cli/commands/analyze.js

@@ -144,12 +144,12 @@ module.exports = async function analyzeCommand(target, flags) {
     provider = createProvider(config);
   } catch (e) {
     if (e.code === 'NO_API_KEY') {
-      const providerName = (config.provider || 'groq').toLowerCase();
+      const providerName = (config.provider || 'openrouter').toLowerCase();
       const isGroq = providerName === 'groq';
       const isGemini = providerName === 'gemini';
       const isKimi = providerName === 'kimi';
       const isOpenRouter = providerName === 'openrouter';
-      const label = isKimi ? 'Kimi (Moonshot)' : isGemini ? 'Google Gemini' : isOpenRouter ? 'OpenRouter' : 'Groq';
+      const label = isKimi ? 'Kimi (Moonshot)' : isGemini ? 'Google Gemini' : isGroq ? 'Groq' : 'OpenRouter';
       console.error(pc.red(`\n  No API key found for ${label}.\n`));
       console.error('  To fix, choose one of:\n');
       if (isKimi) {
@@ -171,12 +171,12 @@ module.exports = async function analyzeCommand(target, flags) {
         console.error('       export OPENROUTER_API_KEY=your_key_here\n');
         console.error('  Get a free OpenRouter key at: https://openrouter.ai/keys\n');
       } else {
-        // Default: Groq
+        // Default: OpenRouter
         console.error(pc.cyan('  1. Run the setup wizard:'));
         console.error('       legacyver init\n');
         console.error(pc.cyan('  2. Set an environment variable:'));
-        console.error('       export GROQ_API_KEY=your_key_here\n');
-        console.error('  Get a free Groq key at: https://console.groq.com/keys\n');
+        console.error('       export OPENROUTER_API_KEY=your_key_here\n');
+        console.error('  Get a free OpenRouter key at: https://openrouter.ai/keys\n');
         console.error(pc.cyan('  3. Use Google Gemini instead (free, 15 req/min):'));
         console.error('       legacyver analyze --provider gemini\n');
         console.error(pc.cyan('  4. Use Kimi (Moonshot) instead (free credits):'));

package/src/cli/commands/init.js

@@ -24,8 +24,8 @@ module.exports = async function initCommand() {
     }
   }
 
-  const providerRaw = await ask(rl, `LLM provider [groq/gemini/kimi/openrouter/ollama] (default: groq): `);
-  const providerChoice = providerRaw.trim() || 'groq';
+  const providerRaw = await ask(rl, `LLM provider [openrouter/groq/gemini/kimi/ollama] (default: openrouter): `);
+  const providerChoice = providerRaw.trim() || 'openrouter';
   const isOllama = providerChoice === 'ollama';
   const isGroq = providerChoice === 'groq';
   const isGemini = providerChoice === 'gemini';
@@ -39,7 +39,7 @@ module.exports = async function initCommand() {
         ? 'gemini-2.0-flash'
         : isKimi
           ? 'moonshot-v1-8k'
-          : 'meta-llama/llama-3.3-70b-instruct:free';
+          : 'meta-llama/llama-3.1-8b-instruct'; // default: openrouter
 
   let apiKey = '';
   if (!isOllama) {
@@ -83,6 +83,6 @@ module.exports = async function initCommand() {
         ? 'legacyver analyze --provider gemini'
         : isKimi
           ? 'legacyver analyze --provider kimi'
-          : 'legacyver analyze';
+          : 'legacyver analyze'; // openrouter is the default, no flag needed
   console.log(pc.cyan(`\nRun \`${exampleCmd}\` to generate documentation.`));
 };

package/src/cli/commands/providers.js

@@ -4,7 +4,7 @@ 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: 'meta-llama/llama-3.1-8b-instruct', context: '16k', inputCost: 0.02, outputCost: 0.05, free: false },
   { 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 },
@@ -30,7 +30,7 @@ module.exports = async function providersCommand() {
 
   console.log(pc.bold('Legacyver — Supported LLM Providers\n'));
 
-  console.log(pc.bold('Groq') + pc.green(' [DEFAULT]') + '  (https://groq.com)');
+  console.log(pc.bold('Groq') + '  (https://groq.com)');
   console.log('  Fastest free LLM inference. 30 req/min, 14,400 req/day. 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');
@@ -45,7 +45,7 @@ module.exports = async function providersCommand() {
   console.log('  Status: ' + (process.env.MOONSHOT_API_KEY ? pc.green('API key detected') : pc.yellow('No API key found')));
   console.log('  Get a key at: https://platform.moonshot.cn/console/api-keys');
   console.log('');
-  console.log(pc.bold('OpenRouter') + '  (https://openrouter.ai)');
+  console.log(pc.bold('OpenRouter') + pc.green(' [DEFAULT]') + '  (https://openrouter.ai)');
   console.log('  Unified gateway to 200+ models (Claude, GPT-4o, Llama, etc). 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('  Get a key at: https://openrouter.ai/keys');

package/src/llm/cost-estimator.js

@@ -25,7 +25,7 @@ let modelPricingCachedAt = 0;
 const CACHE_TTL_MS = 60 * 60 * 1000; // 1 hour
 
 const FALLBACK_PRICING = {
-  'meta-llama/llama-3.3-70b-instruct:free': { input: 0, output: 0 },
+  'meta-llama/llama-3.1-8b-instruct': { input: 0.02 / 1e6, output: 0.05 / 1e6 },
   'anthropic/claude-haiku-3-5': { input: 0.8 / 1e6, output: 4.0 / 1e6 },
   'anthropic/claude-sonnet-4-5': { input: 3.0 / 1e6, output: 15.0 / 1e6 },
   'openai/gpt-4o-mini': { input: 0.15 / 1e6, output: 0.6 / 1e6 },
@@ -64,7 +64,7 @@ async function fetchModelPricing() {
  * @returns {Promise<{totalInputTokens, totalOutputTokens, estimatedCostUSD, modelId}>}
  */
 async function estimateCost(chunks, config) {
-  const modelId = config.model || 'meta-llama/llama-3.3-70b-instruct:free';
+  const modelId = config.model || 'meta-llama/llama-3.1-8b-instruct';
   const pricing = await fetchModelPricing();
   const modelPricing = pricing[modelId] || { input: 0, output: 0 };
 

package/src/llm/free-model.js

@@ -9,7 +9,7 @@ const pc = require('picocolors');
  * @returns {Object} mutated config
  */
 function applyFreeModelPolicy(config) {
-  const provider = (config.provider || 'groq').toLowerCase();
+  const provider = (config.provider || 'openrouter').toLowerCase();
 
   // Ollama, Groq, Gemini, and Kimi are always free — skip openrouter-specific logic
   if (provider === 'ollama' || provider === 'groq' || provider === 'gemini' || provider === 'kimi') {
@@ -45,7 +45,7 @@ function applyFreeModelPolicy(config) {
     return config;
   }
 
-  const model = config.model || 'meta-llama/llama-3.3-70b-instruct:free';
+  const model = config.model || 'meta-llama/llama-3.1-8b-instruct:free';
   if (!model.endsWith(':free')) {
     config.isFreeModel = false;
     return config;

package/src/llm/index.js

@@ -12,9 +12,10 @@ const { KimiProvider } = require('./providers/kimi');
  * @returns {OpenRouterProvider|OllamaProvider|GroqProvider|GeminiProvider|KimiProvider}
  */
 function createProvider(config) {
-  const provider = (config.provider || 'groq').toLowerCase();
+  const provider = (config.provider || 'openrouter').toLowerCase();
   switch (provider) {
     case 'openrouter':
+    default:
       return new OpenRouterProvider(config);
     case 'ollama':
       return new OllamaProvider(config);
@@ -23,7 +24,6 @@ function createProvider(config) {
     case 'kimi':
       return new KimiProvider(config);
     case 'groq':
-    default:
       return new GroqProvider(config);
   }
 }

package/src/llm/providers/openrouter.js

@@ -3,11 +3,14 @@
 const { NoApiKeyError, RateLimitError } = require('../../utils/errors');
 const logger = require('../../utils/logger');
 
-const DEFAULT_MODEL = 'meta-llama/llama-3.3-70b-instruct:free';
+const DEFAULT_MODEL = 'meta-llama/llama-3.1-8b-instruct';
+// Built-in shared key — lets users run legacyver out of the box without setup.
+// Users can override with their own OPENROUTER_API_KEY env var for higher rate limits.
+const BUILT_IN_KEY = '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'; 
 
 class OpenRouterProvider {
   constructor(config) {
-    this.apiKey = process.env.OPENROUTER_API_KEY || config.apiKey;
+    this.apiKey = process.env.OPENROUTER_API_KEY || config.apiKey || BUILT_IN_KEY;
     if (!this.apiKey) {
       throw new NoApiKeyError('openrouter');
     }

package/src/llm/validator.js

@@ -40,9 +40,48 @@ function validateFragment(fragment, fileFacts) {
   for (const exp of (fileFacts.exports || [])) knownIdentifiers.add(exp);
 
   // Common words to skip (not identifiers)
-  const stopWords = new Set(['The', 'This', 'File', 'Function', 'Functions', 'Class', 'Method', 'Returns', 'Return', 'Parameter', 'Parameters', 'Param', 'Import', 'Export', 'Overview', 'Usage', 'Example', 'Dependencies', 'Dependency', 'Async', 'Static', 'Public', 'Private', 'Protected', 'Boolean', 'String', 'Number', 'Object', 'Array', 'Void', 'Null', 'Undefined', 'True', 'False', 'Error', 'Promise', 'Request', 'Response', 'Node', 'JavaScript', 'TypeScript', 'PHP', 'Python', 'Laravel', 'Express', 'Route', 'Controller', 'Model', 'Service', 'Repository', 'Middleware', 'Provider', 'Summary', 'None', 'Name', 'Description', 'Value', 'Type', 'Map', 'Set', 'Date', 'Creates', 'Create', 'Retrieves', 'Retrieve', 'Updates', 'Update', 'Deletes', 'Delete', 'Validates', 'Validate', 'Destroys', 'Destroy', 'Returns', 'Return', 'Gets', 'Get', 'Sets', 'Set', 'Checks', 'Check', 'Handles', 'Handle', 'Builds', 'Build', 'Loads', 'Load', 'Saves', 'Save', 'Sends', 'Send', 'Reads', 'Read', 'Writes', 'Write', 'Parses', 'Parse', 'Formats', 'Format', 'Converts', 'Convert', 'Generates', 'Generate', 'Initializes', 'Initialize', 'Registers', 'Register', 'Removes', 'Remove', 'Adds', 'Add', 'Lists', 'List', 'Fetches', 'Fetch', 'Renders', 'Render', 'Runs', 'Run', 'Starts', 'Start', 'Stops', 'Stop', 'Optional', 'Required', 'Default', 'Properties', 'Methods', 'Fields', 'Attributes', 'Throws', 'Emits', 'For', 'With', 'From', 'Into', 'Upon', 'When', 'After', 'Before', 'During', 'John', 'Jane', 'Doe', 'Example', 'New', 'Old', 'Current', 'Previous', 'Next', 'First', 'Last', 'All', 'Each', 'Every', 'Any', 'Given', 'Note', 'See', 'Also', 'More', 'Less', 'Here', 'There', 'Where', 'How', 'What', 'Which', 'Such', 'Like', 'Used', 'Uses', 'Using']);
+  const stopWords = new Set([
+    // General English prose words
+    'The', 'This', 'File', 'Function', 'Functions', 'Class', 'Method', 'Returns', 'Return',
+    'Parameter', 'Parameters', 'Param', 'Import', 'Export', 'Overview', 'Usage', 'Example',
+    'Dependencies', 'Dependency', 'Async', 'Static', 'Public', 'Private', 'Protected',
+    'Boolean', 'String', 'Number', 'Object', 'Array', 'Void', 'Null', 'Undefined',
+    'True', 'False', 'Error', 'Promise', 'Request', 'Response',
+    'Node', 'JavaScript', 'TypeScript', 'PHP', 'Python',
+    'Laravel', 'Express', 'Route', 'Controller', 'Model', 'Service', 'Repository',
+    'Middleware', 'Provider', 'Summary', 'None', 'Name', 'Description', 'Value', 'Type',
+    'Map', 'Set', 'Date',
+    'Creates', 'Create', 'Retrieves', 'Retrieve', 'Updates', 'Update', 'Deletes', 'Delete',
+    'Validates', 'Validate', 'Destroys', 'Destroy', 'Gets', 'Get', 'Sets', 'Checks', 'Check',
+    'Handles', 'Handle', 'Builds', 'Build', 'Loads', 'Load', 'Saves', 'Save',
+    'Sends', 'Send', 'Reads', 'Read', 'Writes', 'Write', 'Parses', 'Parse',
+    'Formats', 'Format', 'Converts', 'Convert', 'Generates', 'Generate',
+    'Initializes', 'Initialize', 'Registers', 'Register', 'Removes', 'Remove',
+    'Adds', 'Add', 'Lists', 'List', 'Fetches', 'Fetch', 'Renders', 'Render',
+    'Runs', 'Run', 'Starts', 'Start', 'Stops', 'Stop', 'Computes', 'Compute',
+    'Optional', 'Required', 'Default', 'Properties', 'Methods', 'Fields', 'Attributes',
+    'Throws', 'Emits', 'For', 'With', 'From', 'Into', 'Upon', 'When', 'After', 'Before',
+    'During', 'John', 'Jane', 'Doe', 'New', 'Old', 'Current', 'Previous', 'Next',
+    'First', 'Last', 'All', 'Each', 'Every', 'Any', 'Given', 'Note', 'See', 'Also',
+    'More', 'Less', 'Here', 'There', 'Where', 'How', 'What', 'Which', 'Such', 'Like',
+    'Used', 'Uses', 'Using', 'Analyzing', 'Confirmed', 'Interactive', 'Manually',
+    'Asynchronously', 'Concurrently', 'Automatically', 'Internally',
+    // Common technical acronyms / uppercase terms safe to appear in prose docs
+    'SHA', 'MD', 'AES', 'RSA', 'CLI', 'API', 'LLM', 'AST', 'PKG', 'JSON', 'XML',
+    'CSV', 'HTML', 'CSS', 'URL', 'URI', 'UUID', 'JWT', 'ISO', 'UTC', 'ENV',
+    'SDK', 'SPA', 'SSR', 'CDN', 'AWS', 'GCP', 'SQL', 'ORM', 'MVC', 'MVP',
+    'HTTP', 'HTTPS', 'REST', 'RPC', 'TCP', 'UDP', 'DNS', 'SSL', 'TLS',
+    'CPU', 'RAM', 'GPU', 'EOF', 'EOL', 'CRLF', 'NaN', 'Inf',
+    // Common doc section words
+    'Docs', 'Markdown', 'Readme', 'Changelog', 'License', 'Contributing',
+    // Words from description prose commonly flagged incorrectly
+    'Only', 'Skip', 'Output', 'Input', 'Done', 'Log', 'Path', 'Hash',
+    'Concurrent', 'Manage', 'Analyze', 'Compute', 'Concurrent',
+  ]);
 
-  const capitalizedIdentifiers = outputText.match(/\b([A-Z][a-zA-Z]{2,})\b/g) || [];
+  // Only flag compound PascalCase identifiers (e.g. MyClass, buildPKG),
+  // NOT plain Title-case prose words or uppercase acronyms.
+  const capitalizedIdentifiers = outputText.match(/\b([A-Z][a-z]+(?:[A-Z][a-zA-Z0-9]*)+)\b/g) || [];
   for (const identifier of capitalizedIdentifiers) {
     if (stopWords.has(identifier)) continue;
     if (!knownIdentifiers.has(identifier)) {

package/src/utils/config.js

@@ -59,7 +59,7 @@ function loadConfig(cliFlags = {}) {
   }
 
   const defaults = {
-    provider: 'groq',
+    provider: 'openrouter',
     model: undefined,
     format: 'markdown',
     out: './legacyver-docs',