Cline rules

1# OpenCredits VS Code Extension - Project Rules
2 
3## Project Overview
4A VS Code extension that monitors API credits for multiple providers (OpenRouter, OpenAI, Anthropic, Gemini) and displays them in the status bar.
5 
6## Architecture Guidelines
7 
8### Core Principles
9- **Modular Design**: Each provider implements the same interface
10- **Type Safety**: Full TypeScript implementation with strict typing
11- **Security**: API keys stored in VS Code's SecretStorage
12- **Error Resilience**: Graceful handling of API failures with visual feedback
13- **Performance**: Efficient polling with configurable intervals
14 
15### Code Structure
16```
17src/
18├── extension.ts              # Main entry point
19├── providers/
20│   ├── interfaces/
21│   │   └── ICreditProvider.ts    # Provider interface
22│   ├── base/
23│   │   └── BaseProvider.ts       # Common functionality
24│   ├── OpenRouterProvider.ts
25│   ├── OpenAIProvider.ts
26│   ├── AnthropicProvider.ts
27│   └── GeminiProvider.ts
28├── statusBar/
29│   └── StatusBarManager.ts
30├── config/
31│   └── ConfigurationManager.ts
32└── utils/
33    └── apiClient.ts
34```
35 
36### Provider Interface Contract
37All providers must implement:
38- `getCredits(): Promise<CreditInfo>`
39- `validateApiKey(): Promise<boolean>`
40- `getName(): string`
41- `getShortName(): string`
42- `getIcon(): string`
43 
44### Status Bar Display Rules
45- 1 provider: `OpenRouter: $5.20`
46- 2 providers: `OR: $5.20 | OA: $10.50`
47- 3+ providers: `OR: $5.20 | OA: $10.50 | AN: 1.2M`
48- Error states: Show error icon with tooltip
49 
50### Configuration
51- API keys: Stored securely in VS Code SecretStorage
52- Update intervals: 1min, 5min, 15min, 30min, 1h, 6h, 24h
53- Provider toggles: Individual enable/disable per provider
54- Native credit formats: Mix of dollars, tokens, etc.
55 
56### Error Handling
57- Network failures: Show error icon in status bar
58- Invalid API keys: Visual feedback with configuration prompt
59- Rate limiting: Respect provider rate limits
60- Timeout handling: 10-second timeout for all API calls
61 
62### Development Standards
63- **No console.log**: Use VS Code's output channel for logging
64- **Async/await**: Preferred over Promises
65- **Error boundaries**: Catch and handle all async errors
66- **Memory cleanup**: Proper disposal of timers and subscriptions
67- **Testing**: Unit tests for all providers and core logic
68 
69### Security
70- Never log API keys
71- Use VS Code SecretStorage for sensitive data
72- Validate all user inputs
73- Sanitize error messages before display
74 
75## Implementation Priority
761. Core architecture (interfaces, base classes)
772. OpenRouter provider (primary focus)
783. Status bar integration
794. Configuration management
805. Other providers (stubs initially)
816. Polish and testing
82