Root cause: Pre-trained model was loading successfully, causing CLI to skip
calibration entirely. System went straight to classification with 35% model.
Changes:
- config: Set calibration_model to qwen3:8b-q4_K_M (larger model for better instruction following)
- cli: Create separate calibration_llm provider with 8b model
- llm_analyzer: Improved prompt to force exact email ID copying
- workflow: Merge discovered categories with predefined ones
- workflow: Add detailed error logging for label mismatches
- ml_classifier: Fixed model path checking (was checking None parameter)
- ml_classifier: Add dual API support (sklearn predict_proba vs LightGBM predict)
- ollama: Fixed model list parsing (use m.model not m.get('name'))
- feature_extractor: Switch to Ollama embeddings (instant vs 90s load time)
Result: Calibration now runs and generates 16 categories + 50 labels correctly.
Next: Investigate calibration sampling to reduce overfitting on small samples.
- Setup virtual environment and install all dependencies
- Implemented modular configuration system (YAML-based)
- Created logging infrastructure with rich formatting
- Built email data models (Email, Attachment, ClassificationResult)
- Implemented email provider abstraction with stubs:
* MockProvider for testing
* Gmail provider (credentials required)
* IMAP provider (credentials required)
- Implemented feature extraction pipeline:
* Semantic embeddings (sentence-transformers)
* Hard pattern detection (20+ patterns)
* Structural features (metadata, timing, attachments)
- Created ML classifier framework with MOCK Random Forest:
* Mock uses synthetic data for testing only
* Clearly labeled as test/development model
* Placeholder for real LightGBM training at home
- Implemented LLM providers:
* Ollama provider (local, qwen3:1.7b/4b support)
* OpenAI-compatible provider (API-based)
* Graceful degradation when LLM unavailable
- Created adaptive classifier orchestration:
* Hard rules matching (10%)
* ML classification with confidence thresholds (85%)
* LLM review for uncertain cases (5%)
* Dynamic threshold adjustment
- Built CLI interface with commands:
* run: Full classification pipeline
* test-config: Config validation
* test-ollama: LLM connectivity
* test-gmail: Gmail OAuth (when configured)
- Created comprehensive test suite:
* 23 unit and integration tests
* 22/23 passing
* Feature extraction, classification, end-to-end workflows
- Categories system with 12 universal categories:
* junk, transactional, auth, newsletters, social, automated
* conversational, work, personal, finance, travel, unknown
Status:
- Framework: 95% complete and functional
- Mocks: Clearly labeled, transparent about limitations
- Tests: Passing, validates integration
- Ready for: Real data training when Enron dataset available
- Next: Home setup with real credentials and model training
This build is production-ready for framework but NOT for accuracy.
Real ML model training, Gmail OAuth, and LLM will be done at home
with proper hardware and real inbox data.
Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
