vikingowl
8f9d601fdc
Acceptance Criteria: - Workspace metadata, PKGBUILD, and CHANGELOG announce version 0.2.0 - Release notes summarize major v0.2 additions, changes, and fixes for users Test Notes: - cargo test -p owlen-cli
138 lines
8.4 KiB
Markdown
138 lines
8.4 KiB
Markdown
# Changelog
|
||
|
||
All notable changes to this project will be documented in this file.
|
||
|
||
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
|
||
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
|
||
|
||
## [Unreleased]
|
||
|
||
### Added
|
||
- Comprehensive documentation suite including guides for architecture, configuration, testing, and more.
|
||
- Emacs keymap profile alongside runtime `:keymap` switching between Vim and Emacs layouts.
|
||
- Rustdoc examples for core components like `Provider` and `SessionController`.
|
||
- Module-level documentation for `owlen-tui`.
|
||
- Provider integration tests (`crates/owlen-providers/tests`) covering registration, routing, and health status handling for the new `ProviderManager`.
|
||
- TUI message and generation tests that exercise the non-blocking event loop, background worker, and message dispatch.
|
||
- Ollama integration can now talk to Ollama Cloud when an API key is configured.
|
||
- Ollama provider will also read `OLLAMA_API_KEY` / `OLLAMA_CLOUD_API_KEY` environment variables when no key is stored in the config.
|
||
- `owlen config doctor`, `owlen config path`, and `owlen upgrade` CLI commands to automate migrations and surface manual update steps.
|
||
- Startup provider health check with actionable hints when Ollama or remote MCP servers are unavailable.
|
||
- `dev/check-windows.sh` helper script for on-demand Windows cross-checks.
|
||
- Global F1 keybinding for the in-app help overlay and a clearer status hint on launch.
|
||
- Automatic fallback to the new `ansi_basic` theme when the active terminal only advertises 16-color support.
|
||
- Offline provider shim that keeps the TUI usable while primary providers are unreachable and communicates recovery steps inline.
|
||
- `owlen cloud` subcommands (`setup`, `status`, `models`, `logout`) for managing Ollama Cloud credentials without hand-editing config files.
|
||
- Tabbed model selector that separates local and cloud providers, including cloud indicators in the UI.
|
||
- Footer status line includes provider connectivity/credential summaries (e.g., cloud auth failures, missing API keys).
|
||
- Secure credential vault integration for Ollama Cloud API keys when `privacy.encrypt_local_data = true`.
|
||
- Input panel respects a new `ui.input_max_rows` setting so long prompts expand predictably before scrolling kicks in.
|
||
- Command palette offers fuzzy `:model` filtering and `:provider` completions for fast switching.
|
||
- Cloud usage tracker persists hourly/weekly token totals, adds a `:limits` command, shows live header badges, and raises toast warnings at 80 %/95 % of the configured quotas.
|
||
- Message rendering caches wrapped lines and throttles streaming redraws to keep the TUI responsive on long sessions.
|
||
- Model picker badges now inspect provider capabilities so vision/audio/thinking models surface the correct icons even when descriptions are sparse.
|
||
- Chat history honors `ui.scrollback_lines`, trimming older rows to keep the TUI responsive and surfacing a "↓ New messages" badge whenever updates land off-screen.
|
||
|
||
### Changed
|
||
- The main `README.md` has been updated to be more concise and link to the new documentation.
|
||
- Default configuration now pre-populates both `providers.ollama` and `providers.ollama-cloud` entries so switching between local and cloud backends is a single setting change.
|
||
- `McpMode` support was restored with explicit validation; `remote_only`, `remote_preferred`, and `local_only` now behave predictably.
|
||
- Configuration loading performs structural validation and fails fast on missing default providers or invalid MCP definitions.
|
||
- Ollama provider error handling now distinguishes timeouts, missing models, and authentication failures.
|
||
- The `web.search` tool now proxies through Ollama Cloud’s `/api/web_search` endpoint and is hidden whenever the active provider cannot reach the cloud.
|
||
- `owlen` warns when the active terminal likely lacks 256-color support.
|
||
- `config.toml` now carries a schema version (`1.2.0`) and is migrated automatically; deprecated keys such as `agent.max_tool_calls` trigger warnings instead of hard failures.
|
||
- Model selector navigation (Tab/Shift-Tab) now switches between local and cloud tabs while preserving selection state.
|
||
- Header displays the active model together with its provider (e.g., `Model (Provider)`), improving clarity when swapping backends.
|
||
- Documentation refreshed to cover the message handler architecture, the background health worker, multi-provider configuration, and the new provider onboarding checklist.
|
||
|
||
---
|
||
|
||
## [0.2.0] - 2025-10-24
|
||
|
||
### Added
|
||
- Cloud usage tracker now persists hourly and weekly token totals, exposes a `:limits` command, and renders live gradient gauges in the header with 80 %/95 % toast notifications.
|
||
- Web search tooling is available whenever Ollama Cloud is configured, giving the assistant automatic access to the `web.search` function with runtime toggles via `:web on|off`.
|
||
- Provider registry aggregates local and cloud Ollama models, including health checks, scope badges, and graceful fallback between providers.
|
||
- Release documentation covers the migration from v0.1, including the new config schema defaults, cloud setup guide, and troubleshooting steps for common errors.
|
||
|
||
### Changed
|
||
- Workspace packages, distribution metadata, and README badges now report version `0.2.0`.
|
||
- Chat header adopts a cockpit layout powered by Ratatui 0.29 flex layouts and Tailwind-inspired gradients, clearly surfacing context and quota usage.
|
||
- Cloud requests now default to the canonical `https://ollama.com` endpoint and automatically attach the `Authorization: Bearer <API_KEY>` header resolved from config or environment variables.
|
||
- Configuration templates enable both local (`providers.ollama`) and cloud (`providers.ollama_cloud`) entries by default, complete with TTLs, context windows, and quota placeholders.
|
||
|
||
### Fixed
|
||
- Selecting Ollama Cloud without a valid API key now surfaces actionable unauthorized toasts and falls back to the last working local provider instead of looping 401 responses.
|
||
- Rate-limited cloud responses raise non-fatal warnings so sessions remain usable while the usage tracker records the incident.
|
||
|
||
---
|
||
|
||
## [0.1.11] - 2025-10-18
|
||
|
||
### Changed
|
||
- Bump workspace packages and distribution metadata to version `0.1.11`.
|
||
|
||
## [0.1.10] - 2025-10-03
|
||
|
||
### Added
|
||
- **Material Light Theme**: A new built-in theme, `material-light`, has been added.
|
||
|
||
### Fixed
|
||
- **UI Readability**: Fixed a bug causing unreadable text in light themes.
|
||
- **Visual Selection**: The visual selection mode now correctly colors unselected text portions.
|
||
|
||
### Changed
|
||
- **Theme Colors**: The color palettes for `gruvbox`, `rose-pine`, and `monokai` have been corrected.
|
||
- **In-App Help**: The `:help` menu has been significantly expanded and updated.
|
||
|
||
## [0.1.9] - 2025-10-03
|
||
|
||
*This version corresponds to the release tagged v0.1.10 in the source repository.*
|
||
|
||
### Added
|
||
- **Material Light Theme**: A new built-in theme, `material-light`, has been added.
|
||
|
||
### Fixed
|
||
- **UI Readability**: Fixed a bug causing unreadable text in light themes.
|
||
- **Visual Selection**: The visual selection mode now correctly colors unselected text portions.
|
||
|
||
### Changed
|
||
- **Theme Colors**: The color palettes for `gruvbox`, `rose-pine`, and `monokai` have been corrected.
|
||
- **In-App Help**: The `:help` menu has been significantly expanded and updated.
|
||
|
||
## [0.1.8] - 2025-10-02
|
||
|
||
### Added
|
||
- **Command Autocompletion**: Implemented intelligent command suggestions and Tab completion in command mode.
|
||
|
||
### Changed
|
||
- **Build & CI**: Fixed cross-compilation for ARM64, ARMv7, and Windows.
|
||
|
||
## [0.1.7] - 2025-10-02
|
||
|
||
### Added
|
||
- **Tabbed Help System**: The help menu is now organized into five tabs for easier navigation.
|
||
- **Command Aliases**: Added `:o` as a short alias for `:load` / `:open`.
|
||
|
||
### Changed
|
||
- **Session Management**: Improved AI-generated session descriptions.
|
||
|
||
## [0.1.6] - 2025-10-02
|
||
|
||
### Added
|
||
- **Platform-Specific Storage**: Sessions are now saved to platform-appropriate directories (e.g., `~/.local/share/owlen` on Linux).
|
||
- **AI-Generated Session Descriptions**: Conversations can be automatically summarized on save.
|
||
|
||
### Changed
|
||
- **Migration**: Users on older versions can manually move their sessions from `~/.config/owlen/sessions` to the new platform-specific directory.
|
||
|
||
## [0.1.4] - 2025-10-01
|
||
|
||
### Added
|
||
- **Multi-Platform Builds**: Pre-built binaries are now provided for Linux (x86_64, aarch64, armv7) and Windows (x86_64).
|
||
- **AUR Package**: Owlen is now available on the Arch User Repository.
|
||
|
||
### Changed
|
||
- **Build System**: Switched from OpenSSL to rustls for better cross-platform compatibility.
|