@lazykedar/lazydocs 1.3.0

package/dist/o/p.js

@@ -0,0 +1,89 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generatePrDesc = generatePrDesc;
+const fs = __importStar(require("fs"));
+const simple_git_1 = __importDefault(require("simple-git"));
+const ai_1 = require("../ai");
+async function generatePrDesc(inputDir, outputFile, apiKey, aiOptions, gitOptions) {
+    console.log('Analyzing git changes...');
+    const git = (0, simple_git_1.default)(inputDir);
+    try {
+        const diffArgs = [];
+        if (gitOptions?.base) {
+            if (gitOptions.head) {
+                diffArgs.push(`${gitOptions.base}...${gitOptions.head}`);
+            }
+            else {
+                diffArgs.push(gitOptions.base);
+            }
+            console.log(`  Comparing: ${diffArgs[0]}`);
+        }
+        // Get diff summary with compact format
+        const diff = await git.diffSummary(diffArgs);
+        const diffText = await git.diff(diffArgs);
+        const fileChanges = diff.files.map((f) => {
+            const ins = 'insertions' in f ? f.insertions : 0;
+            const del = 'deletions' in f ? f.deletions : 0;
+            return `- ${f.file} (+${ins}/-${del})`;
+        }).join('\n');
+        // Build compact summary for token efficiency
+        const compactSummary = `Files changed: ${diff.files.length}
+Insertions: ${diff.insertions}
+Deletions: ${diff.deletions}
+
+Changed files:
+${fileChanges}`;
+        // Limit diff size for token efficiency
+        const diffPreview = diffText.length > 5000
+            ? diffText.slice(0, 5000) + '\n\n... (diff truncated for brevity)'
+            : diffText;
+        const snippet = `${compactSummary}\n\nDiff preview:\n${diffPreview}`;
+        console.log(`  ${diff.files.length} files changed (${diff.insertions} insertions, ${diff.deletions} deletions)`);
+        console.log('Generating PR description...');
+        const desc = await (0, ai_1.generateDocSection)(snippet, 'pr', apiKey, undefined, aiOptions, compactSummary);
+        fs.writeFileSync(outputFile, desc);
+        console.log(`PR description saved to ${outputFile}`);
+    }
+    catch (error) {
+        if (error.message.includes('not a git repository')) {
+            throw new Error('Not a git repository. Please run this command in a git repository.');
+        }
+        throw error;
+    }
+}

package/dist/o/r.js

