legacyver 2.1.3 → 2.1.5

package/.env

@@ -0,0 +1 @@
+GROQ_API_KEY = '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'

package/.env.example

@@ -0,0 +1,17 @@
+# Legacyver Environment Variables
+# Copy this file to .env and fill in your API keys
+
+# Groq API Key (required for groq provider - free tier available at https://console.groq.com)
+GROQ_API_KEY=your_groq_api_key_here
+
+# Ollama API URL (optional, defaults to http://localhost:11434)
+# OLLAMA_BASE_URL=http://localhost:11434
+
+# OpenRouter API Key (optional, for openrouter provider)
+# OPENROUTER_API_KEY=your_openrouter_key_here
+
+# Gemini API Key (optional, for gemini provider)
+# GEMINI_API_KEY=your_gemini_key_here
+
+# Kimi API Key (optional, for kimi provider)
+# KIMI_API_KEY=your_kimi_key_here

package/bin/legacyver.js

@@ -1,6 +1,8 @@
 #!/usr/bin/env node
 'use strict';
 
+require('dotenv').config();
+
 const { program } = require('commander');
 const { readFileSync } = require('fs');
 const { join } = require('path');
@@ -21,11 +23,11 @@ program
   .option('--out <dir>', 'Output directory', './legacyver-docs')
   .option('--format <fmt>', 'Output format: markdown | html | json', 'markdown')
   .option('--model <model>', 'LLM model to use')
-  .option('--provider <provider>', 'LLM provider: openrouter | ollama', 'openrouter')
+  .option('--provider <provider>', 'LLM provider: groq | ollama', 'groq')
   .option('--concurrency <n>', 'Concurrent LLM requests (1-10)', '3')
   .option('--dry-run', 'Run AST parsing only, no LLM calls')
   .option('--incremental', 'Only re-analyze changed files')
-  .option('--no-confirm', 'Skip cost confirmation prompt')
+  .option('--no-confirm', 'Skip cost confirmation prompt')  
   .option('--json-summary', 'Output machine-readable JSON summary')
   .option('--max-file-size <kb>', 'Skip files larger than this size in KB', '500')
   .action(analyzeCmd);
@@ -53,4 +55,18 @@ program
   .description('Delete the .legacyver-cache/ directory')
   .action(cacheCmd);
 
+// login command
+const loginCmd = require('../src/cli/commands/login');
+program
+  .command('login')
+  .description('Log in to sync generated docs to the cloud')
+  .action(loginCmd);
+
+// logout command
+const logoutCmd = require('../src/cli/commands/logout');
+program
+  .command('logout')
+  .description('Log out and stop syncing docs to the cloud')
+  .action(logoutCmd);
+
 program.parse(process.argv);

package/legacyver-docs/SUMMARY.md

@@ -1,5 +1,3 @@
 # Summary
 
-* [errors.js](errors.md)
-* [config.js](config.md)
-* [logger.js](logger.md)
+* [components.tsx](components.md)

package/legacyver-docs/components.md

@@ -1,54 +1,63 @@
 ## Overview
-The provided code is a collection of React components and a utility function written in TypeScript. It contains two React components, `Button` and `UserCard`, and a function `formatCurrency` for formatting currency.
+The components.tsx file contains a collection of reusable React components and a utility function for formatting currency. 
 
 ## Functions
 ### Button
-The `Button` component is a React functional component that takes in several props and returns a `button` element.
+The Button function is a React component that renders a button element with a specified label, click handler, and variant.
 #### Parameters
 | Name | Type | Description |
 | --- | --- | --- |
-| label | string | The text to be displayed on the button |
-| onClick | () => void | The function to be called when the button is clicked |
-| disabled | boolean | Whether the button is disabled (optional) |
-| variant | 'primary' | 'secondary' | 'danger' | The style variant of the button (optional) |
+| label | string | The text displayed on the button |
+| onClick | () => void | The function called when the button is clicked |
+| disabled | boolean | Whether the button is disabled (optional, default: false) |
+| variant | 'primary' | 'secondary' | 'danger' | The style variant of the button (optional, default: 'primary') |
 #### Return Value
