Files
codex-proxy-rs/docs/implementation-status.md
T
2026-06-11 22:06:17 +08:00

4.8 KiB

Implementation Status

Update this file before each feature commit.

Area Status Commit Verification Notes
Scaffold Completed fc47967 cargo fmt --check; cargo test; cargo clippy --all-targets --all-features --locked -- -D warnings Rust crate, lint policy, pinned TLS-sensitive dependencies, .gitignore, and minimal entry points are in place.
API contract docs Completed fc47967 cargo fmt --check; cargo test; cargo clippy --all-targets --all-features --locked -- -D warnings /v1/* OpenAI-compatible body, /admin/* frontend envelope, body codes, camelCase, and request ID policy are documented.
Configuration Completed 9ed8579 cargo test default_config_keeps_only_codex_backend; full fmt/test/clippy before commit Defines Codex-only config, default YAML, and Arc<AppServices> state shell.
SQLite storage Completed ffec8b5 cargo test sqlite_schema_creates_accounts_and_event_tables; full fmt/test/clippy before commit Creates SQLite WAL connector, sqlx-managed schema for accounts/API keys/sessions/cookies/fingerprints/events, and event/account indexes.
Admin auth and client API keys Completed 24d5799 cargo test client_api_key_has_proxy_prefix_and_verifies_against_hash; cargo test admin_password_hash_is_not_a_client_api_key; full fmt/test/clippy before commit Admin passwords use Argon2id, client API keys use cpr_ prefix plus HMAC-SHA256 with server-side pepper.
Secret encryption Completed 105aa58 cargo test secret_box_encrypts_and_decrypts_without_storing_plaintext; full fmt/test/clippy before commit AES-256-GCM SecretBox stores upstream secrets as v1:<nonce>:<ciphertext> without plaintext.
Logging and pagination Completed eb0341e + runtime logging scope commit cargo test event_logs_are_cursor_paginated; cargo test rotating_writer_splits_files_when_size_limit_is_reached; full fmt/test/clippy before commit Adds cursor pagination, Page<T> camelCase serialization, event log repository, runtime tracing initialization, HTTP trace layer, and date/size-based file rotation.
TLS headers and fingerprint Completed 1bdd08c cargo test codex_headers_include_desktop_identity_and_turn_state; cargo tree | rg 'reqwest|rustls'; full fmt/test/clippy before commit Adds Codex Desktop fingerprint model, exact identity/request headers, and pinned reqwest/rustls client builder.
Cookie persistence Completed 4710926 cargo test cookie_jar_captures_and_replays_account_scoped_cookies; full fmt/test/clippy before commit Adds account-scoped in-memory Cookie jar and repository shell; database persistence follows storage integration.
Account pool and refresh Completed 0f97c5c cargo test account_pool_skips_expired_disabled_banned_and_quota_exhausted_accounts; full fmt/test/clippy before commit Adds account statuses, acquisition filter, lifecycle events, token pair, OAuth config, and native refresh policy shell with no legacy compatibility layer.
Translation Completed eff182e cargo test chat_completion_translates_to_codex_response_request; full fmt/test/clippy before commit Adds OpenAI Chat request types, Codex Responses request type, translation, and OpenAI-compatible error body helper.
HTTP routes Completed ab0ad8f cargo test v1_requires_client_api_key_not_admin_cookie; full fmt/test/clippy before commit Adds Axum router, health route, /v1 unauthorized OpenAI error body, global request-id response header, and binary listener.
Admin/frontend response contract Completed 1c34ea7 cargo test admin_envelope_serializes_lower_camel_case_request_id; cargo test v1_response_has_request_id_header_without_admin_body_field; full fmt/test/clippy before commit Adds reusable admin envelopes with body codes, lower camelCase JSON, paginated list shape, requestId bodies, and keeps /v1/* OpenAI-compatible.
Upstream lifecycle Completed 88cad87 cargo test responses_route_rejects_non_codex_provider_models; cargo test v1_requires_client_api_key_not_admin_cookie; full fmt/test/clippy before commit /v1 accepts only Bearer cpr_..., rejects non-Codex provider models, and returns OpenAI-compatible errors.
Fingerprint updates Completed dd26d31 cargo test update_manifest_updates_app_version_and_build_number; full fmt/test/clippy before commit Parses Codex Desktop update manifests into app version and build number updates.
Runtime docs and packaging Completed 33b63f3 cargo fmt --check; cargo clippy --all-targets --all-features --locked -- -D warnings; cargo test; cargo run; curl -s -i http://127.0.0.1:8080/health README scope, .env.example, Dockerfile, compose file, and health smoke test are complete.