@lazykedar/lazydocs 1.3.0

package/.github/FUNDING.yml

@@ -0,0 +1,7 @@
+# Funding options for LazyDocs
+
+github: [kedar49]
+# patreon: your_patreon_username
+# open_collective: your_open_collective
+# ko_fi: your_ko_fi_username
+# custom: ['https://your-website.com/donate']

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,39 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: bug
+assignees: ''
+---
+
+## Bug Description
+A clear and concise description of what the bug is.
+
+## To Reproduce
+Steps to reproduce the behavior:
+1. Run command '...'
+2. With options '...'
+3. See error
+
+## Expected Behavior
+A clear and concise description of what you expected to happen.
+
+## Actual Behavior
+What actually happened.
+
+## Error Output
+```
+Paste any error messages here
+```
+
+## Environment
+- OS: [e.g., Windows 11, macOS 14, Ubuntu 22.04]
+- Node.js version: [e.g., 18.0.0]
+- LazyDocs version: [e.g., 1.0.0]
+- Installation method: [npm, Homebrew]
+
+## Additional Context
+Add any other context about the problem here.
+
+## Screenshots
+If applicable, add screenshots to help explain your problem.

package/.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,38 @@
+---
+name: Feature Request
+about: Suggest an idea for this project
+title: '[FEATURE] '
+labels: enhancement
+assignees: ''
+---
+
+## Feature Description
+A clear and concise description of the feature you'd like to see.
+
+## Problem Statement
+Is your feature request related to a problem? Please describe.
+Example: I'm always frustrated when [...]
+
+## Proposed Solution
+Describe the solution you'd like to see implemented.
+
+## Alternatives Considered
+Describe any alternative solutions or features you've considered.
+
+## Use Case
+Describe how this feature would be used and who would benefit from it.
+
+## Example Usage
+If applicable, provide example commands or code showing how this feature would work:
+
+```bash
+lazydocs generate --new-feature ...
+```
+
+## Additional Context
+Add any other context, screenshots, or examples about the feature request here.
+
+## Would you like to implement this feature?
+- [ ] Yes, I'd like to work on this
+- [ ] No, but I'd be happy to test it
+- [ ] I just want to suggest it

package/.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,57 @@
+## Description
+<!-- Provide a brief description of the changes in this PR -->
+
+## Type of Change
+<!-- Mark the relevant option with an "x" -->
+
+- [ ] 🐛 Bug fix (non-breaking change which fixes an issue)
+- [ ] ✨ New feature (non-breaking change which adds functionality)
+- [ ] 💥 Breaking change (fix or feature that would cause existing functionality to not work as expected)
+- [ ] 📚 Documentation update
+- [ ] 🔧 Maintenance (dependency updates, refactoring, etc.)
+- [ ] 🧪 Test improvements
+
+## Related Issues
+<!-- Link to related issues using #issue_number -->
+
+Fixes #
+Relates to #
+
+## Changes Made
+<!-- List the main changes made in this PR -->
+
+- 
+- 
+- 
+
+## Testing
+<!-- Describe the tests you ran and how to reproduce them -->
+
+- [ ] All existing tests pass
+- [ ] New tests added for new functionality
+- [ ] Manual testing performed
+
+### Test Commands
+```bash
+npm test
+npm run build
+```
+
+## Checklist
+<!-- Mark completed items with an "x" -->
+
+- [ ] My code follows the project's code style
+- [ ] I have performed a self-review of my code
+- [ ] I have commented my code, particularly in hard-to-understand areas
+- [ ] I have made corresponding changes to the documentation
+- [ ] My changes generate no new warnings or errors
+- [ ] I have added tests that prove my fix is effective or that my feature works
+- [ ] New and existing unit tests pass locally with my changes
+- [ ] Any dependent changes have been merged and published
+- [ ] I have updated the CHANGELOG.md
+
+## Screenshots (if applicable)
+<!-- Add screenshots to help explain your changes -->
+
+## Additional Notes
+<!-- Add any additional notes or context about the PR here -->

package/.github/dependabot.yml

