@iservu-inc/adf-cli 0.14.6 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,179 +1,56 @@
1
1
  # ADF CLI - Current Session Status
2
2
 
3
- **Date:** 2025-11-04
4
- **Status:** ✅ Active - v0.11.0 Ready to Publish
5
- **Latest Version:** v0.11.0 (Ready)
6
- **Phase:** Phase 6.2 - Learning Analytics Dashboard
3
+ **Date:** 2026-01-13
4
+ **Status:** ✅ Active - v0.14.6 Published
5
+ **Latest Version:** v0.14.6
6
+ **Phase:** Phase 6 Complete - Modernization & Stability
7
7
  **Assistant:** Bob (established 2025-10-05)
8
8
 
9
9
  ---
10
10
 
11
11
  ## Recent Completion
12
12
 
13
- **Session:** Learning Analytics Dashboard Implementation (v0.11.0)
14
- **Completed:** 2025-11-04
15
- **Status:** ✅ Ready for npm publish
13
+ **Session:** Phase 6 Documentation & Stability Fixes
14
+ **Completed:** 2026-01-13
15
+ **Status:** ✅ v0.14.6 Published to npm
16
16
  **Branch:** development
17
- **Feature:** Comprehensive analytics dashboard with 10+ metrics and multi-format export
18
- **Chat File:** Project context and implementation via Archon
17
+ **Major Achievements:**
18
+ - Dynamic AI model discovery for all providers.
19
+ - Migration to `@google/genai` (v1.35.0).
20
+ - Self-healing configuration validation.
21
+ - Agent-Native repository standard (`AGENTS.md` + `.context/`).
22
+ - Removal of deprecated models (Gemini 1.5, GPT-3.5).
19
23
 
20
24
  ---
21
25
 
22
26
  ## Current State
23
27
 
24
28
  ### Published Version
25
- - **Package:** `@iservu-inc/adf-cli@0.11.0`
26
- - **Status:** ✅ Ready to publish to npm
29
+ - **Package:** `@iservu-inc/adf-cli@0.14.6`
30
+ - **Status:** ✅ Live on npm
27
31
  - **Branch:** development
28
- - **Size:** ~2.7 MB (unpacked, estimated)
29
- - **Files:** 125 total files
30
32
  - **Major Features:**
31
- - **Learning Analytics Dashboard** - 10+ metrics with multi-format export ✨ NEW
32
- - **Pattern Decay Algorithm** - Exponential decay for inactive patterns
33
- - AI Analysis Settings with performance modes
34
- - Resume from exit functionality
35
- - Ctrl+C graceful quit
36
- - Smart Question Filtering
37
- - Learning System with pattern detection
33
+ - **Dynamic Model Discovery** - Real-time API fetching for AI models.
34
+ - **Learning Analytics Dashboard** - 10+ metrics with multi-format export.
35
+ - **Pattern Decay Algorithm** - Exponential decay for inactive patterns.
36
+ - **Agent-Native Manifest** - Standardized documentation for AI agents.
38
37
 
39
38
  ### npm Registry
40
39
  ```bash
41
- npm install -g @iservu-inc/adf-cli
42
- # Will install v0.11.0 with Learning Analytics Dashboard (after publish)
40
+ npm install -g @iservu-inc/adf-cli@latest
43
41
  ```
44
42
 
45
43
  ### Recent Version History
44
+ - **v0.14.6** (2026-01-12) - Cleanup of deprecated models & help text polish.
45
+ - **v0.14.5** (2026-01-12) - Reconfiguration loop & hang fixes.
46
+ - **v0.14.3** (2026-01-12) - Self-healing config & unified Google SDK.
46
47
  - **v0.11.0** (2025-11-04) - Learning Analytics Dashboard (Phase 6.2)
47
48
  - **v0.10.0** (2025-10-27) - Pattern Decay Algorithm (Phase 6.1)
