115 lines
5.6 KiB
Markdown
115 lines
5.6 KiB
Markdown
# Implementation Plan
|
|
|
|
- [ ] 1. Implement streaming response infrastructure
|
|
- Create StreamingHandler class in new file `streaming_handler.py` with token buffering, UI update methods, and stream state management
|
|
- Add `_handle_stream_token()` method to SidebarWindow that uses GLib.idle_add for thread-safe UI updates
|
|
- Implement token buffering logic (accumulate 3-5 tokens before UI update) to reduce overhead
|
|
- _Requirements: 1.1, 1.2, 1.3, 1.4_
|
|
|
|
- [ ] 2. Integrate streaming into SidebarWindow
|
|
- Modify `_request_response()` to use `ollama_client.stream_chat()` instead of blocking `chat()`
|
|
- Update worker thread to iterate over stream and call `_handle_stream_token()` for each chunk
|
|
- Add streaming state indicator (visual feedback during generation)
|
|
- Handle stream errors and interruptions gracefully with try-except blocks
|
|
- _Requirements: 1.1, 1.2, 1.3, 1.4_
|
|
|
|
- [ ] 3. Replace single-line Entry with multi-line TextView
|
|
- Replace `Gtk.Entry` with `Gtk.TextView` wrapped in `Gtk.ScrolledWindow` in `_build_ui()`
|
|
- Configure text view with word wrapping, min height 40px, max height 200px
|
|
- Implement key event controller to handle Enter (submit) vs Shift+Enter (newline)
|
|
- Add placeholder text handling for empty buffer state
|
|
- Update `_on_submit()` to extract text from TextView buffer instead of Entry
|
|
- _Requirements: 2.1, 2.2, 2.3, 2.4_
|
|
|
|
- [ ] 4. Create command processing system
|
|
- Create `command_processor.py` with CommandProcessor class
|
|
- Implement command parsing logic with `is_command()` and `execute()` methods
|
|
- Define CommandResult dataclass for structured command responses
|
|
- Add command registry dictionary mapping command strings to handler methods
|
|
- _Requirements: 3.1, 3.2, 3.3, 3.4, 3.5_
|
|
|
|
- [ ] 5. Implement conversation management commands
|
|
- [ ] 5.1 Implement `/new` and `/clear` commands
|
|
- Add `_cmd_new_conversation()` method to save current conversation and reset to fresh state
|
|
- Clear message list UI and show confirmation message
|
|
- _Requirements: 3.1, 3.2_
|
|
|
|
- [ ] 5.2 Implement `/models` command
|
|
- Add `_cmd_list_models()` method to query and display available models
|
|
- Format model list with current model highlighted
|
|
- _Requirements: 3.3_
|
|
|
|
- [ ] 5.3 Implement `/model` command
|
|
- Add `_cmd_switch_model()` method to validate and switch active model
|
|
- Update model label in header UI
|
|
- _Requirements: 3.4_
|
|
|
|
- [ ] 5.4 Integrate CommandProcessor into SidebarWindow
|
|
- Add CommandProcessor instance to SidebarWindow initialization
|
|
- Modify `_on_submit()` to check for commands before processing as user message
|
|
- Display command results as system messages with distinct styling
|
|
- _Requirements: 3.5_
|
|
|
|
- [ ] 6. Implement conversation archive system
|
|
- [ ] 6.1 Create ConversationArchive class
|
|
- Create `conversation_archive.py` with ConversationArchive class
|
|
- Implement `list_conversations()` to scan storage directory and return metadata
|
|
- Implement `archive_conversation()` to save with timestamp-based ID format
|
|
- Implement `generate_archive_id()` using YYYYMMDD_HHMMSS_hash pattern
|
|
- Define ConversationMetadata dataclass
|
|
- _Requirements: 4.1, 4.2_
|
|
|
|
- [ ] 6.2 Implement conversation loading
|
|
- Add `load_conversation()` method to ConversationArchive
|
|
- Handle JSON parsing errors and missing files gracefully
|
|
- Return ConversationState compatible with existing ConversationManager
|
|
- _Requirements: 4.4_
|
|
|
|
- [ ] 6.3 Implement `/list` and `/resume` commands
|
|
- Add `_cmd_list_conversations()` to display archived conversations with metadata
|
|
- Add `_cmd_resume_conversation()` to load and display selected conversation
|
|
- Update SidebarWindow to repopulate message list from loaded conversation
|
|
- _Requirements: 4.3, 4.4, 4.5_
|
|
|
|
- [ ] 7. Implement reasoning mode toggle
|
|
- [ ] 7.1 Create ReasoningController class
|
|
- Create `reasoning_controller.py` with ReasoningController class
|
|
- Implement preference persistence to `~/.config/aisidebar/preferences.json`
|
|
- Add `toggle()`, `is_enabled()`, and `get_chat_options()` methods
|
|
- Define PreferencesState dataclass
|
|
- _Requirements: 5.4_
|
|
|
|
- [ ] 7.2 Add reasoning toggle UI
|
|
- Add ToggleButton to header area in `_build_ui()`
|
|
- Connect toggle signal to `_on_reasoning_toggled()` callback
|
|
- Update button state from persisted preference on startup
|
|
- _Requirements: 5.1_
|
|
|
|
- [ ] 7.3 Integrate reasoning mode with Ollama calls
|
|
- Modify `_request_response()` to include reasoning options when enabled
|
|
- Pass model-specific parameters via `get_chat_options()`
|
|
- Handle both streaming and non-streaming modes with reasoning
|
|
- _Requirements: 5.2, 5.3_
|
|
|
|
- [ ] 7.4 Implement reasoning content formatting
|
|
- Add visual distinction for reasoning content (italic, gray text, or expandable section)
|
|
- Separate reasoning from final answer with visual divider
|
|
- Update message rendering to handle reasoning metadata
|
|
- _Requirements: 5.5_
|
|
|
|
- [ ] 8. Add error handling and edge cases
|
|
- Implement stream timeout handling (60s limit) with cancellation
|
|
- Add connection error recovery for streaming failures
|
|
- Handle command execution during active streaming
|
|
- Add validation for conversation archive file corruption
|
|
- Implement graceful degradation for missing preferences file
|
|
- _Requirements: 1.4, 3.5, 4.3, 4.4_
|
|
|
|
- [ ] 9. Polish and integration
|
|
- Add CSS styling for system messages, reasoning content, and streaming indicator
|
|
- Implement `/help` command to display available commands
|
|
- Add visual feedback for command execution (loading states)
|
|
- Ensure all UI updates maintain smooth scrolling behavior
|
|
- Test keyboard focus management across all new widgets
|
|
- _Requirements: 1.3, 2.3, 3.5, 5.5_
|