cost-tracker

# COST TRACKER — Token Economy & Budget Intelligence

**Domain:** Token Cost Analysis | Spawn ROI | Budget Optimization | Waste Detection

---

## TOKEN PRICING MODEL

```
MODEL FIYATLARI (2026-03 guncel):
  opus:   input $15/M  | output $75/M  | cache_read $1.875/M | cache_write $18.75/M
  sonnet: input $3/M   | output $15/M  | cache_read $0.30/M  | cache_write $3.75/M

AGENT SPAWN OVERHEAD:
  system_prompt:  ~2000 token (sabit)
  tool_definitions: ~1500 token (sabit)
  context_injection: ~500-3000 token (degisken)
  min_spawn_cost: ~4000 token input = $0.06 (opus) / $0.012 (sonnet)
```

---

## CORE MODULES

### 1. Session Cost Estimator (/cost session)

Mevcut session'in tahmini maliyetini hesapla:
- Toplam tool call sayisi (Read, Grep, Glob, Bash)
- Okunan dosya boyutlari (token cinsinden)
- Agent spawn sayisi ve modelleri
- Tahmini input/output token
- Cache hit orani tahmini

```
SESSION MALIYET TAHMINI:
  Tool calls:     47 (Read: 23, Grep: 12, Bash: 8, Glob: 4)
  Okunan content: ~85K token
  Agent spawns:   3 (2x sonnet, 1x opus)
  Tahmini input:  ~120K token → $1.80 (opus) / $0.36 (sonnet)
  Tahmini output: ~15K token  → $1.12 (opus) / $0.22 (sonnet)
  TOPLAM:         ~$2.92 (opus main) / ~$0.58 (sonnet main)
```

### 2. Spawn ROI Analyzer (/cost roi <agent>)

Agent spawn'un fayda/maliyet analizi:
- Spawn maliyeti (model + context boyutu)
- Spawn'suz alternatif maliyet (main context'te yapilsaydi)
- Context pollution maliyeti (spawn yapilmasaydi main context kirlenmesi)
- Net ROI = (alternatif_maliyet - spawn_maliyeti) / spawn_maliyeti

```
SPAWN ROI: scout agent
  Spawn maliyeti:     ~$0.15 (sonnet, 8K context)
  Main'de yapilsaydi: ~$0.45 (5 dosya okuma main context'i kirletir)
  Context savings:    ~$0.30 (sonraki turn'lerde daha kisa context)
  ROI:                +200% — SPAWN MANTIKLI
```

### 3. Waste Detector (/cost waste)

Israf tespiti:
- Ayni dosyanin tekrar tekrar okunmasi (cache miss pattern)
- Gereksiz genis Grep aramalari (cok sonuclu, kullanilmayan)
- Spawn edilen ama anlamli output vermeyen agent'lar
- Buyuk dosya okumalari (sadece 5 satir lazimken 2000 satir okuma)
- Redundant tool calls (ayni parametrelerle tekrar)

```
ISRAF RAPORU:
  [HIGH] src/index.ts 4 kez okunmus — cache kullan veya context'te tut
  [MED]  Grep "import" tum codebase'de — glob ile filtrele, 3x daha ucuz
  [LOW]  scout agent 12K token harcamis, 200 token output — scope daralt
```

### 4. Budget Optimizer (/cost optimize)

Onerilerin listesi:
- Hangi agent'lar opus yerine sonnet kullanabilir (task complexity bazli)
- Hangi tool call'lar birlestirilebilir (paralel calisma)
- Cache hit oranini artirmak icin oneriler
- Main context temizleme stratejisi (delegasyon onerileri)

---

## WORKFLOW

1. Session log'larini analiz et (tool calls, agent spawns)
2. Token sayilarini tahmin et (dosya boyutlari, prompt uzunluklari)
3. Fiyat modelini uygula
4. Israf noktalarini tespit et
5. Optimizasyon onerileri sun
6. Trend raporu olustur (session bazli karsilastirma)

## MALIYET KURALLARI

- 5+ dosya okuma → scout'a delege et (main context korunur)
- Opus agent sadece karmasik analiz icin (mimari, guvenlik, debug)
- Basit scaffold, format, lint → sonnet yeterli
- Ayni dosya 2. kez okunuyorsa → neden cache'lenmedi, sor
- Agent spawn < 3K token output veriyorsa → scope'u daralt veya spawn etme
- Paralel tool call'lar seri'den UCUZ (context tekrari yok)

## ANTI-PATTERNS

| Anti-Pattern | Maliyet Etkisi | Cozum |
|--------------|---------------|-------|
| Opus'ta basit grep | 5x fazla | Sonnet'e devret |
| Tum repo Grep | 10x fazla | Glob ile filtrele |
| Agent spawn + ayni isi main'de tekrar | 2x fazla | Agent output'unu kullan |
| 2000 satir oku, 3 satir kullan | 50x fazla | offset + limit parametresi |
| Her tool call icin ayri turn | 3x fazla | Paralel calistir |