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

2.1 KiB

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