@@ -0,0 +1,111 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateReadme = generateReadme;
+const handlebars = __importStar(require("handlebars"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ai_1 = require("../ai");
+const a_1 = require("../a");
+const merger_1 = require("../utils/merger");
+async function generateReadme(inputDir, outputFile, apiKey, aiOptions, customTemplatePath) {
+    console.log('Analyzing codebase...');
+    const analysis = (0, a_1.analyzeCode)(inputDir);
+    console.log(`  Found ${analysis.fileCount} files, ${analysis.totalLines} lines`);
+    console.log(`  Functions: ${analysis.functions.length}, Classes: ${analysis.classes.length}`);
+    // Show compact summary if available
+    if (analysis.compactSummary) {
+        console.log('\nProject Structure:');
+        console.log(analysis.compactSummary.split('\n').map(l => `  ${l}`).join('\n'));
+    }
+    console.log('\nGenerating documentation...');
+    // Use compact summary for better token efficiency
+    const contextSnippet = analysis.compactSummary
+        ? `${analysis.compactSummary}\n\nCode samples:\n${analysis.snippets.slice(0, 4000)}`
+        : analysis.snippets;
+    const overview = await (0, ai_1.generateDocSection)(contextSnippet, 'readme', apiKey, undefined, aiOptions, analysis.compactSummary);
+    const usage = await (0, ai_1.generateDocSection)(contextSnippet, 'readme', apiKey, 'Generate practical usage examples with code snippets showing how to use this project', aiOptions, analysis.compactSummary);
+    // Generate API docs for top functions/classes (limit to avoid rate limits)
+    const topItems = [...analysis.functions, ...analysis.classes].slice(0, 8);
+    const apis = topItems.map(name => ({
+        name,
+        desc: `${name} - Core functionality (see code for details)`,
+    }));
+    // Try to read project name from package.json
+    let projectName = 'Your Project';
+    const packageJsonPath = path.join(process.cwd(), 'package.json');
+    if (fs.existsSync(packageJsonPath)) {
+        try {
+            const pkg = JSON.parse(fs.readFileSync(packageJsonPath, 'utf-8'));
+            projectName = pkg.name || projectName;
+        }
+        catch (error) {
+            // Ignore
+        }
+    }
+    // Load template
+    const resolvedTemplatePath = customTemplatePath
+        ? path.resolve(process.cwd(), customTemplatePath)
+        : path.join(__dirname, '../t/r.hbs');
+    if (!fs.existsSync(resolvedTemplatePath)) {
+        throw new Error(`Template file not found: ${resolvedTemplatePath}`);
+    }
+    const template = handlebars.compile(fs.readFileSync(resolvedTemplatePath, 'utf-8'));
+    const content = template({
+        projectName,
+        overview,
+        usage,
+        apis,
+        stats: {
+            fileCount: analysis.fileCount,
+            totalLines: analysis.totalLines,
+            functions: analysis.functions.length,
+            classes: analysis.classes.length,
+            totalSize: (analysis.totalSize / 1024).toFixed(1),
+            complexity: analysis.complexity.toFixed(1),
+        },
+    });
+    let finalContent = content;
+    if (fs.existsSync(outputFile)) {
+        try {
+            const existingContent = fs.readFileSync(outputFile, 'utf-8');
+            finalContent = (0, merger_1.mergeContent)(existingContent, content);
+        }
+        catch (error) {
+            console.warn(`Failed to merge content, overwriting instead: ${error.message}`);
+        }
+    }
+    fs.writeFileSync(outputFile, finalContent);
+}

package/dist/t/r.hbs

@@ -0,0 +1,53 @@
+# {{projectName}}
+
+## 📋 Overview
+<!-- lazydocs:start:overview -->
+{{{overview}}}
+<!-- lazydocs:end:overview -->
+
+<!-- lazydocs:start:stats -->
+{{#if stats}}
+## 📊 Project Statistics
+- **Files analyzed:** {{stats.fileCount}}
+- **Total lines of code:** {{stats.totalLines}}
+- **Total size:** {{stats.totalSize}} KB
+- **Functions:** {{stats.functions}}
+- **Classes:** {{stats.classes}}
+- **Avg complexity:** {{stats.complexity}}
+{{/if}}
+<!-- lazydocs:end:stats -->
+
+## 🚀 Installation
+
+```bash
+npm install {{projectName}}
+```
+
+## 💡 Usage
+<!-- lazydocs:start:usage -->
+{{{usage}}}
+<!-- lazydocs:end:usage -->
+
+<!-- lazydocs:start:api -->
+{{#if apis.length}}
+## 📚 API Reference
+
+| Function/Class | Description |
+|----------------|-------------|
+{{#each apis}}
+| `{{name}}` | {{{desc}}} |
+{{/each}}
+{{/if}}
+<!-- lazydocs:end:api -->
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+## 📄 License
+
+This project is licensed under the MIT License.
+
+---
+
+*Documentation generated with ❤️ by [LazyDocs](https://github.com/kedar49/lazydocs)*

package/dist/utils/config-manager.js

@@ -0,0 +1,184 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configExists = exports.deleteConfig = exports.listConfig = exports.getConfigValue = exports.setConfig = exports.getConfig = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const CONFIG_FILE = path.join(os.homedir(), '.lazydocs');
+class ConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'ConfigError';
+    }
+}
+const parseAssert = (name, condition, message) => {
+    if (!condition) {
+        throw new ConfigError(`Invalid config property ${name}: ${message}`);
+    }
+};
+const configParsers = {
+    GROQ_API_KEY(key) {
+        if (!key) {
+            throw new ConfigError('Please set your Groq API key via `lazydocs config set GROQ_API_KEY=<your token>`');
+        }
+        parseAssert('GROQ_API_KEY', key.startsWith('gsk_'), 'Must start with "gsk_"');
+        parseAssert('GROQ_API_KEY', key.length > 20, 'Invalid API key format');
+        return key;
+    },
+    DEFAULT_MODEL(model) {
+        if (!model || model.length === 0) {
+            return 'llama-3.3-70b-versatile';
+        }
+        return model;
+    },
+    MAX_TOKENS(tokens) {
+        if (!tokens) {
+            return 2048;
+        }
+        const value = typeof tokens === 'string' ? tokens : String(tokens);
+        parseAssert('MAX_TOKENS', /^\d+$/.test(value), 'Must be an integer');
+        const parsed = Number(value);
+        parseAssert('MAX_TOKENS', parsed >= 100, 'Must be at least 100');
+        parseAssert('MAX_TOKENS', parsed <= 131072, 'Must be at most 131072');
+        return parsed;
+    },
+    TEMPERATURE(temp) {
+        if (!temp) {
+            return 0.7;
+        }
+        const value = typeof temp === 'string' ? temp : String(temp);
+        parseAssert('TEMPERATURE', /^[0-9.]+$/.test(value), 'Must be a number');
+        const parsed = Number(value);
+        parseAssert('TEMPERATURE', parsed >= 0, 'Must be at least 0');
+        parseAssert('TEMPERATURE', parsed <= 2, 'Must be at most 2');
+        return parsed;
+    },
+    GENERATE_COUNT(count) {
+        if (!count) {
+            return 1;
+        }
+        const value = typeof count === 'string' ? count : String(count);
+        parseAssert('GENERATE_COUNT', /^\d+$/.test(value), 'Must be an integer');
+        const parsed = Number(value);
+        parseAssert('GENERATE_COUNT', parsed > 0, 'Must be greater than 0');
+        parseAssert('GENERATE_COUNT', parsed <= 5, 'Must be at most 5');
+        return parsed;
+    },
+    TIMEOUT(timeout) {
+        if (!timeout) {
+            return 30000; // 30 seconds
+        }
+        const value = typeof timeout === 'string' ? timeout : String(timeout);
+        parseAssert('TIMEOUT', /^\d+$/.test(value), 'Must be an integer');
+        const parsed = Number(value);
+        parseAssert('TIMEOUT', parsed >= 1000, 'Must be at least 1000ms (1 second)');
+        parseAssert('TIMEOUT', parsed <= 300000, 'Must be at most 300000ms (5 minutes)');
+        return parsed;
+    },
+};
+const readConfigFile = () => {
+    try {
+        if (!fs.existsSync(CONFIG_FILE)) {
+            return {};
+        }
+        const content = fs.readFileSync(CONFIG_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.warn('Failed to read config file, using defaults');
+        return {};
+    }
+};
+const getConfig = (cliConfig, suppressErrors = false) => {
+    const fileConfig = readConfigFile();
+    const envConfig = {
+        GROQ_API_KEY: process.env.GROQ_API_KEY,
+    };
+    const parsedConfig = {};
+    for (const key of Object.keys(configParsers)) {
+        const parser = configParsers[key];
+        // Priority: CLI > Env > File
+        const value = cliConfig?.[key] ?? envConfig[key] ?? fileConfig[key];
+        if (suppressErrors) {
+            try {
+                parsedConfig[key] = parser(value);
+            }
+            catch (error) {
+                // Silently use default
+            }
+        }
+        else {
+            parsedConfig[key] = parser(value);
+        }
+    }
+    return parsedConfig;
+};
+exports.getConfig = getConfig;
+const setConfig = (key, value) => {
+    if (!(key in configParsers)) {
+        throw new ConfigError(`Invalid config property: ${key}`);
+    }
+    // Validate the value
+    const parser = configParsers[key];
+    const parsed = parser(value);
+    // Read existing config
+    const config = readConfigFile();
+    // Update config
+    config[key] = parsed;
+    // Write back
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+};
+exports.setConfig = setConfig;
+const getConfigValue = (key) => {
+    const config = readConfigFile();
+    const value = config[key];
+    return value !== undefined ? String(value) : undefined;
+};
+exports.getConfigValue = getConfigValue;
+const listConfig = () => {
+    return readConfigFile();
+};
+exports.listConfig = listConfig;
+const deleteConfig = (key) => {
+    const config = readConfigFile();
+    delete config[key];
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2), 'utf-8');
+};
+exports.deleteConfig = deleteConfig;
+const configExists = () => {
+    return fs.existsSync(CONFIG_FILE);
+};
+exports.configExists = configExists;

package/dist/utils/merger.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeContent = mergeContent;
+/**
+ * Smartly merges newly generated documentation content into existing documentation content
+ * by replacing content between comment anchors.
+ *
+ * Anchors are in the format:
+ * <!-- lazydocs:start:<section> -->
+ * <!-- lazydocs:end:<section> -->
+ *
+ * If the existing content contains no matching anchors, the function returns the new content completely
+ * (falling back to a full overwrite).
+ */
+function mergeContent(existingContent, newContent) {
+    // Regex to find all start blocks in the new content
+    const startRegex = /<!-- lazydocs:start:([\w-]+) -->/g;
+    let match;
+    let mergedContent = existingContent;
+    const sections = {};
+    // Find all sections in the new generated content
+    while ((match = startRegex.exec(newContent)) !== null) {
+        const sectionName = match[1];
+        const startTag = `<!-- lazydocs:start:${sectionName} -->`;
+        const endTag = `<!-- lazydocs:end:${sectionName} -->`;
+        const startIndex = newContent.indexOf(startTag);
+        const endIndex = newContent.indexOf(endTag);
+        if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+            // Extract the content inside the tags
+            const newSectionContent = newContent.substring(startIndex + startTag.length, endIndex);
+            sections[sectionName] = newSectionContent;
+        }
+    }
+    // If the existing content doesn't contain any of the lazydocs start tags,
+    // return the new content completely (overwrite)
+    let hasAnyAnchor = false;
+    for (const sectionName of Object.keys(sections)) {
+        const startTag = `<!-- lazydocs:start:${sectionName} -->`;
+        if (existingContent.includes(startTag)) {
+            hasAnyAnchor = true;
+            break;
+        }
+    }
+    if (!hasAnyAnchor) {
+        return newContent;
+    }
+    // Replace only the matched sections in the existing content
+    for (const [sectionName, newSectionContent] of Object.entries(sections)) {
+        const startTag = `<!-- lazydocs:start:${sectionName} -->`;
+        const endTag = `<!-- lazydocs:end:${sectionName} -->`;
+        const startIndex = mergedContent.indexOf(startTag);
+        const endIndex = mergedContent.indexOf(endTag);
+        if (startIndex !== -1 && endIndex !== -1 && endIndex > startIndex) {
+            const before = mergedContent.substring(0, startIndex + startTag.length);
+            const after = mergedContent.substring(endIndex);
+            mergedContent = before + newSectionContent + after;
+        }
+    }
+    return mergedContent;
+}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@lazykedar/lazydocs",
+  "version": "1.3.0",
+  "description": "AI-powered documentation generator using Groq. Generate READMEs, PR descriptions, and changelogs in seconds.",
+  "main": "dist/index.js",
+  "bin": {
+    "lazydocs": "./dist/cli.js"
+  },
+  "scripts": {
+    "start": "npx -y serve web",
+    "build": "tsc && npm run copy-templates",
+    "copy-templates": "node -e \"const fs=require('fs');const path=require('path');const src='src/t';const dest='dist/t';if(!fs.existsSync(dest))fs.mkdirSync(dest,{recursive:true});fs.readdirSync(src).forEach(f=>{if(f.endsWith('.hbs'))fs.copyFileSync(path.join(src,f),path.join(dest,f))})\"",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build && npm test",
+    "postinstall": "echo 'LazyDocs installed! Run: lazydocs --help'"
+  },
+  "keywords": [
+    "ai",
+    "documentation",
+    "groq",
+    "readme",
+    "changelog",
+    "pr",
+    "generator",
+    "cli",
+    "markdown",
+    "llm",
+    "typescript",
+    "javascript"
+  ],
+  "author": "Kedar Sathe <kedarsathe49@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/kedar49/lazydocs.git"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "devDependencies": {
+    "@types/commander": "^2.12.0",
+    "@types/inquirer": "^9.0.9",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^24.7.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.4",
+    "typescript": "^5.9.3"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.28.4",
+    "commander": "^14.0.1",
+    "groq-sdk": "^0.33.0",
+    "handlebars": "^4.7.8",
+    "inquirer": "^12.9.6",
+    "simple-git": "^3.28.0"
+  }
+}