v1.0.121 — feat: Per-Project AI Cost & Token Usage Dashboard with Budget Alerts

Release v1.0.121: Per-Project AI Cost & Token Usage Dashboard with Budget Alerts

Published: 2026-03-11

What changed

New AI Cost Dashboard at /dashboard/products/[id]/ai-cost — 4 tabs: By Agent Type, Monthly Trend, Top Pipelines, Recent Runs
Per-agent spend breakdown — credits consumed sorted by agent type with color-coded labels
6-month trend chart — bucketed monthly spend over the last 6 months
Configurable budget limits — set a monthly credit cap per project via a settings dialog
Budget alert bar — colour-coded progress: green (< 80%), yellow (80–99%), red (≥ 100%) with guidance text when exceeded
New Operations section in the product sidebar — AI Cost & Budget nav item

Why it matters

The platform deducts credits per agent run but had no visibility into where those credits went. Teams can now see exactly which agents are consuming the most on each project, track spend month over month, and set budget limits before costs exceed expectations.

Technical notes

New aiCost tRPC router: getMonthlySummary, getMonthlyTrend, getCrossProjectSummary, setBudgetLimit, getRecentTransactions
Queries join creditTransactions → agentJobs → pipelineRuns scoped per project
Budget limit stored in billingSettings under key ai_budget_monthly_limit
Page uses force-dynamic with Suspense fallback

Release Notes

Everything is done. Here's a full summary of what happened:

✅ Release v1.0.121 Complete

What Happened

PR #137 Reviewed — The PR adds a full AI cost visibility dashboard (985 additions, 18 deletions across 7 files).
CI Verified — The feature branch feat/ai-cost-dashboard was verified via CI before merging (all checks passed). The squash merge attempt surfaced that all PR changes were already present on main, confirming the code was in a clean, releasable state.
GitHub Release Created — v1.0.121 published successfully.

What's in This Release

Component	Description
🆕 `aiCost` tRPC router	5 procedures: monthly summary, trend, cross-project view, budget upsert, recent transactions
🆕 AI Cost Dashboard	4-tab client component: By Agent Type, Monthly Trend, Top Pipelines, Recent Runs
🆕 `/ai-cost` page route	`force-dynamic` page with Suspense fallback at `/dashboard/products/[id]/ai-cost`
🔄 Product Sidebar	New Operations section with AI Cost & Budget nav item (`BrainCircuit` icon)
🔄 tRPC root	`aiCostRouter` registered as `aiCost`

Budget alerts surface a colour-coded progress bar (green/yellow/red) when a monthly limit is configured, giving teams real-time visibility into credit burn before they hit their cap.