48
- - **v0.9.1** (2025-10-05) - Syntax error fix
49
- - **v0.9.0** (2025-10-05) - AI Analysis Settings & Performance Modes
50
- - **v0.8.0** (2025-10-05) - Resume & Ctrl+C quit shortcut
51
- - **v0.7.1** (2025-10-05) - Terminal input restoration
52
- - **v0.5.0** (2025-10-05) - Phase 5: Intelligent Answer Analysis
53
- - **v0.4.36** (2025-10-04) - Multi-IDE improvements
54
- - **v0.4.12** (2025-10-04) - Learning System (Phase 4.2)
55
- - **v0.3.6** (2025-10-04) - Configuration command
56
- - **v0.3.4** (2025-10-04) - Multi-provider AI integration
57
-
58
- ### Test Coverage
59
- - **Tests:** 276/300 passing ✅ (92% pass rate)
60
- - **Test Suites:** 20 total (+3 new analytics suites)
61
- - **New Tests:**
62
- - tests/analytics.test.js (25/25 tests - 100%) ✅
63
- - tests/analytics-exporter.test.js (23/23 tests - 100%) ✅
64
- - tests/analytics-view.test.js (4/13 tests - 31%)
65
- - **Core analytics & export functionality fully tested**
66
-
67
- ### Latest Achievement (v0.11.0 - Learning Analytics Dashboard)
68
- - ✅ Interactive CLI dashboard with multi-view navigation
69
- - ✅ 10+ key metrics (overview, trends, categories, patterns, effectiveness)
70
- - ✅ ASCII visualizations (bar charts, distribution displays, heatmaps)
71
- - ✅ Multi-format export (JSON single file, CSV 5-file suite)
72
- - ✅ Skip trend analysis (12-week grouping with rate calculations)
73
- - ✅ Category preference tracking (skip rates, answer quality, time invested)
74
- - ✅ Pattern health monitoring (healthy/warning/critical status)
75
- - ✅ Effectiveness metrics (time saved, accuracy, rule performance)
76
- - ✅ Session timeline view with detailed metrics
77
- - ✅ Question-level statistics (top skipped, most answered)
78
- - ✅ Impactful patterns ranking by application count
79
- - ✅ Mock data generator for testing (5 scenarios)
80
- - ✅ 48/48 core analytics tests passing (100%)
81
- - ✅ Comprehensive design documentation
82
-
83
- **Key Components:**
84
- 1. **Analytics Engine** - lib/learning/analytics.js (680 lines)
85
- 2. **Dashboard UI** - lib/learning/analytics-view.js (530 lines)
86
- 3. **Export Module** - lib/learning/analytics-exporter.js (240 lines)
87
- 4. **Test Data Generator** - scripts/generate-test-data.js (600+ lines)
88
- 5. **Test Coverage** - 52/61 analytics tests (85.2%)
89
-
90
- **Access:** `adf config` → Learning System → 📊 Analytics Dashboard
91
-
92
- ### Previous Achievement (v0.10.0 - Pattern Decay Algorithm)
93
- - ✅ Exponential decay formula implementation
94
- - ✅ Confidence-based decay rates (high: 7.5%, medium: 15%, low: 22.5%)
95
- - ✅ Pattern renewal system with +10 confidence boost
96
- - ✅ Automatic cleanup of patterns below threshold (40) or inactive 6+ months
97
- - ✅ User-approved pattern protection (decay at half rate)
98
- - ✅ DecayManager orchestration layer
99
- - ✅ Pattern metadata tracking (timestamps, renewal counts)
100
- - ✅ Removal history tracking
101
- - ✅ 25+ unit tests for decay calculations
102
- - ✅ 15+ integration tests for DecayManager
103
- - ✅ Comprehensive design documentation
104
-
105
- ### Previous Achievement (v0.8.0 - Resume & Quit)
106
- - ✅ Skip already-answered questions on resume
107
- - ✅ Show "✓ Already answered" with preview
108
- - ✅ Global Ctrl+C handler for graceful exit
109
- - ✅ Save progress automatically on exit/Ctrl+C
110
- - ✅ Type "exit" or press Ctrl+C at any question
111
- - ✅ Resume with `adf init` continues from last question
112
- - ✅ Works from anywhere (prompts, menus, etc.)
113
-
114
- ### Previous Achievement (v0.7.1 - Terminal Input)
115
- - ✅ Reverted external editor approach (bad UX)
116
- - ✅ Simple terminal input with exit/skip shortcuts
117
- - ✅ Accepted cursor lag as terminal limitation
118
- - ✅ Much better user experience
119
-
120
- ### Previous Achievement (v0.5.6 - Configuration Validation)
121
- - ✅ Detects invalid "cart before horse" state
122
- - ✅ Auto-resets when provider set but no API key
123
- - ✅ Clear warning messages
124
- - ✅ `saveEnvFile()` helper function
125
-
126
- ### Previous Achievement (v0.5.5 - Provider Display)
127
- - ✅ Fixed missing checkmarks for configured providers
128
- - ✅ Both ✓ (configured) and ★ (active) display properly
129
- - ✅ Refactored provider name building logic
130
-
131
- ### Previous Achievement (v0.5.3 - Dependencies)
132
- - ✅ Updated all AI SDK packages to latest
133
- - ✅ Fixed `node-domexception` deprecation warning
134
- - ✅ Maintained backward compatibility
135
-
136
- ### Completed Phases
137
- - ✅ **Phase 1:** Core System (v0.1.0 - v0.2.0)
138
- - ✅ **Phase 2:** Tool Integration (v0.3.0)
139
- - ✅ **Phase 3:** AI Integration (v0.3.4 - v0.3.6)
140
- - ✅ **Phase 4.1:** Smart Question Filtering (v0.4.12)
141
- - ✅ **Phase 4.2:** Learning System (v0.4.12)
142
- - ✅ **Phase 4.3:** Multi-IDE Improvements (v0.4.30-v0.4.36)
143
- - ✅ **Phase 5:** Intelligent Answer Analysis (v0.5.0)
144
- - ✅ **UX Polish:** 9 releases improving user experience (v0.5.1-v0.9.1)
145
- - ✅ **Phase 6.1:** Pattern Decay Algorithm (v0.10.0)
146
- - ✅ **Phase 6.2:** Learning Analytics Dashboard (v0.11.0)
147
-
148
- ### Available Features
149
- - `adf init` - Interactive interview with:
150
- - AI-guided quality scoring
151
- - Smart filtering
152
- - Learning system
153
- - Intelligent answer analysis & question skipping
154
- - **Resume from exit capability** ✨ NEW
155
- - **Ctrl+C graceful quit** ✨ NEW
156
- - `adf config` - Configure:
157
- - **AI Analysis Settings** - Performance modes & features
158
- - AI Provider Setup - Multi-provider configuration
159
- - IDE Deployment - Deploy to multiple IDEs
160
- - Learning System - View patterns, manage rules, **📊 Analytics Dashboard** ✨ NEW
161
- - `adf deploy windsurf` - Generate Windsurf configs + AGENTS.md
162
- - `adf deploy cursor` - Generate Cursor configs + AGENTS.md
163
- - `adf deploy vscode` - Generate VS Code configs + AGENTS.md
164
- - `adf update` - Check for CLI updates
165
49
 
