@iservu-inc/adf-cli 0.3.0 → 0.4.12

package/CHANGELOG.md

@@ -5,7 +5,263 @@ All notable changes to `@iservu-inc/adf-cli` 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).
 
-## [Unreleased]
+## [0.4.12] - 2025-10-04
+
+### 🧠 Learning System (Phase 4.2)
+
+**Intelligent Behavior Learning:**
+- Automatically tracks skip and answer patterns during interviews
+- Learns from your behavior across multiple sessions
+- Generates learned rules from high-confidence patterns (≥75%)
+- Applies learned preferences in future interviews with user approval
+- Privacy-first design with all data stored locally in `.adf/learning/`
+
+**Pattern Detection:**
+- **Consistent Skip Patterns** - Questions you repeatedly skip (3+ sessions, 75%+ confidence)
+- **Category Patterns** - Categories you frequently skip (≥80% skip rate)
+- **Framework Patterns** - Framework-specific skip preferences (e.g., routing questions for Next.js)
+- **User Preferences** - Answer style patterns (brief vs detailed answers)
+
+**Learning Management CLI:**
+- New **Learning System** option in `adf config` command
+- **View Skip History** - Most skipped questions and categories across all sessions
+- **Review Patterns** - View detected patterns by confidence level (high/medium/low)
+- **Manage Rules** - Enable, disable, or remove individual learned rules
+- **Settings** - Configure learning system behavior:
+  - Enable/disable learning system
+  - Toggle tracking, pattern detection, and filter application
+  - Adjust confidence thresholds (minSessionsForPattern, minConfidenceForAutoFilter)
+  - Reset to defaults
+- **Clear Data** - Delete all learning data with confirmation prompt
+
+**User Control & Privacy:**
+- Multiple control layers:
+  - System-level: Enable/disable entire learning system
+  - Feature-level: Toggle tracking, detection, and filtering separately
+  - Rule-level: Enable/disable individual learned rules
+  - Session-level: Approve learned preferences before each interview
+- Transparent explanations for all patterns and rules
+- Preview of rules before applying them
+- No external data transmission - all data stays local
+
+**Technical Implementation:**
+- New `lib/learning/storage.js` - Atomic file writes with data persistence
+- New `lib/learning/skip-tracker.js` - Session-based skip and answer tracking
+- New `lib/learning/pattern-detector.js` - Pattern detection algorithms
+- New `lib/learning/rule-generator.js` - Rule generation and application
+- New `lib/learning/learning-manager.js` - CLI interface for learning management
+- Enhanced `lib/filters/question-filter.js` - Learned rule application
+- Enhanced `lib/frameworks/interviewer.js` - Full learning system integration
+- Enhanced `lib/commands/config.js` - Learning System menu integration
+- Comprehensive test coverage (50 new tests, 120 total tests passing)
+
+**Learning Data Structure:**
+- `skip-history.json` - Skip events from all sessions
+- `answer-history.json` - Answer metadata from all sessions
+- `patterns.json` - Detected patterns with confidence scores
+- `learned-rules.json` - Active learned rules
+- `config.json` - Learning system settings
+- `stats.json` - Learning statistics
+
+**Interview Integration:**
+- Shows learning status at interview start (e.g., "Learning: 3 learned rules active")
+- Prompts user to apply learned preferences with rule preview
+- Displays learning-based skips in filtering summary
+- Records all skip and answer events with metadata
+- Detects patterns and updates rules after interview completion
+- Shows pattern detection results to user
+
+**Impact:**
+- Reduces repetitive manual skipping across sessions
+- Improves interview efficiency based on your actual behavior
+- Learns your preferences without explicit configuration
+- Maintains user control and transparency
+- Zero privacy concerns with local-only storage
+
+### 🎯 Smart Question Filtering (Phase 4.1)
+
+**Intelligent Context-Aware Filtering:**
+- Automatically analyzes your project before starting the interview
+- Detects project type (CLI tool, API server, web app, library, fullstack)
+- Identifies frameworks (React, Vue, Angular, Express, NestJS, Django, etc.)
+- Scans package.json, README, and file structure for context
+- Calculates confidence score (0-100%) for analysis accuracy
+
+**Smart Filtering Features:**
+- Skips irrelevant questions based on project type
+  - CLI tools: Skips UI/UX, responsive design, browser questions
+  - API servers: Skips frontend, styling, browser questions
+  - Libraries: Skips deployment, hosting, server questions
+- Framework-specific filtering (e.g., React projects skip Angular questions)
+- Question relevance scoring (0-100) for intelligent filtering
+- Time estimation: Shows minutes saved by skipping irrelevant questions
+
+**User Control:**
+- User can enable/disable smart filtering (default: enabled if confidence ≥ 50%)
+- Shows project analysis before filtering (type, frameworks, confidence)
+- Displays filtering summary (questions kept/skipped, time saved)
+- Fully optional - gracefully degrades if AI not configured
+- Can still manually skip questions with "skip" keyword
+
+**Technical Implementation:**
+- New `lib/analyzers/project-analyzer.js` - Project context analysis
+- New `lib/filters/question-filter.js` - Smart filtering logic
+- Integrated into interviewer workflow with user prompts
+- Comprehensive test coverage (84 tests, all passing)
+
+**Impact:**
+- Reduces interview time by 40-60% for specialized projects
+- Better user experience with relevant questions only
+- Maintains answer quality while saving time
+- Transparent filtering with clear explanations
+
+## [0.3.6] - 2025-10-04
+
+### ⚙️ New Configuration Command
+
+**New `adf config` command:**
+- Centralized configuration management with category-based menu
+- **AI Provider Setup** as first configuration category
+- Green ✓ status indicators for configured items
+- Yellow ○ indicators for unconfigured items
+- Shows current provider name when already configured
+- Easy reconfiguration - run anytime to switch providers or models
+- Extensible design for future configuration categories
+
+**AI Configuration Made Optional:**
+- AI configuration now optional during `adf init`
+- Prompt: "Configure AI provider now? (Enables intelligent follow-up questions)"
+- Can skip and configure later with `adf config`
+- Helpful reminder: "💡 You can configure AI later by running: adf config"
+- Interview works with or without AI (graceful degradation)
+
+### 🎯 UX Improvements
+
+**User Experience Enhancements:**
+- Added visible "skip" instruction hint to every question
+  - Displays `(Type "skip" to skip remaining questions in this block)` below each question
+  - Prevents user frustration by making escape route obvious
+  - Users no longer need to guess how to skip questions
+
+- Improved deployment messaging for clarity
+  - Changed confusing "Next Steps" to clear "Requirements Complete!"
+  - New prompt: "Automatically deploy to your IDE? (I'll configure everything for you)"
+  - Default changed to Yes to encourage automation
+  - Removed misleading manual steps that made deployment seem manual
+  - Emphasizes that adf-cli does ALL the work automatically
+
+**Impact:**
+- More flexible configuration workflow
+- Better user guidance throughout interview process
+- Clearer expectations about automated deployment
+- Reduced confusion and frustration
+
+## [0.3.5] - 2025-10-04
+
+### 🔧 Enhanced AI Configuration
+
+**API Key Persistence (.env):**
+- API keys now saved to `.adf/.env` file (project-local, gitignored)
+- Automatic loading on subsequent runs
+- No need to set environment variables manually
+- Multiple provider keys supported in same file
+- Secure storage with clear warnings
+
+**Dynamic Model Fetching:**
+- **OpenAI**: Fetches real models from your account API
+- **OpenRouter**: Fetches 100+ available models dynamically
+- **Anthropic/Google**: Uses curated default models
+- Graceful fallback to defaults if API call fails
+
+**Autocomplete Model Selection:**
+- Type to filter models in real-time (e.g., type "gpt-4" to see only GPT-4 models)
+- Arrow keys navigate filtered results
+- Shows 10 models at a time for easy browsing
+- Enter to select highlighted model
+
+**New Dependencies:**
+- `inquirer-autocomplete-prompt@2.0.1` - Autocomplete functionality
+- `dotenv@17.2.3` - .env file management
+- `node-fetch@2.7.0` - API calls for model fetching
+
+**User Experience:**
+```
+First time:
+? Enter your API key: [hidden]
+✓ API key saved to: .adf/.env
+⠹ Fetching available models...
+? Select model (type to filter): |
+
+Next time (same project):
+✓ Detected API keys for: Anthropic Claude
+✓ Using API key from .env file
+```
+
+## [0.3.4] - 2025-10-04
+
+### 🤖 Multi-Provider AI Integration
+
+**Major Enhancement: 4 AI Provider Support**
+
+This is a **paradigm shift** - AI connectivity is now **REQUIRED** before the interview starts, enabling real-time answer analysis and intelligent follow-ups.
+
+**Supported Providers:**
+- **Anthropic Claude** (Sonnet 4.5, Claude 3.5, Opus)
+- **OpenAI GPT** (GPT-4-turbo, GPT-4o, GPT-4, GPT-3.5-turbo)
+- **Google Gemini** (2.0-flash-exp, 1.5-pro, 1.5-flash)
+- **OpenRouter** (Multi-model access to 100+ models)
+
+**AI-Powered Features:**
+
+1. **Real-Time Answer Quality Analysis**
+   - AI evaluates every answer for specificity, completeness, clarity, technical depth
+   - Provides 0-100 quality score instantly
+   - Shows suggestions for improvement
+   - Identifies missing elements
+
+2. **Intelligent Follow-Up Questions**
+   - AI generates contextual follow-ups based on answer quality
+   - Questions are specific to what's missing, not generic
+   - Adapts to user's knowledge level and project context
+   - Fallback to heuristic follow-ups if AI unavailable
+
+3. **Provider Configuration Wizard**
+   - Interactive provider selection
+   - API key validation with format checking
+   - Model selection per provider
+   - Connection testing before interview starts
+   - Secure API key handling (never committed)
+
+**New Files:**
+- `lib/ai/ai-config.js` - Provider configuration and setup
+- `lib/ai/ai-client.js` - Unified AI client for all providers
+
+**New Dependencies:**
+- `@anthropic-ai/sdk@0.32.0` - Anthropic Claude support
+- `@google/generative-ai@0.21.0` - Google Gemini support
+- `openai@4.73.0` - OpenAI GPT support
+
+**Interview Flow Changes:**
+```
+OLD:
+1. Detect project type
+2. Select framework
+3. Start interview
+
+NEW:
+1. Detect project type
+2. Select framework
+3. Configure AI Provider (REQUIRED)
+   - Select provider
+   - Enter API key
+   - Test connection
+4. Start AI-guided interview with real-time analysis
+```
+
+**Graceful Degradation:**
+- If AI analysis fails, automatically falls back to heuristic scoring
+- Interview never blocked by AI issues
+- Clear error messages with troubleshooting guidance
 
 ## [0.3.0] - 2025-10-03