ai-changelog-generator-extension 0.4.0

package/.vscode/launch.json

@@ -0,0 +1,41 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "Run Extension",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": [
+        "--extensionDevelopmentPath=${workspaceFolder}"
+      ],
+      "outFiles": [
+        "${workspaceFolder}/out/**/*.js"
+      ],
+      "preLaunchTask": "${defaultBuildTask}"
+    },
+    {
+      "name": "Run Extension (No Build)",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": [
+        "--extensionDevelopmentPath=${workspaceFolder}"
+      ],
+      "outFiles": [
+        "${workspaceFolder}/out/**/*.js"
+      ]
+    },
+    {
+      "name": "Extension Tests",
+      "type": "extensionHost",
+      "request": "launch",
+      "args": [
+        "--extensionDevelopmentPath=${workspaceFolder}",
+        "--extensionTestsPath=${workspaceFolder}/out/test/suite/index"
+      ],
+      "outFiles": [
+        "${workspaceFolder}/out/test/**/*.js"
+      ],
+      "preLaunchTask": "${defaultBuildTask}"
+    }
+  ]
+}

package/.vscode/settings.json

@@ -0,0 +1,15 @@
+{
+  "editor.formatOnSave": true,
+  "editor.codeActionsOnSave": {
+    "source.fixAll.eslint": "explicit"
+  },
+  "typescript.tsdk": "node_modules/typescript/lib",
+  "files.exclude": {
+    "out": false,
+    "node_modules": true
+  },
+  "search.exclude": {
+    "out": true,
+    "node_modules": true
+  }
+}

package/.vscode/tasks.json

@@ -0,0 +1,26 @@
+{
+  "version": "2.0.0",
+  "tasks": [
+    {
+      "type": "npm",
+      "script": "watch",
+      "problemMatcher": "$tsc-watch",
+      "isBackground": true,
+      "presentation": {
+        "reveal": "never"
+      },
+      "group": {
+        "kind": "build",
+        "isDefault": true
+      },
+      "label": "npm: watch"
+    },
+    {
+      "type": "npm",
+      "script": "compile",
+      "problemMatcher": "$tsc",
+      "group": "build",
+      "label": "npm: compile"
+    }
+  ]
+}

package/.vscodeignore

