legacyver 2.1.2 → 2.1.3

package/legacyver-docs/SUMMARY.md

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

package/legacyver-docs/components.md

@@ -1,57 +1,55 @@
 ## Overview
-This file contains React components and a utility function for formatting currency amounts.
+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
-
-### 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 |
+The `Button` component is a React functional component that takes in several props and returns a `button` element.
+#### Parameters
+| Name | Type | Description |
 | --- | --- | --- |
-| - | - | No |
+| 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
-N/A
+The `Button` component returns a `button` element with the specified props.
 
 ### UserCard
-#### Description
-A card component representing a user.
-#### Params Table
-| Param | Type | Required |
+The `UserCard` component is a React functional component that takes in several props and returns a user card.
+#### Parameters
+| Name | Type | Description |
 | --- | --- | --- |
-| - | - | Yes |
+| 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
-* `@ui-component/library` (UI components library)
-* `@utils/typography` (Typography utilities)
+* 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,12 +1,14 @@
-# src — Documentation
+# utils — Documentation
 
-**Primary language:** typescript  
-**Total files:** 1  
-**Analyzed at:** 2026-02-21T07:52:12.371Z  
+**Primary language:** javascript  
+**Total files:** 3  
+**Analyzed at:** 2026-02-21T08:58:31.525Z  
 
 ## Files
 
-- [components.tsx](components.md)
+- [errors.js](errors.md)
+- [config.js](config.md)
+- [logger.js](logger.md)
 
 ## Dependency Graph
 

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.2",
+  "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/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

@@ -7,7 +7,7 @@ const DEFAULT_MODEL = 'gemini-2.0-flash';
 
 class GeminiProvider {
   constructor(config) {
-    this.apiKey = config.geminiApiKey || process.env.GEMINI_API_KEY;
+    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';

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

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