@lazykedar/lazydocs 1.3.0

package/dist/ai.js

@@ -0,0 +1,223 @@
+"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.getDefaultModel = getDefaultModel;
+exports.getFallbackModels = getFallbackModels;
+exports.getAvailableModels = getAvailableModels;
+exports.generateDocSection = generateDocSection;
+const groq_sdk_1 = require("groq-sdk");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_MODEL = 'llama-3.3-70b-versatile';
+// Fallback models for when API fetch fails
+const FALLBACK_MODELS = [
+    'llama-3.3-70b-versatile',
+    'llama-3.1-8b-instant',
+    'gemma2-9b-it',
+    'mixtral-8x7b-32768',
+    'llama-3.1-70b-versatile',
+];
+function getDefaultModel() {
+    return DEFAULT_MODEL;
+}
+function getFallbackModels() {
+    return FALLBACK_MODELS;
+}
+async function getAvailableModels(apiKey) {
+    try {
+        const groq = new groq_sdk_1.Groq({ apiKey });
+        const models = await groq.models.list();
+        return models.data
+            .filter((model) => model.active !== false)
+            .map((model) => model.id)
+            .sort();
+    }
+    catch (error) {
+        console.warn('Failed to fetch models from API, using fallback list');
+        return FALLBACK_MODELS;
+    }
+}
+const logError = (message) => {
+    const logDir = path.join(process.cwd(), 'logs');
+    if (!fs.existsSync(logDir))
+        fs.mkdirSync(logDir);
+    const logFile = path.join(logDir, 'error.log');
+    fs.appendFileSync(logFile, `${new Date().toISOString()} - ${message}\n`);
+};
+// Enhanced prompt builder with structured requirements
+function buildEnhancedPrompt(codeSnippet, type, compactSummary) {
+    const prompts = {
+        readme: `You are a technical documentation expert. Analyze this codebase and generate a comprehensive, professional README in Markdown.
+
+${compactSummary ? `PROJECT SUMMARY:\n${compactSummary}\n\n` : ''}CODE ANALYSIS:
+${codeSnippet}
+
+Generate a complete README with these sections:
+1. Project title and tagline
+2. Overview - What the project does and why it exists
+3. Key Features - Bullet points of main capabilities
+4. Installation - Clear setup instructions
+5. Usage - Code examples showing how to use it
+6. API Reference - Document main functions/classes with descriptions
+7. Contributing - Brief guidelines
+8. License - Standard license section
+
+Requirements:
+- Use clear Markdown formatting with proper headers
+- Include code blocks with syntax highlighting
+- Keep it concise but comprehensive (800-1200 words)
+- Use tables for API documentation
+- Professional yet approachable tone
+- Focus on what developers need to know`,
+        pr: `You are a code review expert. Analyze these code changes and generate a clear, professional Pull Request description in Markdown.
+
+${compactSummary ? `CHANGES SUMMARY:\n${compactSummary}\n\n` : ''}DIFF ANALYSIS:
+${codeSnippet}
+
+Generate a PR description with these sections:
+## Summary
+Brief overview of what changed and why
+
+## Changes Made
+- Bullet points of specific changes
+- Group related changes together
+- Be specific about what was added/modified/removed
+
+## Impact
+- How this affects the codebase
+- Any breaking changes
+- Performance implications
+
+## Testing
+- How to verify these changes
+- Test scenarios covered
+
+Requirements:
+- Clear, scannable format
+- Use conventional commit style language
+- Highlight breaking changes prominently
+- Professional tone suitable for team review`,
+        changelog: `You are a release notes expert. Analyze these commits and generate a well-organized changelog entry in Markdown.
+
+${compactSummary ? `COMMIT SUMMARY:\n${compactSummary}\n\n` : ''}COMMIT HISTORY:
+${codeSnippet}
+
+Generate a changelog following Keep a Changelog format:
+
+## [Version] - YYYY-MM-DD
+
+### 🚀 Features
+- New user-facing features
+
+### 🐛 Bug Fixes
+- Issues resolved
+
+### 📚 Documentation
+- Doc updates
+
+### 🔧 Maintenance
+- Internal improvements, refactoring, dependencies
+
+### ⚠️ Breaking Changes
+- Changes that break backward compatibility
+
+Requirements:
+- Use emoji for visual scanning
+- Group similar changes together
+- Use imperative mood ("Add feature" not "Added feature")
+- Be specific but concise
+- Highlight breaking changes clearly
+- Follow semantic versioning principles`,
+    };
+    return prompts[type];
+}
+async function generateDocSection(codeSnippet, type, apiKey, customPrompt, options = {}, compactSummary) {
+    const { model = DEFAULT_MODEL, temperature = 0.7, maxTokens = 2048, retries = 3, timeout = 30000, } = options;
+    // Build enhanced prompt with structured requirements
+    const prompt = customPrompt || buildEnhancedPrompt(codeSnippet, type, compactSummary);
+    // Retry logic with exponential backoff for reliability
+    for (let attempt = 1; attempt <= retries; attempt++) {
+        try {
+            const groq = new groq_sdk_1.Groq({
+                apiKey,
+                timeout,
+            });
+            const completion = await groq.chat.completions.create({
+                messages: [
+                    { role: 'system', content: 'You are an expert technical writer who creates clear, professional documentation.' },
+                    { role: 'user', content: prompt }
+                ],
+                model,
+                temperature,
+                max_tokens: maxTokens,
+            });
+            const content = completion.choices[0]?.message?.content;
+            if (!content) {
+                throw new Error('No content generated from AI');
+            }
+            return content;
+        }
+        catch (error) {
+            const errorMsg = `Attempt ${attempt}/${retries} failed: ${error.message}`;
+            logError(errorMsg);
+            // Last attempt - throw detailed error
+            if (attempt === retries) {
+                if (error.status === 401 || error.message?.includes('401')) {
+                    throw new Error('Invalid API key. Get one from console.groq.com and set with: lazydocs config set GROQ_API_KEY=your_key');
+                }
+                if (error.status === 429 || error.message?.includes('rate_limit')) {
+                    throw new Error('Rate limit exceeded. Try:\n' +
+                        '1. Wait a few minutes and try again\n' +
+                        '2. Use a faster model: --model llama-3.1-8b-instant\n' +
+                        '3. Reduce max tokens: --max-tokens 1024');
+                }
+                if (error.status === 413 || error.message?.includes('too large')) {
+                    throw new Error('Request too large. Try:\n' +
+                        '1. Analyze a smaller directory\n' +
+                        '2. Use a model with larger context window\n' +
+                        '3. Reduce the amount of code being analyzed');
+                }
+                if (error.code === 'ENOTFOUND') {
+                    throw new Error(`Network error: Cannot connect to ${error.hostname}. Check your internet connection.`);
+                }
+                throw new Error(`AI generation failed after ${retries} attempts: ${error.message}`);
+            }
+            // Not last attempt - log warning and retry with backoff
+            console.warn(`⚠️  ${errorMsg} - retrying...`);
+            await new Promise(resolve => setTimeout(resolve, 1000 * attempt)); // Exponential backoff
+        }
+    }
+    return 'Error generating content after multiple attempts';
+}

