@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.
- package/.project/chats/current/SESSION-STATUS.md +25 -279
- package/.project/docs/PHASE-6-ADVANCED-LEARNING.md +46 -0
- package/.project/docs/ROADMAP.md +72 -157
- package/.project/docs/designs/CUSTOM-ARTIFACT-UPLOAD.md +259 -0
- package/.project/docs/designs/LEARNING-RULES-EXCHANGE.md +77 -0
- package/CHANGELOG.md +2054 -2995
- package/README.md +4 -7
- package/bin/adf.js +80 -0
- package/conductor/tracks/session_resume_review_20260113/plan.md +18 -0
- package/conductor/tracks.md +4 -0
- package/gemini.md +3 -0
- package/lib/ai/ai-client.js +9 -9
- package/lib/commands/import.js +439 -0
- package/lib/commands/init.js +8 -4
- package/lib/frameworks/interviewer.js +277 -85
- package/lib/frameworks/progress-tracker.js +18 -0
- package/lib/learning/learning-manager.js +107 -8
- package/lib/learning/rules-exporter.js +103 -0
- package/lib/learning/rules-importer.js +141 -0
- package/lib/utils/artifact-detector.js +253 -0
- package/package.json +1 -1
- package/tests/progress-tracker.test.js +16 -0
|
@@ -1,179 +1,56 @@
|
|
|
1
1
|
# ADF CLI - Current Session Status
|
|
2
2
|
|
|
3
|
-
**Date:**
|
|
4
|
-
**Status:** ✅ Active - v0.
|
|
5
|
-
**Latest Version:** v0.
|
|
6
|
-
**Phase:** Phase 6
|
|
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:**
|
|
14
|
-
**Completed:**
|
|
15
|
-
**Status:** ✅
|
|
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
|
-
**
|
|
18
|
-
|
|
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.
|
|
26
|
-
- **Status:** ✅
|
|
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
|
-
- **
|
|
32
|
-
- **
|
|
33
|
-
-
|
|
34
|
-
-
|
|
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
|
-
|
|
192
|
-
|
|
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)*
|
package/.project/docs/ROADMAP.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
# ADF CLI - Development Roadmap
|
|
2
2
|
|
|
3
|
-
**Last Updated:**
|
|
4
|
-
**Current Version:** v0.
|
|
5
|
-
**Status:** Phase
|
|
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
|
|
305
|
-
**Released:**
|
|
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
|
-
-
|
|
311
|
-
-
|
|
312
|
-
-
|
|
313
|
-
-
|
|
314
|
-
-
|
|
315
|
-
-
|
|
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
|
-
- ✅
|
|
321
|
-
- ✅
|
|
322
|
-
- ✅
|
|
323
|
-
- ✅
|
|
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
|
-
|
|
329
|
-
|
|
330
|
-
|
|
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
|
-
**
|
|
329
|
+
**Delivered:**
|
|
389
330
|
|
|
390
|
-
|
|
391
|
-
-
|
|
392
|
-
-
|
|
393
|
-
-
|
|
394
|
-
-
|
|
395
|
-
-
|
|
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
|
-
|
|
398
|
-
-
|
|
399
|
-
-
|
|
400
|
-
-
|
|
401
|
-
-
|
|
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
|
-
|
|
407
|
-
|
|
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.
|
|
597
|
-
-
|
|
598
|
-
-
|
|
599
|
-
|
|
600
|
-
|
|
601
|
-
|
|
602
|
-
-
|
|
603
|
-
-
|
|
604
|
-
-
|
|
605
|
-
|
|
606
|
-
|
|
607
|
-
|
|
608
|
-
|
|
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
|
-
###
|
|
748
|
-
- Phase
|
|
749
|
-
-
|
|
750
|
-
-
|
|
751
|
-
-
|
|
752
|
-
|
|
753
|
-
-
|
|
754
|
-
|
|
755
|
-
|
|
756
|
-
|
|
757
|
-
-
|
|
758
|
-
-
|
|
759
|
-
-
|
|
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
|
|