Extract token-type and per-model cost calculations from cmd/costs.go
into a dedicated pipeline.AggregateCostBreakdown() function. This
eliminates duplicate cost calculation logic between CLI and TUI.
New types:
- TokenTypeCosts: aggregate costs by input/output/cache types
- ModelCostBreakdown: per-model cost components
Benefits:
- Single source of truth for cost calculations
- Uses LookupPricingAt() for historical accuracy
- Both CLI and TUI now share the same cost logic
- Easier to maintain and extend
Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Address golangci-lint findings and improve error handling throughout:
Package doc comments:
- Add canonical "// Package X ..." comments to source, model, config,
pipeline, cli, store, and main packages for godoc compliance.
Security & correctness:
- Fix directory permissions 0o755 -> 0o750 in store/cache.go Open()
(gosec G301: restrict group write on cache directory)
- Fix config.Save() to check encoder error before closing file, preventing
silent data loss on encode failure
- Add //nolint:gosec annotations with justifications on intentional
patterns (constructed file paths, manual bounds checking, config fields)
- Add //nolint:nilerr on intentional error-swallowing in scanner WalkDir
- Add //nolint:revive on stuttering type names (ModelStats, ModelUsage)
that would break too many call sites to rename
Performance (perfsprint):
- Replace fmt.Sprintf("%d", n) with strconv.FormatInt(n, 10) in format.go
FormatTokens() and FormatNumber() hot paths
- Clean up redundant fmt.Sprintf patterns in FormatCost and FormatDelta
Code cleanup:
- Convert if-else chain to switch in parser.go skipJSONString() for clarity
- Remove unused indexedResult struct from pipeline/loader.go
- Add deferred cache.Close() in pipeline/bench_test.go to prevent leaks
- Add deferred cache.Close() in cmd/root.go data loading path
- Fix doc comment alignment in scanner.go decodeProjectName
- Remove trailing blank line in cmd/costs.go
- Fix duplicate "/day" suffix in cmd/summary.go cost-per-day formatting
- Rename shadowed variable 'max' -> 'maxVal' in cli/render.go Sparkline
Implement the complete Cobra command tree (11 subcommands):
- cmd/root.go: Root command with persistent flags (--days, --project,
--model, --no-cache, --data-dir, --quiet, --no-subagents). Shared
loadData() orchestrates the full pipeline: tries cache-assisted
loading first, falls back to uncached parse on cache failure,
reports progress to stderr. applyFilters() applies project/model
substring filters and computes the time window.
- cmd/summary.go: Default command (also "cburn summary"). Renders a
bordered metrics table with token breakdown (5 types), cost with
cache savings, and per-day rates with period-over-period deltas.
- cmd/costs.go: Detailed cost analysis — breaks down costs by token
type (output, cache_write_1h, input, cache_write_5m, cache_read)
with share percentages, period comparison bar chart, and per-model
cost breakdown (input/output/cache/total columns).
- cmd/daily.go: Daily usage table (date, weekday, sessions, prompts,
tokens, cost) sorted most-recent-first.
- cmd/hourly.go: Activity heatmap showing prompt distribution across
24 hours with Unicode block bars, reports peak hour.
- cmd/models.go: Model usage ranking with API call counts, token
volumes, cost, and usage share percentage.
- cmd/projects.go: Project ranking by cost with session/prompt/token
counts.
- cmd/sessions.go: Session list sorted by recency with --limit flag
(default 20). Shows start time, project, duration, tokens, cost.
Marks subagent sessions with "(sub)" suffix.
- cmd/config_cmd.go: Displays current configuration across all
sections (general, admin API, appearance, budget) with auto-
detected plan ceiling.
- cmd/setup.go: Interactive first-run wizard — configures Admin API
key, default time range (7/30/90 days), and color theme (Flexoki
Dark, Catppuccin Mocha, Tokyo Night, Terminal). Saves to
~/.config/cburn/config.toml.
- cmd/tui.go: Launches the interactive Bubble Tea TUI dashboard,
passing through all filter flags and applying the configured theme.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
