llm_council/CHANGELOG.md
Irina Levit 3546c04348
Some checks failed
CI / backend-test (push) Successful in 4m9s
CI / frontend-test (push) Failing after 3m48s
CI / lint-python (push) Successful in 1m41s
CI / secret-scanning (push) Successful in 1m20s
CI / dependency-scan (push) Successful in 10m50s
CI / workflow-summary (push) Successful in 1m11s
feat: Major UI/UX improvements and production readiness
## Features Added

### Document Reference System
- Implemented numbered document references (@1, @2, etc.) with autocomplete dropdown
- Added fuzzy filename matching for @filename references
- Document filtering now prioritizes numeric refs > filename refs > all documents
- Autocomplete dropdown appears when typing @ with keyboard navigation (Up/Down, Enter/Tab, Escape)
- Document numbers displayed in UI for easy reference

### Conversation Management
- Added conversation rename functionality with inline editing
- Implemented conversation search (by title and content)
- Search box always visible, even when no conversations exist
- Export reports now replace @N references with actual filenames

### UI/UX Improvements
- Removed debug toggle button
- Improved text contrast in dark mode (better visibility)
- Made input textarea expand to full available width
- Fixed file text color for better readability
- Enhanced document display with numbered badges

### Configuration & Timeouts
- Made HTTP client timeouts configurable (connect, write, pool)
- Added .env.example with all configuration options
- Updated timeout documentation

### Developer Experience
- Added `make test-setup` target for automated test conversation creation
- Test setup script supports TEST_MESSAGE and TEST_DOCS env vars
- Improved Makefile with dev and test-setup targets

### Documentation
- Updated ARCHITECTURE.md with all new features
- Created comprehensive deployment documentation
- Added GPU VM setup guides
- Removed unnecessary markdown files (CLAUDE.md, CONTRIBUTING.md, header.jpg)
- Organized documentation in docs/ directory

### GPU VM / Ollama (Stability + GPU Offload)
- Updated GPU VM docs to reflect the working systemd environment for remote Ollama
- Standardized remote Ollama port to 11434 (and added /v1/models verification)
- Documented required env for GPU offload on this VM:
  - `OLLAMA_MODELS=/mnt/data/ollama`, `HOME=/mnt/data/ollama/home`
  - `OLLAMA_LLM_LIBRARY=cuda_v12` (not `cuda`)
  - `LD_LIBRARY_PATH=/usr/local/lib/ollama:/usr/local/lib/ollama/cuda_v12`

## Technical Changes

### Backend
- Enhanced `docs_context.py` with reference parsing (numeric and filename)
- Added `update_conversation_title` to storage.py
- New endpoints: PATCH /api/conversations/{id}/title, GET /api/conversations/search
- Improved report generation with filename substitution

### Frontend
- Removed debugMode state and related code
- Added autocomplete dropdown component
- Implemented search functionality in Sidebar
- Enhanced ChatInterface with autocomplete and improved textarea sizing
- Updated CSS for better contrast and responsive design

## Files Changed
- Backend: config.py, council.py, docs_context.py, main.py, storage.py
- Frontend: App.jsx, ChatInterface.jsx, Sidebar.jsx, and related CSS files
- Documentation: README.md, ARCHITECTURE.md, new docs/ directory
- Configuration: .env.example, Makefile
- Scripts: scripts/test_setup.py

## Breaking Changes
None - all changes are backward compatible

## Testing
- All existing tests pass
- New test-setup script validates conversation creation workflow
- Manual testing of autocomplete, search, and rename features
2025-12-28 18:15:02 -05:00

49 lines
2.1 KiB
Markdown

# Changelog
All notable changes to this project will be documented in this file.
## [Unreleased] - Production Ready Release
### Added
- **Document Reference System**: Numbered references (@1, @2, etc.) with autocomplete dropdown
- **Fuzzy Filename Matching**: Support for @filename references with partial matching
- **Conversation Rename**: Inline editing to rename conversations
- **Conversation Search**: Search by title and content, always-visible search box
- **Autocomplete Dropdown**: Keyboard-navigable dropdown when typing @
- **Test Setup Script**: `make test-setup` for automated test conversation creation
- **Configuration Template**: `.env.example` with all available options
- **HTTP Client Timeouts**: Configurable connect, write, and pool timeouts
- **Comprehensive Documentation**: Deployment guides, GPU VM setup, architecture docs
### Changed
- **UI Improvements**: Better text contrast, larger input textarea, improved document display
- **Report Generation**: @N references replaced with actual filenames in exports
- **Document Filtering**: Prioritizes numeric refs > filename refs > all documents
- **Removed Debug UI**: Cleaned up debug toggle button
- **Documentation Organization**: Moved deployment docs to `docs/` directory
### Fixed
- **Text Visibility**: Improved contrast in dark mode
- **Input Sizing**: Textarea now expands to full available width
- **File Text Color**: Better visibility for document names
- **Search Visibility**: Search box remains visible even with no conversations
- **ReferenceError**: Fixed `debugMode is not defined` error
### Technical
- Enhanced `docs_context.py` with reference parsing
- New API endpoints: `PATCH /api/conversations/{id}/title`, `GET /api/conversations/search`
- Improved error handling and user feedback
- Better state management in React components
## [0.1.0] - Initial Release
### Added
- Multi-LLM council system with Stage 1 (individual responses), Stage 2 (peer review), Stage 3 (synthesis)
- OpenAI-compatible API support (Ollama, vLLM, TGI)
- Document upload and management
- Conversation management
- Streaming responses
- Light/dark theme toggle
- Basic UI with React + Vite