166
50
  ---
167
51
 
168
52
  ## Next Phase Options
169
53
 
170
- ### Phase 6: Advanced Learning Features (IN PROGRESS)
171
- - ✅ Pattern decay (reduce confidence over time) - v0.10.0
172
- - ✅ Learning analytics dashboard - v0.11.0
173
- - ⏳ Export/Import rules (team sharing) - NEXT
174
- - ⏳ Cross-project learning
175
- - ⏳ Time-based patterns
176
-
177
54
  ### Phase 7: AI-Enhanced Filtering
178
55
  - AI-powered relevance scoring (beyond rules)
179
56
  - Dynamic question generation
@@ -188,136 +65,5 @@ npm install -g @iservu-inc/adf-cli
188
65
 
189
66
  ---
190
67
 
191
- ## Documentation Status
192
- - `CHANGELOG.md` - Updated with v0.11.0 entry
193
- - `SESSION-STATUS.md` - ✅ Updated with v0.11.0 details
194
- - `package.json` - ✅ Version bumped to 0.11.0
195
- - `ROADMAP.md` - ⏳ Needs update with Phase 6.2 completion
196
- - `README.md` - ⏳ May need Analytics Dashboard feature mention
197
- - `PROJECT-SETTINGS.md` - ✅ Created with Bob's name
198
- - `PHASE-4-2-LEARNING-SYSTEM.md` - ✅ Complete
199
- - `SMART-FILTERING-SYSTEM.md` - ✅ Complete
200
- - `AI-PROVIDER-INTEGRATION.md` - ✅ Complete
201
- - `SYSTEM-DESIGN.md` - ✅ Complete
202
-
203
- ### Chat History
204
- - **Complete:**
205
- - `2025-10-03_ADF-CLI-QUALITY-BASED-PROGRESS-AND-RESUME.md` (v0.2.0)
206
- - `2025-10-03_AGENTS-MD-AND-TOOL-GENERATORS.md` (v0.3.0)
207
- - `2025-10-03_AI-PROVIDER-INTEGRATION.md` (v0.3.4-0.3.5)
208
- - `2025-10-03_FRAMEWORK-UPDATE-SYSTEM.md` (v0.3.7)
209
- - `2025-10-04_CONFIG-COMMAND.md` (v0.3.6)
210
- - `2025-10-04_PHASE-4-1-SMART-FILTERING.md` (Phase 4.1)
211
- - `2025-10-04_CRITICAL-MODEL-FETCHING-BUG.md` (v0.4.15-0.4.29)
212
- - `2025-10-04_PHASE-4-2-LEARNING-SYSTEM.md` (Phase 4.2)
213
- - `2025-10-04_PHASE-4-2-COMPLETION-AND-ROADMAP.md` (Publication)
214
- - `2025-10-05_MULTI-IDE-IMPROVEMENTS.md` (v0.4.30-v0.4.36) ✅ MOVED
215
- - `2025-10-05_INTELLIGENT-ANSWER-ANALYSIS.md` (v0.5.0) ✅ MOVED
216
- - **Current:**
217
- - `2025-10-05_UX-IMPROVEMENTS-AND-AI-ANALYSIS-CONFIG.md` (v0.5.3-v0.9.1) ✅ NEW
218
- - `SESSION-STATUS.md` (this file)
219
-
220
- ---
221
-
222
- ## Quick Start for Next Session
223
-
224
- When resuming work on ADF CLI:
225
-
226
- 1. **Check npm stats:**
227
- ```bash
228
- npm view @iservu-inc/adf-cli
229
- ```
230
-
231
- 2. **Verify published version:**
232
- ```bash
233
- npm info @iservu-inc/adf-cli version
234
- # Should show: 0.11.0
235
- ```
236
-
237
- 3. **Test the new features:**
238
- ```bash
239
- npm update -g @iservu-inc/adf-cli
240
- adf config # → Learning System → Analytics Dashboard
241
-
242
- # Or generate test data first:
243
- node scripts/generate-test-data.js active
244
- adf config # Now view analytics
245
- ```
246
-
247
- 4. **Run tests:**
248
- ```bash
249
- npm test
250
- # Should show: 276/300 tests passing (92%)
251
- ```
252
-
253
- 5. **Review latest chat:**
254
- - Read `.project/chats/current/SESSION-STATUS.md`
255
-
256
- 6. **Address if needed:**
257
- - Update ROADMAP.md with Phase 6.2 completion
258
- - Consider Phase 6.3 (Export/Import rules)
259
-
260
- ---
261
-
262
- ## Key Metrics
263
-
264
- ### v0.11.0 Impact (Learning Analytics Dashboard)
265
- - **Release Date:** 2025-11-04
266
- - **Code Added:** 1,450+ lines (analytics engine, UI, export)
267
- - **Tests Added:** 52 tests (48/48 core passing - 100%)
268
- - **Test Coverage:** 276/300 total (92%)
269
- - **New Features:** 10+ analytics metrics with multi-format export
270
- - **Mock Data Generator:** 5 realistic test scenarios
271
- - **Development Time:** 1 session with comprehensive testing
272
-
273
- ### Analytics Dashboard Capabilities
274
- - **Metrics Tracked:** 10+ (skip trends, categories, patterns, effectiveness)
275
- - **Visualizations:** ASCII bar charts, distributions, heatmaps
276
- - **Export Formats:** JSON (single file), CSV (5-file suite)
277
- - **Pattern Health:** healthy/warning/critical status monitoring
278
- - **Time Analysis:** 12-week trend grouping with rate calculations
279
- - **User Experience:** Interactive menu-driven navigation
280
-
281
- ### Overall Project Stats
282
- - **Total Versions:** 52 (from v0.1.0 to v0.11.0)
283
- - **Total Tests:** 300 (276 passing - 92%)
284
- - **Package Size:** 2.7 MB unpacked
285
- - **Total Files:** 125+
286
- - **Documentation:** Comprehensive (22+ docs)
287
- - **Major Phases:** 6 completed (11 sub-phases)
288
-
289
- ---
290
-
291
- ## Assistant Information
292
-
293
- **Name:** Bob
294
- **Established:** 2025-10-05
295
- **Role:** Development Assistant & Technical Partner
296
- **Capabilities:**
297
- - Exceptional seasoned programmer with decades of experience
298
- - Thoughtful development with complete testing
299
- - No errors, full functionality guaranteed
300
- - Direct, concise, technical communication
301
-
302
- **Communication:**
303
- - Address as "Hey Bob" for attention
304
- - Responds to user feedback quickly
305
- - Iterates based on real testing
306
- - Maintains high code quality standards
307
-
308
- ---
309
-
310
- ## Key Contacts & Links
311
-
312
- - **npm:** https://www.npmjs.com/package/@iservu-inc/adf-cli
313
- - **GitHub:** https://github.com/iServU/adf-cli
314
- - **Issues:** https://github.com/iServU/adf-cli/issues
315
- - **Author:** iServU Inc.
316
- - **Assistant:** Bob
317
-
318
- ---
319
-
320
- **Last Updated:** 2025-11-04 (by Bob)
321
- **Ready for:** npm publish v0.11.0, then Phase 6.3 (Export/Import rules)
322
- **Latest Release:** v0.11.0 - Learning Analytics Dashboard Complete ✅
323
- **Status:** Phase 6.2 Complete - Analytics Dashboard with 10+ Metrics 🎉
68
+ **Last Updated:** 2026-01-13 (by Bob)
69
+ **Status:** Phase 6 Complete - Ready for Phase 7 Planning 🚀
@@ -0,0 +1,46 @@
1
+ # Phase 6: Advanced Learning & Analytics
2
+
3
+ ## Overview
4
+ Phase 6 enhances the ADF CLI Learning System with transparency, intelligence, and adaptability. It introduces a comprehensive analytics dashboard, an automated pattern decay algorithm, and multi-format data export capabilities.
5
+
6
+ ## Key Features
7
+
8
+ ### 1. Learning Analytics Dashboard
9
+ Accessible via `adf config` → **Learning System** → **📊 Analytics Dashboard**, this interactive UI provides visibility into the learning engine's behavior.
10
+
11
+ - **Skip Trends**: A 12-week visualization of manual vs. filtered skips.
12
+ - **Category Preferences**: Heatmap of skip rates and answer quality by category (e.g., Deployment, Security).
13
+ - **Pattern Confidence**: Distribution of learned patterns by confidence level (High, Medium, Low).
14
+ - **Effectiveness Metrics**: Automated calculation of total development time saved (in minutes/hours).
15
+ - **Question Statistics**: Deep dive into most-answered and most-skipped questions.
16
+
17
+ ### 2. Pattern Decay Algorithm
18
+ To ensure learning data remains relevant as user habits evolve, Phase 6 implements a time-based decay system.
19
+
20
+ - **Exponential Decay**: Pattern confidence reduces over time if not reconfirmed.
21
+ - **Confidence-Based Rates**:
22
+ - High Confidence (≥90): 7.5% decay per month.
23
+ - Medium Confidence (75-89): 15% decay per month.
24
+ - Low Confidence (<75): 22.5% decay per month.
25
+ - **Automatic Cleanup**: Patterns are removed if confidence falls below 40% or if inactive for 6+ months.
26
+ - **Renewal Mechanism**: Reconfirming a pattern (skipping a question manually) provides a +10 confidence boost.
27
+
28
+ ### 3. Data Export
29
+ Export learning analytics for team reporting or personal review.
30
+ - **Formats**: JSON (single file) and CSV (5-file suite including trends, categories, and impactful patterns).
31
+ - **Location**: Exports are saved to the user's current project directory.
32
+
33
+ ## Architecture
34
+
35
+ - `lib/learning/analytics.js`: Calculation engine for 10+ metrics.
36
+ - `lib/learning/decay-manager.js`: Orchestrates decay application and cleanup.
37
+ - `lib/learning/analytics-view.js`: Handles ASCII chart generation and menu navigation.
38
+ - `lib/learning/analytics-exporter.js`: Manages CSV/JSON serialization logic.
39
+
40
+ ## Technical Improvements
41
+ - **Performance**: Optimized for 100+ sessions (<2s load time).
42
+ - **Testing**: Added 50+ new tests covering decay logic and metric accuracy.
43
+ - **UI**: Improved navigation with "Back" functionality and real-time refresh.
44
+
45
+ ---
46
+ *Status: COMPLETE (v0.15.0)*
@@ -1,8 +1,8 @@
1
1
  # ADF CLI - Development Roadmap
