Cline rules

1# Project Overview
2 
3## Brief overview
4 
5This is a Cloudflare Worker proxy for OpenAI-compatible and Claude-compatible AI clients (Cline, Claude Code, etc.). It receives local client requests, resolves friendly model aliases, and forwards requests to upstream LLM providers (NVIDIA NIM, OpenRouter, LMStudio, LlamaCPP, Ollama, Google, Claude/Anthropic).
6 
7## Tech Stack
8 
9- **Runtime**: Cloudflare Workers with Durable Objects for async flows
10- **Framework**: Hono (lightweight web framework)
11- **Language**: TypeScript
12- **Testing**: Vitest with Node.js compatibility mocks
13- **Package Manager**: pnpm with strict supply-chain hardening
14- **Primary Pattern**: Proxy — forward OpenAI-compatible and Claude-compatible requests to upstream LLM providers
15 
16## Key Concerns
17 
18- Model alias resolution (friendly names → upstream IDs)
19- Streaming SSE response preservation
20- Error status code forwarding from upstream
21- Provider-agnostic interface
22- Rate limiting
23- Metrics collection via Cloudflare Analytics Engine
24- **Claude API compatibility** — translates Claude `/v1/messages` to OpenAI upstream and back
25 
26## Project Structure
27 
28- `server.ts` — Hono app entrypoint, middleware, error handler, Durable Object re-export
29- `controllers/` — Business logic controllers (all request processing happens here)
30  - `chat.ts` — OpenAI-compatible chat completions
31  - `claude-messages.ts` — Claude-compatible `/v1/messages` endpoint
32  - `count-tokens.ts` — Claude-compatible token counting
33  - `health.ts` — Health check endpoint
34  - `legacy.ts` — Backward-compatible model listing
35  - `models.ts` — Model discovery endpoints
36  - `process.ts` — Async Durable Object workflow
37  - `root.ts` — Root endpoint
38  - `stop.ts` — Stop all pending tasks
39  - `probe.ts` — HEAD/OPTIONS probe handler
40- `routes/` — Thin route registration (delegates immediately to controllers)
41- `providers/` — Provider implementations (NVIDIA, OpenRouter, local, Claude, Google)
42- `config/providers.ts` — Provider configs, model aliases, model resolution, Claude tier mapping
43- `interfaces/` — Shared TypeScript interfaces
44- `metrics/` — Metrics collection and Analytics Engine queries
45- `utils/` — Logger, response helpers, Claude model mapping, Claude request utilities
46- `errors/` — Provider error classes
47- `parsers/` — Tool call and think tag parsers
48- `transformers/` — Claude ↔ OpenAI format transformers, RTK filter pipeline
49- `durable-objects/` — Async processing with Durable Objects
50