package/dist/cli.js

@@ -0,0 +1,379 @@
+#!/usr/bin/env node
+"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 });
+const commander = __importStar(require("commander"));
+const inquirer = __importStar(require("inquirer"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const r_1 = require("./o/r");
+const p_1 = require("./o/p");
+const c_1 = require("./o/c");
+const ai_1 = require("./ai");
+const config_manager_1 = require("./utils/config-manager");
+const logError = (message) => {
+    const logDir = path.join(process.cwd(), 'logs');
+    if (!fs.existsSync(logDir))
+        fs.mkdirSync(logDir);
+    const logFile = path.join(logDir, 'error.log');
+    fs.appendFileSync(logFile, `${new Date().toISOString()} - ${message}\n`);
+};
+const program = new commander.Command();
+program
+    .name('lazydocs')
+    .description('AI-powered documentation generator using Groq')
+    .version('1.1.0');
+// Config commands
+const configCmd = program.command('config');
+configCmd
+    .command('set')
+    .argument('<key=value>', 'Set config (e.g., GROQ_API_KEY=gsk_...)')
+    .action((kv) => {
+    try {
+        const [key, value] = kv.split('=');
+        if (!key || !value) {
+            throw new Error('Invalid format. Use: key=value');
+        }
+        (0, config_manager_1.setConfig)(key, value);
+        console.log(`Set ${key} in ~/.lazydocs`);
+    }
+    catch (error) {
+        logError(`Config set error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+configCmd
+    .command('get')
+    .argument('<key>', 'Get config value')
+    .action((key) => {
+    try {
+        const value = (0, config_manager_1.getConfigValue)(key);
+        if (value) {
+            const displayValue = key.includes('KEY') ? value.substring(0, 10) + '***' : value;
+            console.log(displayValue);
+        }
+        else {
+            console.log('Not set');
+        }
+    }
+    catch (error) {
+        logError(`Config get error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+configCmd
+    .command('list')
+    .description('List all configuration')
+    .action(() => {
+    try {
+        const config = (0, config_manager_1.listConfig)();
+        if (Object.keys(config).length === 0) {
+            console.log('Current Configuration: (empty - using defaults)');
+        }
+        else {
+            console.log('Current Configuration:\n');
+            Object.entries(config).forEach(([key, value]) => {
+                const displayValue = key.includes('KEY') ? String(value).substring(0, 10) + '***' : value;
+                console.log(`  ${key}: ${displayValue}`);
+            });
+        }
+    }
+    catch (error) {
+        logError(`Config list error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+configCmd
+    .command('delete')
+    .argument('<key>', 'Delete config value')
+    .action((key) => {
+    try {
+        const value = (0, config_manager_1.getConfigValue)(key);
+        if (value) {
+            (0, config_manager_1.deleteConfig)(key);
+            console.log(`Deleted ${key} from ~/.lazydocs`);
+        }
+        else {
+            console.log('Not set');
+        }
+    }
+    catch (error) {
+        logError(`Config delete error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Generate command
+program
+    .command('generate')
+    .description('Generate documentation')
+    .option('-i, --input <dir>', 'Input code directory', './src')
+    .option('-o, --output <file>', 'Output file')
+    .option('-t, --type <type>', 'Doc type: readme, pr, changelog', 'readme')
+    .option('-m, --model <model>', 'AI model to use', (0, ai_1.getDefaultModel)())
+    .option('--temperature <temp>', 'AI temperature (0-1)', parseFloat, 0.7)
+    .option('--max-tokens <tokens>', 'Maximum tokens', parseInt, 2048)
+    .option('--interactive', 'Interactive mode')
+    .option('--verbose', 'Verbose output')
+    .option('--template <path>', 'Custom Handlebars template file path')
+    .option('--base <branch>', 'Base branch for PR diff comparison')
+    .option('--head <branch>', 'Head branch for PR diff comparison')
+    .action(async (options) => {
+    try {
+        const startTime = Date.now();
+        // Interactive mode
+        if (options.interactive) {
+            let apiKey;
+            try {
+                const config = (0, config_manager_1.getConfig)({}, true);
+                apiKey = config.GROQ_API_KEY;
+            }
+            catch {
+                const keyAnswer = await inquirer.default.prompt([
+                    {
+                        type: 'password',
+                        name: 'apiKey',
+                        message: 'Enter your Groq API key (from console.groq.com):',
+                        validate: (input) => (input ? true : 'API key is required!'),
+                    },
+                ]);
+                apiKey = keyAnswer.apiKey;
+            }
+            console.log('Fetching available models...');
+            const availableModels = await (0, ai_1.getAvailableModels)(apiKey);
+            const answers = await inquirer.default.prompt([
+                {
+                    type: 'list',
+                    name: 'type',
+                    message: 'What would you like to generate?',
+                    choices: [
+                        { name: 'README.md', value: 'readme' },
+                        { name: 'PR Description', value: 'pr' },
+                        { name: 'Changelog', value: 'changelog' },
+                    ],
+                },
+                {
+                    type: 'input',
+                    name: 'input',
+                    message: 'Input directory:',
+                    default: './src',
+                },
+                {
+                    type: 'list',
+                    name: 'model',
+                    message: 'Select AI model:',
+                    choices: availableModels.map((m) => ({
+                        name: m,
+                        value: m,
+                    })),
+                    default: (0, ai_1.getDefaultModel)(),
+                },
+            ]);
+            Object.assign(options, answers);
+        }
+        // Set default output
+        if (!options.output) {
+            const defaults = {
+                readme: './README.md',
+                pr: './PR_DESCRIPTION.md',
+                changelog: './CHANGELOG.md',
+            };
+            options.output = defaults[options.type];
+        }
+        // Get API key
+        let apiKey;
+        try {
+            const config = (0, config_manager_1.getConfig)({}, true);
+            apiKey = config.GROQ_API_KEY;
+        }
+        catch {
+            const answers = await inquirer.default.prompt([
+                {
+                    type: 'password',
+                    name: 'apiKey',
+                    message: 'Enter your Groq API key (from console.groq.com):',
+                    validate: (input) => (input ? true : 'API key is required!'),
+                },
+                {
+                    type: 'confirm',
+                    name: 'save',
+                    message: 'Save API key to ~/.lazydocs?',
+                    default: true,
+                },
+            ]);
+            apiKey = answers.apiKey;
+            if (answers.save) {
+                (0, config_manager_1.setConfig)('GROQ_API_KEY', apiKey);
+            }
+        }
+        if (options.verbose) {
+            console.log('Configuration:');
+            console.log(`  Type: ${options.type}`);
+            console.log(`  Input: ${options.input}`);
+            console.log(`  Output: ${options.output}`);
+            console.log(`  Model: ${options.model}`);
+            console.log(`  Temperature: ${options.temperature}`);
+            console.log(`  Max Tokens: ${options.maxTokens}`);
+        }
+        console.log(`Generating ${options.type} from ${options.input}...`);
+        const aiOptions = {
+            model: options.model,
+            temperature: options.temperature,
+            maxTokens: options.maxTokens,
+        };
+        // Generate
+        if (options.type === 'readme') {
+            await (0, r_1.generateReadme)(options.input, options.output, apiKey, aiOptions, options.template);
+        }
+        else if (options.type === 'pr') {
+            const gitOptions = { base: options.base, head: options.head };
+            await (0, p_1.generatePrDesc)(options.input, options.output, apiKey, aiOptions, gitOptions);
+        }
+        else if (options.type === 'changelog') {
+            await (0, c_1.generateChangelog)(options.input, options.output, apiKey, aiOptions);
+        }
+        else {
+            throw new Error(`Invalid type: ${options.type}`);
+        }
+        const duration = ((Date.now() - startTime) / 1000).toFixed(1);
+        console.log(`Generated ${options.type} at ${options.output} (${duration}s)`);
+        if (fs.existsSync(options.output)) {
+            const stats = fs.statSync(options.output);
+            console.log(`File size: ${(stats.size / 1024).toFixed(1)} KB`);
+        }
+    }
+    catch (error) {
+        logError(`Generate error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        if (options.verbose && error.stack) {
+            console.error(error.stack);
+        }
+        process.exit(1);
+    }
+});
+// Init command
+program
+    .command('init')
+    .description('Initialize lazydocs in current project')
+    .action(async () => {
+    try {
+        const answers = await inquirer.default.prompt([
+            {
+                type: 'input',
+                name: 'projectName',
+                message: 'Project name:',
+                default: path.basename(process.cwd()),
+            },
+            {
+                type: 'input',
+                name: 'description',
+                message: 'Project description:',
+            },
+            {
+                type: 'checkbox',
+                name: 'features',
+                message: 'Select features to document:',
+                choices: [
+                    'Installation guide',
+                    'Usage examples',
+                    'API documentation',
+                    'Contributing guidelines',
+                    'License information',
+                ],
+            },
+        ]);
+        const projectConfig = {
+            projectName: answers.projectName,
+            description: answers.description,
+            features: answers.features,
+            createdAt: new Date().toISOString(),
+        };
+        fs.writeFileSync('.lazydocs.json', JSON.stringify(projectConfig, null, 2));
+        console.log('Initialized lazydocs configuration at .lazydocs.json');
+    }
+    catch (error) {
+        logError(`Init error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+// Models command
+program
+    .command('models')
+    .description('List available AI models')
+    .option('--refresh', 'Fetch latest models from API')
+    .action(async (options) => {
+    try {
+        if (options.refresh) {
+            let apiKey;
+            try {
+                const config = (0, config_manager_1.getConfig)({}, true);
+                apiKey = config.GROQ_API_KEY;
+            }
+            catch {
+                console.error('API key required. Set with: lazydocs config set GROQ_API_KEY=your_key');
+                process.exit(1);
+            }
+            console.log('Fetching latest models from Groq API...\n');
+            const models = await (0, ai_1.getAvailableModels)(apiKey);
+            console.log('Available AI Models:\n');
+            models.forEach((model, index) => {
+                const isDefault = model === (0, ai_1.getDefaultModel)();
+                const marker = isDefault ? '*' : ' ';
+                console.log(`${marker} ${index + 1}. ${model}${isDefault ? ' (default)' : ''}`);
+            });
+            console.log(`\nFound ${models.length} active models`);
+        }
+        else {
+            console.log('Available AI Models (fallback list):\n');
+            const models = (0, ai_1.getFallbackModels)();
+            models.forEach((model, index) => {
+                const isDefault = model === (0, ai_1.getDefaultModel)();
+                const marker = isDefault ? '*' : ' ';
+                console.log(`${marker} ${index + 1}. ${model}${isDefault ? ' (default)' : ''}`);
+            });
+            console.log('\nUse --refresh to fetch latest models from API');
+        }
+    }
+    catch (error) {
+        logError(`Models error: ${error.message}`);
+        console.error(`Error: ${error.message}`);
+        process.exit(1);
+    }
+});
+program.parse();

package/dist/o/c.js

@@ -0,0 +1,83 @@
+"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.generateChangelog = generateChangelog;
+const fs = __importStar(require("fs"));
+const simple_git_1 = __importDefault(require("simple-git"));
+const ai_1 = require("../ai");
+async function generateChangelog(inputDir, outputFile, apiKey, aiOptions) {
+    console.log('Analyzing git history...');
+    const git = (0, simple_git_1.default)(inputDir);
+    try {
+        // Get recent commits (last 50)
+        const logs = await git.log({ maxCount: 50 });
+        const snippet = `
+Total commits analyzed: ${logs.total}
+
+Recent commits:
+${logs.all
+            .map((l) => `
+- ${l.date}: ${l.message}
+  Author: ${l.author_name}
+  Hash: ${l.hash.substring(0, 7)}
+`)
+            .join('\n')}
+`;
+        console.log(`  Analyzed ${logs.total} commits`);
+        console.log('Generating changelog...');
+        const changelog = await (0, ai_1.generateDocSection)(snippet, 'changelog', apiKey, undefined, aiOptions);
+        // Prepend version and date
+        const today = new Date().toISOString().split('T')[0];
+        const fullChangelog = `# Changelog
+
+## [Unreleased] - ${today}
+
+${changelog}
+
+---
+*Generated by LazyDocs*
+`;
+        fs.writeFileSync(outputFile, fullChangelog);
+    }
+    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;
+    }
+}