@iservu-inc/adf-cli 0.14.5 → 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/AI-MODEL-SOURCES.md +217 -249
- package/.project/docs/AI-PROVIDER-INTEGRATION.md +1 -1
- 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 +5 -8
- package/bin/adf.js +84 -4
- 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/ai/ai-config.js +14 -14
- package/lib/commands/import.js +439 -0
- package/lib/commands/init.js +8 -4
- package/lib/frameworks/interviewer.js +281 -89
- package/lib/frameworks/progress-tracker.js +18 -0
- package/lib/generators/antigravity-generator.js +6 -5
- package/lib/generators/opencode-generator.js +42 -33
- package/lib/generators/tool-config-generator.js +24 -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 🚀
|