legacyver 2.1.0 → 2.1.2

package/package.json

@@ -1,51 +1,49 @@
 {
   "name": "legacyver",
-  "version": "2.1.0",
-  "description": "Generate technical documentation from undocumented or legacy codebases using AST parsing and LLMs",
+  "version": "2.1.2",
+  "description": "AI-powered CLI tool to auto-generate technical documentation from legacy/undocumented codebases",
   "main": "src/index.js",
   "bin": {
     "legacyver": "bin/legacyver.js"
   },
+  "type": "commonjs",
   "engines": {
     "node": ">=18.0.0"
   },
   "scripts": {
     "test": "vitest run",
     "test:watch": "vitest",
-    "lint": "eslint src/ test/"
+    "lint": "eslint src/ bin/"
   },
   "keywords": [
     "documentation",
-    "legacy",
-    "codebase",
+    "cli",
     "ast",
     "llm",
-    "tree-sitter",
-    "cli"
+    "legacy",
+    "code-analysis",
+    "tree-sitter"
   ],
+  "author": "",
   "license": "MIT",
-  "type": "module",
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.75.0",
-    "@google/generative-ai": "^0.24.1",
-    "chalk": "^5.6.2",
+    "chalk": "^4.1.2",
     "cli-progress": "^3.12.0",
-    "commander": "^14.0.3",
-    "conf": "^15.1.0",
+    "commander": "^11.1.0",
+    "conf": "^10.2.0",
     "cosmiconfig": "^9.0.0",
-    "fast-glob": "^3.3.3",
-    "groq-sdk": "^0.37.0",
-    "ignore": "^7.0.5",
-    "marked": "^17.0.3",
-    "openai": "^6.22.0",
-    "ora": "^9.3.0",
-    "p-limit": "^7.3.0",
-    "p-retry": "^7.1.1",
-    "picocolors": "^1.1.1",
-    "web-tree-sitter": "^0.26.5"
+    "fast-glob": "^3.3.2",
+    "ignore": "^5.3.1",
+    "marked": "^11.1.1",
+    "ora": "^5.4.1",
+    "p-limit": "^3.1.0",
+    "p-retry": "^4.6.2",
+    "picocolors": "^1.0.0",
+    "tiktoken": "^1.0.15",
+    "web-tree-sitter": "^0.22.6"
   },
   "devDependencies": {
-    "eslint": "^10.0.0",
-    "vitest": "^4.0.18"
+    "eslint": "^8.57.0",
+    "vitest": "^1.2.2"
   }
 }

package/src/cache/hash.js

@@ -1,17 +1,16 @@
-/**
- * File hash computation for incremental cache.
- * Uses Node.js crypto SHA-256 to produce deterministic file fingerprints.
- */
+'use strict';
 
-import { readFileSync } from 'node:fs';
-import { createHash } from 'node:crypto';
+const { createHash } = require('crypto');
+const { readFileSync } = require('fs');
 
 /**
- * Compute SHA-256 hash of a file's contents.
- * @param {string} filePath - Absolute path to file
- * @returns {string} Hex-encoded SHA-256 hash with "sha256:" prefix
+ * Compute SHA-256 hash of a file.
+ * @param {string} filePath
+ * @returns {string} hex string prefixed with 'sha256:'
  */
