legacyver 2.1.1 → 2.1.3

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,5 @@
 # Summary
 
-* [Index](index.md)
+* [errors.js](errors.md)
+* [config.js](config.md)
+* [logger.js](logger.md)

package/legacyver-docs/components.md

@@ -0,0 +1,55 @@
+## 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.
+
+## Functions
+### Button
+The `Button` component is a React functional component that takes in several props and returns a `button` element.
+#### 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) |
+#### Return Value
+The `Button` component returns a `button` element with the specified props.
+
+### UserCard
+The `UserCard` component is a React functional component that takes in several props and returns a user card.
+#### Parameters
+| Name | Type | Description |
+| --- | --- | --- |
+| userId | number | The ID of the user |
+| onClose | () => void | The function to be 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.
+
+### formatCurrency
+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') |
+#### Return Value
+The `formatCurrency` function returns a string representing the formatted currency.
+
+## Dependencies
+* React
+* Intl.NumberFormat (for currency formatting)
+
+## Usage Example
+No clear usage pattern is visible in the provided code. However, the components and function can be used as follows:
+```tsx
+import { Button, UserCard, formatCurrency } from './components';
+
+const Example = () => {
+  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>
+    </div>
+  );
+};
+```

package/legacyver-docs/config.md

@@ -0,0 +1,30 @@
+## Overview
+This is a JavaScript module that exports a single function `loadConfig`, which loads configuration from a file and merges with CLI flags.
+
+## Functions
+### `loadConfig`
+
+#### Description:
+Load configuration from file and merge with CLI flags.
+CLI flags always win over file config.
+
+#### Params Table:
+
+| Name | Type |
+| --- | --- |
+| `cliFlags` | Object |
+
+#### Return Value:
+Object
+
+```javascript
+function loadConfig(cliFlags = {}) {
+  // ...
+}
+```
+
+## Dependencies
+* `cosmiconfig: cosmiconfigSync`
+
+## Usage Example
+No clear pattern is visible in the code to demonstrate usage.

package/legacyver-docs/errors.md

@@ -0,0 +1,74 @@
+## Overview
+This file exports five custom error classes for use in a Legacyver application.
+
+## Functions
+
+### `LegacyverError`
+#### Description
+A base class for all custom errors in Legacyver.
+#### Parameters
+| Name | Type | Default Value |
+| --- | --- | --- |
+| message | string |  |
+| code | string | 'LEGACYVER_ERROR' |
+
+#### Return Value
+None.
+
+### `NoApiKeyError`
+#### Description
+Raised when no API key is found for a provider.
+#### Parameters
+| Name | Type | Required | Default Value |
+| --- | --- | --- | --- |
+| provider | string |  |  |
+
+#### Return Value
+None.
+
+#### Detected Patterns:
+- The error message includes a suggestion to set the `OPENROUTER_API_KEY` environment variable or run `legacyver init`.
+- The error message includes a link to obtain an API key at https://openrouter.ai/keys.
+
+### `RateLimitError`
+#### Description
+Raised when the rate limit is exceeded for a provider.
+#### Parameters
+| Name | Type | Required | Default Value |
+| --- | --- | --- | --- |
+| provider | string |  |  |
+| retryAfter | number |  | 1000 |
+
+#### Return Value
+None.
+
+#### Detected Patterns:
+- The error message includes a suggestion to retry.
+- The error message indicates the amount of time that must pass before retrying (1000ms by default).
+
+### `ParseError`
+#### Description
+Raised when there is an issue parsing a file.
+#### Parameters
+| Name | Type | Required | Default Value |
+| --- | --- | --- | --- |
+| filePath | string |  |  |
+| originalError | Error |  |  |
+
+#### Return Value
+None.
+
+### `RenderError`
+#### Description
+Raised when there is an issue rendering a format.
+#### Parameters
+| Name | Type | Required | Default Value |
+| --- | --- | --- | --- |
+| format | string |  |  |
+| originalError | Error |  |  |
+
+#### Return Value
+None.
+
+## Dependencies
+* `Error`

package/legacyver-docs/index.md

@@ -1,213 +1,17 @@
-# legacyver
+# utils — Documentation
 
-> Auto-generated documentation by Legacyver
+**Primary language:** javascript  
+**Total files:** 3  
+**Analyzed at:** 2026-02-21T08:58:31.525Z  
 
