glance-cli 0.8.7 → 0.9.1

package/CHANGELOG.md

@@ -5,6 +5,118 @@ 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.1] - 2026-01-02
+
+### 🧾 MAJOR: AI-Powered Smart Formatting for Full Content
+- **Revolutionary Feature**: `--full` mode now uses AI to intelligently format messy content!
+  - Automatically organizes blog posts, articles, and complex layouts
+  - Preserves ALL original content while making it beautifully readable
+  - Perfect structure for both reading and voice synthesis
+  - Works with any website layout - no more CSS selector limitations!
+
+### Enhanced
+- **Smart Content Recognition**: AI identifies titles, dates, reading times, social links
+- **Intelligent Spacing**: Proper paragraph breaks and section separation
+- **Article Organization**: Blog posts formatted with metadata (dates, reading times)
+- **Link Structure**: Navigation and social media links properly organized
+- **Fallback System**: Smart formatting with graceful fallback to raw content
+
+### Performance
+- **English Content**: `🧾 Applying smart formatting...` (~3-6 seconds)
+- **Multilingual**: Combined translation + formatting for non-English languages
+- **Zero Content Loss**: Every piece of original information preserved
+
+### Examples
+```bash
+# Before: messy wall of text
+# After: beautifully structured, readable content
+glance https://complex-blog.com --full --read
+
+# Works perfectly with voice synthesis
+glance https://personal-website.com --full --voice nova --read
+
+# Multilingual with smart formatting
+glance https://messy-site.com --full -l fr --read
+```
+
+### Technical Details
+- Added `format` option to SummarizeOptions interface
+- Created intelligent formatting prompts with content understanding
+- Enhanced CLI to apply smart formatting for English content
+- Improved error handling with multiple fallback levels
+
+## [0.9.0] - 2026-01-02
+
+### 🌍 MAJOR: Multilingual Full Content Support
+- **Breakthrough Feature**: `--full` mode now supports translation to any language!
+  - Read entire English articles in French: `glance https://blog.com/post --full -l fr --read`
+  - Read French content in English: `glance https://lemonde.fr/article --full -l en --read`
+  - Perfect for language learning, accessibility, and international content consumption
+  - Preserves original formatting and structure while translating
+
+### Added
+- **Translation Engine**: Dedicated translation prompts for accurate, structure-preserving translations
+- **Language Detection**: Automatic translation when non-English language specified with `--full`
+- **Voice Integration**: Translated full content works seamlessly with voice synthesis
+- **Smart Fallback**: Falls back to original content if translation fails
+
+### Improved
+- **Text Formatting**: Enhanced paragraph structure preservation in full content mode
+- **Performance**: Optimized content extraction to reduce excessive newlines
+- **User Experience**: Clear progress indicators ("🌍 Translating full content...")
+
+### Examples
+```bash
+# Translate Sam Altman's blog to French and listen
+glance https://blog.samaltman.com/post --full -l fr --read
+
+# Read Spanish news in English with voice
+glance https://elpais.com/news --full -l en --voice nova --read
+
+# Export French content as English markdown
+glance https://lemonde.fr/tech --full -l en --export article.md
+```
+
+## [0.8.9] - 2026-01-02
+
+### Added
+- **Full Content Mode**: New `--full` flag to read entire articles without summarization
+  - Perfect for when you want to listen to complete blog posts or documentation
+  - Works seamlessly with voice synthesis (`--read`) and audio export (`--audio-output`)
+  - Maintains all formatting and structure from original content
+  - Example: `glance https://blog.com/article --full --read`
+
+### Improved
+- **Content Display**: Shows "📖 Full Content" label when using --full mode
+- **Voice Integration**: Full content can be read aloud or saved as audio files
+- **Export Options**: Full content can be exported to markdown, JSON, or other formats
+
+### Technical Details
+- Added isFullContent flag to formatter options
+- Enhanced CLI to skip AI processing when --full is specified
+- Optimized performance for full content delivery
+
+## [0.8.8] - 2026-01-02
+
+### Fixed
+- **Voice System Improvements**: Fixed voice listing to show only working voices with proper language mapping
+- **Text Cleaner Optimization**: Made text cleaning less aggressive to prevent legitimate content removal
+- **Cache System**: Resolved overly aggressive cleaning of cache-related terms and content
+- **--prefer-quality Flag**: Fixed issue where flag wasn't affecting automatic model selection
+- **Voice Validation**: Improved voice name/ID validation and error messages
+
+### Improved
+- **Voice Listing**: Clean, organized display by language (🇺🇸 English, 🇫🇷 French, 🇪🇸 Spanish, 🇭🇹 Haitian Creole)
+- **Error Messages**: More specific and helpful voice synthesis error messages
+- **Text Processing**: Smarter cleaning that preserves paragraph structure and legitimate content
+- **Model Selection**: --prefer-quality now correctly prioritizes OpenAI/Gemini over Ollama
+
+### Technical Details
+- Enhanced voice mapping system to show only available voices in user's ElevenLabs account
+- Refined binary artifact detection to avoid false positives from ANSI color codes
+- Improved cache system stability with better error handling
+- More conservative text cleaning patterns to preserve legitimate content
+
 ## [0.8.7] - 2026-01-02
 
 ### Fixed

