docs: update documentation for v1.3.3 release

- Updated CHANGELOG.md with v1.3.3 release notes
- Updated README.md to reflect new defaults and harmony improvements
- Updated CONFIG.md with harmony section and new feature defaults
- Documented status bar fix and default features being enabled
- Enhanced harmony configuration documentation with all options

Author: jwesleye

CHANGELOG.md

@@ -7,6 +7,25 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.3.3] - 2024-12-24
+
+### Changed
+- **Default Features Enabled** - All wizard options now default to enabled
+  - `features.auto_save: true` (was false)
+  - `features.show_tokens: true` (was false)
+  - `ui.show_status_bar: true` (was false)
+  - `harmony.show_detailed_thinking: true` (was false)
+  - Provides better out-of-the-box experience for new users
+
+### Fixed
+- **Status Bar Display** - Fixed status bar not showing between messages
+  - Status bar now displays by default with agent name, model, query count, and session time
+  - Resolves issue where status bar was hidden due to false default
+- **Harmony Detection Improvements** - Enhanced logging and documentation
+  - Added detailed logging for harmony auto-detection process
+  - Better documentation of `harmony.enabled` config options in example config
+  - Fixed model_info type handling to prevent TypeError with status bar display
+
 ## [1.3.2] - 2024-12-24
 
 ### Added
@@ -334,6 +353,10 @@ For detailed documentation, see [README.md](README.md) and [docs/](docs/).
 
 ---
 
+[1.3.3]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v1.3.3
+[1.3.2]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v1.3.2
+[1.3.1]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v1.3.1
+[1.3.0]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v1.3.0
 [0.3.7]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v0.3.7
 [0.3.6]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v0.3.6
 [0.3.5]: https://github.com/Open-Agent-Tools/Basic-Agent-Chat-Loop/releases/tag/v0.3.5

README.md

@@ -179,6 +179,7 @@ A configuration file (`~/.chatrc`) is automatically created on first use with re
 
 ```yaml
 features:
+  auto_save: true             # Automatically save conversations on exit
   show_tokens: true           # Display token counts
   show_metadata: true         # Show agent model/tools info
   rich_enabled: true          # Enhanced formatting
@@ -191,6 +192,10 @@ audio:
   enabled: true               # Play sound when agent completes
   notification_sound: null    # Custom WAV file (null = bundled sound)
 
+harmony:
+  enabled: auto               # Harmony processing (auto/yes/no)
+  show_detailed_thinking: true  # Show reasoning with labeled prefixes
+
 behavior:
   max_retries: 3              # Retry attempts on failure
   timeout: 120.0              # Request timeout (seconds)
@@ -408,18 +413,27 @@ When a Harmony agent is detected, responses are automatically processed to:
 - Detect and format tool calls appropriately
 - Parse structured Harmony response formats
 
-### Detailed Thinking Mode
+### Configuration
 
-By default, only the final response is shown. You can enable detailed thinking mode to see the agent's internal reasoning with labeled prefixes:
+Control Harmony processing behavior:
 
-**Configuration:**
 ```yaml
 # In ~/.chatrc or .chatrc
 harmony:
-  show_detailed_thinking: false  # Default - only show final response
+  enabled: auto                 # auto (default) / yes / no
+  show_detailed_thinking: true  # Default - show all channels with labels
 ```
 
-**With detailed thinking enabled (`true`):**
+**`harmony.enabled` options:**
+- `auto` (default) - Automatically detect harmony agents
+- `yes` - Force enable harmony processing for all agents
+- `no` - Disable harmony processing completely
+
+### Detailed Thinking Mode
+
+**By default, detailed thinking is enabled** - showing all channels with labeled prefixes:
+
+**With detailed thinking enabled (`true`, default):**
 ```
 💭 [REASONING]
 I need to analyze this query for potential bottlenecks...
