claude-finops 0.1.0

package/config/pricing.json

@@ -0,0 +1,232 @@
+{
+  "_comment": "Model pricing in USD per 1,000,000 tokens. Kept SEPARATE from usage data so it can be updated without touching the dashboard. Any cost derived from these numbers is ESTIMATED, never actual billed cost.",
+  "currency": "USD",
+  "unit": "per_million_tokens",
+  "updated": "2026-09-18",
+  "source": "user-configurable list price table",
+  "default_model_pricing": {
+    "input": 3.0,
+    "output": 15.0,
+    "cache_write_5m": 3.75,
+    "cache_write_1h": 6.0,
+    "cache_read": 0.3
+  },
+  "models": {
+    "claude-opus-5": {
+      "display_name": "Claude Opus 5",
+      "tier": "frontier",
+      "input": 15.0,
+      "output": 75.0,
+      "cache_write_5m": 18.75,
+      "cache_write_1h": 30.0,
+      "cache_read": 1.5,
+      "context_window": 200000,
+      "provider": "anthropic"
+    },
+    "claude-opus-5[1m]": {
+      "display_name": "Claude Opus 5 (1M context)",
+      "tier": "frontier",
+      "input": 22.5,
+      "output": 112.5,
+      "cache_write_5m": 28.125,
+      "cache_write_1h": 45.0,
+      "cache_read": 2.25,
+      "context_window": 1000000,
+      "provider": "anthropic"
+    },
+    "claude-sonnet-5": {
+      "display_name": "Claude Sonnet 5",
+      "tier": "balanced",
+      "input": 3.0,
+      "output": 15.0,
+      "cache_write_5m": 3.75,
+      "cache_write_1h": 6.0,
+      "cache_read": 0.3,
+      "context_window": 200000,
+      "provider": "anthropic"
+    },
+    "claude-fable-5": {
+      "display_name": "Claude Fable 5",
+      "tier": "balanced",
+      "input": 3.0,
+      "output": 15.0,
+      "cache_write_5m": 3.75,
+      "cache_write_1h": 6.0,
+      "cache_read": 0.3,
+      "context_window": 200000,
+      "provider": "anthropic"
+    },
+    "claude-fable-5-1": {
+      "display_name": "Claude Fable 5.1",
+      "tier": "balanced",
+      "input": 3.0,
+      "output": 15.0,
+      "cache_write_5m": 3.75,
+      "cache_write_1h": 6.0,
+      "cache_read": 0.3,
+      "context_window": 200000,
+      "provider": "anthropic"
+    },
+    "claude-haiku-4-5-20251001": {
+      "display_name": "Claude Haiku 4.5",
+      "tier": "economy",
+      "input": 1.0,
+      "output": 5.0,
+      "cache_write_5m": 1.25,
+      "cache_write_1h": 2.0,
+      "cache_read": 0.1,
+      "context_window": 200000,
+      "provider": "anthropic"
+    },
+    "<synthetic>": {
+      "display_name": "Synthetic / local (no billed inference)",
+      "tier": "none",
+      "input": 0.0,
+      "output": 0.0,
+      "cache_write_5m": 0.0,
+      "cache_write_1h": 0.0,
+      "cache_read": 0.0,
+      "context_window": 0
+    },
+    "gpt-5.5": {
+      "display_name": "GPT-5.5 (Codex)",
+      "tier": "frontier",
+      "provider": "openai",
+      "input": 5.0,
+      "output": 30.0,
+      "cache_read": 0.5,
+      "cache_write_5m": 5.0,
+      "cache_write_1h": 5.0,
+      "context_window": 400000
+    },
+    "gpt-5.3-codex": {
+      "display_name": "GPT-5.3 Codex",
+      "tier": "balanced",
+      "provider": "openai",
+      "input": 1.75,
+      "output": 14.0,
+      "cache_read": 0.175,
+      "cache_write_5m": 1.75,
+      "cache_write_1h": 1.75,
+      "context_window": 400000
+    },
+    "gpt-5.2-codex": {
+      "display_name": "GPT-5.2 Codex",
+      "tier": "balanced",
+      "provider": "openai",
+      "input": 1.75,
+      "output": 14.0,
+      "cache_read": 0.175,
+      "cache_write_5m": 1.75,
+      "cache_write_1h": 1.75,
+      "context_window": 400000,
+      "_note": "Not on OpenAI's price list; priced as GPT-5.2"
+    },
+    "gpt-5.2": {
+      "display_name": "GPT-5.2",
+      "tier": "balanced",
+      "provider": "openai",
+      "input": 1.75,
+      "output": 14.0,
+      "cache_read": 0.175,
+      "cache_write_5m": 1.75,
+      "cache_write_1h": 1.75,
+      "context_window": 400000
+    },
+    "gpt-5.1": {
+      "display_name": "GPT-5.1",
+      "tier": "balanced",
+      "provider": "openai",
+      "input": 1.25,
+      "output": 10.0,
+      "cache_read": 0.125,
+      "cache_write_5m": 1.25,
+      "cache_write_1h": 1.25,
+      "context_window": 400000
+    },
+    "gpt-5": {
+      "display_name": "GPT-5",
+      "tier": "balanced",
+      "provider": "openai",
+      "input": 1.25,
+      "output": 10.0,
+      "cache_read": 0.125,
+      "cache_write_5m": 1.25,
+      "cache_write_1h": 1.25,
+      "context_window": 400000
+    },
+    "gpt-5-mini": {
+      "display_name": "GPT-5 mini",
+      "tier": "economy",
+      "provider": "openai",
+      "input": 0.25,
+      "output": 2.0,
+      "cache_read": 0.025,
+      "cache_write_5m": 0.25,
+      "cache_write_1h": 0.25,
+      "context_window": 400000
+    },
+    "gemini-2.5-flash": {
+      "display_name": "Gemini 2.5 Flash",
+      "tier": "economy",
+      "provider": "google",
+      "input": 0.3,
+      "output": 2.5,
+      "cache_read": 0.075,
+      "cache_write_5m": 0.3,
+      "cache_write_1h": 0.3,
+      "context_window": 1048576,
+      "_note": "Cache read: lower bound of Google's published range"
+    },
+    "gemini-2.5-pro": {
+      "display_name": "Gemini 2.5 Pro",
+      "tier": "frontier",
+      "provider": "google",
+      "input": 1.25,
+      "output": 10.0,
+      "cache_read": 0.3125,
+      "cache_write_5m": 1.25,
+      "cache_write_1h": 1.25,
+      "context_window": 1048576,
+      "_note": "<=200K prompt; $2.50/$15 above"
+    },
+    "gemini-3.5-flash": {
+      "display_name": "Gemini 3.5 Flash",
+      "tier": "balanced",
+      "provider": "google",
+      "input": 1.5,
+      "output": 9.0,
+      "cache_read": 0.375,
+      "cache_write_5m": 1.5,
+      "cache_write_1h": 1.5,
+      "context_window": 1048576
+    },
+    "gemini-3.8-flash": {
+      "display_name": "Gemini 3.8 Flash",
+      "tier": "economy",
+      "provider": "google",
+      "input": 0.75,
+      "output": 3.75,
+      "cache_read": 0.1875,
+      "cache_write_5m": 0.75,
+      "cache_write_1h": 0.75,
+      "context_window": 1048576,
+      "_note": "Promo price through 2026-12-31; $1.50/$7.50 after"
+    },
+    "cursor": {
+      "display_name": "Cursor (model not recorded)",
+      "tier": "none",
+      "provider": "cursor",
+      "input": 0,
+      "output": 0,
+      "cache_read": 0,
+      "cache_write_5m": 0,
+      "cache_write_1h": 0,
+      "_note": "Cursor bills by subscription and doesn't record the model locally: no cost is estimated"
+    }
+  },
+  "_sources": {
+    "openai": "https://developers.openai.com/api/docs/pricing (standard tier, 2026-09-18)",
+    "google": "https://ai.google.dev/gemini-api/docs/pricing (paid tier, 2026-09-18)"
+  }
+}