2
2
 
3
- **Last Updated:** 2025-10-26
4
- **Current Version:** v0.9.1
5
- **Status:** Phase 5 Complete (with UX Polish), Phase 6 Planning
3
+ **Last Updated:** 2026-01-21
4
+ **Current Version:** v0.16.0
5
+ **Status:** Phase 6.2 Complete, Phase 7 Active
6
6
 
7
7
  ---
8
8
 
@@ -301,110 +301,60 @@ Create the definitive AI-driven requirements gathering tool that transforms vagu
301
301
 
302
302
  ---
303
303
 
304
- ### ✅ Phase 6.1: Pattern Decay Algorithm (v0.10.0)
305
- **Released:** 2025-10-27
304
+ ### ✅ Phase 6: Advanced Learning & Modernization (v0.10.0 - v0.14.6)
305
+ **Released:** 2026-01-12
306
306
  **Status:** Complete
307
307
 
308
308
  **Delivered:**
309
- - Time-based exponential decay for inactive patterns
310
- - Confidence-based decay rates (high: 7.5%, medium: 15%, low: 22.5% per month)
311
- - Automatic pattern cleanup (removes patterns <40 confidence or inactive 6+ months)
312
- - Pattern renewal system (+10 confidence boost when reconfirmed)
313
- - User-approved pattern protection (decay at half rate)
314
- - DecayManager orchestration layer
315
- - Pattern metadata tracking (createdAt, lastSeen, lastDecayCalculation, timesRenewed)
316
- - Removal history tracking
317
- - 40+ comprehensive tests (240 total tests passing)
309
+ - Time-based exponential decay for inactive patterns (v0.10.0)
310
+ - Learning Analytics Dashboard with 10+ metrics and ASCII charts (v0.11.0)
311
+ - Multi-format data export (JSON/CSV) for team reporting
312
+ - Dynamic AI model discovery for all providers (v0.14.x)
313
+ - Unified Google SDK migration (@google/genai)
314
+ - Self-healing configuration validation logic
315
+ - Agent-Native repository standard (AGENTS.md + .context/)
318
316
 
