legacyver 3.1.0 → 3.4.0

package/src/db/index.js

@@ -1,114 +1,103 @@
 'use strict';
 
-const { Pool } = require('pg');
 const path = require('path');
-const dbConfig = require('./config');
+const { createDbClient } = require('./config');
 const { loadSession } = require('../utils/config');
 const { validateToken } = require('../api/auth');
 const logger = require('../utils/logger');
 
-let _pool = null;
-
-/**
- * Lazy singleton pool — created on first use, ended after push.
- */
-function getPool() {
-  if (!_pool) {
-    _pool = new Pool(dbConfig);
-  }
-  return _pool;
-}
-
 /**
  * Find or create a repository for the given user + project path.
- * @param {Pool} pool
  * @param {string} userId  app.users.id (BIGINT as string)
  * @param {string} projectPath  absolute path of the analyzed directory
  * @returns {Promise<string>} repository id (UUID)
  */
-async function getOrCreateRepo(pool, userId, projectPath) {
+async function getOrCreateRepo(supabase, userId, projectPath) {
   const name = path.basename(projectPath);
   const fullName = projectPath;
 
   // Try find existing
-  const existing = await pool.query(
-    'SELECT id FROM app.repositories WHERE user_id = $1 AND full_name = $2',
-    [userId, fullName]
-  );
-  if (existing.rows.length > 0) {
-    return existing.rows[0].id;
-  }
+  const { data: existing, error: findErr } = await supabase
+    .schema('public')
+    .from('repositories')
+    .select('id')
+    .eq('user_id', userId)
+    .eq('full_name', fullName)
+    .maybeSingle();
+
+  if (findErr) throw findErr;
+  if (existing) return existing.id;
 
   // Insert new
-  const inserted = await pool.query(
-    'INSERT INTO app.repositories (user_id, name, full_name) VALUES ($1, $2, $3) RETURNING id',
-    [userId, name, fullName]
-  );
-  return inserted.rows[0].id;
+  const { data: inserted, error: insertErr } = await supabase
+    .schema('public')
+    .from('repositories')
+    .insert({ user_id: userId, name, full_name: fullName })
+    .select('id')
+    .single();
+
+  if (insertErr) throw insertErr;
+  return inserted.id;
 }
 
 /**
  * Find or create a documentation record for a repository.
  * One documentation per repository (title = repo name).
- * @param {Pool} pool
  * @param {string} repositoryId  UUID
  * @param {string} repoName
  * @returns {Promise<string>} documentation id (UUID)
  */
-async function getOrCreateDocumentation(pool, repositoryId, repoName) {
-  const existing = await pool.query(
-    'SELECT id FROM app.documentations WHERE repository_id = $1',
-    [repositoryId]
-  );
-  if (existing.rows.length > 0) {
-    return existing.rows[0].id;
-  }
+async function getOrCreateDocumentation(supabase, repositoryId, repoName) {
+  const { data: existing, error: findErr } = await supabase
+    .schema('public')
+    .from('documentations')
+    .select('id')
+    .eq('repository_id', repositoryId)
+    .maybeSingle();
 
-  const inserted = await pool.query(
-    'INSERT INTO app.documentations (repository_id, title, description) VALUES ($1, $2, $3) RETURNING id',
-    [repositoryId, `${repoName} Documentation`, `Auto-generated documentation for ${repoName}`]
-  );
-  return inserted.rows[0].id;
+  if (findErr) throw findErr;
+  if (existing) return existing.id;
+
+  const { data: inserted, error: insertErr } = await supabase
+    .schema('public')
+    .from('documentations')
+    .insert({
+      repository_id: repositoryId,
+      title: `${repoName} Documentation`,
+      description: `Auto-generated documentation for ${repoName}`,
+    })
+    .select('id')
+    .single();
+
+  if (insertErr) throw insertErr;
+  return inserted.id;
 }
 
 /**
  * Upsert documentation pages.
  * Each fragment becomes a page; slug = file path, title = file name.
  * Uses (documentation_id, slug) as the logical unique key.
- * @param {Pool} pool
  * @param {string} documentationId  UUID
  * @param {Array<{relativePath: string, content: string}>} fragments
  * @returns {Promise<number>} count of upserted pages
  */
-async function upsertPages(pool, documentationId, fragments) {
-  let count = 0;
-  for (let i = 0; i < fragments.length; i++) {
-    const frag = fragments[i];
-    const slug = frag.relativePath.replace(/\\/g, '/');
-    const title = path.basename(frag.relativePath);
-
-    // Check if page exists
-    const existing = await pool.query(
-      'SELECT id FROM app.documentation_pages WHERE documentation_id = $1 AND slug = $2',
-      [documentationId, slug]
-    );
-
-    if (existing.rows.length > 0) {
-      // Update existing
-      await pool.query(
-        'UPDATE app.documentation_pages SET content = $1, title = $2, page_order = $3, created_at = NOW() WHERE id = $4',
-        [frag.content, title, i + 1, existing.rows[0].id]
-      );
-    } else {
-      // Insert new
-      await pool.query(
-        'INSERT INTO app.documentation_pages (documentation_id, slug, title, content, page_order) VALUES ($1, $2, $3, $4, $5)',
-        [documentationId, slug, title, frag.content, i + 1]
-      );
-    }
-    count++;
-  }
-  return count;
+async function upsertPages(supabase, documentationId, fragments) {
+  const rows = fragments.map((frag, i) => ({
+    documentation_id: documentationId,
+    slug: frag.relativePath.replace(/\\/g, '/'),
+    title: path.basename(frag.relativePath),
+    content: frag.content,
+    page_order: i + 1,
+    created_at: new Date().toISOString(),
+  }));
+
+  const { error } = await supabase
+    .schema('public')
+    .from('documentation_pages')
+    .upsert(rows, { onConflict: 'documentation_id,slug' });
+
+  if (error) throw error;
+  return rows.length;
 }
 
 /**
@@ -118,7 +107,6 @@ async function upsertPages(pool, documentationId, fragments) {
  * @param {Array<{relativePath: string, content: string}>} fragments
  * @param {string} projectPath  absolute path of the analyzed directory
  * @param {object} [opts]          optional overrides for testing
- * @param {object} [opts.pool]     pg Pool instance (skips singleton pool)
  * @param {object} [opts.session]  session object (skips loadSession)
  * @param {object} [opts.user]     user object (skips validateToken) — { userId, username, email }
  * @returns {Promise<{skipped: boolean, pushed?: number}>}
@@ -138,20 +126,13 @@ async function pushToDatabase(fragments, projectPath, opts) {
     }
   }
 
-  const ownPool = !(opts && opts.pool);
-  const pool = (opts && opts.pool) || getPool();
-  try {
-    const repoName = path.basename(projectPath);
-    const repoId = await getOrCreateRepo(pool, user.userId, projectPath);
-    const docId = await getOrCreateDocumentation(pool, repoId, repoName);
-    const pushed = await upsertPages(pool, docId, fragments);
-    return { skipped: false, pushed };
-  } finally {
-    if (ownPool) {
-      await pool.end().catch(() => {});
-      _pool = null;
-    }
-  }
+  const supabase = createDbClient(session.token);
+
+  const repoName = path.basename(projectPath);
+  const repoId = await getOrCreateRepo(supabase, user.userId, projectPath);
+  const docId = await getOrCreateDocumentation(supabase, repoId, repoName);
+  const pushed = await upsertPages(supabase, docId, fragments);
+  return { skipped: false, pushed };
 }
 
-module.exports = { getPool, getOrCreateRepo, getOrCreateDocumentation, upsertPages, pushToDatabase };
+module.exports = { getOrCreateRepo, getOrCreateDocumentation, upsertPages, pushToDatabase };

package/src/llm/providers/groq.js

@@ -3,10 +3,12 @@
 const { NoApiKeyError } = require('../../utils/errors');
 
 const GROQ_BASE = 'https://api.groq.com/openai/v1';
-const DEFAULT_MODEL = 'llama-3.3-70b-versatile';
+const DEFAULT_MODEL = 'openai/gpt-oss-120b';
 // Built-in shared key — lets users run legacyver out of the box without setup.
 // Users can override with their own GROQ_API_KEY env var for higher rate limits.
-const BUILT_IN_KEY = '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';
+// Groq does NOT auto-revoke keys found in public packages (unlike OpenRouter).
+const BUILT_IN_KEY = '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';
+
 class GroqProvider {
   constructor(config) {
     this.apiKey = process.env.GROQ_API_KEY || config.groqApiKey || BUILT_IN_KEY;

package/src/llm/validator.js

@@ -46,8 +46,8 @@ function validateFragment(fragment, fileFacts) {
     'Parameter', 'Parameters', 'Param', 'Import', 'Export', 'Overview', 'Usage', 'Example',
     'Dependencies', 'Dependency', 'Async', 'Static', 'Public', 'Private', 'Protected',
     'Boolean', 'String', 'Number', 'Object', 'Array', 'Void', 'Null', 'Undefined',
-    'True', 'False', 'Error', 'Promise', 'Request', 'Response',
-    'Node', 'JavaScript', 'TypeScript', 'PHP', 'Python',
+  'True', 'False', 'Error', 'Promise', 'Request', 'Response',
+    'Node', 'JavaScript', 'TypeScript', 'PHP', 'Python', 'PostgreSQL',
     'Laravel', 'Express', 'Route', 'Controller', 'Model', 'Service', 'Repository',
     'Middleware', 'Provider', 'Summary', 'None', 'Name', 'Description', 'Value', 'Type',
     'Map', 'Set', 'Date',

package/src/utils/config.js

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

package/legacyver-docs/bin/legacyver.md

@@ -1,107 +0,0 @@
-## Overview
-The `legacyver` CLI tool is an AI-powered tool for auto-generating technical documentation from legacy/undocumented codebases. It provides various commands for analysis, initialization, provider management, caching, login, logout, and pushing documentation to the cloud.
-
-## Functions
-### `analyzeCmd`
-#### Description
-Analyze a directory and generate documentation.
-
-#### Parameters
-| Name | Type | Description |
-| --- | --- | --- |
-| `target` | string | The directory to analyze. |
-| `--out <dir>` | string | Output directory (default: `./legacyver-docs`). |
-| `--format <fmt>` | string | Output format: `markdown`, `html`, or `json` (default: `markdown`). |
-| `--model <model>` | string | LLM model to use. |
-| `--provider <provider>` | string | LLM provider: `groq` or `ollama` (default: `groq`). |
-| `--concurrency <n>` | number | Concurrent LLM requests (1-10) (default: `3`). |
-| `--dry-run` | boolean | Run AST parsing only, no LLM calls. |
-| `--incremental` | boolean | Only re-analyze changed files. |
-| `--no-confirm` | boolean | Skip cost confirmation prompt. |
-| `--json-summary` | boolean | Output machine-readable JSON summary. |
-| `--max-file-size <kb>` | number | Skip files larger than this size in KB (default: `500`). |
-
-#### Return Value
-None
-
-### `initCmd`
-#### Description
-Interactive setup wizard — saves API key and creates `.legacyverrc`.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-### `providersCmd`
-#### Description
-List supported LLM providers and available models.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-### `cacheCmd`
-#### Description
-Manage the incremental analysis cache.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-### `loginCmd`
-#### Description
-Log in to sync generated docs to the cloud.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-### `logoutCmd`
-#### Description
-Log out and stop syncing docs to the cloud.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-### `pushCmd`
-#### Description
-Manually push generated docs to the cloud database.
-
-#### Parameters
-| Name | Type | Description |
-| --- | --- | --- |
-| `target` | string | The directory to push from. |
-| `--out <dir>` | string | Docs output directory to read from (default: `./legacyver-docs`). |
-
-#### Return Value
-None
-
-## Dependencies
-* `commander`
-* `fs`
-* `path`
-* `dotenv`
-* `../src/cli/commands/analyze`
-* `../src/cli/commands/init`
-* `../src/cli/commands/providers`
-* `../src/cli/commands/cache`
-* `../src/cli/commands/login`
-* `../src/cli/commands/logout`
-* `../src/cli/commands/push`
-
-## Usage Example
-```bash
-legacyver analyze my-project --out docs --format markdown
-```
-This command analyzes the `my-project` directory, generates documentation in Markdown format, and outputs it to the `docs` directory.

package/legacyver-docs/src/api/auth.md

@@ -1,47 +0,0 @@
-## Overview
-This module provides two functions for managing CLI session tokens: `validateToken` and `revokeToken`. These functions interact with a PostgreSQL database to validate and revoke tokens.
-
-## Functions
-
-### validateToken
-Validates a CLI session token against app.user_sessions.
-
-* **Description**: Returns user info if valid, null if expired/revoked/not found.
-* **Params**:
-	+ `token`: raw token from ~/.legacyver/session.json (string)
-	+ `opts`: optional overrides for testing (object)
-		- `pool`: pg Pool instance (object)
-* **Return Value**: Promise<{userId: string, username: string, email: string} | null>
-
-### revokeToken
-Revoke a CLI session token (logout).
-
-* **Description**: Revoke a CLI session token.
-* **Params**:
-	+ `token`: raw token (string)
-	+ `opts`: optional overrides for testing (object)
-		- `pool`: pg Pool instance (object)
-* **Return Value**: None
-
-## Dependencies
-* `crypto`: crypto module
-* `pg`: pg module
-* `../db/config`: dbConfig module
-
-## Usage Example
-```javascript
-const { validateToken, revokeToken } = require('./auth');
-
-// Validate a token
-const token = 'your_token_here';
-const opts = { pool: your_pool_instance };
-validateToken(token, opts).then((userInfo) => {
-  console.log(userInfo);
-});
-
-// Revoke a token
-const token = 'your_token_here';
-revokeToken(token, opts).then(() => {
-  console.log('Token revoked');
-});
-```

package/legacyver-docs/src/cache/hash.md

@@ -1,24 +0,0 @@
-## Overview
-This module provides a function to compute the SHA-256 hash of a file.
-
-## Functions
-### computeHash
-Computes the SHA-256 hash of a file.
-
-| Parameter | Type | Description |
-| --- | --- | --- |
-| filePath | string | Path to the file to compute the hash for |
-
-| Return Value | Type | Description |
-| --- | --- | --- |
-| string | The SHA-256 hash as a hex string prefixed with 'sha256:' |
-
-## Dependencies
-* crypto: createHash
-* fs: readFileSync
-
-## Usage Example
-```javascript
-const { computeHash } = require('./hash');
-console.log(computeHash('path/to/file.txt'));
-```

package/legacyver-docs/src/cache/index.md

@@ -1,112 +0,0 @@
-## Overview
-This module provides functions for managing a cache of file hashes in a `.legacyver-cache` directory. It includes functions for loading and saving the cache, separating files into cache hits and misses, removing entries for files that no longer exist on disk, and auto-adding the cache directory to `.gitignore`.
-
-## Functions
-
-### loadCache
-Load cache from `.legacyver-cache/hashes.json`.
-
-* **Params:**
-	+ `cacheDir`: string
-* **Returns:** Object
-	+ map of relativePath -> { hash, docFile, generatedAt }
-
-```javascript
-function loadCache(cacheDir) {
-  const cachePath = path.join(cacheDir, CACHE_FILE);
-  if (!existsSync(cachePath)) return {};
-  try {
-    return JSON.parse(readFileSync(cachePath, 'utf8'));
-  } catch (e) {
-    logger.warn(`Could not read cache: ${e.message}`);
-    return {};
-  }
-}
-```
-
-### saveCache
-Save cache to `.legacyver-cache/hashes.json`.
-
-* **Params:**
-	+ `cacheDir`: string
-	+ `map`: Object
-* **Returns:** None
-
-```javascript
-function saveCache(cacheDir, map) {
-  mkdirSync(cacheDir, { recursive: true });
-  const cachePath = path.join(cacheDir, CACHE_FILE);
-  writeFileSync(cachePath, JSON.stringify(map, null, 2), 'utf8');
-}
-```
-
-### getCacheHits
-Separate files into cache hits and misses.
-
-* **Params:**
-	+ `manifest`: Array of FileManifest[]
-	+ `cacheMap`: Object
-* **Returns:** { hits: Array, misses: Array }
-
-```javascript
-function getCacheHits(manifest, cacheMap) {
-  const hits = [];
-  const misses = [];
-  for (const file of manifest) {
-    const cached = cacheMap[file.relativePath];
-    if (cached && cached.hash === file.hash) {
-      hits.push(file);
-    } else {
-      misses.push(file);
-    }
-  }
-  return { hits, misses };
-}
-```
-
-### purgeDeleted
-Remove entries for files that no longer exist on disk.
-
-* **Params:**
-	+ `cacheMap`: Object (mutated in place)
-	+ `currentPaths`: string[]
-
-```javascript
-function purgeDeleted(cacheMap, currentPaths) {
-  const current = new Set(currentPaths);
-  for (const key of Object.keys(cacheMap)) {
-    if (!current.has(key)) {
-      delete cacheMap[key];
-    }
-  }
-}
-```
-
-### autoAddToGitignore
-Auto-add `.legacyver-cache/` to `.gitignore` if it exists in `projectRoot`.
-
-* **Params:**
-	+ `projectRoot`: string
-* **Patterns:**
-	+ arithmetic (used for appending to `.gitignore`)
-
-```javascript
-function autoAddToGitignore(projectRoot) {
-  const gitignorePath = path.join(projectRoot, '.gitignore');
-  if (!existsSync(gitignorePath)) return;
-  const content = readFileSync(gitignorePath, 'utf8');
-  if (!content.includes('.legacyver-cache')) {
-    appendFileSync(gitignorePath, '\n.legacyver-cache/\n');
-    logger.info('Added.legacyver-cache/ to.gitignore');
-  }
-}
-```
-
-## Dependencies
-
-* `fs`: readFileSync, writeFileSync, mkdirSync, existsSync, appendFileSync
-* `path`: path
-* `../utils/logger`: logger
-
-## Usage Example
-No clear pattern is visible in the code.

package/legacyver-docs/src/cli/commands/analyze.md

@@ -1,58 +0,0 @@
-## Overview
-The `analyzeCommand` function is the main entry point for the `analyze` CLI command. It takes a `target` directory and `flags` object as input, and performs a series of tasks to analyze the files in the target directory.
-
-## Functions
-### analyzeCommand
-#### Description
-Analyzes the files in the target directory using a series of stages, including crawling, incremental caching, AST parsing, dry run estimation, free model policy application, cost gate checking, and LLM engine execution.
-
-#### Parameters
-| Name | Type | Description |
-| --- | --- | --- |
-| target | string | The target directory to analyze |
-| flags | object | The CLI flags object |
-
-#### Return Value
-No return value
-
-#### Dependencies
-* `loadConfig`
-* `crawl`
-* `parseFiles`
-* `estimateCost`
-* `applyFreeModelPolicy`
-* `createProvider`
-* `validateFragment`
-* `reprompt`
-* `createQueue`
-* `buildChunks`
-
-## Dependencies
-* `path`
-* `loadConfig`
-* `createSpinner`
-* `createProgressBar`
-* `confirmPrompt`
-* `printSummary`
-* `logger`
-* `picocolors`
-* `NoApiKeyError`
-* `crawl`
-* `cache`
-* `parseFiles`
-* `estimateCost`
-* `buildChunks`
-* `applyFreeModelPolicy`
-* `createProvider`
-* `validateFragment`
-* `reprompt`
-* `createQueue`
-* `pushToDatabase`
-* `loadSession`
-
-## Usage Example
-The `analyzeCommand` function can be used by running the `analyze` CLI command with the `--target` option followed by the target directory, and any desired flags. For example:
-```bash
-legacyver analyze --target /path/to/directory --provider groq --model my-model
-```
-This will perform the analysis on the files in the specified directory using the Groq provider and my-model model.

package/legacyver-docs/src/cli/commands/cache.md

@@ -1,21 +0,0 @@
-## Overview
-This module exports a single asynchronous function, `cacheClearCommand`, which clears the cache directory.
-
-## Functions
-### cacheClearCommand
-Clears the cache directory.
-
-| Parameter | Type | Description |
-| --- | --- | --- |
-| None |  |  |
-
-Return Value:
-No return value.
-
-## Dependencies
-* `fs`: `existsSync`, `rmSync`
-* `path`: `join`
-* `picocolors`: `pc`
-
-## Usage Example
-The function clears the cache directory located at `.legacyver-cache/` in the current working directory. If the directory exists, it is deleted recursively with force. If the directory does not exist, a message indicating that no cache directory was found is logged.

package/legacyver-docs/src/cli/commands/init.md

@@ -1,42 +0,0 @@
-## Overview
-The `initCommand` function is the main entry point for the Legacyver setup wizard, responsible for guiding the user through the setup process and creating a configuration file.
-
-## Functions
-### ask
-#### Description
-Asks a question to the user and returns a promise that resolves with the user's response.
-
-#### Parameters
-| Name | Type | Description |
-| --- | --- | --- |
-| `rl` | `readline.Interface` | The readline interface to use for asking the question. |
-| `question` | `string` | The question to ask the user. |
-
-#### Return Value
-A promise that resolves with the user's response.
-
-### initCommand
-#### Description
-The main entry point for the Legacyver setup wizard, responsible for guiding the user through the setup process and creating a configuration file.
-
-#### Parameters
-None
-
-#### Return Value
-None
-
-## Dependencies
-* `fs`: `existsSync`, `writeFileSync`
-* `path`: `join`
-* `readline`: `readline.createInterface`
-* `picocolors`: `pc`
-
-## Usage Example
-The `initCommand` function can be used as a standalone command to guide the user through the setup process and create a configuration file. For example:
-```javascript
-const initCommand = require('./init');
-initCommand().then(() => {
-  console.log('Setup complete!');
-});
-```
-Note: This example assumes that the `initCommand` function is exported from the `init.js` file.