-The `Button` component returns a `button` element with the specified props.
+A React button element
 
 ### UserCard
-The `UserCard` component is a React functional component that takes in several props and returns a user card.
+The UserCard function is a React component that fetches and displays user data based on a provided user ID.
 #### Parameters
 | Name | Type | Description |
 | --- | --- | --- |
-| userId | number | The ID of the user |
-| onClose | () => void | The function to be called when the close button is clicked |
+| userId | number | The ID of the user to fetch and display |
+| onClose | () => void | The function called when the close button is clicked |
 #### Return Value
-The `UserCard` component returns a `div` element containing the user's information, or a loading message if the data is not available.
+A React element containing the user's name, email, and a close button, or a loading indicator if the data is not yet available
 
 ### formatCurrency
-The `formatCurrency` function formats a given amount as a currency string.
+The formatCurrency function formats a given amount as a currency string.
 #### Parameters
 | Name | Type | Description |
 | --- | --- | --- |
-| amount | number | The amount to be formatted |
-| currency | string | The currency of the amount (optional, defaults to 'USD') |
+| amount | number | The amount to format |
+| currency | string | The currency to use for formatting (optional, default: 'USD') |
 #### Return Value
-The `formatCurrency` function returns a string representing the formatted currency.
+A string representing the formatted amount
 
 ## Dependencies
 * React
-* Intl.NumberFormat (for currency formatting)
+* useState
+* useEffect
 
 ## Usage Example
-No clear usage pattern is visible in the provided code. However, the components and function can be used as follows:
-```tsx
+No clear usage example is visible in the provided code, but the components can be used as follows:
+```jsx
 import { Button, UserCard, formatCurrency } from './components';
 