319
317
  **Impact:**
320
- - ✅ Keeps learning data fresh and relevant over time
321
- - ✅ Adapts to changing user workflows automatically
322
- - ✅ Prevents stale patterns from affecting filtering
323
- - ✅ User-approved patterns protected from rapid decay
324
- - ✅ Pattern renewal reinforces active preferences
318
+ - ✅ keeps learning data fresh and transparent
319
+ - ✅ zero-friction AI configuration
320
+ - ✅ future-proofed against model deprecations
321
+ - ✅ standardized agent-native development environment
325
322
 
326
323
  ---
327
324
 
328
- ## Active Development
329
-
330
- ### 🔄 Phase 6.2: Advanced Learning Features (Continued)
331
- **Target Version:** v0.11.0
332
- **Priority:** High
333
- **Estimated Effort:** 2-3 weeks
334
- **Status:** Planning
335
-
336
- #### Goals
337
- Continue enhancing the learning system with analytics, team collaboration, and advanced features.
338
-
339
- #### Features Remaining
340
-
341
- ##### 1. Learning Analytics Dashboard (High Priority)
342
- **Problem:** Users can't visualize their learning data effectively.
343
- **Solution:** Comprehensive analytics with insights and visualizations.
344
-
345
- **Implementation:**
346
- - Skip trends over time (chart data)
347
- - Category preference heatmap
348
- - Pattern confidence distribution
349
- - Learning effectiveness metrics
350
- - Export analytics as JSON/CSV
351
-
352
- **User Benefit:** Visibility into learning behavior and patterns
353
-
354
- ##### 2. Export/Import Rules (Medium Priority)
355
- **Problem:** Teams can't share learned preferences.
356
- **Solution:** Export rules as JSON, import with validation.
357
-
358
- **Implementation:**
359
- - Export rules to JSON file
360
- - Import with schema validation
361
- - Merge strategies (replace, append, skip duplicates)
362
- - Rule provenance tracking (who created/imported)
363
-
364
- **User Benefit:** Team collaboration and knowledge sharing
365
-
366
- ##### 3. Cross-Project Learning (Low Priority)
367
- **Problem:** Patterns learned in one project could benefit others.
368
- **Solution:** Optional aggregation across projects.
369
-
370
- **Implementation:**
371
- - Opt-in cross-project pattern detection
372
- - Privacy-preserving aggregation
373
- - Project-specific rule overrides
374
- - Clear user consent flow
375
-
376
- **User Benefit:** Faster learning for new projects
377
-
378
- ##### 4. Time-Based Patterns (Low Priority)
379
- **Problem:** Some patterns are time-dependent (e.g., skip deployment on Fridays).
380
- **Solution:** Detect and apply schedule-aware patterns.
381
-
382
- **Implementation:**
383
- - Timestamp all skip events
384
- - Detect day-of-week patterns
385
- - Detect time-of-day patterns
386
- - Contextual pattern application
325
+ ### Phase 6.2: Artifact Import & Rules Exchange (v0.16.0)
326
+ **Released:** 2026-01-21
327
+ **Status:** Complete
387
328
 