package/README.md

@@ -5,9 +5,10 @@
 - **100% FREE by default** – Uses local Ollama (no API keys needed!)
 - **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
 
-Turn any webpage into terminal-friendly insights — no browser needed.
+Turn any webpage into beautifully formatted, terminal-friendly insights — no browser needed.
 
 [![npm version](https://badge.fury.io/js/glance-cli.svg)](https://www.npmjs.com/package/glance-cli)
 [![Downloads](https://img.shields.io/npm/dm/glance-cli.svg)](https://www.npmjs.com/package/glance-cli)
@@ -71,6 +72,14 @@ glance https://complex-topic.com --eli5
 
 # Ask specific questions
 glance https://nextjs.org/docs --ask "What's the App Router?"
+
+# Read FULL content (no summarization)
+glance https://blog.samaltman.com/article --full
+glance https://important-article.com --full --read  # Listen to entire article
+
+# Read FULL content in different languages
+glance https://blog.samaltman.com/article --full -l fr  # Translate to French
+glance https://lemonde.fr/article --full -l en --read   # French article in English with voice
 ```
 
 ### AI Models
@@ -118,6 +127,15 @@ glance https://article.com --audio-output summary.mp3
 
 # Read aloud immediately
 glance https://blog.com --read
+
+# Use specific voice
+glance https://news.com --voice nova --read
+
+# French content with French voice
+glance https://lemonde.fr --voice antoine -l fr --read
+
+# Spanish content with Spanish voice
+glance https://elpais.com --voice isabella -l es --read
 ```
 
 ### Advanced Features
@@ -214,6 +232,69 @@ done
 glance https://api-docs.com --ask "How do I authenticate?" --format plain
 ```
 
+### 6. Listen to Full Articles
+```bash
+# Read entire blog posts or articles
+glance https://blog.example.com/long-post --full --read
+
+# Save full content as audio
+glance https://important-article.com --full --audio-output article.mp3
+
+# Export full content to markdown
+glance https://documentation.com/guide --full --export guide.md
+```
+
+### 7. Multilingual Full Content
+```bash
+# Translate entire articles to other languages
+glance https://blog.samaltman.com/post --full -l fr --read  # English to French
+glance https://lemonde.fr/article --full -l en --read       # French to English
+glance https://elpais.com/news --full -l en --voice nova --read  # Spanish to English
+
+# Perfect for language learning or accessibility
+glance https://technical-docs.com --full -l es --audio-output spanish-docs.mp3
+```
+
+### 8. Smart Content Formatting
+```bash
+# AI automatically formats messy websites for better readability
+glance https://personal-blog.com --full  # Cleans up layout
+glance https://complex-site.com --full --read  # Perfect for voice
+
+# Works great for sites with poor formatting
+glance https://old-website.com --full --export clean-article.md
+```
+
+---
+
+## 🎤 Voice & Language Support
+
+Glance supports **multi-language voice synthesis** with ElevenLabs integration:
+
+```bash
+# List available voices by language
+glance --list-voices
+
+# English voices (default)
+glance https://news.com --voice nova --read       # Energetic
+glance https://docs.com --voice onyx --read       # Deep, authoritative
+
+# French voices  
+glance https://lemonde.fr --voice antoine -l fr --read
+
+# Spanish voices
+glance https://elpais.com --voice isabella -l es --read
+
+# Haitian Creole support
+glance https://example.ht --voice nova -l ht --read
+```
+
+**Voice Quality Levels:**
+- **Free**: System TTS (macOS Say, Windows SAPI, Linux espeak)
+- **Premium**: ElevenLabs voices with natural pronunciation (requires API key)
+
+Set `ELEVENLABS_API_KEY` environment variable for premium voices.
+
 ---
 
 ## 📚 All Options
@@ -225,6 +306,8 @@ glance <url> --tldr           # One sentence
 glance <url> --key-points     # Bullet points
 glance <url> --eli5           # Simple explanation
 glance <url> --ask "question" # Custom Q&A
+glance <url> --full           # Full content (no summary)
+glance <url> --full -l fr     # Full content translated to French
 
 # AI models
 --model <name>                # llama3, gpt-4o-mini, gemini-2.0-flash-exp
@@ -243,8 +326,9 @@ glance <url> --ask "question" # Custom Q&A
 # Voice/Audio
 --read, --speak               # Read aloud (text-to-speech)
 --audio-output <file>         # Save as MP3
---voice <name>                # Choose voice (alloy, echo, nova, etc.)
---list-voices                 # Show available voices
+--voice <name>                # Choose voice (nova, onyx, antoine, etc.)
+--list-voices                 # Show available voices by language
+-l, --language <code>         # Language for voice selection (en, fr, es, ht)
 
 # Advanced
 --screenshot <file>           # Capture screenshot
@@ -356,6 +440,17 @@ glance https://article.com --tldr --audio-output commute.mp3
 glance https://long-article.com --stream
 ```
 
+**6. Read full articles without summarization:**
+```bash
+glance https://blog-post.com --full --read
+```
+
+**7. AI-powered smart formatting:**
+```bash
+# Automatically formats messy content for readability
+glance https://complex-site.com --full  # AI fixes formatting
+```
+
 ---
 
 ## 🤝 Contributing