Beta Release v0.5.3-beta.3

This beta release introduces advanced routing capabilities specifically designed for Anthropic Claude model families. Users can now implement flexible model switching by mapping entire model families to specific upstream targets, providing a seamless experience for tools like Claude Code.

New Features

• Add model_family_overrides configuration block to map Claude families (Opus, Sonnet, Haiku) to target models via case-insensitive substring matching.
• Implement hierarchical routing precedence: exact model overrides > family-based overrides > respect requested model > scenario routing.

Improvements

• Refactor model family override validation and routing logic for better simplicity and performance.
• Add validation for anthropic_tools_disabled within the configuration loader.
• Enhance internal routing logic with RouteWithFamilyOverride and shared helper functions.

Documentation

• Add detailed specification for family-based model overrides.
• Update CLAUDE.md with new routing information.
• Add docs/howto-custom-routing.md for implementation guidance.
• Update docs/reference-api.md to reflect new configuration fields.
• Add docs/2026-07-14-family-model-overrides-design.md for architectural context.
• Update configs/config.example.json with new configuration options.

Chores

• Add comprehensive unit tests for model family overrides in internal/handlers/messages_test.go and internal/router/model_router_test.go.

---

Note: This is a beta release. Please test all new routing configurations in a non-production environment and provide feedback via our issue tracker.

Beta Release v0.5.3-beta.2

This beta release focuses on expanding ecosystem compatibility and improving API discoverability. Key updates include the introduction of an OpenAI-compatible /v1/models endpoint and enhanced integration with CC-Switch for better model discovery.

New Features

• Implement OpenAI-compatible /v1/models endpoint for model listing
• Add Claude Code model picker support
• Integrate gateway model discovery support via CC-Switch compatibility

Bug Fixes

• Fix model provider precedence in /v1/models to ensure model_overrides take priority over base configurations

Improvements

• Implement request context propagation in ListModels to allow cancellation of slow SQLite reads on client disconnect

Documentation

• Expand CONFIGURATION.md with detailed configuration details
• Add comprehensive API reference documentation in docs/reference-api.md
• Update README.md

Chores

• Add regression tests for model override collisions
• Add unit tests for new model listing handlers

---

Note: This is a beta release. Please test all new features in a non-production environment and provide feedback on any unexpected behavior.

Beta Release v0.5.3-beta.1

⚠️ Breaking Changes

• Reserve the :latest tag for stable releases only; beta builds now use the beta tag, so pulling :latest will no longer fetch prereleases.
• Version numbers follow a sequential patch‑based scheme (e.g., 0.5.3-beta.1), which may differ from previous timestamp‑based tags.

New Features

• Publish GHCR images publicly with OCI source, description, and license labels for easy discovery.
• Add latest and beta tags to Docker images, enabling docker pull ghcr.io/routatic/proxy:latest to work with the most recent beta.
• Implement sequential beta versioning based on the upcoming patch version and a counter that resets on stable release.

Bug Fixes

• Fix Docker image visibility so images are publicly pullable from GHCR.
• Resolve tag‑collision issues by ensuring mutable beta tags are used for prereleases and latest is preserved for stable builds.

Improvements

• Enhance CI workflow to automatically push rolling beta and latest tags from beta builds.
• Update version script to compute sequential beta counters correctly.

Documentation

• Document GHCR pull instructions in INSTALLATION.md.
• Update README to reflect new tagging behavior and versioning scheme.

Chores

• Update GitHub Actions workflow for beta releases.
• Adjust versioning scripts and related configuration files.
• Add OCI labels to Dockerfile for better package metadata.

This is a beta release; please test thoroughly and provide feedback.

Beta Release v0.7.0-beta.20260713.102140

User Safety: safe

Beta Release v0.6.0-beta.20260712.232956

Changelog: v0.6.0-beta.1

This beta release introduces a unified start command with an integrated analytics dashboard, adds OpenRouter provider support, enhances AWS Bedrock with OpenAI Responses API compatibility, and implements a dual release channel system (beta/production) with automated release workflows. The GUI has been modernized with Tailwind CSS and now runs natively on macOS while providing a simple URL on Linux/Windows.

---

⚠️ Breaking Changes

• Unified start command replaces serve and ui: The new routatic-proxy start command launches the proxy server with an optional GUI dashboard (--headless flag for server-only mode). The old serve and ui subcommands are removed.
• Docker image now uses start --background: Update Docker Compose / run commands accordingly.
• Configuration structure updated: New analytics and update channel settings added to config; review CONFIGURATION.md for changes.

---

New Features

• Add unified start command launching proxy server with integrated GUI dashboard (macOS native, Linux/Windows print URL)
• Implement --headless flag for start command to run server-only without GUI
• Add OpenRouter provider support with model catalog, pricing, and configuration guide
• Enhance AWS Bedrock provider with OpenAI Responses API support for openai.gpt-* models
• Implement analytics dashboard with token usage trends, latency statistics, and estimated cost tracking
• Add analytics storage layer with summary, token trends, and latency endpoints
• Implement dual release channel system (beta/production) with automated beta release workflow
• Add update command with channel management (beta/stable) and release fetching
• Add background daemon support for headless operation with autostart configuration
• Implement build info extraction (version, commit, date) with test coverage
• Add Tailwind CSS for modernized GUI styling and responsive layout
• Add model catalog migration and seed pricing data for cost estimation
• Implement content detection in SSE responses for improved streaming error handling
• Add new error type for empty streams with graceful handling