388
- **User Benefit:** More intelligent, context-aware filtering
329
+ **Delivered:**
389
330
 
390
- #### Success Criteria
391
- - Pattern decay prevents >90% of stale patterns from affecting filtering (COMPLETE)
392
- - Analytics dashboard shows 5+ meaningful insights
393
- - Export/Import works across team members
394
- - Cross-project learning requires explicit user opt-in
395
- - Time patterns detected with >80% accuracy
331
+ **Custom Artifact Import:**
332
+ - New `adf import` command for importing existing documentation
333
+ - Intelligent artifact type auto-detection (filename, frontmatter, content analysis)
334
+ - Support for 8 artifact types: PRD, Architecture, Stories, Tasks, Specification, Constitution, Plan, PRP
335
+ - Custom artifact support with user-defined naming
336
+ - Interactive mode for manual type selection
337
+ - Dry-run preview mode
338
+ - Session merge capability for augmenting existing sessions
339
+
340
+ **Learning Rules Exchange:**
341
+ - Export learned rules to JSON for backup/sharing
342
+ - Import rules from JSON with merge strategies (merge, replace, skip)
343
+ - Team collaboration through shareable learning profiles
344
+ - Confidence score preservation during export/import
396
345
 
397
- #### Technical Challenges
398
- - Decay algorithm tuning (what's the right rate?)
399
- - Analytics performance with large datasets
400
- - Import validation and merge conflicts
401
- - Privacy in cross-project learning
402
- - Time pattern noise vs signal
346
+ **Impact:**
347
+ - Zero-friction onboarding for projects with existing documentation
348
+ - Team-wide learning optimization through rules sharing
349
+ - Reduced interview overhead when documentation already exists
350
+ - Cross-project knowledge transfer
403
351
 
404
352
  ---
405
353
 
406
- ### 🔄 Phase 7: AI-Enhanced Filtering (Planned)
407
- **Target Version:** v0.11.0
354
+ ## Active Development
355
+
356
+ ### 🔄 Phase 7: AI-Enhanced Filtering & Automation
357
+ **Target Version:** v0.16.0
408
358
  **Priority:** Medium
409
359
  **Estimated Effort:** 3-4 weeks
410
360
  **Status:** Planning
@@ -576,8 +526,9 @@ Build a community-driven ecosystem around ADF CLI with plugins, templates, and s
576
526
 
577
527
  ### High Priority (Do Next)
578
528
  - ✅ **Pattern Decay** - Critical for learning quality (COMPLETE v0.10.0)
579
- - **Learning Analytics** - User visibility and trust
580
- - **Export/Import Rules** - Team collaboration
529
+ - **Learning Analytics** - User visibility and trust (COMPLETE v0.15.0)
530
+ - **Export/Import Rules** - Team collaboration (COMPLETE v0.16.0)
531
+ - ✅ **Custom Artifact Import** - Zero-friction onboarding (COMPLETE v0.16.0)
581
532
 
582
533
  ### Medium Priority (Do Soon)
583
534
  - **AI-Powered Relevance** - Improve accuracy
@@ -593,49 +544,19 @@ Build a community-driven ecosystem around ADF CLI with plugins, templates, and s
593
544
 
594
545
  ## Version Planning
595
546
 
596
- ### v0.9.1 - Current Release ✅
597
- - Critical bug fix (syntax error in interviewer.js)
598
- - Released: 2025-10-05
599
-
600
- ### v0.9.0 - AI Analysis Settings ✅
601
- - Three performance modes (Fast, Balanced, Comprehensive)
602
- - Five configurable AI features
603
- - Complete control over speed vs intelligence
604
- - Released: 2025-10-05
605
-
606
- ### v0.8.0 - Resume from Exit ✅
607
- - Exit and Ctrl+C graceful quit
608
- - Resume capability from any point
609
- - Already-answered questions skipped
610
- - Released: 2025-10-05
611
-
612
- ### v0.7.1 - UX Improvements ✅
613
- - Terminal input restoration
614
- - Reverted external editor experiment
615
- - Released: 2025-10-05
616
-
617
- ### v0.5.0 - v0.7.0 - Core Features ✅
618
- - Intelligent Answer Analysis (v0.5.0)
619
- - Multi-line input experiments (v0.6.0-v0.7.0, later reverted)
620
- - Configuration improvements (v0.5.3-v0.5.6)
621
- - Released: 2025-10-05
622
-
623
- ### v0.10.0 - Pattern Decay Algorithm ✅
624
- - Time-based exponential decay for inactive patterns
625
- - Confidence-based decay rates (high/medium/low)
626
- - Automatic pattern cleanup and renewal system
627
- - Pattern metadata tracking and removal history
628
- - 40+ comprehensive tests (240 total tests passing)
629
- - Released: 2025-10-27
630
-
631
- ### v0.11.0 - Advanced Learning (Next)
632
- - Learning analytics dashboard
633
- - Export/Import rules for team sharing
634
- - Cross-project learning (optional)
635
- - Time-based patterns
636
- - Estimated: 2-3 weeks
637
-
638
- ### v0.12.0 - AI Enhancement
547
+ ### v0.16.0 - Current Release ✅
548
+ - Custom artifact import (`adf import`)
549
+ - Learning rules export/import
550
+ - Team collaboration features
551
+ - Released: 2026-01-21
552
+
553
+ ### v0.15.1 - Previous Release
554
+ - Interview UI improvements
555
+ - AI response reliability fixes
556
+ - Context review feature
557
+ - Released: 2026-01-13
558
+
559
+ ### v0.17.0 - AI Enhancement (Next)
639
560
  - AI-powered relevance scoring
640
561
  - Dynamic question generation
641
562
  - Custom follow-ups
@@ -744,25 +665,19 @@ Build a community-driven ecosystem around ADF CLI with plugins, templates, and s
744
665
 
745
666
  ## Changelog
746
667
 
747
- ### 2025-10-05 (Later)
748
- - Phase 5 marked complete (v0.5.0)
749
- - Intelligent Answer Analysis system implemented
750
- - 4 new test suites (80 tests) added
751
- - 200 total tests passing
752
- - Updated phase numbering (4.4→6, 4.5→7, 5→8)
753
- - Version planning updated
754
-
755
- ### 2025-10-05 (Earlier)
756
- - Phase 4.3 marked complete (v0.4.30-v0.4.36)
757
- - 7 versions published with multi-IDE improvements
758
- - Updated phase numbering (4.3→4.4, 4.4→4.5)
759
- - Documented security, model support, and UX enhancements
760
-
761
- ### 2025-10-04
762
- - Initial roadmap created
763
- - Phase 4.1 & 4.2 marked complete (v0.4.12)
764
- - Phase 4.3, 4.4, and 5 defined
765
- - Prioritization framework established
668
+ ### 2026-01-13
669
+ - Phase 6 marked complete (v0.15.0)
670
+ - Pattern Decay system implemented
671
+ - Learning Analytics Dashboard with ASCII visualizations added
672
+ - Version planning updated for Phase 7
673
+
674
+ ### 2026-01-12
675
+ - v0.14.6 release: Dynamic discovery, Unified Google SDK, Agent-Native repo docs.
676
+
677
+ ### 2025-10-27
678
+ - Phase 6.1: Pattern Decay Algorithm released (v0.10.0)
679
+ - 40+ new comprehensive tests added
680
+ - Removal history tracking implemented
766
681
 
767
682
  ---
768
683