@@ -0,0 +1,50 @@
+version: 2
+updates:
+  # Enable version updates for npm
+  - package-ecosystem: "npm"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+      time: "09:00"
+    open-pull-requests-limit: 10
+    reviewers:
+      - "kedar49"
+    assignees:
+      - "kedar49"
+    commit-message:
+      prefix: "chore"
+      prefix-development: "chore"
+      include: "scope"
+    labels:
+      - "dependencies"
+      - "automated"
+    ignore:
+      # Ignore major version updates for stable dependencies
+      - dependency-name: "*"
+        update-types: ["version-update:semver-major"]
+    groups:
+      development-dependencies:
+        dependency-type: "development"
+        patterns:
+          - "@types/*"
+          - "typescript"
+          - "jest"
+          - "ts-jest"
+      production-dependencies:
+        dependency-type: "production"
+        update-types:
+          - "minor"
+          - "patch"
+
+  # Enable version updates for GitHub Actions
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"
+      day: "monday"
+    commit-message:
+      prefix: "ci"
+    labels:
+      - "github-actions"
+      - "automated"

package/.github/workflows/ci.yml

@@ -0,0 +1,67 @@
+name: CI
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+
+jobs:
+  test:
+    name: Test on Node.js ${{ matrix.node-version }}
+    runs-on: ${{ matrix.os }}
+    
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        node-version: [18.x, 20.x, 21.x]
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js ${{ matrix.node-version }}
+        uses: actions/setup-node@v4
+        with:
+          node-version: ${{ matrix.node-version }}
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npm test
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Upload coverage
+        if: matrix.os == 'ubuntu-latest' && matrix.node-version == '20.x'
+        uses: codecov/codecov-action@v3
+        with:
+          files: ./coverage/lcov.info
+          flags: unittests
+          name: codecov-umbrella
+
+  lint:
+    name: Lint and Type Check
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Type check
+        run: npx tsc --noEmit
+      
+      - name: Check formatting
+        run: npx prettier --check "src/**/*.ts" || true

package/.github/workflows/codeql.yml

@@ -0,0 +1,38 @@
+name: CodeQL Security Analysis
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main]
+  schedule:
+    - cron: '0 0 * * 1' # Run every Monday at midnight
+
+jobs:
+  analyze:
+    name: Analyze Code
+    runs-on: ubuntu-latest
+    permissions:
+      actions: read
+      contents: read
+      security-events: write
+    
+    strategy:
+      fail-fast: false
+      matrix:
+        language: ['javascript']
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Initialize CodeQL
+        uses: github/codeql-action/init@v2
+        with:
+          languages: ${{ matrix.language }}
+      
+      - name: Autobuild
+        uses: github/codeql-action/autobuild@v2
+      
+      - name: Perform CodeQL Analysis
+        uses: github/codeql-action/analyze@v2

package/.github/workflows/dependency-review.yml

@@ -0,0 +1,24 @@
+name: Dependency Review
+
+on:
+  pull_request:
+    branches: [main]
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  dependency-review:
+    name: Review Dependencies
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Dependency Review
+        uses: actions/dependency-review-action@v3
+        with:
+          fail-on-severity: moderate
+          comment-summary-in-pr: true

package/.github/workflows/docs.yml

@@ -0,0 +1,65 @@
+name: Update Documentation
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'src/**'
+      - 'package.json'
+  workflow_dispatch:
+
+jobs:
+  update-docs:
+    name: Auto-generate Documentation
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Generate README (using LazyDocs itself!)
+        run: |
+          export GROQ_API_KEY=${{ secrets.GROQ_API_KEY }}
+          node dist/cli.js generate --type readme --input ./src --output ./README_NEW.md || true
+        continue-on-error: true
+      
+      - name: Check if README changed
+        id: check_changes
+        run: |
+          if [ -f README_NEW.md ]; then
+            if ! diff -q README.md README_NEW.md > /dev/null 2>&1; then
+              echo "changed=true" >> $GITHUB_OUTPUT
+            else
+              echo "changed=false" >> $GITHUB_OUTPUT
+            fi
+          else
+            echo "changed=false" >> $GITHUB_OUTPUT
+          fi
+      
+      - name: Create Pull Request
+        if: steps.check_changes.outputs.changed == 'true'
+        uses: peter-evans/create-pull-request@v5
+        with:
+          token: ${{ secrets.GITHUB_TOKEN }}
+          commit-message: 'docs: auto-update README with LazyDocs'
+          title: '📚 Auto-update Documentation'
+          body: |
+            This PR was automatically generated by LazyDocs to update the documentation.
+            
+            Please review the changes before merging.
+          branch: docs/auto-update
+          delete-branch: true

