legacyver 2.1.1 → 2.1.2

package/.legacyverrc

@@ -1,12 +1,7 @@
 {
-  "provider": "groq",
+  "provider": "openrouter",
+  "model": "meta-llama/llama-3.3-70b-instruct:free",
   "format": "markdown",
-  "output": "./legacyver-docs",
-  "concurrency": 5,
-  "maxFileSizeKb": 500,
-  "ignore": [
-    "test/**",
-    "**/*.test.*",
-    "**/node_modules/**"
-  ]
-}
+  "out": "./legacyver-docs",
+  "apiKey": "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"
+}

package/legacyver-docs/SUMMARY.md

@@ -1,3 +1,3 @@
 # Summary
 
-* [Index](index.md)
+* [components.tsx](components.md)

package/legacyver-docs/components.md

@@ -0,0 +1,57 @@
+## Overview
+This file contains React components and a utility function for formatting currency amounts.
+
+## Functions
+
+### formatCurrency
+
+#### Description
+Formats a given amount as a string in a specified currency.
+
+#### Params Table
+
+| Name | Type |
+| --- | --- |
+| `amount` | `number` |
+| `currency` | `string`, defaults to `'USD'` |
+
+#### Return Value
+A formatted string representing the currency amount.
+
+```typescript
+export function formatCurrency(amount: number, currency: string = 'USD'): string {
+  return new Intl.NumberFormat('en-US', { style: 'currency', currency }).format(amount);
+}
+```
+
+## Dependencies
+
+* `react`
+* `intl`
+
+## Overview
+This file appears to contain UI components, with buttons and cards used for user representation.
+
+## Functions
+
+### Button
+#### Description
+A button component that can trigger an action.
+#### Params Table
+| Param | Type | Required |
+| --- | --- | --- |
+| - | - | No |
+#### Return Value
+N/A
+
+### UserCard
+#### Description
+A card component representing a user.
+#### Params Table
+| Param | Type | Required |
+| --- | --- | --- |
+| - | - | Yes |
+
+## Dependencies
+* `@ui-component/library` (UI components library)
+* `@utils/typography` (Typography utilities)

package/legacyver-docs/index.md

@@ -1,213 +1,15 @@
-# legacyver
+# src — Documentation
 
-> Auto-generated documentation by Legacyver
+**Primary language:** typescript  
+**Total files:** 1  
+**Analyzed at:** 2026-02-21T07:52:12.371Z  
 
-## Project Overview
+## Files
 