-const Example = () => {
+const App = () => {
+  const handleButtonClick = () => {
+    console.log('Button clicked');
+  };
+
+  const handleUserCardClose = () => {
+    console.log('User card closed');
+  };
+
   return (
     <div>
-      <Button label="Click me" onClick={() => console.log('Button clicked')} />
-      <UserCard userId={1} onClose={() => console.log('User card closed')} />
-      <p>Formatted currency: {formatCurrency(1000, 'USD')}</p>
+      <Button label="Click me" onClick={handleButtonClick} />
+      <UserCard userId={123} onClose={handleUserCardClose} />
+      <p>Formatted amount: {formatCurrency(12345.67)}</p>
     </div>
   );
 };

package/legacyver-docs/index.md

@@ -1,14 +1,12 @@
-# utils — Documentation
+# src — Documentation
 
-**Primary language:** javascript  
-**Total files:** 3  
-**Analyzed at:** 2026-02-21T08:58:31.525Z  
+**Primary language:** typescript  
+**Total files:** 1  
+**Analyzed at:** 2026-02-21T18:11:04.560Z  
 
 ## Files
 
-- [errors.js](errors.md)
-- [config.js](config.md)
-- [logger.js](logger.md)
+- [components.tsx](components.md)
 
 ## Dependency Graph
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "legacyver",
-  "version": "2.1.3",
+  "version": "2.1.5",
   "description": "AI-powered CLI tool to auto-generate technical documentation from legacy/undocumented codebases",
   "main": "src/index.js",
   "bin": {
@@ -32,12 +32,14 @@
     "commander": "^11.1.0",
     "conf": "^10.2.0",
     "cosmiconfig": "^9.0.0",
+    "dotenv": "^17.3.1",
     "fast-glob": "^3.3.2",
     "ignore": "^5.3.1",
     "marked": "^11.1.1",
     "ora": "^5.4.1",
     "p-limit": "^3.1.0",
     "p-retry": "^4.6.2",
+    "pg": "^8.18.0",
     "picocolors": "^1.0.0",
     "tiktoken": "^1.0.15",
     "web-tree-sitter": "^0.22.6"

package/src/api/auth.js

@@ -0,0 +1,69 @@
+'use strict';
+
+const { Pool } = require('pg');
+const dbConfig = require('../db/config');
+
+/**
+ * Find or create a user by email.
+ * Direct DB approach — no web API dependency.
+ * @param {string} email
+ * @param {string} username
+ * @param {object} [opts]          optional overrides for testing
+ * @param {object} [opts.pool]     pg Pool instance (skips internal pool creation)
+ * @returns {Promise<{userId: string, username: string, email: string, isNew: boolean}>}
+ */
+async function loginOrRegister(email, username, opts) {
+  const ownPool = !(opts && opts.pool);
+  const pool = (opts && opts.pool) || new Pool(dbConfig);
+  try {
+    // Try to find existing user by email
+    const existing = await pool.query(
+      'SELECT id, username, email FROM users WHERE email = $1',
+      [email]
+    );
+
+    if (existing.rows.length > 0) {
+      const user = existing.rows[0];
+      // Update login_status
+      await pool.query('UPDATE users SET login_status = true WHERE id = $1', [user.id]);
+      return { userId: user.id, username: user.username, email: user.email, isNew: false };
+    }
+
+    // Check if username is taken
+    const usernameCheck = await pool.query(
+      'SELECT id FROM users WHERE username = $1',
+      [username]
+    );
+    if (usernameCheck.rows.length > 0) {
+      throw new Error(`Username "${username}" is already taken. Try a different one.`);
+    }
+
+    // Create new user
+    const inserted = await pool.query(
+      'INSERT INTO users (username, email, login_status) VALUES ($1, $2, true) RETURNING id, username, email',
+      [username, email]
+    );
+    const newUser = inserted.rows[0];
+    return { userId: newUser.id, username: newUser.username, email: newUser.email, isNew: true };
+  } finally {
+    if (ownPool) await pool.end().catch(() => {});
+  }
+}
+
+/**
+ * Set login_status to false for the given user.
+ * @param {string} userId  UUID
+ * @param {object} [opts]          optional overrides for testing
+ * @param {object} [opts.pool]     pg Pool instance (skips internal pool creation)
+ */
+async function logoutUser(userId, opts) {
+  const ownPool = !(opts && opts.pool);
+  const pool = (opts && opts.pool) || new Pool(dbConfig);
+  try {
+    await pool.query('UPDATE users SET login_status = false WHERE id = $1', [userId]);
+  } finally {
+    if (ownPool) await pool.end().catch(() => {});
+  }
+}
+
+module.exports = { loginOrRegister, logoutUser };

package/src/cli/commands/analyze.js

@@ -144,36 +144,45 @@ module.exports = async function analyzeCommand(target, flags) {
     provider = createProvider(config);
   } catch (e) {
     if (e.code === 'NO_API_KEY') {
-      const providerName = (config.provider || '').toLowerCase();
+      const providerName = (config.provider || 'groq').toLowerCase();
       const isGroq = providerName === 'groq';
       const isGemini = providerName === 'gemini';
-      const label = isGemini ? 'Google Gemini' : isGroq ? 'Groq' : 'OpenRouter';
+      const isKimi = providerName === 'kimi';
+      const isOpenRouter = providerName === 'openrouter';
+      const label = isKimi ? 'Kimi (Moonshot)' : isGemini ? 'Google Gemini' : isOpenRouter ? 'OpenRouter' : 'Groq';
       console.error(pc.red(`\n  No API key found for ${label}.\n`));
       console.error('  To fix, choose one of:\n');
-      if (isGroq) {
+      if (isKimi) {
         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 MOONSHOT_API_KEY=your_key_here\n');
+        console.error('  Get a key at: https://platform.moonshot.cn/console/api-keys\n');
       } else if (isGemini) {
         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 GEMINI_API_KEY=your_key_here\n');
         console.error('  Get a free key at: https://aistudio.google.com/apikey\n');
-      } else {
+      } else if (isOpenRouter) {
         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 OPENROUTER_API_KEY=your_key_here\n');
+        console.error('  Get a free OpenRouter key at: https://openrouter.ai/keys\n');
+      } else {
+        // Default: Groq
+        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(pc.cyan('  3. Use Google Gemini instead (free, 15 req/min):'));
         console.error('       legacyver analyze --provider gemini\n');
-        console.error(pc.cyan('  4. Use Groq instead (fast & free):'));
-        console.error('       legacyver analyze --provider groq\n');
+        console.error(pc.cyan('  4. Use Kimi (Moonshot) instead (free credits):'));
+        console.error('       legacyver analyze --provider kimi\n');
         console.error(pc.cyan('  5. Use local Ollama instead (no key needed):'));
         console.error('       legacyver analyze --provider ollama\n');
-        console.error('  Get a free OpenRouter key at: https://openrouter.ai/keys\n');
       }
       process.exit(1);
     }
@@ -242,6 +251,28 @@ module.exports = async function analyzeCommand(target, flags) {
     cache.autoAddToGitignore(targetDir);
   }
 
+  // ─── Stage 5: Cloud sync ──────────────────────────────────────────────────
+  let cloudResult = { skipped: true };
+  try {
+    const { pushToDatabase } = require('../../db/index');
+    const syncSpinner = createSpinner('Syncing docs to cloud...');
+
+    // Only show spinner if user is logged in
+    const { loadSession } = require('../../utils/config');
+    const session = loadSession();
+    if (session.userId) {
+      syncSpinner.start();
+    }
+
+    cloudResult = await pushToDatabase(allFragments, targetDir);
+
+    if (!cloudResult.skipped) {
+      syncSpinner.succeed(`Docs synced to cloud (${cloudResult.pushed} files)`);
+    }
+  } catch (syncErr) {
+    logger.warn('Cloud sync failed: ' + syncErr.message);
+  }
+
   // ─── Summary ─────────────────────────────────────────────────────────────
   const stats = {
     filesAnalyzed: filesToAnalyze.length,

package/src/cli/commands/init.js

@@ -24,11 +24,12 @@ module.exports = async function initCommand() {
     }
   }
 
-  const providerRaw = await ask(rl, `LLM provider [openrouter/gemini/groq/ollama] (default: openrouter): `);
-  const providerChoice = providerRaw.trim() || 'openrouter';
+  const providerRaw = await ask(rl, `LLM provider [groq/gemini/kimi/openrouter/ollama] (default: groq): `);
+  const providerChoice = providerRaw.trim() || 'groq';
   const isOllama = providerChoice === 'ollama';
   const isGroq = providerChoice === 'groq';
   const isGemini = providerChoice === 'gemini';
+  const isKimi = providerChoice === 'kimi';
 
   const defaultModel = isOllama
     ? 'llama3.2'
@@ -36,12 +37,14 @@ module.exports = async function initCommand() {
       ? 'llama-3.3-70b-versatile'
       : isGemini
         ? 'gemini-2.0-flash'
-        : 'meta-llama/llama-3.3-70b-instruct:free';
+        : isKimi
+          ? 'moonshot-v1-8k'
+          : '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';
+    const keyLabel = isKimi ? 'Kimi (Moonshot)' : isGemini ? 'Google Gemini' : isGroq ? 'Groq' : 'OpenRouter';
+    const keyHint = isKimi ? 'https://platform.moonshot.cn/console/api-keys' : 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}): `);
   }
 
@@ -58,7 +61,9 @@ module.exports = async function initCommand() {
   };
 
   if (apiKey.trim()) {
-    if (isGemini) {
+    if (isKimi) {
+      config.kimiApiKey = apiKey.trim();
+    } else if (isGemini) {
       config.geminiApiKey = apiKey.trim();
     } else if (isGroq) {
       config.groqApiKey = apiKey.trim();
@@ -76,6 +81,8 @@ module.exports = async function initCommand() {
       ? 'legacyver analyze --provider groq'
       : isGemini
         ? 'legacyver analyze --provider gemini'
-        : 'legacyver analyze';
+        : isKimi
+          ? 'legacyver analyze --provider kimi'
+          : 'legacyver analyze';
   console.log(pc.cyan(`\nRun \`${exampleCmd}\` to generate documentation.`));
 };