---

Bug Fixes

• Fix Docker entrypoint to use start --background instead of invalid --headless flag
• Fix import paths for systray and webview packages
• Fix GUI port handling using instance variable and atomic types for thread safety
• Fix shutdown handling and process name detection for routatic-proxy processes
• Fix estimated cost calculation in TokenSummary with correct JSON field names
• Fix lint errors (errcheck, unused variables) across codebase
• Fix buildinfo tests and PIDString implementation
• Suppress error on response body close in ensurePortAvailable method
• Fix token handling in AnalyticsModule for consistency with new data structure
• Fix fallback scenario and model selection elements in GUI
• Fix analytics loading behavior and user feedback in dashboard

---

Improvements

• Refactor GUI codebase: remove old CGo-dependent UI files, add platform-specific entry points
• Streamline FallbackModule with improved model handling and scenario management
• Simplify provider and model record creation with dedicated factory functions
• Enhance catalog and analytics handling with latency tracking and improved model management
• Improve update channel command documentation and error handling
• Refactor test cases for build info with better assertions and error messages
• Update release workflow to use fetch-depth: 0 for full git history
• Add golang.org/x/mod v0.38.0 for semantic version comparison (IsNewerVersion)
• Enhance README and CONFIGURATION.md with OpenRouter integration details
• Add comprehensive OpenRouter models documentation (context windows, pricing, benefits)
• Add AWS Bedrock endpoint handling for various model IDs with test coverage

---

Documentation

• Add RELEASE_PROCESS.md documenting dual release channel system and beta/production workflows
• Add docs/openrouter.md with complete OpenRouter provider configuration guide
• Add MODELS.md with supported models across providers
• Add REVIEW.md code review guide with standards and checks
• Update README.md with OpenRouter setup instructions and environment variables
• Update CONFIGURATION.md with new analytics and update channel options
• Update CLAUDE.md with project context
• Add CONTRIBUTING.md with contribution guidelines
• Document dual release channel system and automated beta release process

---

Chores

• Add Tailwind CSS as dev dependency with configuration (tailwind.config.js, package.json)
• Add .gstack/ to .gitignore
• Update GitHub Actions workflows: beta-release.yml (new), release.yml (updated)
• Add get-versions.sh script for version extraction
• Update Makefile with new build targets
• Update go.mod / go.sum with new dependencies
• Refactor code structure for improved readability and maintainability
• Clean up import statements and struct field formatting
• Add pre-push git hook updates

---

Note: This is a beta release. Please test thoroughly in your environment and report any issues on GitHub. The dual release channel system means you can opt into beta updates via routatic-proxy update channel beta or stay on stable with routatic-proxy update channel stable.

Release v0.5.2

Release Notes

This release introduces major architectural improvements with SQLite-based storage for the catalog system, adds OpenRouter provider support with cost-based routing capabilities, and enhances the CLI with provider-specific initialization templates. The catalog migration from JSON to SQLite improves performance and reliability while maintaining backward compatibility.

⚠️ Breaking Changes

• Catalog Storage Migration: The catalog system now uses SQLite by default instead of JSON files. Existing JSON catalogs will be automatically migrated on first run. Manual JSON catalog files in the configuration directory should be removed after migration completes.

New Features

• Add OpenRouter provider support with catalog-driven model resolution and cost-based routing
• Add --provider flag to init command for generating provider-specific config templates (opencode-go, opencode-zen, aws-bedrock, openrouter)
• Implement SQLite-based catalog storage to replace JSON file storage
• Add cost-based routing with provider penalties and context window limits
• Add catalog synchronization with automatic syncing and configuration options
• Add catalog stats endpoint for monitoring catalog status and statistics
• Implement macOS GUI support with systray integration
• Add SQLite storage for performance metrics, request tracking, and log management
• Add catalog migration function from JSON to SQLite with backward compatibility

Bug Fixes

• Add missing period in error message for catalog not found
• Improve error messages and streamline output in models list command
• Adjust percentile index calculations to handle edge cases in latency metrics
• Update config path in TestRoute_LegacyConfigFixtures for consistency
• Update ResolveShort documentation to clarify matching logic and provider prioritization

Improvements

• Enhance ModelRouter to support catalog-based model resolution
• Improve model resolution to handle unknown providers and ambiguity
• Enhance provider model index creation and synchronization in catalog
• Add automatic catalog reloading in ModelRouter
• Enhance SelectCheapest and providerSet with effective penalties and preferred provider logic
• Add debug logging to BuildProviderIndex for provider and model samples
• Enhance performance metrics handling with improved latency calculations and success counts
• Refactor StorageWriter interface for better storage integration
• Update cost calculation in resolvedModel function to use model-specific values

Documentation

