@iservu-inc/adf-cli 0.10.0 → 0.12.0

package/CHANGELOG.md

@@ -5,6 +5,347 @@ 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).
 
+## [0.12.0] - 2025-12-22
+
+### 🎯 Agent-Native Development Framework (ANDF) Standard Implementation
+
+**MAJOR FEATURE:** Complete implementation of the ANDF specification, bringing industry-standard AI agent configuration to ADF CLI with enhanced IDE support.
+
+#### What's New
+
+**AGENTS.md Standard Compliance:**
+- **YAML Frontmatter** - Agent metadata with `name`, `description`, and `tools` fields
+- **MCP Tools Configuration** - Model Context Protocol server integration (project_context, archon)
+- **Structured Sections** - 8 ANDF-compliant sections for consistent AI agent guidance
+  - § 1: Operational Rules (High Priority)
+  - § 2: Build & Test Commands
+  - § 3: Project Structure
+  - § 4: Workflow Directives
+  - § 5-8: Framework-specific content (PRP/Balanced/BMAD)
+- **Auto-Discovery** - Next-generation AI tools automatically detect and consume AGENTS.md
+
+**.context/ Directory Support:**
+- **Context Manager** - New utility for managing agent-accessible deep context
+- **architecture.md** - Auto-generated system architecture from session outputs
+  - PRP: Extracts goal, context intelligence, and blueprint
+  - Balanced: Combines specification, plan, and constitution
+  - BMAD: Uses existing architecture or generates from PRD
+- **glossary.md** - Automatically extracts domain terminology from interview transcripts
+- **MCP Access** - Files accessible via Model Context Protocol filesystem server
+
+**Zed Editor Support (NEW):**
+- **Full Generator** - Complete Zed editor configuration generation
+- **MCP Integration** - Context servers configured (project_context, archon)
+- **Agent Configuration** - Model selection based on framework complexity
+  - Rapid: Claude Sonnet + Gemini Flash
+  - Balanced: Mixed models for optimization
+  - Comprehensive: Premium models (Claude Sonnet, Gemini Exp)
+- **Keymap Support** - Agent switching shortcuts (Ctrl+Shift+A, Ctrl+Enter, etc.)
+- **Symlink Strategy** - `.zed/rules -> ../AGENTS.md` (Unix/Mac) with Windows fallback
+
+**Google Antigravity Support (NOW IMPLEMENTED):**
+- **Full Generator** - Complete Antigravity agent configuration
+- **YAML Configuration** - `.antigravity/agents.yaml` with AGENTS.md mount
+- **File System Access** - Read-only access to AGENTS.md, .context/, and sessions
+- **Security** - Excludes sensitive files (.env, node_modules, .git)
+- **Smart System Prompt** - Instructs agent to read AGENTS.md immediately on startup
+- **Model Selection** - Gemini models based on framework (Flash/Thinking/Exp)
+
+#### Enhanced Features
+
+**All Original IDE Support Maintained:**
+- ✅ Windsurf - Full generator (unchanged)
+- ✅ Cursor - Full generator (unchanged)
+- ✅ VS Code / VS Code Insider - Full generator (unchanged)
+- ✅ Kiro, Trae, Claude Code, Gemini CLI, Codex CLI - Generic configs (unchanged)
+- ✅ **Zed** - NEW full generator
+- ✅ **Antigravity** - NEW full generator (previously listed, now implemented)
+
+**Deployment Enhancements:**
+- `.context/` directory created automatically on all deployments
+- AGENTS.md generated with ANDF compliance for all frameworks
+- Architecture and glossary populated from interview data
+- All 11 IDE tools supported with enhanced configurations
+
+#### Technical Details
+
+**New Files:**
+- `lib/utils/context-manager.js` - Context directory management (500+ lines)
+- `lib/generators/zed-generator.js` - Zed editor configurations (250+ lines)
+- `lib/generators/antigravity-generator.js` - Antigravity configurations (150+ lines)
+
+**Modified Files:**
+- `lib/generators/agents-md-generator.js` - ANDF compliance implementation (~250 lines added)
+- `lib/generators/index.js` - Export new generators
+- `lib/commands/deploy.js` - Integrate context manager and new generators
+- `tests/agents-md-generator.test.js` - Updated for ANDF format
+
+**Documentation:**
+- `CLAUDE.md` - Added comprehensive ANDF architecture section
+- `.adf/feature-audit.md` - Feature comparison and gaps analysis
+- `.adf/implementation-plan.md` - Implementation roadmap
+- `.adf/final-summary.md` - Complete implementation summary
+
+#### Keywords Added
+- `zed` - Zed Editor support
+- `antigravity` - Google Antigravity support
+- `andf` - Agent-Native Development Framework
+- `agents-md` - AGENTS.md standard
+- `mcp` - Model Context Protocol
+
+#### Backward Compatibility
+- ✅ **100% Backward Compatible** - All changes are additive
+- ✅ All existing IDE deployments continue to work
+- ✅ No breaking changes to API or CLI commands
+- ✅ Existing sessions and learning data unaffected
+
+#### Upgrade Path
+No migration needed. Simply upgrade and run:
+```bash
+npm update -g @iservu-inc/adf-cli
+adf deploy <tool>  # Now includes ANDF features
+```
+
+#### Benefits
+- **Industry Standard** - AGENTS.md follows emerging ANDF specification
+- **Better AI Guidance** - Structured operational rules and workflow directives
+- **Deep Context** - Architecture and terminology preserved for AI agents
+- **Expanded IDE Support** - 11 total IDEs (2 new full generators)
+- **MCP Ready** - Integrated with Model Context Protocol for next-gen tools
+
+---
+
+## [0.11.0] - 2025-11-04
+
+### 📊 Learning Analytics Dashboard - Phase 6.2
+
+**MAJOR FEATURE:** Comprehensive analytics dashboard for visualizing and analyzing learning system performance with 10+ metrics and multi-format export.
+
+#### What's New
+
+**Analytics Dashboard:**
+- **Interactive CLI Dashboard** - Navigate through multiple analytics views with intuitive menu
+- **10+ Key Metrics** - Overview stats, skip trends, category preferences, pattern distribution, effectiveness
+- **ASCII Visualizations** - Bar charts, distribution displays, and heatmaps in the terminal
+- **Multi-Format Export** - Export analytics as JSON (single file) or CSV (5 separate files)
+- **Pattern Health Tracking** - Monitor pattern decay status (healthy/warning/critical)
+- **Time-Based Trends** - 12-week skip trend analysis with skip rate calculations
+- **Effectiveness Metrics** - Track time saved, pattern accuracy, and rule performance
+
+#### Core Components
+
+**Analytics Engine (lib/learning/analytics.js - 680 lines):**
+- `generateAnalytics()` - Main analytics generation with comprehensive data aggregation
+- `calculateOverviewStats()` - Total sessions, skips, answers, patterns, rules, learning age
+- `calculateSkipTrends()` - 12-week trend analysis with skip rates
+- `calculateCategoryPreferences()` - Category-level skip rates and preference levels
+- `calculatePatternDistribution()` - Confidence distribution (high/medium/low/veryLow)
+- `calculateDecayStatus()` - Pattern health categorization (healthy/warning/critical)
+- `calculateEffectiveness()` - Time saved, pattern accuracy, rule applications, overall effectiveness
+- `calculateSessionTimeline()` - Session frequency and history analysis
+- `calculateImpactfulPatterns()` - Top patterns by time saved and applications
+- `calculateQuestionStats()` - Most answered/skipped questions
+
+**Dashboard UI (lib/learning/analytics-view.js - 530 lines):**
+- `showAnalyticsDashboard()` - Main dashboard entry point
+- `showMainDashboard()` - Overview, trends, and effectiveness view
+- `showCategoryView()` - Detailed category breakdown with heatmap
+- `showPatternHealthView()` - Pattern confidence and decay status
+- `showTimelineView()` - Session history and frequency
+- `showQuestionStatsView()` - Question statistics and insights
+- `showImpactfulPatternsView()` - Top performing patterns
+- `handleExport()` - Export functionality integration
+
+**Export Module (lib/learning/analytics-exporter.js - 240 lines):**
+- `exportAnalytics()` - Main export router (JSON/CSV)
+- `exportJSON()` - Single comprehensive JSON file export
+- `exportCSV()` - Multi-file CSV export (5 files)
+- CSV generators for: overview, skip trends, categories, patterns, effectiveness
+- Proper CSV escaping and timestamp-based filenames
+
+#### Analytics Metrics
+
+**Overview Statistics:**
+- Total sessions count
+- Total skips (manual + filtered breakdown)
+- Total answers count
+- Active patterns and rules
+- Learning system age (days since first session)
+
+**Skip Trends (12 weeks):**
+- Weekly skip counts (manual vs filtered)
+- Skip rate percentage per week
+- Week-over-week comparison
+
+**Category Preferences:**
+- Skip rate by category (0-100%)
+- Preference levels: High Skip (≥70%), Medium Skip (40-69%), Low Skip (<40%)
+- Total questions per category
+- Sorted by skip rate descending
+
+**Pattern Distribution:**
+- Total patterns count
+- Distribution by confidence:
+  - High (≥90%) - Very strong patterns
+  - Medium (75-89%) - Strong patterns
+  - Low (50-74%) - Weak patterns
+  - Very Low (<50%) - Very weak patterns
+- Average confidence score
+- Patterns at risk count (confidence <50 or inactive 5+ months)
+
+**Pattern Decay Status:**
+- Healthy patterns (confidence ≥75%, active <3 months)
+- Warning patterns (confidence 50-74%, active 3-5 months)
+- Critical patterns (confidence <50 or inactive 5+ months)
+- Recently renewed count (last 30 days)
+- Average pattern age (days)
+
+**Effectiveness Metrics:**
+- Time saved (minutes and hours)
+- Questions filtered count
+- False positives and rate
+- Pattern accuracy (% user-approved)
+- Total rule applications
+- Average applications per rule
+- Overall effectiveness score
+
+**Session Timeline:**
+- Total sessions count
+- Average sessions per week
+- Session history with dates
+- First and last session dates
+
+**Impactful Patterns:**
+- Top 10 by time saved (most effective filters)
+- Top 10 by applications (most frequently used)
+
+**Question Statistics:**
+- Top 10 most answered questions
+- Top 10 most skipped questions
+- Total unique questions encountered
+
+#### Export Formats
+
+**JSON Export:**
+- Single comprehensive file with all analytics
+- Structure: `analytics-YYYY-MM-DDTHH-MM-SS.json`
+- Includes all metrics, trends, and metadata
+- Size: ~50-100 KB for typical datasets
+
+**CSV Export:**
+- 5 separate CSV files for different metrics:
+  1. `analytics-overview-*.csv` - Overview statistics
+  2. `analytics-skip-trends-*.csv` - 12-week trends
+  3. `analytics-categories-*.csv` - Category preferences
+  4. `analytics-patterns-*.csv` - Pattern distribution and decay
+  5. `analytics-effectiveness-*.csv` - Effectiveness metrics
+- Timestamp-based filenames
+- Proper CSV escaping for special characters
+
+#### Access & Usage
+
+**Dashboard Access:**
+```bash
+adf config
+# → Learning System
+# → 4. 📊 Analytics Dashboard (NEW)
+```
+
+**Navigation:**
+- Main Dashboard → Overview, Trends, Effectiveness
+- Category Breakdown → Skip rates by category with heatmap
+- Pattern Health → Confidence distribution and decay status
+- Session Timeline → Session history and frequency
+- Question Statistics → Most answered/skipped questions
+- Impactful Patterns → Top performers by time saved/applications
+- Export Analytics → JSON or CSV format
+
+**Export Location:**
+```
+.adf/learning/exports/
+  ├── analytics-2025-11-04T10-30-45.json
+  └── analytics-overview-2025-11-04T10-30-45.csv
+  └── analytics-skip-trends-2025-11-04T10-30-45.csv
+  └── analytics-categories-2025-11-04T10-30-45.csv
+  └── analytics-patterns-2025-11-04T10-30-45.csv
+  └── analytics-effectiveness-2025-11-04T10-30-45.csv
+```
+
+#### Testing
+
+**Test Coverage:**
+- `analytics.test.js` - 25/25 tests passing (100%) ✅
+- `analytics-exporter.test.js` - 23/23 tests passing (100%) ✅
+- `analytics-view.test.js` - 4/13 tests passing (31% - integration tests)
+- **Overall:** 52/61 analytics tests (85.2%)
+- **Project-wide:** 276/300 tests (92%)
+
+**Test Data Generator:**
+- `scripts/generate-test-data.js` - Mock data generator for testing
+- 5 scenarios: empty, new user, active user, power user, edge cases
+- Generates realistic learning data for dashboard testing
+
+#### Performance
+
+**Load Time Target:** < 2 seconds for 100+ sessions
+**Memory Efficiency:** Streaming data processing for large datasets
+**Visualization:** Lightweight ASCII charts for terminal rendering
+
+#### Configuration
+
+No additional configuration required. Analytics uses existing learning data from:
+- `.adf/learning/skip-history.json`
+- `.adf/learning/answer-history.json`
+- `.adf/learning/patterns.json`
+- `.adf/learning/learned-rules.json`
+- `.adf/learning/stats.json`
+
+#### Benefits
+
+**For Users:**
+- Understand learning system behavior and effectiveness
+- Identify patterns in skip/answer behavior
+- Track pattern health and decay status
+- Monitor time savings from automated filtering
+- Make data-driven decisions about pattern approval
+
+**For Debugging:**
+- Verify pattern detection is working correctly
+- Validate decay algorithm effectiveness
+- Identify false positives
+- Analyze category-specific behavior
+- Export data for external analysis
+
+#### Use Cases
+
+**Use Case 1: Review Learning System Performance**
+- View overview to see total sessions and effectiveness
+- Check skip trends to understand behavior over time
+- Review pattern accuracy to validate system
+
+**Use Case 2: Optimize Pattern Management**
+- Check pattern health view to identify critical patterns
+- Review impactful patterns to see which provide most value
+- Export data for deeper analysis
+
+**Use Case 3: Category-Specific Analysis**
+- View category breakdown to identify high-skip categories
+- Understand which question types are most relevant
+- Adjust workflow based on insights
+
+**Use Case 4: Export for Reporting**
+- Generate JSON export for programmatic analysis
+- Create CSV exports for spreadsheet analysis
+- Share analytics with team members
+
+#### Breaking Changes
+
+None. Fully backward compatible with existing learning data.
+
+#### Migration
+
+No migration required. Analytics reads existing learning data without modifications.
+
 ## [0.10.0] - 2025-10-27
 
 ### 🧠 Pattern Decay Algorithm - Phase 6