Merge dev branch for v0.3.0 release

Major changes:
- Migrate documentation from Docusaurus to Astro
- Modern CLI interface with pflag
- Global configuration support
- Performance improvements
- Comprehensive test coverage

Author: 1broseidon

.github/workflows/deploy-docs.yml

@@ -1,11 +1,11 @@
-name: Deploy Docusaurus Documentation
+name: Deploy Astro Documentation
 
 on:
   push:
     branches:
       - main
     paths:
-      - "docs/**"
+      - "docs-astro/**"
 
 permissions:
   contents: write
@@ -16,35 +16,33 @@ jobs:
     runs-on: ubuntu-latest
     defaults:
       run:
-        working-directory: docs
+        working-directory: docs-astro
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
       - name: Setup Node.js
         uses: actions/setup-node@v4
         with:
-          node-version: 18
-          cache: npm
-          cache-dependency-path: docs/package-lock.json
-
+          node-version: 20
+          
+      - name: Setup pnpm
+        uses: pnpm/action-setup@v3
+        with:
+          version: 8
+          
       - name: Install dependencies
         run: |
-          npm ci
-
-      - name: Lint and test
-        run: |
-          npm run lint || echo "Lint script not defined"
-          npm test || echo "Test script not defined"
+          pnpm install
 
       - name: Build website
         run: |
-          npm run build
+          pnpm run build
 
       - name: Deploy to GitHub Pages
         uses: peaceiris/actions-gh-pages@v3
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: docs/build
+          publish_dir: docs-astro/dist
           user_name: github-actions[bot]
           user_email: 41898282+github-actions[bot]@users.noreply.github.com

.gitignore

@@ -1,12 +1,84 @@
-.aider*
+# Binaries
+promptext
+prx
+*.exe
+*.exe~
+*.dll
+*.so
+*.dylib
+
+# Test binaries, built with `go test -c`
+*.test
+
+# Output of the go coverage tool, specifically when used with LiteIDE
+*.out
+
+# Go workspace file
+go.work
+go.work.sum
+
+# Dependency directories (Node.js for docs)
+**/node_modules/
+docs/node_modules/
+
+# Environment files
 .env
+.env.local
+.env.production
+.env.staging
+
+# Build outputs
 dist/
-.release-env
+build/
 _site/
+
+# Configuration files (local/personal)
+.promptext.yml
+
+# Development tools
+.aider*
+.release-env
+.jira-config.json
+
+# IDE/Editor files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS generated files
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Documentation build (Jekyll/Docusaurus)
 .sass-cache/
 .jekyll-cache/
 .jekyll-metadata
 docs-old/
-**/node_modules/
-.jira-config.json
-.promptext.yml
+
+# Claude Code related
+CLAUDE.md
+.claude/
+
+# Test coverage
+coverage.out
+coverage.html
+
+# Temporary files
+*.tmp
+*.temp
+temp/
+tmp/
+
+# Log files
+*.log
+
+# Cache directories
+.cache/
+.tiktoken_cache/

CHANGELOG.md

@@ -0,0 +1,45 @@
+# Changelog
+
+## [0.3.0] - 2025-08-31
+
+### Major Changes
+- **New Documentation System**: Migrated from Docusaurus to Astro for better performance and maintainability
+- **Modern CLI Interface**: Complete refactoring with pflag for better flag handling and POSIX compliance
+- **Global Configuration Support**: Added support for global and project-level configuration files
+- **Performance Improvements**: Major refactoring for better performance on large codebases
+
+### Features
+- Implemented modern CLI interface with improved help text and flag descriptions
+- Added global configuration support with proper precedence (CLI flags > project config > global config)
+- Enhanced .gitignore patterns with comprehensive Go CLI project support
+- Improved configuration merging logic for better flexibility
+- Added support for XDG_CONFIG_HOME standard for configuration paths
+
+### Bug Fixes
+- Fixed CLI flag mapping for version and verbose options
+- Corrected angle bracket escaping in MDX documentation
+- Fixed configuration precedence issues
+
+### Documentation
+- Migrated to Astro-based documentation system
+- Updated GitHub Actions workflow for new documentation deployment
+- Improved documentation structure and navigation
+
+### Internal Improvements
+- Refactored internal modules for better separation of concerns
+- Enhanced test coverage for configuration and flag handling
+- Improved error handling and user-friendly messages
+- Better cross-platform compatibility
+
+### Breaking Changes
+- None - this release maintains backward compatibility
+
+### Migration Notes
+- The documentation has moved to a new Astro-based system
+- Configuration files now support both global and project-level settings
+- CLI flags have been standardized for better consistency
+
+---
+
+## [0.2.6] - Previous Release
+- Last stable release before major refactoring