@revenium/claude-code-metering 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -4,47 +4,41 @@ All notable changes to this project will be documented in this file.
 
 ## [Unreleased]
 
-### Changed
-- **BREAKING**: Changed from `OTEL_LOGS_EXPORTER` to `OTEL_METRICS_EXPORTER` in generated config
-  - If you have an existing `~/.claude/revenium.env`, run `revenium-metering setup` to regenerate it
-  - The `status` command now detects old configs and warns about migration
+## [0.1.1] - 2026-01-21
 
-### Added
-- SDK standardization files (LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md, CHANGELOG.md)
-- Examples directory with usage samples
-- Migration detection in `status` command to identify outdated configurations
-- Unit tests for config content generation (OTEL exporter type validation)
+### Fixed
 
-## [0.1.0] - 2026-01-05
+- Corrected OTLP endpoint path from `/meter/v2/otel` to `/meter/v2/otlp`
+- Changed payload format from OTEL Metrics to OTLP Logs for correct backend compatibility
+- Updated endpoint URL from `/v1/metrics` to `/v1/logs`
+- Fixed response field from `processedMetrics` to `processedEvents`
 
-### Fixed
-- Changed OTEL endpoint from `/meter/v2/ai/otlp/v1/logs` to `/meter/v2/otel/v1/metrics` (PR #3)
-- Changed payload format from OTEL Logs to OTEL Metrics for correct API compatibility
+### Changed
+
+- Updated minimum Node.js version from 18.0.0 to 20.0.0
+- Migrated from OTEL Metrics format to OTLP Logs format
+- Updated test payload structure to match ClaudeCodeMapper backend expectations
+- Added email field support in test payloads for subscriber attribution
 
 ### Added
+
+- New `hashing.ts` utility module for transaction ID generation
+- Support for `user.email` attribute in log records
+- Improved error message truncation (max 200 chars) for better readability
+- SDK standardization files (LICENSE, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md)
+- Examples directory with usage samples
 - Interactive setup wizard (`revenium-metering setup`)
 - Status check command (`revenium-metering status`)
 - Test metric sender (`revenium-metering test`)
+- Backfill command for historical data import (`revenium-metering backfill`)
 - Shell profile auto-detection (bash, zsh, fish)
 - Subscription tier configuration (Pro, Max, Team, Enterprise, API)
 - Cost multiplier calculation based on subscription tier
 - Non-interactive mode with CLI flags
 - Verbose output option for debugging
-
-### Configuration
-- Creates `~/.claude/revenium.env` with OTEL environment variables
+- Creates `~/.claude/revenium.env` with OTLP environment variables
 - Automatic shell profile sourcing configuration
 - Support for custom endpoints (for development/testing)
 
-### Supported Tiers
-| Tier | Cost Multiplier | Effective Discount |
-|------|-----------------|-------------------|
-| Pro | 0.16 | 84% |
-| Max 5x | 0.16 | 84% |
-| Max 20x | 0.08 | 92% |
-| Team Premium | 0.24 | 76% |
-| Enterprise | 0.05 | 95% |
-| API | 1.0 | 0% |
-
-[Unreleased]: https://github.com/revenium/revenium-claude-code-metering/compare/v0.1.0...HEAD
-[0.1.0]: https://github.com/revenium/revenium-claude-code-metering/releases/tag/v0.1.0
+[Unreleased]: https://github.com/revenium/revenium-claude-code-sdk/compare/v0.1.1...HEAD
+[0.1.1]: https://github.com/revenium/revenium-claude-code-sdk/releases/tag/v0.1.1

package/README.md

@@ -1,202 +1,375 @@
 # @revenium/claude-code-metering
 
-[![npm version](https://img.shields.io/npm/v/@revenium/claude-code-metering.svg)](https://www.npmjs.com/package/@revenium/claude-code-metering)
-[![Node.js](https://img.shields.io/badge/Node.js-18%2B-green)](https://nodejs.org/)
-[![Documentation](https://img.shields.io/badge/docs-revenium.io-blue)](https://docs.revenium.io)
-[![Website](https://img.shields.io/badge/website-revenium.ai-blue)](https://www.revenium.ai)
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![CI](https://github.com/revenium/revenium-claude-code-sdk-internal/actions/workflows/ci.yml/badge.svg)](https://github.com/revenium/revenium-claude-code-sdk-internal/actions/workflows/ci.yml)
+[![Coverage](https://img.shields.io/badge/coverage-92.77%25-brightgreen)](https://github.com/revenium/revenium-claude-code-sdk-internal)
+[![Node.js](https://img.shields.io/badge/node-%3E%3D20.0.0-brightgreen)](https://nodejs.org)
+[![License](https://img.shields.io/badge/license-MIT-blue)](LICENSE)
 
-**CLI tool for automatic Revenium usage tracking with Claude Code**
+A CLI tool to configure Claude Code telemetry export to Revenium for AI usage metering and cost tracking.
 
-A professional-grade CLI tool that configures Claude Code to export OpenTelemetry (OTLP) telemetry data to Revenium's metering infrastructure. Enables usage tracking, cost attribution, and subscription optimization for Claude Code API calls.
+## Overview
 
-## Features
+This package configures Claude Code CLI to export OpenTelemetry (OTLP) telemetry data to Revenium's metering infrastructure. This enables:
 
-- **Zero-Code Integration** - Simple CLI setup, no code changes required
-- **Automatic Tracking** - Captures all Claude Code API calls automatically via OTLP
-- **Cost Attribution** - Track AI spend per developer, team, or project
-- **Subscription Tiers** - Apply subscription discounts (Pro, Max, Enterprise) to cost calculations
-- **Shell Integration** - Automatic shell profile configuration (Bash, Zsh, Fish)
-- **Non-Interactive Mode** - CI/CD friendly with command-line options
+- **Usage Tracking**: Monitor Claude Code API calls, token counts, and model usage
+- **Cost Attribution**: Track AI spend per developer, team, or project
+- **Subscription Optimization**: Apply subscription discounts (Pro/Max/Enterprise) to cost calculations
 
-## Prerequisites
-
-**Before starting, you'll need:**
-
-1. **Node.js 18+** - [Download](https://nodejs.org/)
-2. **Claude Code CLI** - [Installation guide](https://docs.anthropic.com/en/docs/claude-code)
-3. **Revenium API Key** - Obtain from [app.revenium.ai](https://app.revenium.ai):
-   - Sign up or log in
-   - Navigate to **Settings → API Keys**
-   - Create a new API key (starts with `hak_`)
-
----
-
-## Getting Started
-
-### 1. Install the Package
+## Installation
 
 ```bash
 npm install -g @revenium/claude-code-metering
 ```
 
-Or use npx (no install required):
+Or with npx (no install required):
 
 ```bash
 npx @revenium/claude-code-metering setup
 ```
 
-### 2. Run the Setup Wizard
+## Quick Start
+
+### 1. Run the Setup Wizard
 
 ```bash
 revenium-metering setup
 ```
 
 The wizard will prompt you for:
+
 - **API Key**: Your Revenium API key (`hak_...`)
 - **Email**: For usage attribution (optional)
-- **Subscription Tier**: Your Claude Code subscription
+- **Subscription Tier**: Your Claude Code subscription (Pro, Max, Team, Enterprise, or API)
 
-### 3. Restart Your Terminal
+### 2. Restart Your Terminal
 
 The setup automatically updates your shell profile. Either:
+
 - Open a new terminal, OR
 - Run: `source ~/.claude/revenium.env`
 
-### 4. Use Claude Code Normally
+### 3. Use Claude Code Normally
 
 That's it! Telemetry will be sent to Revenium automatically when you use Claude Code.
 
----
+> **Using an IDE?** If you use Claude Code through VS Code, Cursor, Windsurf, or JetBrains IDEs, see [IDE Configuration](#ide-configuration) for additional setup steps.
 
-## What Gets Tracked
+## Commands
 
-The tool configures Claude Code to export the following via OpenTelemetry:
+### `revenium-metering setup`
 
-### **Usage Metrics**
+Interactive setup wizard to configure Claude Code metering.
 
-- **Session ID** - Unique identifier for each Claude Code session
-- **Model Information** - Model used (claude-opus-4-5, claude-sonnet-4, etc.)
-- **Token Counts** - Input tokens, output tokens, cache read/creation tokens
-- **Request Timing** - Request timestamps
+```bash
+revenium-metering setup [options]
 
-### **Cost Attribution**
+Options:
+  -k, --api-key <key>       Revenium API key (hak_...)
+  -e, --email <email>       Email for usage attribution
+  -t, --tier <tier>         Subscription tier (pro, max_5x, max_20x, team_premium, enterprise, api)
+  -o, --organization <name> Organization name for cost attribution
+  -p, --product <name>      Product name for cost attribution
+  --endpoint <url>          Revenium API endpoint URL (default: https://api.revenium.ai)
+  --skip-shell-update       Skip automatic shell profile update
+```
 
-- **Subscription Tier** - Applied cost multiplier based on your plan
-- **Email** - For per-developer attribution
-- **Organization/Product IDs** - Optional business context
+**Non-interactive mode:**
 
----
+```bash
+revenium-metering setup \
+  --api-key hak_your_key_here \
+  --email developer@company.com \
+  --tier pro
 
-## API Overview
+# With organization and product attribution:
+revenium-metering setup \
+  --api-key hak_your_key_here \
+  --email developer@company.com \
+  --tier pro \
+  --organization my-team \
+  --product backend-api
+```
+
+### `revenium-metering status`
+
+Check current configuration and endpoint connectivity.
+
+```bash
+revenium-metering status
+```
 
-### Commands
+Outputs:
 
-| Command | Description |
-|---------|-------------|
-| `revenium-metering setup` | Interactive configuration wizard |
-| `revenium-metering status` | Check current configuration and connectivity |
-| `revenium-metering test` | Send test metric to verify integration |
+- Current configuration settings
+- Endpoint health check
+- Authentication status
 
-### Setup Options
+### `revenium-metering test`
+
+Send a test metric to verify the integration is working.
 
 ```bash
-revenium-metering setup [options]
+revenium-metering test [options]
 
 Options:
-  -k, --api-key <key>     Revenium API key (hak_...)
-  -e, --email <email>     Email for usage attribution
-  -t, --tier <tier>       Subscription tier
-  --endpoint <url>        Revenium API endpoint (default: https://api.revenium.ai)
-  --skip-shell-update     Skip automatic shell profile update
+  -v, --verbose    Show detailed payload information
 ```
 
-**Non-interactive mode (CI/CD):**
+### `revenium-metering backfill`
+
+Import historical Claude Code usage data from local JSONL files stored in `~/.claude/projects/`. This is useful for sending past usage to Revenium when you first set up metering.
 
 ```bash
-revenium-metering setup \
-  --api-key hak_your_key_here \
-  --email developer@company.com \
-  --tier pro
+revenium-metering backfill [options]
+
+Options:
+  --since <date>      Only backfill records after this date
+  --dry-run           Show what would be sent without actually sending
+  --batch-size <n>    Records per API batch (default: 100)
+  -v, --verbose       Show detailed progress and sample payloads
 ```
 
----
+**Date formats for `--since`:**
 
-## Configuration
+- Relative: `7d` (7 days), `2w` (2 weeks), `1m` (1 month), `1y` (1 year)
+- ISO format: `2024-01-15` or `2024-01-15T00:00:00Z`
 
-### Environment Variables
+**Examples:**
 
-The setup creates `~/.claude/revenium.env` with:
+```bash
+# Preview what would be sent (recommended first step)
+revenium-metering backfill --dry-run
+
+# Backfill only the last 30 days
+revenium-metering backfill --since 30d
+
+# Backfill since a specific date with verbose output
+revenium-metering backfill --since 2024-12-01 --verbose
+
+# Full backfill of all historical data
+revenium-metering backfill
+```
 
-| Variable | Description |
-|----------|-------------|
-| `CLAUDE_CODE_ENABLE_TELEMETRY` | Enables Claude Code telemetry export (`1`) |
-| `OTEL_EXPORTER_OTLP_ENDPOINT` | Revenium OTLP endpoint URL |
-| `OTEL_EXPORTER_OTLP_HEADERS` | Authentication header with API key |
-| `OTEL_EXPORTER_OTLP_PROTOCOL` | OTLP protocol (`http/json`) |
-| `OTEL_METRICS_EXPORTER` | Set to `otlp` to enable metrics export |
-| `OTEL_RESOURCE_ATTRIBUTES` | Cost multiplier based on subscription tier |
+**What it does:**
+
+1. Scans `~/.claude/projects/` for JSONL session files
+2. Extracts usage records (model, tokens, timestamps) from assistant messages
+3. Batches records and sends them to Revenium's OTLP endpoint
+4. Applies your configured subscription tier's cost multiplier
+
+## Configuration
+
+The setup wizard creates `~/.claude/revenium.env` with the following environment variables:
+
+| Variable                       | Description                                                                        |
+| ------------------------------ | ---------------------------------------------------------------------------------- |
+| `CLAUDE_CODE_ENABLE_TELEMETRY` | Enables Claude Code telemetry export (set to `1`)                                  |
+| `OTEL_EXPORTER_OTLP_ENDPOINT`  | Revenium OTLP endpoint URL                                                         |
+| `OTEL_EXPORTER_OTLP_HEADERS`   | Authentication header with API key                                                 |
+| `OTEL_EXPORTER_OTLP_PROTOCOL`  | OTLP protocol (`http/json`)                                                        |
+| `OTEL_LOGS_EXPORTER`           | **Required** - Set to `otlp` to enable log export                                  |
+| `OTEL_RESOURCE_ATTRIBUTES`     | Comma-separated key=value pairs (cost_multiplier, organization.name, product.name) |
 
 ### Subscription Tiers
 
-| Tier | Monthly Cost | Cost Multiplier | Effective Discount |
-|------|-------------|-----------------|-------------------|
-| Pro | $20/mo | 0.16 | 84% |
-| Max 5x | $100/mo | 0.16 | 84% |
-| Max 20x | $200/mo | 0.08 | 92% |
-| Team Premium | $150/seat | 0.24 | 76% |
-| Enterprise | Custom | 0.05 | 95% |
-| API (no subscription) | Pay-per-token | 1.0 | 0% |
+| Tier                  | Monthly Cost  | Cost Multiplier | Effective Discount |
+| --------------------- | ------------- | --------------- | ------------------ |
+| Pro                   | $20/mo        | 0.16            | 84%                |
+| Max 5x                | $100/mo       | 0.16            | 84%                |
+| Max 20x               | $200/mo       | 0.08            | 92%                |
+| Team Premium          | $150/seat     | 0.24            | 76%                |
+| Enterprise            | Custom        | 0.05            | 95%                |
+| API (no subscription) | Pay-per-token | 1.0             | 0%                 |
+
+#### How Cost Multipliers Are Calculated
+
+The cost multiplier represents the effective cost as a percentage of API pricing. These values are **estimates based on fully consuming the monthly token allotment** for each tier compared to API costs for the same usage.
+
+**Calculation Basis:** The Max 20x tier provides real usage data as the baseline.
+
+- Max 20x: $200 for 20X tokens → $2,500 API equivalent → **$125 per X tokens** at API rates
+
+Using this baseline, other tiers are calculated:
+
+- **Pro**: $20 for X tokens → $20 / $125 = 0.16 (84% discount)
+- **Max 5x**: $100 for 5X tokens → $100 / $625 = 0.16 (84% discount)
+- **Max 20x**: $200 for 20X tokens → $200 / $2,500 = 0.08 (92% discount - best value per dollar)
+- **Team Premium**: $150 for 5X tokens → $150 / $625 = 0.24 (76% discount)
+- **Enterprise**: Custom pricing with negotiated discounts = 0.05 (95% discount)
+
+**Key Insight:** Higher tiers provide better value per dollar. Max 20x offers 4x the usage of Max 5x for only 2x the cost, resulting in a better discount (92% vs 84%).
+
+#### Manual Cost Multiplier Override
+
+If you want to use a custom cost multiplier instead of the tier defaults, you can manually edit `~/.claude/revenium.env` after running setup:
+
+1. Run the setup wizard first:
+
+   ```bash
+   revenium-metering setup
+   ```
+
+2. Edit `~/.claude/revenium.env` and add/modify the cost multiplier:
+
+   ```bash
+   # Add this line with your custom multiplier (e.g., 0.12 for 88% discount)
+   export CLAUDE_CODE_COST_MULTIPLIER=0.12
+   ```
+
+3. Update the `OTEL_RESOURCE_ATTRIBUTES` line to use your custom value:
+
+   ```bash
+   export OTEL_RESOURCE_ATTRIBUTES="cost_multiplier=0.12"
+   ```
+
+4. Reload your environment:
+   ```bash
+   source ~/.claude/revenium.env
+   ```
 
-### Optional: Organization & Product IDs
+This allows you to set custom discount rates based on negotiated pricing or internal cost allocation policies.
 
-For business context tracking, you can set additional environment variables:
+### Organization & Product Attribution
+
+You can attribute Claude Code costs to specific organizations (customers/teams) and products (projects). This is useful for:
+
+- **Consulting firms**: Track AI costs per client project
+- **Internal teams**: Separate costs by product (mobile-app, backend-api, etc.)
+- **Cost centers**: Attribute AI spend to business units
+
+#### Option 1: Use CLI Flags (Recommended)
 
 ```bash
-export REVENIUM_ORGANIZATION_ID=your-org-id
-export REVENIUM_PRODUCT_ID=your-product-id
+revenium-metering setup \
+  --api-key hak_your_key \
+  --tier max_20x \
+  --organization engineering \
+  --product backend-api
 ```
 
----
+#### Option 2: Edit OTEL_RESOURCE_ATTRIBUTES Directly
+
+Add `organization.name` and/or `product.name` to the `OTEL_RESOURCE_ATTRIBUTES` line in `~/.claude/revenium.env`:
+
+```bash
+# Before:
+export OTEL_RESOURCE_ATTRIBUTES="cost_multiplier=0.08"
+
+# After:
+export OTEL_RESOURCE_ATTRIBUTES="cost_multiplier=0.08,organization.name=engineering,product.name=backend-api"
+```
+
+Then reload: `source ~/.claude/revenium.env`
+
+> **Important**: The backend **only** reads `organization.name` and `product.name` from `OTEL_RESOURCE_ATTRIBUTES`. Do not set them as standalone environment variables - they will not be sent to Revenium.
+
+## How It Works
 
-## Examples
+1. **Claude Code CLI** exports OTLP telemetry when configured with the proper environment variables
+2. **This package** generates the configuration file (`~/.claude/revenium.env`) with the correct settings
+3. **Revenium's OTLP endpoint** (`/meter/v2/ai/otlp/v1/logs`) receives and translates the telemetry
+4. **Revenium** processes the data for cost tracking, attribution, and analytics
 
-**For complete examples and usage patterns, see [`examples/README.md`](https://github.com/revenium/revenium-claude-code-sdk/blob/HEAD/examples/README.md).**
+### Telemetry Data
 
-### Quick Examples
+Claude Code exports the following data points:
+
+- Session ID
+- Model used (claude-opus-4-5, claude-sonnet-4, etc.)
+- Input token count
+- Output token count
+- Cache read/creation tokens
+- Request timestamps
+
+## Manual Configuration
+
+If automatic shell profile update fails, add this line to your shell profile:
+
+**Bash** (`~/.bashrc` or `~/.bash_profile`):
 
 ```bash
-# Interactive setup
-revenium-metering setup
+[ -f ~/.claude/revenium.env ] && source ~/.claude/revenium.env
+```
 
-# Non-interactive (CI/CD)
-revenium-metering setup --api-key hak_key --tier pro
+**Zsh** (`~/.zshrc`):
 
-# Check status
-revenium-metering status
+```zsh
+[ -f ~/.claude/revenium.env ] && source ~/.claude/revenium.env
+```
+
+**Fish** (`~/.config/fish/config.fish`):
+
+```fish
+if test -f ~/.claude/revenium.env
+    source ~/.claude/revenium.env
+end
+```
+
+## IDE Configuration
+
+If you use Claude Code through an IDE's integrated terminal, the shell profile configuration from `revenium-metering setup` should work automatically - just restart your IDE.
+
+If telemetry isn't working, configure the environment variables directly in your IDE:
+
+### VS Code, Cursor, Windsurf (and other VS Code-based editors)
 
-# Test the integration
-revenium-metering test --verbose
+Add to your `settings.json` (use `terminal.integrated.env.windows` or `.linux` as needed):
+
+```json
+{
+  "terminal.integrated.env.osx": {
+    "CLAUDE_CODE_ENABLE_TELEMETRY": "1",
+    "OTEL_LOGS_EXPORTER": "otlp",
+    "OTEL_EXPORTER_OTLP_ENDPOINT": "https://api.revenium.ai/meter/v2/otlp",
+    "OTEL_EXPORTER_OTLP_HEADERS": "x-api-key=hak_YOUR_API_KEY_HERE",
+    "OTEL_EXPORTER_OTLP_PROTOCOL": "http/json",
+    "OTEL_RESOURCE_ATTRIBUTES": "cost_multiplier=0.08,organization.name=my-org,product.name=my-product"
+  }
+}
 ```
 
----
+> **Note**: Include `organization.name` and `product.name` in `OTEL_RESOURCE_ATTRIBUTES` if you want cost attribution. See [Organization & Product Attribution](#organization--product-attribution).
+
+**Tip:** Run `revenium-metering setup` first, then copy the values from `~/.claude/revenium.env`.
+
+### JetBrains IDEs
+
+Go to **Settings** > **Tools** > **Terminal** > **Environment variables** and add the same variables in semicolon-separated format.
+
+### Other IDEs
+
+Configure these environment variables in your IDE's terminal settings:
+
+| Variable                       | Value                                                                   |
+| ------------------------------ | ----------------------------------------------------------------------- |
+| `CLAUDE_CODE_ENABLE_TELEMETRY` | `1`                                                                     |
+| `OTEL_LOGS_EXPORTER`           | `otlp`                                                                  |
+| `OTEL_EXPORTER_OTLP_ENDPOINT`  | `https://api.revenium.ai/meter/v2/otlp`                                 |
+| `OTEL_EXPORTER_OTLP_HEADERS`   | `x-api-key=hak_YOUR_API_KEY`                                            |
+| `OTEL_EXPORTER_OTLP_PROTOCOL`  | `http/json`                                                             |
+| `OTEL_RESOURCE_ATTRIBUTES`     | `cost_multiplier=0.08,organization.name=my-org,product.name=my-product` |
+
+See [Subscription Tiers](#subscription-tiers) for cost multiplier values and [Organization & Product Attribution](#organization--product-attribution) for attribution options.
 
 ## Troubleshooting
 
 ### Telemetry not appearing in Revenium
 
 1. **Check configuration:**
+
    ```bash
    revenium-metering status
    ```
 
 2. **Verify environment variables are loaded:**
+
    ```bash
-   echo $OTEL_METRICS_EXPORTER  # Should output: otlp
+   echo $OTEL_LOGS_EXPORTER  # Should output: otlp
    echo $CLAUDE_CODE_ENABLE_TELEMETRY  # Should output: 1
    ```
 
 3. **Send a test metric:**
+
    ```bash
    revenium-metering test --verbose
    ```
@@ -211,64 +384,75 @@ revenium-metering test --verbose
 
 ### Shell profile not updated
 
-Run setup with manual instructions:
+Run the setup with manual instructions:
+
 ```bash
 revenium-metering setup --skip-shell-update
 ```
 
-Then manually add to your shell profile:
+Then manually add the source line to your shell profile.
+
+## Local Development Testing
+
+For testing against local Revenium infrastructure:
 
-**Bash/Zsh:**
 ```bash
-[ -f ~/.claude/revenium.env ] && source ~/.claude/revenium.env
+revenium-metering setup \
+  --api-key hak_your_test_key \
+  --endpoint http://localhost:8082 \
+  --tier pro
 ```
 
-**Fish:**
-```fish
-if test -f ~/.claude/revenium.env
-    source ~/.claude/revenium.env
-end
-```
+Note: The local metering service must be running on port 8082 with Kafka connectivity.
+
+## Requirements
+
+- Node.js >= 20.0.0
+- Claude Code CLI installed
+- Revenium API key (obtain from app.revenium.ai)
 
-### Debug Mode
+## Development
+
+### Running Tests
 
-Enable detailed logging:
 ```bash
-REVENIUM_DEBUG=true revenium-metering status
+npm test
+npm test -- --coverage
 ```
 
----
+### CI/CD
 
-## Documentation
+This project uses GitHub Actions for continuous integration. The CI pipeline runs on every push and pull request to `main`:
 
-For detailed documentation, visit [docs.revenium.io](https://docs.revenium.io)
+**Test Matrix:**
 
-## Contributing
+- Node.js 20.x (LTS)
+- Linting with ESLint
+- TypeScript compilation
+- Unit and integration tests with coverage
 
-See [CONTRIBUTING.md](https://github.com/revenium/revenium-claude-code-sdk/blob/HEAD/CONTRIBUTING.md)
+**Coverage Requirements:**
 
-## Code of Conduct
+The CI enforces minimum coverage thresholds via Vitest:
 
-See [CODE_OF_CONDUCT.md](https://github.com/revenium/revenium-claude-code-sdk/blob/HEAD/CODE_OF_CONDUCT.md)
+- `backfill.ts`: >80%
+- `setup.ts`: >80%
+- `detector.ts`: >80%
+- `profile-updater.ts`: >80%
 
-## Security
+The CI will fail if:
 
-See [SECURITY.md](https://github.com/revenium/revenium-claude-code-sdk/blob/HEAD/SECURITY.md)
+- Linting errors are found
+- TypeScript compilation fails
+- Any test fails
+- Coverage thresholds are not met
 
 ## License
 
-This project is licensed under the MIT License - see the [LICENSE](https://github.com/revenium/revenium-claude-code-sdk/blob/HEAD/LICENSE) file for details.
+MIT
 
 ## Support
 
-For issues, feature requests, or contributions:
-
-- **Website**: [www.revenium.ai](https://www.revenium.ai)
-- **GitHub Repository**: [revenium/revenium-claude-code-sdk](https://github.com/revenium/revenium-claude-code-sdk)
-- **Issues**: [Report bugs or request features](https://github.com/revenium/revenium-claude-code-sdk/issues)
-- **Documentation**: [docs.revenium.io](https://docs.revenium.io)
-- **Email**: support@revenium.io
-
----
-
-**Built by Revenium**
+- Issues: https://github.com/revenium/revenium-claude-code-sdk-internal/issues
+- Documentation: https://docs.revenium.ai
+- Dashboard: https://app.revenium.ai