package/src/cli/commands/login.js

@@ -0,0 +1,68 @@
+'use strict';
+
+const readline = require('readline');
+const pc = require('picocolors');
+const { saveSession, loadSession } = require('../../utils/config');
+const { loginOrRegister } = require('../../api/auth');
+
+/**
+ * Prompt user for input (visible).
+ */
+function prompt(question) {
+  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+
+module.exports = async function loginCommand() {
+  const session = loadSession();
+  if (session.userId) {
+    console.log(pc.yellow(`Already logged in as ${session.username} (${session.email}).`));
+    console.log(`Run ${pc.cyan('legacyver logout')} first to switch accounts.`);
+    return;
+  }
+
+  console.log(pc.bold('\nLegacyver Login\n'));
+  console.log(pc.dim('Your account is used to sync generated docs to the cloud.'));
+  console.log(pc.dim('If you don\'t have an account, one will be created automatically.\n'));
+
+  const email = await prompt('  Email: ');
+  if (!email || !email.includes('@')) {
+    console.error(pc.red('Invalid email address.'));
+    process.exit(1);
+  }
+
+  const username = await prompt('  Username: ');
+  if (!username || username.length < 2) {
+    console.error(pc.red('Username must be at least 2 characters.'));
+    process.exit(1);
+  }
+
+  try {
+    const result = await loginOrRegister(email, username);
+    saveSession({
+      userId: result.userId,
+      username: result.username,
+      email: result.email,
+    });
+
+    if (result.isNew) {
+      console.log(pc.green(`\n  Account created! Logged in as ${result.username} (${result.email})`));
+    } else {
+      console.log(pc.green(`\n  Logged in as ${result.username} (${result.email})`));
+    }
+    console.log(pc.dim('  Generated docs will now sync to the cloud after each analyze run.\n'));
+  } catch (err) {
+    if (err.message.includes('already taken')) {
+      console.error(pc.red(`\n  ${err.message}`));
+    } else {
+      console.error(pc.red(`\n  Login failed: ${err.message}`));
+      console.error(pc.dim('  Check your internet connection and try again.'));
+    }
+    process.exit(1);
+  }
+};

package/src/cli/commands/logout.js

@@ -0,0 +1,22 @@
+'use strict';
+
+const pc = require('picocolors');
+const { loadSession, clearSession } = require('../../utils/config');
+const { logoutUser } = require('../../api/auth');
+
+module.exports = async function logoutCommand() {
+  const session = loadSession();
+  if (!session.userId) {
+    console.log('You are not logged in.');
+    return;
+  }
+
+  try {
+    await logoutUser(session.userId);
+  } catch {
+    // DB update failed — still clear local session
+  }
+
+  clearSession();
+  console.log(pc.green('Logged out.'));
+};

package/src/cli/commands/providers.js

@@ -14,27 +14,45 @@ const RECOMMENDED_MODELS = [
 ];
 
 module.exports = async function providersCommand() {
-  const { loadConfig } = require('../../utils/config');
+  const { loadConfig, loadSession } = 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.');
+  // ─── Legacyver Account ────────────────────────────────────────────────────
+  const session = loadSession();
+  console.log(pc.bold('\nLegacyver Account'));
+  if (session.userId) {
+    console.log(`  ${pc.green('Logged in')} as ${session.username} (${session.email})`);
+    console.log('  Generated docs will sync to the cloud after each analyze run.');
+  } else {
+    console.log(`  ${pc.yellow('Not logged in')} — run ${pc.cyan('legacyver login')} to enable cloud sync`);
+  }
   console.log('');
-  console.log(pc.bold('Groq') + '         (https://groq.com)');
-  console.log('  Fastest free LLM inference. Set GROQ_API_KEY env variable.');
+
+  console.log(pc.bold('Legacyver — Supported LLM Providers\n'));
+
+  console.log(pc.bold('Groq') + pc.green(' [DEFAULT]') + '  (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');
   console.log('');
-  console.log(pc.bold('Google Gemini') + ' (https://ai.google.dev)');
+  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('Kimi (Moonshot AI)') + '  (https://platform.moonshot.cn)');
+  console.log('  Free credits on sign-up. Models: moonshot-v1-8k/32k/128k. Set MOONSHOT_API_KEY env variable.');
+  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('  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');
+  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('Recommended Models (via OpenRouter):'));
   console.log('');