package/.github/workflows/publish.yml

@@ -0,0 +1,60 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [created]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.0.0)'
+        required: true
+        type: string
+
+jobs:
+  publish:
+    name: Publish to NPM
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npm test
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Update version (if manual trigger)
+        if: github.event_name == 'workflow_dispatch'
+        run: npm version ${{ github.event.inputs.version }} --no-git-tag-version
+      
+      - name: Publish to NPM
+        run: npm publish --access public
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+      
+      - name: Create GitHub Release (if manual trigger)
+        if: github.event_name == 'workflow_dispatch'
+        uses: actions/create-release@v1
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+        with:
+          tag_name: v${{ github.event.inputs.version }}
+          release_name: Release v${{ github.event.inputs.version }}
+          body: |
+            Release version ${{ github.event.inputs.version }}
+            
+            See [CHANGELOG.md](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md) for details.
+          draft: false
+          prerelease: false

package/.github/workflows/release.yml

@@ -0,0 +1,102 @@
+name: Release
+
+on:
+  push:
+    tags:
+      - 'v*.*.*'
+
+permissions:
+  contents: write
+  packages: write
+
+jobs:
+  create-release:
+    name: Create Release
+    runs-on: ubuntu-latest
+    
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+      
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          cache: 'npm'
+      
+      - name: Install dependencies
+        run: npm ci
+      
+      - name: Run tests
+        run: npm test
+      
+      - name: Build project
+        run: npm run build
+      
+      - name: Get version from tag
+        id: get_version
+        run: echo "VERSION=${GITHUB_REF#refs/tags/v}" >> $GITHUB_OUTPUT
+      
+      - name: Generate changelog for this release
+        id: changelog
+        run: |
+          VERSION=${{ steps.get_version.outputs.VERSION }}
+          if [ -f CHANGELOG.md ]; then
+            CHANGELOG=$(sed -n "/## \[$VERSION\]/,/## \[/p" CHANGELOG.md | sed '$d' || echo "See CHANGELOG.md for details")
+          else
+            CHANGELOG="See repository for details"
+          fi
+          echo "CHANGELOG<<EOF" >> $GITHUB_OUTPUT
+          echo "$CHANGELOG" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+      
+      - name: Package for distribution
+        run: |
+          mkdir -p dist-package
+          cp -r dist package.json README.md LICENSE dist-package/
+          if [ -f CHANGELOG.md ]; then
+            cp CHANGELOG.md dist-package/
+          fi
+          cd dist-package
+          tar -czf ../lazydocs-${{ steps.get_version.outputs.VERSION }}.tar.gz .
+      
+      - name: Create GitHub Release
+        uses: softprops/action-gh-release@v1
+        with:
+          name: LazyDocs v${{ steps.get_version.outputs.VERSION }}
+          body: |
+            # LazyDocs v${{ steps.get_version.outputs.VERSION }}
+            
+            ## What's New
+            
+            ${{ steps.changelog.outputs.CHANGELOG }}
+            
+            ## Installation
+            
+            ```bash
+            npm install -g @tfkedar/lazydocs@${{ steps.get_version.outputs.VERSION }}
+            ```
+            
+            ## Quick Start
+            
+            ```bash
+            # Configure
+            lazydocs config set GROQ_API_KEY=your_key
+            
+            # Generate
+            lazydocs generate --interactive
+            ```
+            
+            ## Links
+            
+            - [NPM Package](https://www.npmjs.com/package/@tfkedar/lazydocs)
+            - [Documentation](https://github.com/${{ github.repository }}#readme)
+            - [Changelog](https://github.com/${{ github.repository }}/blob/main/CHANGELOG.md)
+          draft: false
+          prerelease: false
+          files: |
+            lazydocs-${{ steps.get_version.outputs.VERSION }}.tar.gz
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

package/CHANGELOG.md

@@ -0,0 +1,137 @@
+# Changelog
+
+All notable changes to LazyDocs will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.2.1] - 2025-01-07
+
+### Fixed
+- Template files (.hbs) now included in npm package
+- Added copy-templates script to build process
+- Updated .npmignore to ensure dist/t/ folder is included
+
+### Technical
+- Build script now copies Handlebars templates to dist folder
+- Fixes "ENOENT: no such file or directory" error when generating README
+
+## [1.2.0] - 2025-01-07
+
+### Changed
+- Removed all emojis from console output for better terminal compatibility
+- Cleaned up code comments and removed external references
+- Updated README to minimal, focused version
+- Improved package description
+- Updated web landing page with modern design
+
+### Removed
+- Dead code and unused files
+- Empty test folders
+- Implementation documentation files
+- Emoji from postinstall message
+
+### Fixed
+- GitHub Actions release workflow permissions
+- Updated to use softprops/action-gh-release@v1
+
+### Technical
+- All TypeScript files compile without errors
+- Optimized code organization
+- Better error messages
+- Improved code maintainability
+
+## [1.1.0] - 2025-01-06
+
+### Added
+- Token-efficient code analysis (handles 100+ file projects)
+- Automatic retry logic with exponential backoff (3 attempts)
+- Structured prompt engineering for better output
+- Compact summaries for large codebases
+- Enhanced error messages with actionable solutions
+- File statistics tracking
+- Smart code truncation
+
+### Changed
+- Improved AI integration with better error handling
+- Enhanced prompt structure for consistent output
+- Better token management
+
+## [1.0.3] - 2025-01-05
+
+### Added
+- Professional landing page (web/)
+- Modern, responsive design with dark theme
+- Interactive features and animations
+
+### Changed
+- Improved config system
+- Better validation with helpful error messages
+- API key format validation (must start with gsk_)
+- Config value masking for security
+
+### Added
+- New config delete command
+- Support for more config options (TIMEOUT, GENERATE_COUNT)
+
+## [1.0.2] - 2025-01-04
+
+### Added
+- Dynamic model fetching from Groq API
+- lazydocs models --refresh to get latest models
+- Interactive mode now shows all available models
+
+### Changed
+- Updated default model to llama-3.3-70b-versatile
+- Added support for OpenAI models (gpt-oss-120b, gpt-oss-20b)
+- All models support 131K+ context windows
+- Automatic fallback if API fetch fails
+
+### Improved
+- Simplified README (professional yet casual)
+- Better model descriptions
+- Cleaner package structure
+
+## [1.0.1] - 2025-01-03
+
+### Changed
+- Reduced package size from 27.4 KB to 15.8 KB (42% smaller)
+- Optimized .npmignore to exclude non-essential files
+- Improved .gitignore for better development experience
+
+### Improved
+- Simplified README for better readability
+- Created concise QUICK_START guide
+- Better file organization
+
+## [1.0.0] - 2025-01-02
+
+### Added
+- Initial release of LazyDocs
+- AI-powered documentation generation using Groq API
+- Support for README, PR descriptions, and changelog generation
+- Multi-file type support (.js, .ts, .jsx, .tsx, .mjs, .cjs, .py)
+- Interactive CLI mode
+- Multiple AI model selection
+- Configurable AI parameters (temperature, max tokens)
+- Recursive directory scanning
+- Smart code analysis with Babel parser
+- Handlebars templating system
+- Configuration management (~/.lazydocs)
+- Project initialization command
+- Comprehensive error handling with retry logic
+
+### Documentation
+- Complete README with examples
+- API documentation
+- Contributing guidelines
+- Installation instructions
+
+### Testing
+- Unit tests for code analyzer
+- Unit tests for AI integration
+- Test fixtures and utilities
+
+---
+
+*Generated by LazyDocs*