Bump version to 0.1.3; enhance logging with correlation_id for better error tracing and add request lifecycle middleware

2026-07-23 22:50:52 +08:00
parent ac79dd0618
commit bba1cc2f56
10 changed files with 220 additions and 4 deletions
@@ -60,6 +60,7 @@ The proxy defaults to Opus because this deployment is intended for users whose N
 - As a Claude Code user, I can use tool calls and tool results.
 - As a multimodal user, I can send images through Claude-compatible image content blocks.
 - As a developer debugging setup, I can enable verbose logs without exposing tokens.
+- As a developer debugging issues, I can trace any error in the log file using a correlation_id that appears in both the client response and the log entry.

 ## Acceptance Criteria

@@ -70,6 +71,7 @@ The proxy defaults to Opus because this deployment is intended for users whose N
 - `--dev` startup reads current-directory `nexus-claude-api.local.json` instead of user config.
 - Default logs are written to `~/.config/nexus-claude-api/logs/nexus-claude-api-YYYY-MM-DD.log`.
 - `--dev` logs are written to current-directory `logs/nexus-claude-api-YYYY-MM-DD.log`.
+- All API errors (4xx, 5xx, network failures, client disconnects) are logged with correlation_id and duration.
 - Missing Nexus credentials fail fast with a clear error.
 - `GET /health` returns healthy status.
 - `GET /v1/models` returns the supported Claude models.