glance-cli 0.10.2 → 0.10.3

package/CHANGELOG.md

@@ -5,27 +5,53 @@ All notable changes to glance-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.9.2] - 2026-01-02
+## [0.10.2] - 2026-01-03
+
+### 🗑️ Removed: Cache System (Temporary)
+- **Major Change**: Completely removed caching functionality to eliminate corruption issues
+- All cache-related CLI options removed (--no-cache, --clear-cache, --cache-stats)
+- Fresh content generation on every request - no caching artifacts
+- Implementation preserved in next-features/ for future robust restoration
+
+### ✅ Benefits
+- Zero cache corruption - no binary artifacts in summaries
+- Predictable behavior - same input gives consistent output
+- Simpler debugging - fewer moving parts during development
+- User confidence - reliable, clean results every time
+
+### 🔧 Technical Changes
+- Replaced cache system with stub functions for API compatibility
+- Removed cache references from help text and documentation
+- Simplified command flow without cache complexity
+- All existing functionality works without caching dependency
+
+## [0.10.1] - 2026-01-03
+
+### 🏗️ Major: CLI Modularization
+- Complete restructure from 1219-line monolith into 9 focused modules
+- Exportable components for programmatic usage (see examples/)
+- Production-ready error handling with custom GlanceError classes
+- Zero TypeScript errors with comprehensive type safety
+
+### 🔧 Critical Fixes
+- Fixed service detection to properly recognize Ollama availability
+- Fixed language parameter defaulting to undefined (was causing failures)
+- Resolved summarization failures after modularization
+- All AI models (Llama, OpenAI, Gemini) working correctly
+
+### 📦 Programmatic API
+- All CLI components now exportable and reusable
+- Full TypeScript support with proper interfaces
+- Package exports configured for easy imports
+- Example usage provided in examples/ directory
 
-### 🔧 Fixed: Cache Corruption Issues
-- **Critical Fix**: Resolved cache corruption causing garbled/binary artifacts in cached content
-  - Fixed double nuclear cleaning that was corrupting cached data on read operations
-  - Implemented proper UTF-8 encoding with error handling using TextDecoder
-  - Reduced overly aggressive text sanitization that destroyed content structure
-  - Added validation to prevent empty/corrupted content from being cached
-  - Enhanced error recovery for corrupted cache entries with automatic cleanup
+## [0.9.2] - 2026-01-02
 
-### Technical Details
-- Modified cache system to only apply sanitization on write, not read operations
-- Added proper encoding detection and UTF-8 conversion with fallback handling
-- Improved binary artifact detection to avoid false positives from normal content
-- Enhanced cache validation with better error messages and recovery mechanisms
-- Fixed memory corruption issues that were causing truncated Ollama responses
-
-### Performance Improvements
-- Faster cache operations with reduced processing overhead
-- Better memory management for large cached content
-- Improved reliability of cache reads across all AI providers
+### 🔧 Fixed: Cache Corruption Issues (Later Removed)
+- **Note**: Cache system was later removed in v0.10.2 due to persistent corruption
+- Attempted fixes included UTF-8 encoding improvements and validation
+- Issues with binary artifacts persisted despite multiple fix attempts
+- Full cache removal provided permanent solution to corruption problems
 
 ## [0.9.1] - 2026-01-02
 

package/README.md

@@ -6,7 +6,7 @@
 - **Privacy-first** – Your data stays on your machine
 - **Lightning fast** – Built with Bun and TypeScript
 - **AI-powered formatting** – Intelligent content structure for `--full` mode
-- **Production-ready** – Smart caching, error handling, and retry logic
+- **Production-ready** – Error handling, and retry logic
 
 Turn any webpage into beautifully formatted, terminal-friendly insights — no browser needed.
 
@@ -177,29 +177,11 @@ glance https://example.com --format plain | grep "keyword"
 
 ---
 
-## 💾 Smart Caching
-
-Glance automatically caches results to save time and API costs:
-
-```bash
-# First request: ~3 seconds
-glance https://example.com
-
-# Cached request: ~0.1 seconds
-glance https://example.com
-
-# View cache stats
-glance --cache-stats
-
-# Clear cache
-glance --clear-cache
-```
-
-**Cache features:**
-- 24-hour TTL (configurable)
-- 70% compression
-- LRU eviction (100MB max)
-- Hit rate tracking
+## 🚀 Performance
+- Fast content extraction with Cheerio
+- Optimized AI model selection 
+- Efficient text processing pipeline
+- Lightweight 8MB bundle
 
 ---
 
@@ -339,12 +321,6 @@ glance <url> --full -l fr     # Full content translated to French
 -l, --language <code>         # Output language (en, fr, es, ht)
 -e, --emoji                   # Add emojis
 
-# Cache
---cache-stats                 # Show cache statistics
---cache-cleanup               # Remove expired entries
---clear-cache                 # Clear all cache
---no-cache                    # Skip cache for this request
-
 # Other
 -v, --verbose                 # Show detailed logs
 -h, --help                    # Show help
@@ -368,9 +344,6 @@ export ELEVENLABS_API_KEY=...
 # Ollama (optional, auto-detected)
 export OLLAMA_ENDPOINT=http://localhost:11434
 
-# Cache (optional)
-export GLANCE_CACHE_DIR=~/.glance/cache
-export GLANCE_CACHE_TTL=86400000  # 24h in ms
 ```
 
 ---
@@ -419,33 +392,27 @@ glance https://lemonde.fr --tldr -l fr --export french-news.md
 glance https://example.com --model llama3  # Free, fast, private
 ```
 
-**2. Cache speeds up repeated requests:**
-```bash
-glance https://docs.com  # First: 3s
-glance https://docs.com  # Cached: 0.1s
-```
-
-**3. Pipe output for scripting:**
+**2. Pipe output for scripting:**
 ```bash
 glance https://example.com --format plain | grep "keyword" | wc -l
 ```
 
-**4. Save audio for commute:**
+**3. Save audio for commute:**
 ```bash
 glance https://article.com --tldr --audio-output commute.mp3
 ```
 
-**5. Use streaming for long content:**
+**4. Use streaming for long content:**
 ```bash
 glance https://long-article.com --stream
 ```
 
-**6. Read full articles without summarization:**
+**5. Read full articles without summarization:**
 ```bash
 glance https://blog-post.com --full --read
 ```
 
-**7. AI-powered smart formatting:**
+**6. AI-powered smart formatting:**
 ```bash
 # Automatically formats messy content for readability
 glance https://complex-site.com --full  # AI fixes formatting