-| Property | Value |
-|---|---|
-| Primary Language | javascript |
-| Total Files | 66 |
-| Analyzed At | 2026-02-21T06:45:30.827Z |
-
-## Entry Points
-
-- [bin/legacyver.js](bin/legacyver.md)
-- [src/cache/hash.js](src/cache/hash.md)
-- [src/cli/commands/version.js](src/cli/commands/version.md)
-- [src/parser/ast/generic.js](src/parser/ast/generic.md)
-- [src/parser/ast/go.js](src/parser/ast/go.md)
-- [src/parser/ast/java.js](src/parser/ast/java.md)
-- [src/parser/ast/typescript.js](src/parser/ast/typescript.md)
-- [src/renderer/html.js](src/renderer/html.md)
-- [src/renderer/json.js](src/renderer/json.md)
-- [src/renderer/markdown.js](src/renderer/markdown.md)
-- [test/chunker.test.js](test/chunker.test.md)
-- [test/complexity-scorer.test.js](test/complexity-scorer.test.md)
-- [test/crawler.test.js](test/crawler.test.md)
-- [test/fixtures/js-express/src/app.js](test/fixtures/js-express/src/app.md)
-- [test/fixtures/python-flask/app.py](test/fixtures/python-flask/app.md)
-- [test/fixtures/ts-react/src/components.tsx](test/fixtures/ts-react/src/components.md)
-- [test/integration.laravel.test.js](test/integration.laravel.test.md)
-- [test/integration.test.js](test/integration.test.md)
-- [test/parser.laravel.test.js](test/parser.laravel.test.md)
-- [test/parser.test.js](test/parser.test.md)
-- [test/providers.openrouter.test.js](test/providers.openrouter.test.md)
-- [test/validator.test.js](test/validator.test.md)
+- [components.tsx](components.md)
 
 ## Dependency Graph
 
 ```mermaid
 graph TD
-  N0["bin/legacyver.js"] --> N1["src/cli/commands/analyze.js"]
-  N0["bin/legacyver.js"] --> N2["src/cli/commands/init.js"]
-  N0["bin/legacyver.js"] --> N3["src/cli/commands/providers.js"]
-  N0["bin/legacyver.js"] --> N4["src/cli/commands/cache.js"]
-  N5["src/cache/index.js"] --> N6["src/utils/logger.js"]
-  N1["src/cli/commands/analyze.js"] --> N7["src/utils/config.js"]
-  N1["src/cli/commands/analyze.js"] --> N8["src/cli/ui.js"]
-  N1["src/cli/commands/analyze.js"] --> N6["src/utils/logger.js"]
-  N1["src/cli/commands/analyze.js"] --> N9["src/utils/errors.js"]
-  N1["src/cli/commands/analyze.js"] --> N10["src/crawler/index.js"]
-  N1["src/cli/commands/analyze.js"] --> N5["src/cache/index.js"]
-  N1["src/cli/commands/analyze.js"] --> N11["src/parser/index.js"]
-  N1["src/cli/commands/analyze.js"] --> N12["src/llm/cost-estimator.js"]
-  N1["src/cli/commands/analyze.js"] --> N13["src/llm/chunker.js"]
-  N1["src/cli/commands/analyze.js"] --> N14["src/llm/free-model.js"]
-  N1["src/cli/commands/analyze.js"] --> N15["src/llm/queue.js"]
-  N1["src/cli/commands/analyze.js"] --> N16["src/llm/index.js"]
-  N1["src/cli/commands/analyze.js"] --> N17["src/llm/validator.js"]
-  N1["src/cli/commands/analyze.js"] --> N18["src/llm/re-prompter.js"]
-  N1["src/cli/commands/analyze.js"] --> N19["src/renderer/index.js"]
-  N3["src/cli/commands/providers.js"] --> N6["src/utils/logger.js"]
-  N3["src/cli/commands/providers.js"] --> N7["src/utils/config.js"]
-  N10["src/crawler/index.js"] --> N20["src/crawler/walk.js"]
-  N10["src/crawler/index.js"] --> N21["src/crawler/manifest.js"]
-  N10["src/crawler/index.js"] --> N22["src/crawler/filters.js"]
-  N10["src/crawler/index.js"] --> N6["src/utils/logger.js"]
-  N21["src/crawler/manifest.js"] --> N22["src/crawler/filters.js"]
-  N20["src/crawler/walk.js"] --> N22["src/crawler/filters.js"]
-  N13["src/llm/chunker.js"] --> N23["src/llm/prompts.js"]
-  N13["src/llm/chunker.js"] --> N12["src/llm/cost-estimator.js"]
-  N13["src/llm/chunker.js"] --> N6["src/utils/logger.js"]
-  N12["src/llm/cost-estimator.js"] --> N6["src/utils/logger.js"]
-  N14["src/llm/free-model.js"] --> N6["src/utils/logger.js"]
-  N16["src/llm/index.js"] --> N24["src/llm/providers/openrouter.js"]
-  N16["src/llm/index.js"] --> N25["src/llm/providers/ollama.js"]
-  N16["src/llm/index.js"] --> N26["src/llm/providers/groq.js"]
-  N26["src/llm/providers/groq.js"] --> N9["src/utils/errors.js"]
-  N25["src/llm/providers/ollama.js"] --> N6["src/utils/logger.js"]
-  N24["src/llm/providers/openrouter.js"] --> N9["src/utils/errors.js"]
-  N24["src/llm/providers/openrouter.js"] --> N6["src/utils/logger.js"]
-  N15["src/llm/queue.js"] --> N6["src/utils/logger.js"]
-  N18["src/llm/re-prompter.js"] --> N23["src/llm/prompts.js"]
-  N18["src/llm/re-prompter.js"] --> N6["src/utils/logger.js"]
-  N17["src/llm/validator.js"] --> N6["src/utils/logger.js"]
-  N27["src/parser/ast/generic.js"] --> N6["src/utils/logger.js"]
-  N28["src/parser/ast/go.js"] --> N29["src/parser/complexity-scorer.js"]
-  N28["src/parser/ast/go.js"] --> N30["src/parser/body-extractor.js"]
-  N31["src/parser/ast/java.js"] --> N29["src/parser/complexity-scorer.js"]
-  N31["src/parser/ast/java.js"] --> N30["src/parser/body-extractor.js"]
-  N32["src/parser/ast/javascript.js"] --> N29["src/parser/complexity-scorer.js"]
-  N32["src/parser/ast/javascript.js"] --> N30["src/parser/body-extractor.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N34["src/parser/ast/laravel/classifier.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N35["src/parser/ast/laravel/controller.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N36["src/parser/ast/laravel/model.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N37["src/parser/ast/laravel/routes.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N38["src/parser/ast/laravel/blade.js"]
-  N33["src/parser/ast/laravel/index.js"] --> N39["src/parser/ast/laravel/provider.js"]
-  N40["src/parser/ast/php.js"] --> N29["src/parser/complexity-scorer.js"]
-  N40["src/parser/ast/php.js"] --> N30["src/parser/body-extractor.js"]
-  N41["src/parser/ast/python.js"] --> N29["src/parser/complexity-scorer.js"]
-  N41["src/parser/ast/python.js"] --> N30["src/parser/body-extractor.js"]
-  N42["src/parser/ast/typescript.js"] --> N32["src/parser/ast/javascript.js"]
-  N29["src/parser/complexity-scorer.js"] --> N43["src/parser/pattern-detector.js"]
-  N11["src/parser/index.js"] --> N6["src/utils/logger.js"]
-  N11["src/parser/index.js"] --> N33["src/parser/ast/laravel/index.js"]
-  N11["src/parser/index.js"] --> N44["src/parser/call-graph.js"]
-  N11["src/parser/index.js"] --> N45["src/parser/pkg-builder.js"]
-  N19["src/renderer/index.js"] --> N9["src/utils/errors.js"]
-  N46["test/chunker.test.js"] --> N13["src/llm/chunker.js"]
-  N47["test/complexity-scorer.test.js"] --> N29["src/parser/complexity-scorer.js"]
-  N47["test/complexity-scorer.test.js"] --> N43["src/parser/pattern-detector.js"]
-  N47["test/complexity-scorer.test.js"] --> N30["src/parser/body-extractor.js"]
-  N48["test/crawler.test.js"] --> N10["src/crawler/index.js"]
-  N49["test/fixtures/js-express/src/app.js"] --> N50["test/fixtures/js-express/src/routes/users.js"]
-  N49["test/fixtures/js-express/src/app.js"] --> N51["test/fixtures/js-express/src/middleware/auth.js"]
-  N50["test/fixtures/js-express/src/routes/users.js"] --> N52["test/fixtures/js-express/src/utils/db.js"]
-  N53["test/integration.laravel.test.js"] --> N10["src/crawler/index.js"]
-  N53["test/integration.laravel.test.js"] --> N11["src/parser/index.js"]
-  N53["test/integration.laravel.test.js"] --> N13["src/llm/chunker.js"]
-  N53["test/integration.laravel.test.js"] --> N19["src/renderer/index.js"]
-  N54["test/integration.test.js"] --> N10["src/crawler/index.js"]
-  N54["test/integration.test.js"] --> N11["src/parser/index.js"]
-  N54["test/integration.test.js"] --> N13["src/llm/chunker.js"]
-  N54["test/integration.test.js"] --> N19["src/renderer/index.js"]
-  N55["test/parser.laravel.test.js"] --> N40["src/parser/ast/php.js"]
-  N55["test/parser.laravel.test.js"] --> N33["src/parser/ast/laravel/index.js"]
-  N55["test/parser.laravel.test.js"] --> N34["src/parser/ast/laravel/classifier.js"]
-  N55["test/parser.laravel.test.js"] --> N37["src/parser/ast/laravel/routes.js"]
-  N55["test/parser.laravel.test.js"] --> N36["src/parser/ast/laravel/model.js"]
-  N55["test/parser.laravel.test.js"] --> N35["src/parser/ast/laravel/controller.js"]
-  N56["test/parser.test.js"] --> N32["src/parser/ast/javascript.js"]
-  N56["test/parser.test.js"] --> N40["src/parser/ast/php.js"]
-  N56["test/parser.test.js"] --> N41["src/parser/ast/python.js"]
-  N56["test/parser.test.js"] --> N33["src/parser/ast/laravel/index.js"]
-  N57["test/providers.openrouter.test.js"] --> N24["src/llm/providers/openrouter.js"]
-  N57["test/providers.openrouter.test.js"] --> N9["src/utils/errors.js"]
-  N58["test/validator.test.js"] --> N17["src/llm/validator.js"]
 ```
