ai-changelog-generator-extension 0.4.0

package/QUICK-START.md

@@ -0,0 +1,211 @@
+# Quick Start Guide - v0.2.0
+
+## 🚀 Installation
+
+1. Install the VSIX file:
+   ```bash
+   code --install-extension ai-changelog-generator-extension-0.2.0.vsix
+   ```
+
+2. Or install from VSCode:
+   - Open Extensions (Cmd+Shift+X)
+   - Click "..." menu → "Install from VSIX"
+   - Select `ai-changelog-generator-extension-0.2.0.vsix`
+
+## 🎯 First Time Setup (Improved!)
+
+### Step 1: Launch Setup Wizard
+- Extension automatically prompts on first activation
+- Or run: **Command Palette** → `AI Changelog: Setup Wizard`
+
+### Step 2: Follow the 3-Step Process
+
+**Step 1 of 3: Choose Storage**
+- 🔒 **Secure Storage** (Recommended) - VSCode secret storage
+- 📄 **Environment File** - .env.local in workspace
+- ⚙️ **Settings File** - settings.json (not recommended)
+
+**Step 2 of 3: Select Provider**
+Choose from:
+- OpenAI (GPT-4, GPT-4 Turbo, GPT-4o)
+- Anthropic (Claude 3.5 Sonnet, Opus)
+- Google (Gemini Pro, Ultra)
+- Azure OpenAI
+- AWS Bedrock
+- Ollama (local)
+- LM Studio (local)
+
+**Step 3 of 3: Enter Credentials**
+- Enter API key (validated for length)
+- Azure users: also enter endpoint and deployment
+- Local providers: configure host URL
+
+### Step 3: Test Connection
+After setup, click **"Test Now"** to verify everything works!
+
+## 📊 Check Your Status
+
+### Status Bar Indicator
+Look at the bottom-right of VSCode:
+- ✅ **AI Changelog: Ready** - All configured and working
+- ⚠️ **AI Changelog: Setup Required** - Needs configuration
+- ❌ **AI Changelog: Error** - Something's wrong
+
+**Click the status bar** to see detailed report!
+
+### View Detailed Status
+Run: `AI Changelog: Show Status`
+
+You'll see:
+```markdown
+# AI Changelog Generator Status
+
+## Configuration Status
+✅ Setup completed
+✅ Provider configured: openai
+✅ API key configured
+✅ Storage mode: secrets
+
+## Provider Details
+- Provider: OpenAI
+- Model: gpt-4-turbo
+- Available: Yes
+
+## Recommendations
+✓ Everything looks good! You're ready to generate commits and changelogs.
+```
+
+## 🔍 Test Your Connection
+
+Run: `AI Changelog: Test Connection`
+
+**Success:**
+```
+✅ Connection test successful!
+Provider: OpenAI
+Response time: 847ms
+
+Configuration is working correctly.
+```
+
+**Failure:**
+```
+❌ Connection test failed
+Provider: OpenAI
+Error: Invalid API key
+
+[Open Logs]  [Reconfigure]
+```
+
+## 📝 View Logs
+
+Run: `AI Changelog: Show Logs`
+
+See exactly what the extension is doing:
+```
+[2024-01-15 10:30:00] Extension activation started
+[2024-01-15 10:30:01] Setup complete: true
+[2024-01-15 10:30:01] Configuration loaded successfully
+[2024-01-15 10:30:02] Status bar updated: Ready
+```
+
+## 🎨 Using the Extension
+
+### Generate Commit Messages
+
+1. Make changes to your files
+2. Open **Source Control** sidebar
+3. Click **"AI Changelog: Commit Assistant"** panel
+4. Review changed files
+5. Click **"Generate Commit Message"**
+6. AI analyzes changes and suggests commit message
+7. Copy or edit as needed
+
+### Generate Release Notes
+
+1. Open **"AI Changelog: Release Manager"** panel
+2. View available tags
+3. Select tag range (e.g., v1.0.0...v2.0.0)
+4. Click **"Generate Changelog"**
+5. AI analyzes all commits in range
+6. Get formatted changelog with categories
+
+## 🔧 Troubleshooting
+
+### Status Bar Shows ⚠️
+**Problem:** Setup not complete
+**Solution:** Run `AI Changelog: Setup Wizard`
+
+### Status Bar Shows ❌
+**Problem:** Configuration error
+**Solutions:**
+1. Click status bar to see detailed error
+2. Run `AI Changelog: Show Logs` for details
+3. Run `AI Changelog: Test Connection` to verify
+4. Re-run setup wizard if needed
+
+### Connection Test Fails
+**Solutions:**
+1. Check API key is correct
+2. Verify provider endpoint (Azure/Bedrock)
+3. Check network connection
+4. View logs for detailed error
+5. Try reconfiguring with setup wizard
+
+### .env File Not Detected
+**Solution:**
+- Ensure .env or .env.local exists in workspace root
+- Run `AI Changelog: Detect Environment Variables`
+- Or manually configure in setup wizard
+
+## 💡 Pro Tips
+
+1. **Keep Status Bar Visible** - Always know your configuration state
+2. **Test After Setup** - Verify everything works immediately
+3. **Check Logs** - When something doesn't work, logs show exactly what happened
+4. **Use .env Files** - Easier to manage and share configurations
+5. **Click Status Bar** - Quick access to detailed status report
+
+## 📚 Command Reference
+
+| Command | Purpose | When to Use |
+|---------|---------|-------------|
+| `AI Changelog: Setup Wizard` | Initial configuration | First time or reconfigure |
+| `AI Changelog: Test Connection` | Verify AI provider | After setup or when unsure |
+| `AI Changelog: Show Status` | View configuration | Check what's configured |
+| `AI Changelog: Show Logs` | View activity logs | Troubleshooting |
+| `AI Changelog: Configure AI Provider` | Change provider | Switch providers |
+| `AI Changelog: Detect Environment Variables` | Find .env keys | Import existing keys |
+| `AI Changelog: Generate Commit Message` | Create commit | When ready to commit |
+| `AI Changelog: Generate Release` | Create changelog | Preparing release |
+
+## 🎯 What's Different from v0.1.0?
+
+### Before (v0.1.0)
+- ❌ No feedback - didn't know if setup worked
+- ❌ Silent failures - errors hidden
+- ❌ No testing - couldn't verify configuration
+- ❌ No visibility - unclear what's configured
+
+### Now (v0.2.0)
+- ✅ Status bar - always know the state
+- ✅ Test connection - verify it works
+- ✅ Detailed reports - see configuration
+- ✅ Comprehensive logs - understand what's happening
+- ✅ Better errors - clear messages with solutions
+- ✅ Progress indicators - know what's happening
+
+## Need Help?
+
+1. **Check Status Bar** - See current state
+2. **View Status Report** - Detailed configuration
+3. **Test Connection** - Verify provider works
+4. **Check Logs** - See what's happening
+5. **Re-run Setup** - Start fresh if needed
+
+---
+
+**Version:** 0.2.0
+**Package:** ai-changelog-generator-extension-0.2.0.vsix
+**Size:** 44.65 KB
+**Ready to use!** 🚀

