feat: add model alias resolution and HTTP API (Part 2/2)

[yacosta738]

Summary

Part 2 of 2 for Model Aliasing & Normalization (#47). This PR integrates alias resolution into the routing flow, adds HTTP API for alias management, and completes the feature with comprehensive testing.

Depends on: #109 (PR #1: Foundation)

Changes

Phase 3: Resolution Logic

• Add [model_aliases] config section with enabled and auto_seed flags (both default to true)
• Wire SqliteModelAliasRepository into DI container with startup seeding (26 built-in aliases)
• Implement alias resolution in RouteRequest::execute_with_format() before restrictions check
• Fail-open error handling: if resolution fails, pass through original model ID
• Debug-level logging for resolution events

Phase 4: HTTP API

• GET /api/models/aliases — List all aliases (built-in + custom)
• POST /api/models/aliases — Create custom alias with validation (cycle prevention, non-empty fields)
• DELETE /api/models/aliases/:alias — Delete alias (404 if not found)

Phase 5: Final Verification

• 7 E2E tests for alias resolution flow (resolution, seeding, provider-scoped, concurrent access)
• 10 HTTP API integration tests (CRUD operations, validation, error cases)
• 5 config tests (defaults, enabled/disabled, auto_seed)

Test Results

Total: 548 tests passing
- 11 repository unit tests (from PR #1)
- 7 E2E tests (resolution flow)
- 10 HTTP API tests
- 5 config tests
- 515 existing tests (all passing)

✅ cargo test --all
✅ cargo clippy (no warnings)
✅ cargo fmt --check

Usage Example

Config (rook.toml)

[model_aliases]
enabled = true      # Enable alias resolution (default: true)
auto_seed = true    # Seed built-in aliases at startup (default: true)

Built-in Aliases (26 total, seeded automatically)

• OpenAI: gpt-4o-latest → gpt-4o-2024-05-13, gpt-4-turbo → gpt-4-turbo-2024-04-09, etc.
• Anthropic: claude-opus → claude-3-opus-20240229, claude-sonnet → claude-3-5-sonnet-20241022, etc.
• Google: gemini-pro → gemini-1.5-pro-latest, gemini-flash → gemini-1.5-flash-latest, etc.
• Mistral: mistral-large, mistral-small, ministral-8b
• Groq: groq-llama-3.1-70b, groq-llama-3.1-8b, groq-llama-3.3-70b

HTTP API Examples

# List all aliases
GET /api/models/aliases

# Create custom alias
POST /api/models/aliases
Body: {"alias": "my-gpt4", "canonical": "gpt-4o-2024-05-13", "providerId": null}

# Delete alias
DELETE /api/models/aliases/my-gpt4

Request Flow

1. Client sends request with model: "gpt-4o-latest"
2. Alias resolution resolves to gpt-4o-2024-05-13
3. Restrictions check sees canonical model
4. Router selects provider using canonical model
5. Audit log records canonical model

Related

• Closes Model Aliasing & Normalization #47
• Part 2 of 2 (depends on feat: add model alias domain model and SQLite repository (Part 1/2) #109)
• Implementation complete and verified

[coderabbitai]

Warning

Review limit reached

@yacosta738, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 5 minutes and 23 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info

⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 4c058cc1-e914-464b-966f-03f0f8542f86

📥 Commits

Reviewing files that changed from the base of the PR and between 91f140a and f6863c2.

⛔ Files ignored due to path filters (1)

• Cargo.lock is excluded by !**/*.lock

📒 Files selected for processing (23)

• Cargo.toml
• apps/rook/Cargo.toml
• apps/rook/src/config.rs
• apps/rook/src/di.rs
• apps/rook/tests/alias_routing_e2e.rs
• apps/rook/tests/config_tests.rs
• crates/application/rook-usecases/src/route_request.rs
• crates/application/rook-usecases/tests/route_request_restrictions.rs
• crates/domain/rook-core/src/model.rs
• crates/domain/rook-core/src/ports.rs
• crates/infrastructure/alias-sqlite/Cargo.toml
• crates/infrastructure/alias-sqlite/src/builtin.rs
• crates/infrastructure/alias-sqlite/src/lib.rs
• crates/infrastructure/alias-sqlite/src/repository.rs
• crates/infrastructure/db-migration/src/migrations/V5__model_aliases.sql
• crates/infrastructure/transport-axum/src/alias_routes.rs
• crates/infrastructure/transport-axum/src/bootstrap_helpers.rs
• crates/infrastructure/transport-axum/src/handlers/aliases.rs
• crates/infrastructure/transport-axum/src/handlers/mod.rs
• crates/infrastructure/transport-axum/src/lib.rs
• crates/infrastructure/transport-axum/src/routes.rs
• crates/infrastructure/transport-axum/tests/alias_api.rs
• crates/infrastructure/transport-axum/tests/format_translation_integration.rs

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/model-aliasing-integration

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}