@@ -0,0 +1,62 @@
+# VS Code Extension packaging ignore file
+
+# Parent directory files
+../**
+**/vitest.config.js
+
+# Build artifacts
+.vscode-test/**
+.vscode-test-web/**
+out/test/**
+
+# Development files
+.vscode/**
+.vscode-test/**
+src/**
+tsconfig.json
+setup.sh
+*.sh
+
+# Documentation (keep some, remove dev docs)
+DEVELOPMENT.md
+IMPLEMENTATION_SUMMARY.md
+MIGRATION_CHECKLIST.md
+
+# Git
+.git
+.gitignore
+.gitattributes
+
+# Node - Keep dependencies but exclude dev dependencies
+node_modules/**/test/**
+node_modules/**/tests/**
+node_modules/**/*.md
+node_modules/**/.editorconfig
+node_modules/**/.eslintrc*
+node_modules/**/LICENSE
+node_modules/**/CHANGELOG*
+!node_modules/@entro314labs/**
+
+# Logs
+*.log
+npm-debug.log*
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Testing
+**/*.test.ts
+**/*.test.js
+test/**
+coverage/**
+
+# Config files
+.eslintrc*
+.prettierrc*
+.editorconfig
+
+# Misc
+*.vsix
+.env
+.env.local

package/ARCHITECTURE-v0.4.0.md

@@ -0,0 +1,418 @@
+# v0.4.0 Architecture Overview
+
+## Component Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                     VSCode Extension                        │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  ┌─────────────────────────────────────────────────────┐   │
+│  │              extension.ts (Main)                    │   │
+│  │  • Activation logic                                 │   │
+│  │  • First-run detection                              │   │
+│  │  • Command registration                             │   │
+│  └──────────┬──────────────────────────────────────────┘   │
+│             │                                               │
+│             ├─────────────┬──────────────┬─────────────┐    │
+│             ▼             ▼              ▼             ▼    │
+│  ┌──────────────┐  ┌──────────┐  ┌──────────┐  ┌─────────┐│
+│  │ Onboarding   │  │ Settings │  │  Commit  │  │Release  ││
+│  │   Panel      │  │  Panel   │  │ Sidebar  │  │Sidebar  ││
+│  │  Provider    │  │ Provider │  │ Provider │  │Provider ││
+│  │              │  │          │  │          │  │         ││
+│  │ (NEW v0.4)   │  │(existing)│  │(existing)│  │(existing││
+│  └──────┬───────┘  └────┬─────┘  └────┬─────┘  └────┬────┘│
+│         │               │             │             │      │
+│         │               └─────────────┴─────────────┘      │
+│         │                           │                      │
+│         └───────────────────────────┼──────────────────────┤
+│                                     ▼                       │
+│              ┌────────────────────────────────────┐         │
+│              │  Configuration & Services          │         │
+│              ├────────────────────────────────────┤         │
+│              │ • ExtensionConfigurationManager    │         │
+│              │ • StatusService                    │         │
+│              │ • EnvFileService                   │         │
+│              │ • Core AI Changelog Package        │         │
+│              └────────────────────────────────────┘         │
+│                                                             │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Onboarding Flow
+
+```
+Installation
+    │
+    ▼
+First Activation
+    │
+    ▼
+Setup Complete? ──No──► Open Onboarding Panel ──────┐
+    │                         │                      │
+   Yes                        │                      │
+    │                         ▼                      │
+    │                   ┌──────────────┐             │
+    │                   │   Step 1:    │             │
+    │                   │   Storage    │             │
+    │                   │   Selection  │             │
+    │                   └──────┬───────┘             │
+    │                          │                     │
+    │                          ▼                     │
+    │                   ┌──────────────┐             │
+    │                   │   Step 2:    │             │
+    │                   │   Provider   │             │
+    │                   │   Selection  │             │
+    │                   └──────┬───────┘             │
+    │                          │                     │
+    │                          ▼                     │
+    │                   ┌──────────────┐             │
+    │                   │   Step 3:    │             │
+    │                   │     API      │             │
+    │                   │  Configure   │             │
+    │                   └──────┬───────┘             │
+    │                          │                     │
+    │                          ▼                     │
+    │                   ┌──────────────┐             │
+    │                   │   Step 4:    │             │
+    │                   │   Review &   │             │
+    │                   │   Complete   │             │
+    │                   └──────┬───────┘             │
+    │                          │                     │
+    │                          ▼                     │
+    │                   Save Configuration           │
+    │                          │                     │
+    │                          ▼                     │
+    │                   Set setupCompleted = true    │
+    │                          │                     │
+    └──────────────────────────┴─────────────────────┤
+                               │                     │
+                               ▼                     │
+                        Extension Ready              │
+                               │                     │
+                    ┌──────────┴──────────┐          │
+                    ▼                     ▼          │
+              Commit View          Release View      │
+                                                     │
+                                    Skip ────────────┘
+                                    Setup
+```
+
+## Message Flow (Onboarding ↔ Extension)
+
+```
+┌─────────────────┐                    ┌──────────────────────┐
+│   Webview UI    │                    │   Extension Host     │
+│  (JavaScript)   │                    │   (TypeScript)       │
+└────────┬────────┘                    └──────────┬───────────┘
+         │                                        │
+         │  1. User clicks "Test Storage"        │
+         ├──────────────────────────────────────►│
+         │  { type: 'testStorageMode',           │
+         │    mode: 'secrets' }                  │
+         │                                        │
+         │                         Validate       │
+         │                         Storage ◄──────┤
+         │                                        │
+         │  2. Validation result                 │
+         │◄──────────────────────────────────────┤
+         │  { type: 'validationResult',          │
+         │    step: 'storage',                   │
+         │    success: true,                     │
+         │    message: '✅ ...' }                │
+         │                                        │
+         │  3. Show feedback to user             │
+         ├─► Display green message               │
+         │                                        │
+         │  4. User completes all steps          │
+         ├──────────────────────────────────────►│
+         │  { type: 'saveConfiguration',         │
+         │    config: {...} }                    │
+         │                                        │
+         │                         Save to        │
+         │                         VSCode ◄───────┤
+         │                         Settings       │
+         │                                        │
+         │  5. Save complete                     │
+         │◄──────────────────────────────────────┤
+         │  { type: 'saveComplete',              │
+         │    success: true }                    │
+         │                                        │
+         │  6. Close panel after 2s              │
+         ├─► Auto-close                          │
+         │                                        │
+         └────────────────────────────────────────┘
+```
+
+## Data Flow
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                      User Input                             │
+└─────────────────┬───────────────────────────────────────────┘
+                  │
+                  ▼
+┌─────────────────────────────────────────────────────────────┐
+│              Webview State (JavaScript)                     │
+│  • config.storageMode                                       │
+│  • config.provider                                          │
+│  • config.apiKey                                            │
+│  • config.model                                             │
+│  • config.azureEndpoint                                     │
+│  • config.ollamaHost                                        │
+└─────────────────┬───────────────────────────────────────────┘
+                  │
+                  ▼
+┌─────────────────────────────────────────────────────────────┐
+│          Message to Extension (postMessage)                 │
+└─────────────────┬───────────────────────────────────────────┘
+                  │
+                  ▼
+┌─────────────────────────────────────────────────────────────┐
+│      OnboardingPanelProvider (TypeScript)                   │
+│  • _testStorageMode()                                       │
+│  • _testProvider()                                          │
+│  • _testApiKey()                                            │
+│  • _saveConfiguration()                                     │
+└─────────────────┬───────────────────────────────────────────┘
+                  │
+                  ├─────────────┬─────────────┬────────────┐
+                  ▼             ▼             ▼            ▼
+    ┌──────────────────┐  ┌──────────┐  ┌─────────┐  ┌────────┐
+    │ Configuration    │  │  Status  │  │  Env    │  │VSCode  │
+    │     Manager      │  │ Service  │  │ Service │  │Settings│
+    └──────────────────┘  └──────────┘  └─────────┘  └────────┘
+              │                 │            │            │
+              └─────────────────┴────────────┴────────────┘
+                                │
+                                ▼
+                  ┌──────────────────────────┐
+                  │  VSCode Secure Storage   │
+                  │  or .env file            │
+                  │  or settings.json        │
+                  └──────────────────────────┘
+```
+
+## State Management
+
+```
+Step State:
+┌─────────────────────────────────────────┐
+│ currentStep: 1, 2, 3, or 4              │
+│ config: {                               │
+│   storageMode: 'secrets'|'env'|'...'    │
+│   provider: 'openai'|'anthropic'|'...'  │
+│   apiKey: string                        │
+│   model: string (optional)              │
+│   azureEndpoint: string (if Azure)      │
+│   ollamaHost: string (if Ollama)        │
+│   ...                                   │
+│ }                                       │
+└─────────────────────────────────────────┘
+
+Validation State (per field):
+┌─────────────────────────────────────────┐
+│ success: true | false | null            │
+│ message: string                         │
+│ visible: boolean                        │
+│ type: 'success'|'error'|'loading'       │
+└─────────────────────────────────────────┘
+
+UI State:
+┌─────────────────────────────────────────┐
+│ Progress: (step - 1) / 3 * 100%         │
+│ Step indicators: completed|active|future│
+│ Active step visibility: block|none      │
+│ Button states: enabled|disabled         │
+│ Provider fields: show|hide              │
+└─────────────────────────────────────────┘
+```
+
+## Validation Architecture
+
+```
+User Action
+    │
+    ▼
+┌────────────────────────┐
+│  Test Button Clicked   │
+└──────────┬─────────────┘
+           │
+           ▼
+┌────────────────────────┐
+│  Show Loading State    │  ← Immediate UI feedback
+└──────────┬─────────────┘
+           │
+           ▼
+┌────────────────────────┐
+│  Post Message to       │
+│  Extension             │
+└──────────┬─────────────┘
+           │
+           ▼
+┌────────────────────────┐
+│  Extension Receives    │
+│  Message               │
+└──────────┬─────────────┘
+           │
+           ▼
+┌────────────────────────┐
+│  Call Validation       │
+│  Service               │
+│  • EnvFileService      │
+│  • ConfigManager       │
+│  • Fetch API           │
+└──────────┬─────────────┘
+           │
+           ├──Success────┐
+           │             │
+           ▼             ▼
+    ┌──────────┐   ┌──────────┐
+    │  Error   │   │  Success │
+    └────┬─────┘   └────┬─────┘
+         │              │
+         └──────┬───────┘
+                │
+                ▼
+    ┌────────────────────────┐
+    │  Send Result to        │
+    │  Webview               │
+    └──────────┬─────────────┘
+               │
+               ▼
+    ┌────────────────────────┐
+    │  Show Success/Error    │
+    │  Message               │
+    └────────────────────────┘
+```
+
+## File Organization
+
+```
+vscode-extension/
+├── src/
+│   ├── extension.ts              ← Entry point, registers providers
+│   ├── views/
+│   │   ├── OnboardingPanelProvider.ts  ← NEW v0.4.0 (520 lines)
+│   │   ├── SettingsPanelProvider.ts    ← Existing (unchanged)
+│   │   ├── CommitSidebarProvider.ts    ← Existing
+│   │   └── ReleaseSidebarProvider.ts   ← Existing
+│   ├── services/
+│   │   ├── ExtensionConfigurationManager.ts
+│   │   ├── StatusService.ts
+│   │   └── EnvFileService.ts
+│   └── commands/
+│       ├── setupWizard.ts         ← Still used by CLI mode
+│       ├── testConnection.ts
+│       └── configureProvider.ts
+├── out/                           ← Compiled JavaScript
+└── package.json                   ← Extension manifest
+```
+
+## Component Responsibilities
+
+### OnboardingPanelProvider (NEW)
+**Responsibilities:**
+- Render full-screen onboarding UI
+- Handle user interactions (clicks, inputs)
+- Validate each step
+- Communicate with extension host
+- Manage wizard state
+- Show success/error feedback
+
+**Does NOT:**
+- Store configuration directly
+- Make API calls (delegates to services)
+- Manage global extension state
+
+### ExtensionConfigurationManager
+**Responsibilities:**
+- Load/save VSCode settings
+- Store/retrieve API keys from secure storage
+- Check if setup is complete
+- Initialize core AI package
+
+**Used By:**
+- OnboardingPanelProvider
+- SettingsPanelProvider
+- All other providers
+
+### StatusService
+**Responsibilities:**
+- Log extension activity
+- Show status bar item
+- Display status reports
+- Manage output channel
+
+**Updated By:**
+- OnboardingPanelProvider (logs validation)
+- All other components
+
+### EnvFileService
+**Responsibilities:**
+- Detect .env files in workspace
+- Parse environment variables
+- Extract API keys
+
+**Called By:**
+- OnboardingPanelProvider (when testing storage mode)
+- Extension activation (auto-detect)
+
+## Why This Architecture?
+
+### Separation of Concerns
+- ✅ UI logic in webview (HTML/CSS/JS)
+- ✅ Business logic in TypeScript (providers)
+- ✅ Data persistence in services
+- ✅ Clear boundaries
+
+### Reusability
+- ✅ Validation services shared
+- ✅ Configuration manager reused
+- ✅ Status service used everywhere
+- ✅ No duplication
+
+### Testability
+- ✅ Each component has clear inputs/outputs
+- ✅ Services can be mocked
+- ✅ Webview can be tested independently
+- ✅ Message protocol well-defined
+
+### Maintainability
+- ✅ One file per provider
+- ✅ Clear naming conventions
+- ✅ TypeScript type safety
+- ✅ Well-documented
+
+### Extensibility
+- ✅ Easy to add new providers
+- ✅ Easy to add validation steps
+- ✅ Easy to add new panels
+- ✅ Doesn't break existing code
+
+## Performance Considerations
+
+### Lazy Loading
+- Steps rendered but hidden (display:none)
+- No unnecessary re-renders
+- Fast step transitions
+
+### Efficient Communication
+- Messages only when needed
+- No polling
+- Batch updates when possible
+
+### Minimal Dependencies
+- Uses built-in VSCode APIs
+- No heavy external libraries
+- Small bundle size (84 KB)
+
+---
+
+This architecture ensures:
+1. **Clean code** - Easy to read and maintain
+2. **Good UX** - Fast, responsive, clear feedback
+3. **Extensible** - Easy to add features
+4. **Reliable** - TypeScript safety, error handling
+5. **Professional** - Follows VSCode best practices

package/CHANGELOG.md

@@ -0,0 +1,28 @@
+# Change Log
+
+All notable changes to the "AI Changelog Generator" extension will be documented in this file.
+
+## [0.1.0] - 2026-01-10
+
+### Added
+- Initial release
+- AI-powered commit message generation
+- Changelog generation from git history
+- Support for multiple AI providers (OpenAI, Anthropic, Google, Azure, Ollama)
+- Secure API key storage using VS Code Secret Storage
+- Sidebar panels for Commit Assistant and Release Manager
+- Git integration with working directory analysis
+- Interactive commit message selection
+
+### Features
+- Generate commit messages from staged/unstaged changes
+- Create release changelogs with version tagging
+- Configure AI provider and model preferences
+- Real-time file change analysis
+- Integration with VS Code's built-in Git extension
+
+### Technical
+- Built on @entro314labs/ai-changelog-generator v3.7.1
+- TypeScript implementation with full type safety
+- Webview-based UI for rich interactions
+- Extensible architecture for future enhancements