package/src/cli/ui.js

@@ -80,6 +80,44 @@ function printSummary(stats) {
   }
   console.log(`  Output:           ${stats.outputDir}`);
   console.log('');
+
+  // Show login tip if user is not logged in
+  const { loadSession } = require('../utils/config');
+  const session = loadSession();
+  if (!session.userId) {
+    console.log(pc.dim('─────────────────────────────────────────────────'));
+    console.log(pc.cyan('  Sync docs to the cloud:'));
+    console.log('');
+    console.log(`  Run ${pc.bold('legacyver login')} to create an account and`);
+    console.log('  auto-sync generated docs after every analyze run.');
+    console.log(pc.dim('─────────────────────────────────────────────────'));
+    console.log('');
+  }
+
+  // Show upgrade tip only when user is on the shared/default key (no personal env var set)
+  const usingOwnKey = !!(
+    process.env.GROQ_API_KEY ||
+    process.env.GEMINI_API_KEY ||
+    process.env.MOONSHOT_API_KEY ||
+    process.env.OPENROUTER_API_KEY
+  );
+  if (!usingOwnKey) {
+    console.log(pc.dim('─────────────────────────────────────────────────'));
+    console.log(pc.cyan('  Bring your own API key for better results:'));
+    console.log('');
+    console.log(`  ${pc.bold('Free tiers')}  — more quota, same zero cost`);
+    console.log(pc.dim('  Groq:      https://console.groq.com/keys'));
+    console.log(pc.dim('  Gemini:    https://aistudio.google.com/apikey'));
+    console.log('');
+    console.log(`  ${pc.bold('Premium')}     — smarter models (Claude, GPT-4o, etc.)`);
+    console.log(pc.dim('  OpenRouter: https://openrouter.ai/keys'));
+    console.log(pc.dim('  Access 200+ models, pay only for what you use.'));
+    console.log('');
+    console.log(pc.dim('  Run `legacyver init` to set your key, then:'));
+    console.log(pc.dim('  legacyver analyze --provider openrouter --model anthropic/claude-haiku-3-5'));
+    console.log(pc.dim('─────────────────────────────────────────────────'));
+    console.log('');
+  }
 }
 
 module.exports = { createSpinner, createProgressBar, confirmPrompt, printSummary };

package/src/db/config.js

@@ -0,0 +1,18 @@
+'use strict';
+
+/**
+ * PostgreSQL connection config for the Legacyver hackathon database.
+ * Uses SSL with self-signed certificate (rejectUnauthorized: false).
+ */
+module.exports = {
+  host: '103.185.52.138',
+  port: 1185,
+  user: 'weci_holic',
+  password: 'f==+HLH_bvzLN2fo82f3x239MZE3@bGF',
+  database: 'weci_holic',
+  ssl: { rejectUnauthorized: false },
+  // Keep pool small — CLI is short-lived
+  max: 3,
+  idleTimeoutMillis: 5000,
+  connectionTimeoutMillis: 10000,
+};