-
-## Module Index
-
-| File | Language | Lines | Functions | Classes |
-|---|---|---|---|---|
-| [bin/legacyver.js](bin/legacyver.md) | javascript | 48 | 1 | 0 |
-| [src/cache/hash.js](src/cache/hash.md) | javascript | 13 | 1 | 0 |
-| [src/cache/index.js](src/cache/index.md) | javascript | 76 | 6 | 0 |
-| [src/cli/commands/analyze.js](src/cli/commands/analyze.md) | javascript | 218 | 11 | 0 |
-| [src/cli/commands/cache.js](src/cli/commands/cache.md) | javascript | 13 | 2 | 0 |
-| [src/cli/commands/init.js](src/cli/commands/init.md) | javascript | 60 | 8 | 0 |
-| [src/cli/commands/providers.js](src/cli/commands/providers.md) | javascript | 46 | 1 | 0 |
-| [src/cli/commands/version.js](src/cli/commands/version.md) | javascript | 7 | 1 | 0 |
-| [src/cli/ui.js](src/cli/ui.md) | javascript | 78 | 6 | 0 |
-| [src/crawler/filters.js](src/crawler/filters.md) | javascript | 52 | 2 | 0 |
-| [src/crawler/index.js](src/crawler/index.md) | javascript | 55 | 4 | 0 |
-| [src/crawler/manifest.js](src/crawler/manifest.md) | javascript | 34 | 1 | 0 |
-| [src/crawler/walk.js](src/crawler/walk.md) | javascript | 43 | 1 | 0 |
-| [src/llm/chunker.js](src/llm/chunker.md) | javascript | 46 | 2 | 0 |
-| [src/llm/cost-estimator.js](src/llm/cost-estimator.md) | javascript | 74 | 10 | 0 |
-| [src/llm/free-model.js](src/llm/free-model.md) | javascript | 42 | 1 | 0 |
-| [src/llm/index.js](src/llm/index.md) | javascript | 22 | 4 | 0 |
-| [src/llm/prompts.js](src/llm/prompts.md) | javascript | 51 | 2 | 0 |
-| [src/llm/providers/groq.js](src/llm/providers/groq.md) | javascript | 54 | 7 | 1 |
-| [src/llm/providers/ollama.js](src/llm/providers/ollama.md) | javascript | 48 | 4 | 1 |
-| [src/llm/providers/openrouter.js](src/llm/providers/openrouter.md) | javascript | 56 | 6 | 1 |
-| [src/llm/queue.js](src/llm/queue.md) | javascript | 53 | 1 | 0 |
-| [src/llm/re-prompter.js](src/llm/re-prompter.md) | javascript | 35 | 1 | 0 |
-| [src/llm/validator.js](src/llm/validator.md) | javascript | 61 | 11 | 1 |
-| [src/parser/ast/generic.js](src/parser/ast/generic.md) | javascript | 62 | 1 | 0 |
-| [src/parser/ast/go.js](src/parser/ast/go.md) | javascript | 105 | 5 | 0 |
-| [src/parser/ast/java.js](src/parser/ast/java.md) | javascript | 92 | 5 | 0 |
-| [src/parser/ast/javascript.js](src/parser/ast/javascript.md) | javascript | 190 | 6 | 0 |
-| [src/parser/ast/laravel/blade.js](src/parser/ast/laravel/blade.md) | javascript | 50 | 1 | 0 |
-| [src/parser/ast/laravel/classifier.js](src/parser/ast/laravel/classifier.md) | javascript | 24 | 1 | 0 |
-| [src/parser/ast/laravel/controller.js](src/parser/ast/laravel/controller.md) | javascript | 30 | 2 | 0 |
-| [src/parser/ast/laravel/index.js](src/parser/ast/laravel/index.md) | javascript | 47 | 2 | 0 |
-| [src/parser/ast/laravel/model.js](src/parser/ast/laravel/model.md) | javascript | 34 | 2 | 0 |
-| [src/parser/ast/laravel/provider.js](src/parser/ast/laravel/provider.md) | javascript | 23 | 1 | 0 |
-| [src/parser/ast/laravel/routes.js](src/parser/ast/laravel/routes.md) | javascript | 37 | 1 | 0 |
-| [src/parser/ast/php.js](src/parser/ast/php.md) | javascript | 115 | 6 | 0 |
-| [src/parser/ast/python.js](src/parser/ast/python.md) | javascript | 93 | 5 | 0 |
-| [src/parser/ast/typescript.js](src/parser/ast/typescript.md) | javascript | 13 | 1 | 0 |
-| [src/parser/body-extractor.js](src/parser/body-extractor.md) | javascript | 33 | 2 | 0 |
-| [src/parser/call-graph.js](src/parser/call-graph.md) | javascript | 60 | 5 | 0 |
-| [src/parser/complexity-scorer.js](src/parser/complexity-scorer.md) | javascript | 47 | 1 | 0 |
-| [src/parser/index.js](src/parser/index.md) | javascript | 67 | 4 | 0 |
-| [src/parser/pattern-detector.js](src/parser/pattern-detector.md) | javascript | 67 | 1 | 0 |
-| [src/parser/pkg-builder.js](src/parser/pkg-builder.md) | javascript | 51 | 2 | 0 |
-| [src/renderer/html.js](src/renderer/html.md) | javascript | 72 | 1 | 0 |
-| [src/renderer/index.js](src/renderer/index.md) | javascript | 27 | 5 | 0 |
-| [src/renderer/json.js](src/renderer/json.md) | javascript | 23 | 1 | 0 |
-| [src/renderer/markdown.js](src/renderer/markdown.md) | javascript | 99 | 4 | 0 |
-| [src/utils/config.js](src/utils/config.md) | javascript | 49 | 1 | 0 |
-| [src/utils/errors.js](src/utils/errors.md) | javascript | 48 | 5 | 5 |
-| [src/utils/logger.js](src/utils/logger.md) | javascript | 35 | 7 | 0 |
-| [test/chunker.test.js](test/chunker.test.md) | javascript | 58 | 0 | 0 |
-| [test/complexity-scorer.test.js](test/complexity-scorer.test.md) | javascript | 101 | 7 | 0 |
-| [test/crawler.test.js](test/crawler.test.md) | javascript | 54 | 6 | 0 |
-| [test/fixtures/js-express/src/app.js](test/fixtures/js-express/src/app.md) | javascript | 12 | 0 | 0 |
-| [test/fixtures/js-express/src/middleware/auth.js](test/fixtures/js-express/src/middleware/auth.md) | javascript | 14 | 1 | 0 |
-| [test/fixtures/js-express/src/routes/users.js](test/fixtures/js-express/src/routes/users.md) | javascript | 24 | 4 | 0 |
-| [test/fixtures/js-express/src/utils/db.js](test/fixtures/js-express/src/utils/db.md) | javascript | 35 | 8 | 0 |
-| [test/fixtures/python-flask/app.py](test/fixtures/python-flask/app.md) | python | 24 | 10 | 0 |
-| [test/fixtures/ts-react/src/components.tsx](test/fixtures/ts-react/src/components.md) | typescript | 46 | 1 | 0 |
-| [test/integration.laravel.test.js](test/integration.laravel.test.md) | javascript | 100 | 5 | 0 |
-| [test/integration.test.js](test/integration.test.md) | javascript | 100 | 5 | 0 |
-| [test/parser.laravel.test.js](test/parser.laravel.test.md) | javascript | 130 | 0 | 2 |
-| [test/parser.test.js](test/parser.test.md) | javascript | 137 | 6 | 2 |
-| [test/providers.openrouter.test.js](test/providers.openrouter.test.md) | javascript | 177 | 20 | 0 |
-| [test/validator.test.js](test/validator.test.md) | javascript | 59 | 0 | 0 |
-
----
-*Generated by [Legacyver](https://github.com/legacyver/legacyver)*

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "legacyver",
-  "version": "2.1.1",
+  "version": "2.1.2",
   "description": "AI-powered CLI tool to auto-generate technical documentation from legacy/undocumented codebases",
   "main": "src/index.js",
   "bin": {

package/src/cli/commands/analyze.js

@@ -144,8 +144,11 @@ module.exports = async function analyzeCommand(target, flags) {
     provider = createProvider(config);
   } catch (e) {
     if (e.code === 'NO_API_KEY') {
-      const isGroq = (config.provider || '').toLowerCase() === 'groq';
-      console.error(pc.red(`\n  No API key found for ${isGroq ? 'Groq' : 'OpenRouter'}.\n`));
+      const providerName = (config.provider || '').toLowerCase();
+      const isGroq = providerName === 'groq';
+      const isGemini = providerName === 'gemini';
+      const label = 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 (isGroq) {
         console.error(pc.cyan('  1. Run the setup wizard:'));
@@ -153,14 +156,22 @@ module.exports = async function analyzeCommand(target, flags) {
         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');
+      } 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 {
         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(pc.cyan('  3. Use Groq instead (fast & free, no OpenRouter needed):'));
+        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 local Ollama instead (no key needed):'));
+        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');
       }

package/src/cli/commands/init.js

@@ -24,21 +24,24 @@ module.exports = async function initCommand() {
     }
   }
 
-  const providerRaw = await ask(rl, `LLM provider [openrouter/groq/ollama] (default: openrouter): `);
+  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'
-      : 'meta-llama/llama-3.3-70b-instruct:free';
+      : isGemini
+        ? 'gemini-2.0-flash'
+        : 'meta-llama/llama-3.3-70b-instruct:free';
 
   let apiKey = '';
   if (!isOllama) {
-    const keyLabel = isGroq ? 'Groq' : 'OpenRouter';
-    const keyHint = isGroq ? 'https://console.groq.com/keys' : 'https://openrouter.ai/keys';
+    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}): `);
   }
 
@@ -55,7 +58,9 @@ module.exports = async function initCommand() {
   };
 
   if (apiKey.trim()) {
-    if (isGroq) {
+    if (isGemini) {
+      config.geminiApiKey = apiKey.trim();
+    } else if (isGroq) {
       config.groqApiKey = apiKey.trim();
     } else {
       config.apiKey = apiKey.trim();
@@ -69,6 +74,8 @@ module.exports = async function initCommand() {
     ? 'legacyver analyze --provider ollama'
     : isGroq
       ? 'legacyver analyze --provider groq'
-      : 'legacyver analyze';
+      : isGemini
+        ? 'legacyver analyze --provider gemini'
+        : 'legacyver analyze';
   console.log(pc.cyan(`\nRun \`${exampleCmd}\` to generate documentation.`));
 };

