openclacky 0.5.6 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 34f843ea474327ea95f88685111f1a86149730503625c5e971de239e63764969
-  data.tar.gz: 85f2e93d791d3f774aa4f0d29177d4999fd91306f3c441f21d89c11ab37f15d0
+  metadata.gz: cf44c03777d71d011e78e17171352ea824da23fa3cc5bcb09c8ba985134ea28e
+  data.tar.gz: bafeeb81f93b770c2929c9a71a11fd8ed8f344251d284d10031023c41390f73b
 SHA512:
-  metadata.gz: 8bcb13d8cb5ee790ff698fc9bd0be4d2b366e1d16216db6a2f24e56c0dc1954c3b82349473b49cdee7c66ae732e3b684ee1d249d54dabe0f7d9cb0cf1f59873b
-  data.tar.gz: 866e043424ca831364baba5a842b5554cc1da2309e2935a0458edbead75c5e89f9cdf146506df12fc04c87d78c5613e3b2e812b13a816864af5861b1f815c788
+  metadata.gz: 8d4be2efc7721ec808722faa943d3fe99e4a074bebdaf710be79c8b55cfc1ef5f6757ddf33f5c37dc63ebe020bbd135f98b19d3be287121756d020b86fdd3e8f
+  data.tar.gz: cb451f53e1d1c589760c1bfccfd530faa9bfafa22d1b3e6aaca1a03813dd5bc524fb3c12037c3f0fd84cf18c8a76d71d6e6fc02421bd7e314cde8b0d783156b5

data/CHANGELOG.md

@@ -7,6 +7,49 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.6.0] - 2026-01-28
+
+### Added
+- **New UI System (UI2)**: Complete component-based UI rewrite with modular architecture (InputArea, OutputArea, TodoArea, ToolComponent, ScreenBuffer, LayoutManager)
+- **Slash Commands**: `/help`, `/clear`, `/exit` for quick actions
+- **Prompt Caching**: Significantly improved performance and reduced API costs
+- **Theme System**: Support for multiple UI themes (base, hacker, minimal)
+- **Session Management**: Auto-keep last 10 sessions with datetime naming
+
+### Improved
+- Advanced inline input with Unicode support, multi-line handling, smooth scrolling, and rapid paste detection
+- Better terminal resize handling and flicker-free rendering
+- Work/idle status indicators with token cost display
+- Enhanced tool execution feedback and multiple tool rejection handling
+- Tool improvements: glob limits, grep performance, safe shell security, UTF-8 encoding fixes
+
+### Fixed
+- Input flickering, output scrolling, Ctrl+C behavior, image copying, base64 warnings, prompt cache issues
+
+### Removed
+- Legacy UI components (Banner, EnhancedPrompt, Formatter, StatusBar)
+- Max cost/iteration limits for better flexibility
+
+## [0.5.6] - 2026-01-18
+
+### Added
+- **Image Support**: Added support for image handling with cost tracking and display
+- **Enhanced Input Controls**: Added Emacs-like Ctrl+A/E navigation for input fields
+- **Session Management**: Added `/clear` command to clear session history
+- **Edit Mode Switching**: New feature to switch between different edit modes
+- **File Operations**: Support for reading from home directory (`~/`) and current directory (`.`)
+- **Image Management**: Ctrl+D hotkey to delete images functionality
+
+### Improved
+- **Cost Tracking**: Display detailed cost information at every turn for better transparency
+- **Performance**: Test suite speed optimizations and performance improvements
+- **Token Efficiency**: Reduced token usage in grep operations for cost savings
+
+### Fixed
+- Fixed system Cmd+V copy functionality for multi-line text
+- Fixed input flickering issues during text editing
+- Removed unnecessary blank lines from image handling
+
 ## [0.5.4] - 2026-01-16
 
 ### Added

data/docs/ui2-architecture.md