• Add Fedora 44 setup guide to documentation
• Add catalog schema documentation with key fields and model resolution details
• Update documentation for model addition process and cost-based routing details
• Document --provider flag for init command in Quick Start, CLI Commands, and Configuration docs

Chores

• Default to CGO_ENABLED=0 for build in Makefile (browser-based UI)
• Remove system tray for Linux, use web portal only
• Update golangci-lint configuration to enable additional linters
• Remove duplicate entry for .worktrees/ in .gitignore
• Update dependencies in go.mod and go.sum for improved functionality and performance
• Clean up whitespace in migration and performance handling code

Release v0.5.1

Routatic-Proxy v0.5.1 Release Notes

This release focuses on enhancing authentication error handling in fallback chains, improving model routing reliability, and significantly expanding documentation to support new configuration options and model management features.

New Features

• Add llms.txt file for project structure and key concepts overview
• Introduce Anthropic-first fallback configuration options
• Implement model selection with capacity filtering
• Add circuit breaking for model routing scenarios
• Enhance system design documentation with contributor guidelines

Bug Fixes

• Short-circuit fallback chain on 401/403 authentication errors
• Normalize provider strings by replacing underscores with hyphens
• Update provider retrieval to use Client.Provider for accurate model handling
• Enhance WireFormat logic for OpenAI models and fallback streamlining
• Block providers on authentication errors in fallback logic
• Handle multiple API keys during authentication error fallback

Improvements

• Streamline fallback chain logic for authentication errors
• Improve model metadata and routing strategies in documentation
• Add detailed comments and codebase documentation for clarity
• Optimize capacity handling in router logic
• Refactor fallback and router components for maintainability

Documentation

• Update README with Go version and license badges
• Add contributing guidelines and system design documentation
• Expand installation instructions with update commands
• Document deprecated Zen models and replacements
• Improve model guide with routing strategies and metadata
• Add llms.txt file documentation

Chores

• Refactor fallback and router components
• Update configuration handling in model registry
• Enhance test coverage for fallback scenarios

Release v0.5.0

Release Notes for routatic-proxy v0.4.10

This release focuses on refining scenario routing logic to improve model selection accuracy and reduce unnecessary traffic to complex models. Key changes include narrowing scenario keywords to prevent false positives and enhancing test coverage for critical routing paths.

Breaking Changes

• Narrowed scenario keywords: Removed over-broad keywords like "error", "debug", "build", and "bash" from complex scenario detection. This change may affect routing behavior for messages containing these terms, requiring users to adjust their prompt patterns if they previously relied on these keywords for complex routing.

New Features

• Improved scenario detection accuracy: Enhanced keyword filtering in complex scenario detection to prevent false positives while maintaining routing for true architectural work.

Bug Fixes

• Fixed false positive routing: Resolved issue where routine coding tasks containing common technical terms were being incorrectly routed to complex models (#111).

Improvements

• Enhanced test coverage: Added new test cases for scenario routing edge cases and improved existing tests for reliability.

Documentation

• Updated README: Added documentation about scenario keyword usage and routing behavior changes.

Chores

• Refactored routing logic: Improved code structure for better maintainability and performance.

Release v0.4.9

This release introduces critical updates to proxy configuration and reliability, with structural adjustments.

New Features

• Added configuration files for enhanced settings.
• Introduced new handler implementations.

Bug Fixes

• Fixed availability gate handling issues.
• Simplified retry logic in availability tests.

Improvements

• Optimized performance metrics.
• Enhanced documentation clarity.

Documentation

• Updated README and internal guides.

Chores

• Updated CI/CD pipelines.
• Refactored dependency management.

Release v0.4.8

Summary
This release introduces a robust Windows autostart fix and a built‑in self‑update mechanism, enabling users to keep routatic‑proxy current directly from the command line. Enhancements to autostart handling, command‑line formatting, and background process logging improve reliability on Windows, while the new updater package adds version comparison, checksum verification, and GitHub API integration.

---

New Features

• Add Windows autostart fix – handle WindowsApps aliases and improve command‑line argument formatting.
• Introduce self‑update command – check for and apply updates from GitHub.
• Create updater package – download, verify, and install updates with checksum validation.
• Enhance User‑Agent handling – set a custom User‑Agent for GitHub API requests.

Bug Fixes

• Update .gitignore – include .kimchi and remove obsolete documentation files.
• Replace ping with timeout – improve backup deletion reliability on Windows.

Improvements

• Autostart status command – now checks if the server process is running and logs startup errors.
• Background process startup – add error handling and logging improvements.
• Windows command‑line building – unit tests added for path extraction and argument formatting.
• Updater functionality – tests added for version comparison and checksum verification.

Documentation

• Add Windows autostart specification – new documentation file detailing the fix.
• Update INSTALLATION.md & README.md – reflect new features and usage.

Chores

• Add cmd/routatic-proxy/update.go – command implementation for updates.
• Update internal daemon files – autostart_windows.go, background.go, and their tests.
• Add updater source and tests – internal/updater package and corresponding test files.
• Update .gitignore – maintain clean repository state.