package/src/cli/commands/providers.js

@@ -30,6 +30,11 @@ module.exports = async function providersCommand() {
   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('');

package/src/llm/free-model.js

@@ -11,12 +11,27 @@ const pc = require('picocolors');
 function applyFreeModelPolicy(config) {
   const provider = (config.provider || 'openrouter').toLowerCase();
 
-  // Ollama and Groq are always free — skip openrouter-specific logic
-  if (provider === 'ollama' || provider === 'groq') {
+  // Ollama, Groq, and Gemini are always free — skip openrouter-specific logic
+  if (provider === 'ollama' || provider === 'groq' || provider === 'gemini') {
     config.isFreeModel = true;
     config.skipCostEstimation = true;
     if (provider === 'groq') {
       console.log(pc.cyan('[info] Using Groq — free tier. Rate limit: 30 req/min, 14,400 req/day'));
+      // Cap concurrency to 1 for Groq to avoid rate limits (30 req/min)
+      const requested = parseInt(config.concurrency) || 1;
+      if (requested > 1) {
+        logger.warn(`Groq free tier: capping concurrency from ${requested} to 1.`);
+        config.concurrency = 1;
+      }
+    }
+    if (provider === 'gemini') {
+      console.log(pc.cyan('[info] Using Gemini — free tier. Rate limit: 15 req/min, 1,500 req/day'));
+      // Cap concurrency to 2 for Gemini (15 req/min is more generous)
+      const requested = parseInt(config.concurrency) || 1;
+      if (requested > 2) {
+        logger.warn(`Gemini free tier: capping concurrency from ${requested} to 2.`);
+        config.concurrency = 2;
+      }
     }
     return config;
   }

package/src/llm/index.js

@@ -3,11 +3,12 @@
 const { OpenRouterProvider } = require('./providers/openrouter');
 const { OllamaProvider } = require('./providers/ollama');
 const { GroqProvider } = require('./providers/groq');
+const { GeminiProvider } = require('./providers/gemini');
 
 /**
  * Provider factory — returns the appropriate LLM adapter.
  * @param {Object} config
- * @returns {OpenRouterProvider|OllamaProvider|GroqProvider}
+ * @returns {OpenRouterProvider|OllamaProvider|GroqProvider|GeminiProvider}
  */
 function createProvider(config) {
   const provider = (config.provider || 'openrouter').toLowerCase();
@@ -16,6 +17,8 @@ function createProvider(config) {
       return new OllamaProvider(config);
     case 'groq':
       return new GroqProvider(config);
+    case 'gemini':
+      return new GeminiProvider(config);
     case 'openrouter':
     default:
       return new OpenRouterProvider(config);

package/src/llm/providers/gemini.js

@@ -0,0 +1,94 @@
+'use strict';
+
+const { NoApiKeyError } = require('../../utils/errors');
+
+const GEMINI_BASE = 'https://generativelanguage.googleapis.com/v1beta';
+const DEFAULT_MODEL = 'gemini-2.0-flash';
+
+class GeminiProvider {
+  constructor(config) {
+    this.apiKey = config.geminiApiKey || process.env.GEMINI_API_KEY;
+    if (!this.apiKey) throw new NoApiKeyError('gemini');
+    this.model = config.model || DEFAULT_MODEL;
+    this.name = 'gemini';
+    this.isFreeModel = true;
+  }
+
+  async complete(chunk) {
+    const url = `${GEMINI_BASE}/models/${this.model}:generateContent?key=${this.apiKey}`;
+
+    const body = {
+      contents: [
+        {
+          parts: [
+            { text: chunk.systemPrompt + '\n\n' + chunk.userMessage },
+          ],
+        },
+      ],
+      generationConfig: {
+        temperature: 0.3,
+        maxOutputTokens: 4096,
+      },
+    };
+
+    let response;
+    try {
+      response = await fetch(url, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify(body),
+      });
+    } catch (e) {
+      throw new Error(`Could not connect to Gemini API: ${e.message}`);
+    }
+
+    if (response.status === 429) {
+      const body = await response.text();
+      const { RateLimitError } = require('../../utils/errors');
+      const headerVal = parseInt(response.headers.get('retry-after') || '0');
+      const retryAfter = Math.max(headerVal * 1000, 15000);
+      const err = new RateLimitError('gemini', retryAfter);
+      // Include Gemini's actual error detail so user can see what's wrong
+      try {
+        const parsed = JSON.parse(body);
+        const detail = parsed.error && parsed.error.message ? parsed.error.message : body.substring(0, 200);
+        err.message = `Rate limit exceeded for provider "gemini": ${detail}`;
+      } catch (_) {
+        err.message = `Rate limit exceeded for provider "gemini": ${body.substring(0, 200)}`;
+      }
+      throw err;
+    }
+
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Gemini API error ${response.status}: ${text.substring(0, 500)}`);
+    }
+
+    if (!response.ok) {
+      const text = await response.text();
+      throw new Error(`Gemini API error ${response.status}: ${text}`);
+    }
+
+    const data = await response.json();
+
+    // Extract content from Gemini response format
+    let content = '';
+    if (data.candidates && data.candidates[0] && data.candidates[0].content) {
+      const parts = data.candidates[0].content.parts || [];
+      content = parts.map((p) => p.text || '').join('');
+    }
+
+    // Extract usage metadata
+    const usage = data.usageMetadata || {};
+    const tokensUsed = {
+      input: usage.promptTokenCount || 0,
+      output: usage.candidatesTokenCount || 0,
+    };
+
+    return { content, tokensUsed };
+  }
+
+  estimateCost() { return 0; }
+}
+
+module.exports = { GeminiProvider };

package/src/llm/providers/groq.js

@@ -39,7 +39,9 @@ class GroqProvider {
 
     if (response.status === 429) {
       const { RateLimitError } = require('../../utils/errors');
-      const retryAfter = parseInt(response.headers.get('retry-after') || '5') * 1000;
+      const headerVal = parseInt(response.headers.get('retry-after') || '0');
+      // Minimum 15s wait — Groq free tier needs breathing room
+      const retryAfter = Math.max(headerVal * 1000, 15000);
       throw new RateLimitError('groq', retryAfter);
     }
 

package/src/llm/queue.js

@@ -21,7 +21,18 @@ async function createQueue(chunks, provider, config, callbacks = {}) {
     limit(async () => {
       try {
         const result = await pRetry(
-          () => provider.complete(chunk),
+          async () => {
+            try {
+              return await provider.complete(chunk);
+            } catch (err) {
+              // If it's a rate-limit error, wait for the retry-after period
+              // before letting p-retry schedule the next attempt.
+              if (err.code === 'RATE_LIMIT' && err.retryAfter) {
+                await new Promise((r) => setTimeout(r, err.retryAfter));
+              }
+              throw err;
+            }
+          },
           {
             retries: 3,
             minTimeout: config.isFreeModel ? 8000 : 1000,

package/src/utils/config.js

@@ -26,7 +26,7 @@ function loadConfig(cliFlags = {}) {
   try {
     const result = explorer.search();
     if (result && result.config) {
-      fileConfig = result.config;
+      fileConfig = { ...result.config }; // shallow copy — never mutate the cached object
     }
   } catch (e) {
     // no config file found — use defaults
@@ -50,6 +50,14 @@ function loadConfig(cliFlags = {}) {
     Object.entries(cliFlags).filter(([, v]) => v !== undefined)
   );
 
+  // If CLI specifies a different provider than what's in the config file,
+  // discard the file's model — it belongs to the old provider.
+  const effectiveProvider = cleanCli.provider || fileConfig.provider || defaults.provider;
+  const fileConfigProvider = fileConfig.provider || defaults.provider;
+  if (effectiveProvider !== fileConfigProvider && !cleanCli.model) {
+    delete fileConfig.model;
+  }
+
   return { ...defaults, ...fileConfig, ...cleanCli };
 }