package/config/settings.json

@@ -0,0 +1,57 @@
+{
+  "_comment": "Shared defaults. Your own budgets and limits go in settings.local.json (the Settings screen writes there; it is gitignored). account.label is auto-detected from ~/.claude.json. Account, billing period, plan limits and budgets. Anything set to null is reported by the dashboard as 'Unavailable from connected Claude data' rather than being invented.",
+  "account": {
+    "label": null,
+    "plan_name": null,
+    "plan_type": null
+  },
+  "billing_period": {
+    "mode": "calendar_month",
+    "anchor_day": 1
+  },
+  "limits": {
+    "_comment": "Set these ONLY from your real plan. null => dashboard shows the metric as unavailable instead of guessing.",
+    "monthly_cost_allowance_usd": null,
+    "monthly_token_allowance": null,
+    "monthly_request_allowance": null,
+    "remaining_credits_usd": null
+  },
+  "budgets": {
+    "_comment": "Set your real budgets here. null => the dashboard reports 'No budget configured' instead of scoring you against an invented number.",
+    "monthly_usd": null,
+    "daily_usd": null,
+    "monthly_tokens": null,
+    "per_project_usd": {},
+    "per_model_usd": {}
+  },
+  "alert_thresholds_pct": [
+    50,
+    75,
+    90,
+    100
+  ],
+  "waste_rules": {
+    "long_prompt_chars": 6000,
+    "large_context_tokens": 150000,
+    "huge_session_tokens": 2000000,
+    "duplicate_window_minutes": 60,
+    "idle_gap_minutes": 45,
+    "simple_task_output_tokens": 400,
+    "frontier_tiers": [
+      "frontier"
+    ],
+    "low_output_ratio_vs_median": 0.4,
+    "_low_output_note": "Sessions are flagged when their output/billable ratio falls below this fraction of YOUR median session ratio, rather than an absolute number, because a healthy ratio depends on how agentic your workload is."
+  },
+  "anomaly": {
+    "daily_zscore": 2.0,
+    "daily_ratio": 2.0,
+    "session_ratio": 3.0
+  },
+  "scorecard": {
+    "_comment": "Reference points the 0-100 dimension scores are graded against. Derived from your own data by default; override to hold yourself to a different bar.",
+    "target_output_ratio": 0.0088,
+    "target_cost_per_1k_output_usd": 0.3,
+    "frontier_cost_share_allowance_pct": 40
+  }
+}