Refresh model mappings and bump version to 0.1.1

sidrat2612 · sidrat2612 · commit 28ee8c502ef4 · 2026-05-07T13:07:53.000+05:30
diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md
@@ -19,6 +19,12 @@ routesmith is a HOST-AWARE skill layer, NOT a universal cross-provider broker.
 4. **Graceful fallback** — If switching is unsupported, use prompt strategy.
 5. **Deterministic planning** — Planner works without API calls.
 
+## Versioning Rule
+
+- Any code change must also update the package version in `pyproject.toml`.
+- Do not leave behavior-changing code edits at the same published version.
+- When making code changes, treat the version bump as part of the same change.
+
 ## Package Structure
 
 - `src/routesmith/` — Main package
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -2,6 +2,12 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.1.1] - 2026-05-07
+
+### Changed
+- Refreshed host model mappings and README examples to current public model lineups.
+- Centralized runtime version reporting so package metadata and server responses stay in sync with `pyproject.toml`.
+
 ## [0.1.0] - 2026-05-07
 
 ### Added
diff --git a/README.md b/README.md
@@ -26,11 +26,11 @@ Most coding agents are stuck on one model. Mixed tasks (plan → code → test 
 
 | Host | Models | Strategy |
 |------|--------|----------|
-| Claude Code | Opus / Sonnet / Haiku | Dynamic model switching |
-| Codex | o3 / codex-mini / GPT-4.1 | Dynamic model switching |
-| Copilot | Host-controlled | Prompt optimization |
-| Cursor | User-controlled | Prompt optimization |
-| Aider | Multi-provider | Dynamic model switching |
+| Claude Code | Claude Opus 4.7 / Sonnet 4.6 / Haiku 4.5 | Dynamic model switching |
+| Codex | GPT-5.5 / GPT-5.4 / GPT-5.3-Codex | Dynamic model switching |
+| Copilot | Claude 4.7 / GPT-5.5 / Gemini 3.1 Pro (plan-dependent) | Prompt optimization |
+| Cursor | Claude 4.7 / GPT-5.5 / GPT-5.3-Codex / Gemini 3.1 Pro | Prompt optimization |
+| Aider | Claude 4.7 / GPT-5.5 / Gemini 3.1 Pro | Dynamic model switching |
 
 ## Quickstart
 
@@ -108,10 +108,10 @@ Instead of hardcoding model names, routesmith uses abstract capability classes:
 
 | Class | Use Case | Example Models |
 |-------|----------|----------------|
-| `deep_reasoning` | Planning, architecture, review | Claude Opus, o3 |
-| `coding` | Implementation, testing, refactoring | Claude Sonnet, codex-mini |
-| `balanced` | Documentation, general tasks | Claude Sonnet, GPT-4.1 |
-| `fast` | Formatting, simple transforms | Claude Haiku, GPT-4.1-mini |
+| `deep_reasoning` | Planning, architecture, review | Claude Opus 4.7, GPT-5.5 |
+| `coding` | Implementation, testing, refactoring | Claude Sonnet 4.6, GPT-5.3-Codex |
+| `balanced` | Documentation, general tasks | Claude Sonnet 4.6, GPT-5.4 |
+| `fast` | Formatting, simple transforms | Claude Haiku 4.5, GPT-5.4-mini |
 
 Each host adapter maps these to actual available models.
 
diff --git a/pyproject.toml b/pyproject.toml
@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "routesmith"
-version = "0.1.0"
+version = "0.1.1"
 description = "Host-aware auto-routing skill library for IDEs and coding agents."
 readme = "README.md"
 license = "MIT"
diff --git a/src/routesmith/__init__.py b/src/routesmith/__init__.py
@@ -1,5 +1,8 @@
 """routesmith - Host-aware auto-routing skill library for IDEs and coding agents."""
 
+from importlib.metadata import PackageNotFoundError, version as package_version
+from pathlib import Path
+
 from routesmith.types import (
     CapabilityClass,
     HostCapabilities,
@@ -17,7 +20,25 @@
 from routesmith.router import Router
 from routesmith.hosts.detector import detect_host, get_host_capabilities
 
-__version__ = "0.1.0"
+
+def _read_version_from_pyproject() -> str:
+    """Fallback to pyproject.toml when package metadata is unavailable."""
+    pyproject_path = Path(__file__).resolve().parents[2] / "pyproject.toml"
+    try:
+        for line in pyproject_path.read_text(encoding="utf-8").splitlines():
+            stripped = line.strip()
+            if stripped.startswith("version = "):
+                return stripped.split("=", 1)[1].strip().strip('"').strip("'")
+    except OSError:
+        pass
+    return "0.1.1"
+
+
+try:
+    __version__ = package_version("routesmith")
+except PackageNotFoundError:
+    __version__ = _read_version_from_pyproject()
+
 __all__ = [
     "run",
     "explain_route",
diff --git a/src/routesmith/hosts/aider.py b/src/routesmith/hosts/aider.py
@@ -18,19 +18,21 @@ class AiderHostAdapter(BaseHostAdapter):
     """Adapter for Aider coding assistant."""
 
     MODEL_MAP: dict[CapabilityClass, str] = {
-        CapabilityClass.DEEP_REASONING: "claude-opus-4-20250514",
-        CapabilityClass.CODING: "claude-sonnet-4-20250514",
-        CapabilityClass.BALANCED: "claude-sonnet-4-20250514",
-        CapabilityClass.FAST: "claude-haiku-3-5-20241022",
+        CapabilityClass.DEEP_REASONING: "claude-opus-4-7",
+        CapabilityClass.CODING: "gpt-5.3-codex",
+        CapabilityClass.BALANCED: "claude-sonnet-4-6",
+        CapabilityClass.FAST: "claude-haiku-4-5",
     }
 
     AVAILABLE_MODELS = [
-        "claude-opus-4-20250514",
-        "claude-sonnet-4-20250514",
-        "claude-haiku-3-5-20241022",
-        "gpt-4.1",
-        "gpt-4.1-mini",
-        "o3",
+        "claude-opus-4-7",
+        "claude-sonnet-4-6",
+        "claude-haiku-4-5",
+        "gpt-5.5",
+        "gpt-5.4",
+        "gpt-5.4-mini",
+        "gpt-5.3-codex",
+        "gemini-3.1-pro",
     ]
 
     def detect(self) -> HostDetectionResult:
diff --git a/src/routesmith/hosts/claude_code.py b/src/routesmith/hosts/claude_code.py
@@ -19,16 +19,16 @@ class ClaudeCodeHostAdapter(BaseHostAdapter):
 
     # Claude-family model mapping by capability class
     MODEL_MAP: dict[CapabilityClass, str] = {
-        CapabilityClass.DEEP_REASONING: "claude-opus-4-20250514",
-        CapabilityClass.CODING: "claude-sonnet-4-20250514",
-        CapabilityClass.BALANCED: "claude-sonnet-4-20250514",
-        CapabilityClass.FAST: "claude-haiku-3-5-20241022",
+        CapabilityClass.DEEP_REASONING: "claude-opus-4-7",
+        CapabilityClass.CODING: "claude-sonnet-4-6",
+        CapabilityClass.BALANCED: "claude-sonnet-4-6",
+        CapabilityClass.FAST: "claude-haiku-4-5",
     }
 
     AVAILABLE_MODELS = [
-        "claude-opus-4-20250514",
-        "claude-sonnet-4-20250514",
-        "claude-haiku-3-5-20241022",
+        "claude-opus-4-7",
+        "claude-sonnet-4-6",
+        "claude-haiku-4-5",
     ]
 
     def detect(self) -> HostDetectionResult:
@@ -95,7 +95,7 @@ def _detect_current_model(self) -> str | None:
         if model:
             return model
         # Default assumption for Claude Code
-        return "claude-sonnet-4-20250514"
+        return "claude-sonnet-4-6"
 
     def get_available_models(self) -> list[str]:
         """Get available Claude models."""
diff --git a/src/routesmith/hosts/codex.py b/src/routesmith/hosts/codex.py
@@ -18,18 +18,18 @@ class CodexHostAdapter(BaseHostAdapter):
     """Adapter for OpenAI Codex CLI / OpenAI-native environments."""
 
     MODEL_MAP: dict[CapabilityClass, str] = {
-        CapabilityClass.DEEP_REASONING: "o3",
-        CapabilityClass.CODING: "codex-mini",
-        CapabilityClass.BALANCED: "gpt-4.1",
-        CapabilityClass.FAST: "gpt-4.1-mini",
+        CapabilityClass.DEEP_REASONING: "gpt-5.5",
+        CapabilityClass.CODING: "gpt-5.3-codex",
+        CapabilityClass.BALANCED: "gpt-5.4",
+        CapabilityClass.FAST: "gpt-5.4-mini",
     }
 
     AVAILABLE_MODELS = [
-        "o3",
-        "codex-mini",
-        "gpt-4.1",
-        "gpt-4.1-mini",
-        "gpt-4.1-nano",
+        "gpt-5.5",
+        "gpt-5.4",
+        "gpt-5.4-mini",
+        "gpt-5.3-codex",
+        "gpt-5.3-codex-spark",
     ]
 
     def detect(self) -> HostDetectionResult:
@@ -80,6 +80,7 @@ def get_capabilities(self) -> HostCapabilities:
             notes=[
                 "Codex supports OpenAI-family models only.",
                 "Model can be set via CLI flags or environment.",
+                "GPT-5.5 is current top-end when available; GPT-5.4 is the broad fallback.",
                 "AGENTS.md repo instructions are supported.",
             ],
         )
@@ -93,7 +94,7 @@ def _detect_current_model(self) -> str | None:
         model = os.environ.get("CODEX_MODEL") or os.environ.get("OPENAI_MODEL")
         if model:
             return model
-        return "codex-mini"
+        return "gpt-5.4"
 
     def get_available_models(self) -> list[str]:
         """Get available OpenAI models."""
@@ -134,13 +135,16 @@ def resolve_capability_class(self, capability: CapabilityClass) -> str | None:
     def apply_prompt_strategy(self, task: TaskNode) -> dict:
         """Generate Codex-specific prompt strategy."""
         model = self.resolve_capability_class(task.preferred_capability_class)
+        hints = [
+            f"Use {model} for {task.type.value} tasks.",
+            f"Codex supports switching to this model via --model flag.",
+        ]
+        if model == "gpt-5.5":
+            hints.append("If GPT-5.5 is unavailable in your account, fall back to gpt-5.4.")
         return {
             "task_id": task.id,
             "task_type": task.type.value,
             "strategy": "model_switch",
             "target_model": model,
-            "hints": [
-                f"Use {model} for {task.type.value} tasks.",
-                f"Codex supports switching to this model via --model flag.",
-            ],
+            "hints": hints,
         }
diff --git a/src/routesmith/hosts/copilot.py b/src/routesmith/hosts/copilot.py
@@ -20,17 +20,19 @@ class CopilotHostAdapter(BaseHostAdapter):
 
     # Copilot may expose multiple models but switching is host-controlled
     MODEL_MAP: dict[CapabilityClass, str] = {
-        CapabilityClass.DEEP_REASONING: "claude-sonnet-4",
-        CapabilityClass.CODING: "claude-sonnet-4",
-        CapabilityClass.BALANCED: "gpt-4.1",
-        CapabilityClass.FAST: "gpt-4.1-mini",
+        CapabilityClass.DEEP_REASONING: "claude-opus-4.7",
+        CapabilityClass.CODING: "claude-sonnet-4.6",
+        CapabilityClass.BALANCED: "gpt-5.4",
+        CapabilityClass.FAST: "gpt-5-mini",
     }
 
     AVAILABLE_MODELS = [
-        "claude-sonnet-4",
-        "gpt-4.1",
-        "gpt-4.1-mini",
-        "o3-mini",
+        "claude-opus-4.7",
+        "claude-sonnet-4.6",
+        "gpt-5.5",
+        "gpt-5.4",
+        "gpt-5-mini",
+        "gemini-3.1-pro",
     ]
 
     def detect(self) -> HostDetectionResult:
@@ -80,6 +82,7 @@ def get_capabilities(self) -> HostCapabilities:
             model_family="mixed",
             notes=[
                 "Copilot model selection is controlled by the host IDE.",
+                "Available models vary by Copilot plan and rollout stage.",
                 "Direct model switching from skill code is not reliably supported.",
                 "Use .github/copilot-instructions.md and prompt files for guidance.",
                 "Task decomposition and prompt optimization are the primary strategies.",
diff --git a/src/routesmith/hosts/cursor.py b/src/routesmith/hosts/cursor.py
@@ -18,17 +18,19 @@ class CursorHostAdapter(BaseHostAdapter):
     """Adapter for Cursor IDE."""
 
     MODEL_MAP: dict[CapabilityClass, str] = {
-        CapabilityClass.DEEP_REASONING: "claude-sonnet-4",
-        CapabilityClass.CODING: "claude-sonnet-4",
-        CapabilityClass.BALANCED: "gpt-4.1",
-        CapabilityClass.FAST: "cursor-small",
+        CapabilityClass.DEEP_REASONING: "claude-opus-4.7",
+        CapabilityClass.CODING: "gpt-5.3-codex",
+        CapabilityClass.BALANCED: "claude-sonnet-4.6",
+        CapabilityClass.FAST: "composer-2",
     }
 
     AVAILABLE_MODELS = [
-        "claude-sonnet-4",
-        "gpt-4.1",
-        "gpt-4.1-mini",
-        "cursor-small",
+        "claude-opus-4.7",
+        "claude-sonnet-4.6",
+        "gpt-5.5",
+        "gpt-5.3-codex",
+        "gemini-3.1-pro",
+        "composer-2",
     ]
 
     def detect(self) -> HostDetectionResult:
diff --git a/src/routesmith/install/aider.py b/src/routesmith/install/aider.py
@@ -10,13 +10,13 @@
 # Aider supports model switching via --model flag
 
 # Recommended model for mixed tasks:
-# model: claude-sonnet-4-20250514
+# model: claude-sonnet-4-6
 
 # For planning-heavy tasks:
-# model: claude-opus-4-20250514
+# model: claude-opus-4-7
 
 # For fast formatting:
-# model: claude-haiku-3-5-20241022
+# model: claude-haiku-4-5
 """
 
 AIDERIGNORE_ADDITION = """\
diff --git a/src/routesmith/install/codex.py b/src/routesmith/install/codex.py
@@ -17,10 +17,10 @@
 - Auto mode is the default. Tasks are decomposed and routed to the best available OpenAI model.
 - Model routing respects host constraints.
 - Capability mapping:
-  - Deep reasoning (planning, analysis, review) -> strongest reasoning model (e.g., o3)
-  - Coding (implement, test, refactor) -> strongest coding model (e.g., codex-mini)
-  - Documentation -> balanced model (e.g., gpt-4.1)
-  - Formatting -> fastest model (e.g., gpt-4.1-mini)
+    - Deep reasoning (planning, analysis, review) -> strongest reasoning model (e.g., gpt-5.5; fall back to gpt-5.4)
+    - Coding (implement, test, refactor) -> strongest coding model (e.g., gpt-5.3-codex)
+    - Documentation -> balanced model (e.g., gpt-5.4)
+    - Formatting -> fastest model (e.g., gpt-5.4-mini)
 
 ## Task Decomposition
 
diff --git a/src/routesmith/server/stdio.py b/src/routesmith/server/stdio.py
@@ -6,6 +6,7 @@
 import sys
 from typing import Any
 
+from routesmith import __version__
 from routesmith.config import load_config
 from routesmith.executor import Executor
 from routesmith.hosts.detector import detect_host, get_host_capabilities
@@ -75,7 +76,7 @@ def handle_request(request: dict[str, Any]) -> dict[str, Any]:
             return _success(req_id, {
                 "protocolVersion": "2024-11-05",
                 "capabilities": {"tools": {}},
-                "serverInfo": {"name": "routesmith", "version": "0.1.0"},
+                "serverInfo": {"name": "routesmith", "version": __version__},
             })
 
         elif method == "notifications/initialized":
@@ -113,7 +114,7 @@ def handle_request(request: dict[str, Any]) -> dict[str, Any]:
             return _success(req_id, caps.model_dump())
 
         elif method == "ping":
-            return _success(req_id, {"status": "ok", "version": "0.1.0"})
+            return _success(req_id, {"status": "ok", "version": __version__})
 
         else:
             return _error(req_id, -32601, f"Unknown method: {method}")
diff --git a/tests/test_cli_snapshots.py b/tests/test_cli_snapshots.py
@@ -38,9 +38,9 @@ def test_run_shows_model_usage(self):
         assert "Model Usage" in result.output
 
     def test_run_with_model_flag(self):
-        result = runner.invoke(app, ["run", "--model", "claude-sonnet-4-20250514", "implement"])
+        result = runner.invoke(app, ["run", "--model", "claude-sonnet-4-6", "implement"])
         assert result.exit_code == 0
-        assert "claude-sonnet-4-20250514" in result.output
+        assert "claude-sonnet-4-6" in result.output
 
 
 class TestCLIExplain:
diff --git a/tests/test_host_capabilities.py b/tests/test_host_capabilities.py
@@ -36,7 +36,7 @@ def test_resolves_capability_classes(self):
             assert "claude" in model.lower()
 
     def test_set_model_known_model(self):
-        assert self.adapter.set_model("claude-sonnet-4-20250514") is True
+        assert self.adapter.set_model("claude-sonnet-4-6") is True
 
     def test_set_model_unknown_model(self):
         assert self.adapter.set_model("gpt-4") is False
diff --git a/tests/test_integration.py b/tests/test_integration.py
@@ -38,9 +38,9 @@ def test_run_multi_task_has_multiple_models(self):
     def test_run_with_pinned_model(self):
         config = SkillConfig()
         executor = Executor(config=config)
-        result = executor.run("implement a function", model="claude-sonnet-4-20250514")
+        result = executor.run("implement a function", model="claude-sonnet-4-6")
         # When host supports switching: model_used matches. Otherwise: advisory mentions pinned model.
-        has_model = any("claude-sonnet-4-20250514" in (task.model_used or "") for task in result.tasks)
+        has_model = any("claude-sonnet-4-6" in (task.model_used or "") for task in result.tasks)
         has_advisory = any("Pinned model" in msg for msg in result.advisory)
         assert has_model or has_advisory
 
