chore: prepare v0.3.0 release

README.md

@@ -19,10 +19,10 @@ Requires Python 3.11+ and no third-party runtime dependencies.
 
 ### Stable release from GitHub
 
-After the `v0.2.0` tag exists, install that exact release directly from GitHub:
+After the `v0.3.0` tag exists, install that exact release directly from GitHub:
 
 ```bash
-python -m pip install "git+https://github.com/AviBackToBlack/litellm-codex-models.git@v0.2.0"
+python -m pip install "git+https://github.com/AviBackToBlack/litellm-codex-models.git@v0.3.0"
 ```
 
 This is the recommended VCS install because it is reproducible.
@@ -183,6 +183,13 @@ For an **exact Codex template match**, `context_window` and `max_context_window`
 
 For a **foreign model group**, the generator uses the minimum known LiteLLM `max_input_tokens` across every deployment as the best safe approximation for both context fields. A multi-deployment foreign group with missing or invalid context evidence fails closed rather than advertising a guessed window. An explicit `max_input_tokens` override can supply the trusted effective evidence needed to synthesize that group. A single foreign deployment preserves the v0.2 fallback behavior.
 
+## v0.3 highlights
+
+- Multiple LiteLLM deployments sharing one user-facing `model_name` are aggregated deterministically with conservative safe-to-route capability evidence instead of rejecting duplicates or choosing an arbitrary donor.
+- Verified offline Codex bundles bind catalog/prompt/schema resources to one declared repository/ref identity and verify SHA-256 digests before generation.
+- Deterministic case-sensitive model globs and exact-keyed trusted `model_overrides` add controlled selection and compatibility correction with full `explain` provenance.
+- LiteLLM web-search evidence is explicitly decoupled from Codex `supports_search_tool`; hosted web-search compatibility remains provider/runtime controlled and is not inferred from similarly named metadata.
+
 ## v0.2 highlights
 
 - Model-specific Codex donor fields are never inherited by foreign models.

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "litellm-codex-models"
-version = "0.2.1"
+version = "0.3.0"
 description = "Generate a Codex model catalog from LiteLLM /v1/model/info"
 readme = "README.md"
 requires-python = ">=3.11"

src/litellm_codex_models/__init__.py

@@ -1,3 +1,3 @@
 """LiteLLM -> Codex model catalog generator."""
 
-__version__ = "0.2.1"
+__version__ = "0.3.0"

tests/test_cli.py

@@ -25,4 +25,4 @@ def test_cli_version_does_not_require_config(capsys):
     with pytest.raises(SystemExit) as exc_info:
         build_parser().parse_args(["--version"])
     assert exc_info.value.code == 0
-    assert capsys.readouterr().out == "litellm-codex-models 0.2.1\n"
+    assert capsys.readouterr().out == "litellm-codex-models 0.3.0\n"