@@ -436,7 +450,13 @@ This is a common pattern I see in legacy codebases...
 Here are three optimizations for your database query...
 ```
 
-**With detailed thinking disabled (`false`, default):**
+**To disable detailed thinking (set to `false`):**
+```yaml
+harmony:
+  show_detailed_thinking: false  # Only show final response
+```
+
+**Output with detailed thinking disabled:**
 ```
 Here are three optimizations for your database query...
 ```
@@ -543,18 +563,17 @@ MIT License - see LICENSE file for details.
 
 See [CHANGELOG.md](CHANGELOG.md) for detailed version history.
 
-### Latest Release: v0.1.0 (2025-10-09)
-
-Initial public release with:
-- 🏷️ Agent alias system
-- 📝 Prompt templates with auto-setup
-- 💰 Token tracking and cost estimation
-- ⚙️ YAML configuration with auto-setup
-- 📊 Status bar and session summaries
-- 🎨 Rich markdown rendering
-- 🔄 Automatic error recovery
-- 📜 Persistent command history
-- ✅ 61% test coverage (158 tests)
+### Latest Release: v1.3.3 (2024-12-24)
+
+Hotfix release with default features enabled and harmony improvements:
+- ✨ **Default Features Enabled** - All features now enabled by default for better UX
+  - `auto_save: true` - Save conversations automatically
+  - `show_tokens: true` - Display token counts and costs
+  - `show_status_bar: true` - Status bar with agent, model, queries, time
+  - `show_detailed_thinking: true` - Show harmony reasoning channels
+- 🔧 **Status Bar Fix** - Status bar now displays correctly between messages
+- 📊 **Harmony Improvements** - Enhanced detection logging and documentation
+- 🎨 **Better Defaults** - Optimized out-of-the-box experience for new users
 
 ## Troubleshooting
 

docs/CONFIG.md

@@ -68,9 +68,9 @@ Toggle functionality on/off:
 
 ```yaml
 features:
-  auto_save: false              # Save conversations on exit
+  auto_save: true               # Save conversations on exit (default: true)
   rich_enabled: true            # Use rich library for formatting
-  show_tokens: false            # Display token counts (future)
+  show_tokens: true             # Display token counts (default: true)
   show_metadata: true           # Show agent metadata on startup
   readline_enabled: true        # Command history
 ```
@@ -109,11 +109,11 @@ ui:
   show_banner: true            # Welcome banner
   show_thinking_indicator: true  # "Thinking..." spinner
   show_duration: true          # Query duration
-  show_status_bar: false       # Top status bar (agent, model, queries, time)
+  show_status_bar: true        # Top status bar (agent, model, queries, time)
 ```
 
 **Status Bar:**
-When enabled, shows a persistent status bar at the top:
+Enabled by default, shows a persistent status bar at the top:
 ```
 ┌─────────────────────────────────────────────────┐
 │ Clara │ Sonnet 4.5 │ 3 queries │ 12m 34s        │
@@ -153,6 +153,55 @@ audio:
   enabled: false
 ```
 
+### Harmony
+
+OpenAI Harmony format support for gpt-oss models:
+
+```yaml
+harmony:
+  enabled: auto                 # Harmony processing (auto/yes/no)
+  show_detailed_thinking: true  # Show reasoning with labeled prefixes
+```
+
+**`harmony.enabled` options:**
+- `auto` (default) - Automatically detect harmony agents by checking for:
+  - Explicit `uses_harmony` attribute on the agent
+  - Model names containing "gpt-oss" or "harmony"
+  - Harmony-specific methods or attributes
+  - Agent class names containing "harmony"
+- `yes` - Force enable harmony processing for all agents
+- `no` - Disable harmony processing completely
+
+**Detailed thinking mode:**
+When `show_detailed_thinking: true` (default), the agent's internal reasoning is displayed with labeled prefixes:
+```
+💭 [REASONING]
+I need to analyze this query...
+
+📊 [ANALYSIS]
+Looking at the structure...
+
+📝 [COMMENTARY]
+This is a common pattern...
+
+💬 [RESPONSE]
+Here are the optimizations...
+```
+
+When `show_detailed_thinking: false`, only the final response is shown:
+```
+Here are the optimizations...
+```
+
+**Per-agent harmony settings:**
+```yaml
+agents:
+  'My Harmony Agent':
+    harmony:
+      enabled: yes              # Force enable for this agent
+      show_detailed_thinking: false  # Hide internal reasoning
+```
+
 ### Sessions
 
 Conversation session management settings:
@@ -468,6 +517,10 @@ audio:
   enabled: boolean          # Play sound when agent completes
   notification_sound: string | null  # Path to WAV file or null for bundled sound
 
+harmony:
+  enabled: string           # auto / yes / no - Harmony processing control
+  show_detailed_thinking: boolean  # Show reasoning with labeled prefixes
+
 agents:
   '<agent_name>':
     # Any of the above sections can be overridden
@@ -477,6 +530,7 @@ agents:
     behavior: {...}
     ui: {...}
     audio: {...}
+    harmony: {...}
 ```
 
 ## See Also