package/README.md

@@ -0,0 +1,95 @@
+# AI Changelog Generator - VS Code Extension
+
+AI-powered changelog and commit message generator integrated directly into VS Code.
+
+## Features
+
+- 🤖 **AI Commit Messages** - Generate meaningful commit messages from your staged changes
+- 📝 **Smart Changelog Generation** - Create professional changelogs with one click
+- 🔄 **Multiple AI Providers** - Supports OpenAI, Anthropic, Google, Azure, and more
+- 🔒 **Secure API Key Storage** - Keys stored in VS Code's secret storage
+- 🎯 **Git Integration** - Works seamlessly with VS Code's built-in Git
+
+## Installation
+
+1. Install from VS Code Marketplace
+2. Run command: `AI Changelog: Configure AI Provider`
+3. Select your preferred AI provider and enter API key
+4. Start generating!
+
+## Usage
+
+### Generate Commit Message
+
+1. Stage your changes in VS Code's Source Control panel
+2. Open the AI Changelog sidebar
+3. Click "Generate Commit Message"
+4. Select from AI-generated suggestions
+
+### Create Release
+
+1. Open Release Manager in the sidebar
+2. Click "Draft New Release"
+3. Enter version number
+4. AI generates changelog from commits since last tag
+
+## Configuration
+
+Configure in VS Code Settings (search for "AI Changelog"):
+
+- `aiChangelog.provider` - AI provider (openai, anthropic, etc.)
+- `aiChangelog.model` - Override default model
+- `aiChangelog.temperature` - Control creativity (0.0-1.0)
+
+## Requirements
+
+- Node.js >= 22.21.1
+- Git repository
+- API key for chosen AI provider
+
+## Supported AI Providers
+
+- **OpenAI** (GPT-4.1, o3, o4)
+- **Anthropic** (Claude 3.5 Sonnet, Opus)
+- **Google** (Gemini 2.0)
+- **Azure OpenAI**
+- **AWS Bedrock**
+- **Ollama** (Local models)
+- **LM Studio** (Local models)
+
+## Extension Settings
+
+This extension contributes the following settings:
+
+* `aiChangelog.provider`: Select AI provider
+* `aiChangelog.model`: Override default model
+* `aiChangelog.temperature`: Control generation creativity
+
+## Known Issues
+
+- First-time setup requires manual API key entry
+- Large diffs may take longer to analyze
+
+## Release Notes
+
+### 0.1.0
+
+Initial release:
+- Commit message generation
+- Changelog generation
+- Multi-provider support
+- Secure key storage
+
+## Development
+
+Built on top of [@entro314labs/ai-changelog-generator](https://www.npmjs.com/package/@entro314labs/ai-changelog-generator)
+
+## License
+
+MIT
+
+## Links
+
+- [GitHub Repository](https://github.com/entro314-labs/ai-changelog-generator-vscode)
+- [Report Issues](https://github.com/entro314-labs/ai-changelog-generator-vscode/issues)
+- [Core Package](https://github.com/entro314-labs/AI-changelog-generator)

package/RELEASE-NOTES-0.2.0.md

@@ -0,0 +1,176 @@
+# VSCode Extension - Version 0.2.0 Updates
+
+## What's New
+
+### 🎯 Major Improvements
+
+**1. Status Bar Indicator**
+- Added persistent status bar icon showing extension configuration state
+- Visual indicators: ✅ (ready), ⚠️ (needs setup), ❌ (error)
+- Click to view detailed status report
+- Always visible so you know at a glance if everything is working
+
+**2. Connection Testing**
+- New "Test Connection" command to validate AI provider setup
+- Automatically offered after setup wizard completion
+- Tests actual API connectivity with progress indicators
+- Clear success/error feedback with actionable buttons
+- Command: `AI Changelog: Test Connection`
+
+**3. Enhanced Setup Wizard**
+- Now with detailed step indicators (Step 1 of 3, Step 2 of 3, etc.)
+- Better validation with helpful error messages
+- API key length validation
+- More informative progress messages
+- Automatic connection test offer after setup
+- Better error handling and logging
+
+**4. Status Report**
+- Detailed markdown report showing:
+  - ✅ Setup completion status
+  - 🔑 API key configuration
+  - 📦 Storage mode (secrets/env/settings)
+  - 🤖 Selected provider and model
+  - 🎯 Provider availability check
+  - 💡 Actionable recommendations
+- Command: `AI Changelog: Show Status`
+
+**5. Logging System**
+- Output channel for all extension activities
+- View detailed logs to understand what's happening
+- Helpful for troubleshooting
+- Command: `AI Changelog: Show Logs`
+
+## New Commands
+
+1. **AI Changelog: Test Connection** - Test your AI provider connection
+2. **AI Changelog: Show Status** - View detailed configuration status
+3. **AI Changelog: Show Logs** - Open output channel with logs
+
+## Technical Improvements
+
+### StatusService
+- Centralized status management
+- Real-time status bar updates
+- Configuration health checking
+- Structured logging
+- Status report generation
+
+### Enhanced Setup Wizard
+- Step-by-step progress indicators
+- Better validation and error messages
+- Automatic .env detection and import
+- Connection testing integration
+- Comprehensive logging
+
+### Better Error Handling
+- All operations now logged
+- Clear error messages with context
+- Actionable error prompts (buttons to fix issues)
+- No more silent failures
+
+## User Experience Improvements
+
+### Before (v0.1.0)
+- ❌ No way to know if setup worked
+- ❌ No feedback during operations
+- ❌ Silent failures
+- ❌ Unclear what was configured
+- ❌ No way to test if provider works
+
+### After (v0.2.0)
+- ✅ Status bar shows configuration state
+- ✅ Progress indicators during setup
+- ✅ Test connection validates everything works
+- ✅ Detailed status reports available
+- ✅ Comprehensive logging for troubleshooting
+- ✅ Clear error messages with fix suggestions
+- ✅ Always know what's working and what isn't
+
+## How to Use
+
+### First Time Setup
+1. Extension will show welcome message
+2. Click "Start Setup" to begin wizard
+3. Follow 3 simple steps:
+   - Choose storage method
+   - Select AI provider
+   - Enter credentials
+4. Click "Test Now" to verify connection
+5. Check status bar for ✅ indicator
+
+### Check Status Anytime
+- Click status bar icon for detailed report
+- Or run: `AI Changelog: Show Status`
+
+### Test Connection
+- Run: `AI Changelog: Test Connection`
+- Get instant feedback if your provider is working
+
+### View Logs
+- Run: `AI Changelog: Show Logs`
+- See what the extension is doing behind the scenes
+
+## File Changes
+
+### New Files
+- `src/services/StatusService.ts` - Status bar and reporting
+- `src/commands/testConnection.ts` - Connection testing
+
+### Enhanced Files
+- `src/extension.ts` - Integrated status service, logging, new commands
+- `src/commands/setupWizard.ts` - Better UX, validation, testing
+- `package.json` - Added 3 new commands
+
+### Commands Registered
+```json
+{
+  "ai-changelog.testConnection": "Test Connection",
+  "ai-changelog.showStatus": "Show Status",
+  "ai-changelog.showLogs": "Show Logs"
+}
+```
+
+## Testing the Extension
+
+1. Open Extension Development Host (F5)
+2. Run setup wizard or check status bar
+3. Test all new commands:
+   - Test Connection
+   - Show Status
+   - Show Logs
+4. Verify status bar updates correctly
+5. Try different scenarios:
+   - Fresh install (no setup)
+   - After setup completion
+   - With .env file detected
+   - Connection failures
+
+## Build Info
+
+- **Version**: 0.2.0
+- **Package Size**: 44.65 KB (was 35.9 KB - added features)
+- **Files**: 25 files
+- **New Dependencies**: None (no package changes)
+- **Compiled**: ✅ No TypeScript errors
+- **Packaged**: ✅ ai-changelog-generator-extension-0.2.0.vsix
+
+## What This Solves
+
+### Original Issue
+> "needs more work, it is almost unusable, the setup should be more robust and intuitive as well as the setting should have reactiveness and feedback, right now i have no idea what work and what doesnt"
+
+### Resolution
+✅ **Robust Setup** - Step-by-step wizard with validation and error handling
+✅ **Intuitive** - Clear progress indicators, helpful messages, guided flow
+✅ **Reactiveness** - Status bar updates in real-time
+✅ **Feedback** - Progress indicators, success/error messages, logging
+✅ **Know What Works** - Status bar icon, status report, connection testing
+
+## Next Steps
+
+1. Test the extension thoroughly
+2. Verify all commands work as expected
+3. Check that status bar updates correctly
+4. Ensure connection testing works with different providers
+5. Validate error scenarios are handled gracefully