@@ -0,0 +1,124 @@
+# UI2 Architecture
+
+## Core Principle
+**Strict Layering**: UI layer must NOT directly access Agent layer. Use callbacks for communication.
+
+## Component Hierarchy
+```
+UIController (single external interface)
+  ├── LayoutManager (layout coordination)
+  │   ├── OutputArea (output display)
+  │   ├── InputArea (user input)
+  │   ├── TodoArea (task list)
+  │   └── InlineInput (confirmation prompt)
+  └── Callbacks (external communication)
+      ├── on_input -> CLI handles input
+      ├── on_interrupt -> CLI handles interruption
+      └── on_mode_toggle -> CLI handles mode change
+```
+
+## Data Flow
+
+### Agent → UI: One-way calls
+```ruby
+# Agent calls UI to display
+@ui&.show_tool_call(...)
+@ui&.append_output(...)
+@ui&.show_token_usage(...)
+```
+
+### UI → Agent: Via callbacks
+```ruby
+# ❌ Wrong: UI directly calls Agent
+agent.run(input)
+
+# ✅ Correct: Via callback
+ui_controller.on_input { |input| agent.run(input) }
+```
+
+## Common Mistakes
+
+### ❌ Directly accessing Agent in UI components
+```ruby
+# Bad example
+def toggle_mode
+  @agent.config.mode = "auto_approve"  # ❌ Violates separation
+end
+```
+
+### ✅ Notify via callback
+```ruby
+# Good example
+def toggle_mode
+  @mode_toggle_callback&.call("auto_approve")  # ✅ Proper separation
+end
+```
+
+### ❌ Using puts for logging
+```ruby
+puts "Debug info"  # ❌ Breaks UI rendering
+```
+
+### ✅ Use UIController.log
+```ruby
+ui_controller.log("Debug info")  # ✅ Displays in output area
+ui_controller.log("Warning", level: :warning)
+ui_controller.log("Error", level: :error)
+```
+
+## Logging System
+
+Use `ui_controller.log(message, level: :info)` to display debug information in the output area without breaking rendering.
+
+**Available log levels:**
+- `:debug` - Gray dimmed text
+- `:info` - Normal text with info symbol
+- `:warning` - Yellow warning text
+- `:error` - Red error text
+
+**Example:**
+```ruby
+# In UIController or components with access to UIController
+@ui_controller.log("Tool execution started", level: :debug)
+@ui_controller.log("Cache hit", level: :info)
+@ui_controller.log("Retry attempt 3/10", level: :warning)
+@ui_controller.log("Network failed", level: :error)
+```
+
+## Rendering Flow
+
+### Fixed Areas
+- **InputArea**: Fixed at bottom (hidden when InlineInput is active via `paused?`)
+- **TodoArea**: Fixed above InputArea
+
+### Scrolling Area
+- **OutputArea**: Natural scrolling, all content appended here
+
+### Thread Safety
+- All rendering protected by `@render_mutex`
+- Never call render methods outside LayoutManager
+
+## Key Methods
+
+### Display Methods (Agent → UI)
+- `append_output(content)` - Add content to output area
+- `update_sessionbar(tasks:, cost:)` - Update session bar
+- `show_token_usage(token_data)` - Display token statistics
+- `show_tool_call(name, args)` - Display tool execution
+- `request_confirmation(message)` - Blocking user confirmation
+
+### Callback Registration (CLI sets these)
+- `on_input { |text, images| ... }` - Handle user input
+- `on_interrupt { |input_was_empty:| ... }` - Handle Ctrl+C
+- `on_mode_toggle { |new_mode| ... }` - Handle Shift+Tab
+
+### Logging (Use instead of puts)
+- `log(message, level: :info)` - Display debug/info in output
+
+## Best Practices
+
+1. **Never bypass UIController** - All UI updates go through UIController
+2. **Use callbacks for upward communication** - UI notifies CLI/Agent via callbacks
+3. **Log via UIController** - Never use `puts` or `print` directly
+4. **Check paused state** - Don't render InputArea when InlineInput is active
+5. **Trust the render flow** - Let LayoutManager handle rendering coordination