-export function computeHash(filePath) {
+function computeHash(filePath) {
   const content = readFileSync(filePath);
   return 'sha256:' + createHash('sha256').update(content).digest('hex');
 }
+
+module.exports = { computeHash };

package/src/cache/index.js

@@ -1,56 +1,47 @@
-/**
- * Incremental cache module.
- * Persists file hashes to .legacyver-cache/hashes.json so that
- * unchanged files can skip LLM re-analysis on subsequent runs.
- */
+'use strict';
 
-import { readFileSync, writeFileSync, mkdirSync, existsSync } from 'node:fs';
-import { join } from 'node:path';
+const { readFileSync, writeFileSync, mkdirSync, existsSync, appendFileSync } = require('fs');
+const path = require('path');
+const logger = require('../utils/logger');
 
 const CACHE_FILE = 'hashes.json';
 
 /**
- * Load the cache map from disk.
- * @param {string} cacheDir - Path to .legacyver-cache directory
- * @returns {Record<string, { hash: string, generatedAt: string }>} Cache map (empty object if no cache)
+ * Load cache from .legacyver-cache/hashes.json.
+ * @param {string} cacheDir
+ * @returns {Object} map of relativePath -> { hash, docFile, generatedAt }
  */
-export function loadCache(cacheDir) {
-  const cachePath = join(cacheDir, CACHE_FILE);
-  if (!existsSync(cachePath)) {
-    return {};
-  }
+function loadCache(cacheDir) {
+  const cachePath = path.join(cacheDir, CACHE_FILE);
+  if (!existsSync(cachePath)) return {};
   try {
-    const raw = readFileSync(cachePath, 'utf-8');
-    return JSON.parse(raw);
-  } catch {
-    // Corrupted cache — start fresh
+    return JSON.parse(readFileSync(cachePath, 'utf8'));
+  } catch (e) {
+    logger.warn(`Could not read cache: ${e.message}`);
     return {};
   }
 }
 
 /**
- * Save the cache map to disk.
- * Creates the cache directory if it doesn't exist.
- * @param {string} cacheDir - Path to .legacyver-cache directory
- * @param {Record<string, { hash: string, generatedAt: string }>} cacheMap - Cache map to persist
+ * Save cache to .legacyver-cache/hashes.json.
+ * @param {string} cacheDir
+ * @param {Object} map
  */
-export function saveCache(cacheDir, cacheMap) {
+function saveCache(cacheDir, map) {
   mkdirSync(cacheDir, { recursive: true });
-  const cachePath = join(cacheDir, CACHE_FILE);
-  writeFileSync(cachePath, JSON.stringify(cacheMap, null, 2), 'utf-8');
+  const cachePath = path.join(cacheDir, CACHE_FILE);
+  writeFileSync(cachePath, JSON.stringify(map, null, 2), 'utf8');
 }
 
 /**
- * Separate manifest entries into cache hits and misses.
- * A hit means the file hash matches the cached hash — no re-analysis needed.
- * @param {import('../crawler/manifest.js').FileManifest[]} manifest - Current file manifest
- * @param {Record<string, { hash: string }>} cacheMap - Loaded cache map
- * @returns {{ hits: import('../crawler/manifest.js').FileManifest[], misses: import('../crawler/manifest.js').FileManifest[] }}
+ * Separate files into cache hits and misses.
+ * @param {Array} manifest  FileManifest[]
+ * @param {Object} cacheMap
+ * @returns {{ hits: Array, misses: Array }}
  */
-export function getCacheHits(manifest, cacheMap) {
+function getCacheHits(manifest, cacheMap) {
   const hits = [];
   const misses = [];
-
   for (const file of manifest) {
     const cached = cacheMap[file.relativePath];
     if (cached && cached.hash === file.hash) {
@@ -59,48 +50,35 @@ export function getCacheHits(manifest, cacheMap) {
       misses.push(file);
     }
   }
-
   return { hits, misses };
 }
 
 /**
- * Remove cache entries for files that no longer exist on disk.
- * @param {Record<string, { hash: string }>} cacheMap - Current cache map
- * @param {string[]} currentPaths - Relative paths of files currently on disk
- * @returns {Record<string, { hash: string }>} Cleaned cache map
+ * Remove entries for files that no longer exist on disk.
+ * @param {Object} cacheMap  mutated in place
+ * @param {string[]} currentPaths  relative paths currently on disk
  */
-export function purgeDeleted(cacheMap, currentPaths) {
-  const pathSet = new Set(currentPaths);
-  const cleaned = {};
-  for (const [key, value] of Object.entries(cacheMap)) {
-    if (pathSet.has(key)) {
-      cleaned[key] = value;
+function purgeDeleted(cacheMap, currentPaths) {
+  const current = new Set(currentPaths);
+  for (const key of Object.keys(cacheMap)) {
+    if (!current.has(key)) {
+      delete cacheMap[key];
     }
   }
-  return cleaned;
 }
 
 /**
- * Auto-add .legacyver-cache/ to .gitignore if .gitignore exists
- * and doesn't already contain the entry.
- * @param {string} projectRoot - Root directory of the project being analyzed
+ * Auto-add .legacyver-cache/ to .gitignore if it exists in projectRoot.
+ * @param {string} projectRoot
  */
-export function addToGitignore(projectRoot) {
-  const gitignorePath = join(projectRoot, '.gitignore');
-  if (!existsSync(gitignorePath)) {
-    return;
+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');
   }
-
-  const content = readFileSync(gitignorePath, 'utf-8');
-  const entry = '.legacyver-cache/';
-
-  // Check if already present (exact line match)
-  const lines = content.split('\n');
-  if (lines.some((line) => line.trim() === entry || line.trim() === '.legacyver-cache')) {
-    return;
-  }
-
-  // Append entry with a newline separator
-  const separator = content.endsWith('\n') ? '' : '\n';
-  writeFileSync(gitignorePath, content + separator + entry + '\n', 'utf-8');
 }
+
+module.exports = { loadCache, saveCache, getCacheHits, purgeDeleted, autoAddToGitignore };