-## 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)
+- [errors.js](errors.md)
+- [config.js](config.md)
+- [logger.js](logger.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/legacyver-docs/logger.md

@@ -0,0 +1,83 @@
+## Overview
+This module provides a logging system with configurable log levels and colorful output.
+
+## Functions
+
+### `setLevel(level)`
+#### Params | Description
+----------|-------------
+`level`    | The desired log level
+
+#### Returns
+None
+
+Sets the current log level to the specified `level`.
+
+### `setCI(val)`
+#### Params | Description
+----------|-------------
+`val`      | A boolean indicating whether CI mode is enabled
+
+#### Returns
+None
+
+Toggles the CI mode on or off.
+
+### `shouldLog(level)`
+#### Params | Description
+----------|-------------
+`level`    | The log level to check for
+
+#### Returns
+Boolean
+Determines whether the current log level allows logging at the specified `level`.
+
+### `debug(...args)`
+#### Params | Description
+----------|-------------
+`...args`  | Variable number of arguments to be logged as debug output
+
+#### Returns
+None
+Logs the provided `args` to the console with a gray '[debug]' prefix if the current log level allows it.
+
+### `info(...args)`
+#### Params | Description
+----------|-------------
+`...args`  | Variable number of arguments to be logged as info output
+
+#### Returns
+None
+Logs the provided `args` to the console with a cyan '[info]' prefix if the current log level allows it.
+
+### `warn(...args)`
+#### Params | Description
+----------|-------------
+`...args`  | Variable number of arguments to be logged as warn output
+
+#### Returns
+None
+Logs the provided `args` to the console with a yellow '[warn]' prefix if the current log level allows it.
+
+### `error(...args)`
+#### Params | Description
+----------|-------------
+`...args`  | Variable number of arguments to be logged as error output
+
+#### Returns
+None
+Logs the provided `args` to the console with a red '[error]' prefix if the current log level allows it.
+
+## Dependencies
+* picocolors (`pc`)
+
+## Usage Example
+```javascript
+const logger = require('./logger');
+
+logger.debug('This is a debug message');
+logger.info('This is an info message');
+logger.warn('This is a warn message');
+logger.error('This is an error message');
+```
+Note: This example demonstrates the usage of the `debug`, `info`, `warn`, and `error` functions, which are exported from the logger module.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "legacyver",
-  "version": "2.1.1",
+  "version": "2.1.3",
   "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/prompts.js

@@ -1,34 +1,98 @@
 'use strict';
 
-const SYSTEM_PROMPT = `You are a technical documentation writer. You will be given:
-  1. Extracted structural facts about a source file (JSON)
-  2. The raw source code of that file
-
-Your job is to write clear, accurate Markdown documentation based ONLY on what is present in the code.
+const SYSTEM_PROMPT = `You are a technical documentation writer. Given a file's structure and source code, write accurate Markdown documentation based ONLY on what is present.
 
 Rules:
-- Do NOT infer behavior not explicitly shown in the code
-- Do NOT mention external systems unless they appear in imports
-- Do NOT fabricate function descriptions
-- If a function's purpose is unclear from its body, say so honestly
-- Do not mention any function, class, parameter, or behavior that does not appear in the FileFacts JSON or bodySnippet above
-- For each function with complexityClass "moderate" or "complex", explain the logic described in the bodySnippet in plain language
-- For each function with detectedPatterns[] non-empty, explicitly describe what that pattern does in context
-
-Temperature: use 0.1 — factual output only.
+- Do NOT infer behavior not shown in the code
+- Do NOT fabricate descriptions
+- For complex functions, explain the logic from the bodySnippet
+- For functions with detectedPatterns, describe what each pattern does
 
-Output format (strict Markdown):
+Output format:
 ## Overview
-[1-2 sentences about what this file does]
+[1-2 sentences]
 
 ## Functions
-[One ### subsection per exported function with: description, params table, return value]
+[### per function: description, params table, return value]
 
 ## Dependencies
-[Bullet list of imports with one-line description of each]
+[Bullet list of imports]
 
 ## Usage Example
-[Only include if a clear usage pattern is visible in the code itself]`;
+[Only if a clear pattern is visible in the code]`;
+
+/**
+ * Strip null/undefined values and empty arrays from an object (shallow).
+ */
+function stripEmpty(obj) {
+  const result = {};
+  for (const [k, v] of Object.entries(obj)) {
+    if (v === null || v === undefined) continue;
+    if (Array.isArray(v) && v.length === 0) continue;
+    result[k] = v;
+  }
+  return result;
+}
+
+/**
+ * Build a slim version of FileFacts for the prompt — remove noise, keep signal.
+ */
+function slimFacts(fileFacts) {
+  const slim = {
+    file: fileFacts.relativePath,
+    lang: fileFacts.language,
+    lines: fileFacts.linesOfCode,
+  };
+
+  // Functions — only include useful fields
+  if (fileFacts.functions && fileFacts.functions.length > 0) {
+    slim.functions = fileFacts.functions.map(fn => {
+      const entry = { name: fn.name };
+      if (fn.params && fn.params.length > 0) {
+        entry.params = fn.params.map(p => p.type ? `${p.name}:${p.type}` : p.name);
+      }
+      if (fn.returnType) entry.returns = fn.returnType;
+      if (fn.isExported) entry.exported = true;
+      if (fn.isAsync) entry.async = true;
+      if (fn.complexityClass && fn.complexityClass !== 'simple') {
+        entry.complexity = fn.complexityClass;
+      }
+      if (fn.detectedPatterns && fn.detectedPatterns.length > 0) {
+        entry.patterns = fn.detectedPatterns;
+      }
+      if (fn.bodySnippet) entry.body = fn.bodySnippet;
+      if (fn.calls && fn.calls.length > 0) entry.calls = fn.calls;
+      return entry;
+    });
+  }
+
+  // Classes
+  if (fileFacts.classes && fileFacts.classes.length > 0) {
+    slim.classes = fileFacts.classes.map(c => {
+      const entry = { name: c.name };
+      if (c.superClass) entry.extends = c.superClass;
+      if (c.methods && c.methods.length > 0) entry.methods = c.methods.map(m => m.name || m);
+      return entry;
+    });
+  }
+
+  // Imports — compact
+  if (fileFacts.imports && fileFacts.imports.length > 0) {
+    slim.imports = fileFacts.imports.map(i => {
+      if (i.specifiers && i.specifiers.length > 0) {
+        return `${i.module}: ${i.specifiers.join(', ')}`;
+      }
+      return i.module;
+    });
+  }
+
+  // Exports
+  if (fileFacts.exports && fileFacts.exports.length > 0) {
+    slim.exports = fileFacts.exports;
+  }
+
+  return slim;
+}
 
 /**
  * Build the user message for a single file.
@@ -37,28 +101,22 @@ Output format (strict Markdown):
  * @returns {string}
  */
 function buildUserMessage(fileFacts, rawSource) {
-  // Include bodySnippets inline in the facts JSON for moderate/complex functions
-  const factsForPrompt = {
-    ...fileFacts,
-    functions: (fileFacts.functions || []).map(fn => {
-      const entry = { ...fn };
-      if (fn.complexityClass === 'moderate' || fn.complexityClass === 'complex') {
-        entry._promptHint = `Explain this function's logic in plain language based on its bodySnippet.`;
-      }
-      if (fn.detectedPatterns && fn.detectedPatterns.length > 0) {
-        entry._patternHint = `This function uses patterns: ${fn.detectedPatterns.join(', ')}. Describe what each does in context.`;
-      }
-      return entry;
-    }),
-  };
+  const slim = slimFacts(fileFacts);
+
+  // Truncate source to ~150 lines to keep prompt small
+  const lines = rawSource.split('\n');
+  let source = rawSource;
+  if (lines.length > 150) {
+    source = lines.slice(0, 150).join('\n') + '\n// ... truncated';
+  }
 
-  return `FILE FACTS (extracted by static analysis):
-${JSON.stringify(factsForPrompt, null, 2)}
+  return `STRUCTURE:
+${JSON.stringify(slim)}
 
-SOURCE CODE:
-${rawSource}
+CODE:
+${source}
 
-Generate documentation for this file following the system instructions.`;
+Generate documentation following the system instructions.`;
 }
 
 module.exports = { SYSTEM_PROMPT, buildUserMessage };

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 = process.env.GEMINI_API_KEY || config.geminiApiKey;
+    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

@@ -7,7 +7,7 @@ const DEFAULT_MODEL = 'llama-3.3-70b-versatile';
 
 class GroqProvider {
   constructor(config) {
-    this.apiKey = config.groqApiKey || process.env.GROQ_API_KEY;
+    this.apiKey = process.env.GROQ_API_KEY || config.groqApiKey;
     if (!this.apiKey) throw new NoApiKeyError('groq');
     this.model = config.model || DEFAULT_MODEL;
     this.name = 'groq';
@@ -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/providers/openrouter.js

@@ -7,7 +7,7 @@ const DEFAULT_MODEL = 'meta-llama/llama-3.3-70b-instruct:free';
 
 class OpenRouterProvider {
   constructor(config) {
-    this.apiKey = config.apiKey || process.env.OPENROUTER_API_KEY;
+    this.apiKey = process.env.OPENROUTER_API_KEY || config.apiKey;
     if (!this.apiKey) {
       throw new NoApiKeyError('openrouter');
     }

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 };
 }