feat(usage): add OpenCode usage reporting

[aflekkas]

What Changed

• Read completed OpenCode assistant usage from its SQLite store in read-only mode, supporting both the legacy message table and current session_message table.
• Project only usage metadata from SQLite, normalize OpenCode's disjoint reasoning counts to the shared token contract, de-duplicate migrated rows, and use OpenCode-reported cost when available.
• Discover the standard XDG data path, explicit OPENCODE_DB overrides, and channel-specific databases while reporting missing, failed, or partial source health.
• Add OpenCode to the v6 usage contract and the web/mobile provider presentation, then document the behavior.

Why

Closes #7622. OpenCode persists its usage in SQLite, so the existing Claude Code, Codex, and Grok JSONL scan could never include it. This keeps sessions run outside T3 Code visible while ensuring prompt, response, and tool content never leave the local database.

This overlaps #7623 and #7221. #7623 covers the contract and presentation but not collection; #7221 is based on an older main and mixes in broader scan behavior. This PR keeps the complete path focused on OpenCode usage against current main.

UI Changes

Before	After

Validation

• 92 focused usage tests across server, shared merge logic, and web presentation
• Targeted typechecks for server, contracts, shared, web, and mobile
• Targeted lint, formatting, and git diff --check
• Server bundle and web production build
• Integrated Chrome pass against a dedicated .t3 runtime and the live OpenCode schema

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for the UI change
• No animation or interaction change requires a video

Built with GPT-5 Codex in T3 Code.

---

Note

Medium Risk
Touches usage contract v6, cross-environment merge rules, and read-only SQLite against user-local OpenCode DBs; behavior is heavily tested but affects reported totals and mixed-version clients.

Overview
Adds OpenCode as a first-class usage provider by reading completed assistant usage from local SQLite stores (read-only), alongside the existing Claude/Codex/Grok JSONL scans.

A new usageOpenCode adapter discovers databases from XDG data paths, OPENCODE_DB / channel DB naming, and per–OpenCode-instance env overrides; it projects only token/cost metadata from session_message and legacy message tables, normalizes reasoning vs output tokens, dedupes migrated rows, and surfaces missing/failed/partial source health. UsageService.readSummary folds those records in with optional sourcePath on buckets so multiple DBs stay distinct.

The usage contract bumps to v6 (opencode + optional sourcePath); aggregation and multi-environment merge respect sourcePath when deduplicating shared databases. Web and mobile gain OpenCode label, color, and icon; user docs describe SQLite-backed totals and pricing fallbacks when cost is zero.

^{Reviewed by Cursor Bugbot for commit 84d43e4. Bugbot is set up for automated code reviews on this repo. Configure here.}

Note

Add OpenCode usage reporting across server, contracts, and UI

• Introduces usageOpenCode.ts to read OpenCode assistant usage from SQLite databases (current and legacy tables) with cross-runtime Bun/Node support, honoring OPENCODE_DB overrides and channel database discovery
• Extends UsageService.make to collect OpenCode environments from the host and opencode provider instances, resolve database paths, and aggregate records with sourcePath provenance
• Updates UsageAggregator and usageMerge to bucket and deduplicate by sourcePath so multiple stores under the same provider stay distinct and shared stores are owned correctly
• Bumps USAGE_CONTRACT_VERSION to 6, adds 'opencode' to UsageProviderKind, and adds optional sourcePath to UsageBucket
• Adds OpenCode label, color, icon, and stacking order to mobile and web usage charts
• Behavioral Change: USAGE_CONTRACT_VERSION moves from 5 to 6; older clients that only negotiate version 5 will not receive OpenCode summaries. readFileRecords and readTranscriptRecords now exclude 'opencode' from their provider type parameter, so any caller passing 'opencode' to these JSONL readers will get a type error

^{Macroscope summarized 84d43e4.}

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on this repository. Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Repository UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 6c27b364-015f-49ea-9bbc-377e1bedf8ef

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

_{Comment @coderabbitai help to get the list of available commands.}

[chatgpt-codex-connector]

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 2c7485e2e2

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

• Open a pull request for review
• Mark a draft as ready
• Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

[macroscopeapp]

Approvability

Verdict: Not approved

Macroscope's review found this PR not approvable — This PR adds a substantial OpenCode usage capability across SQLite scanning, configuration discovery, cross-environment deduplication, contract versioning, and client presentation. Because it changes production usage collection and reported totals across multiple layers, the scope warrants human review.

^{You can add or adjust custom eligibility rules. Learn more.}

[cursor]

Cursor Bugbot has reviewed your changes using high effort and found 1 potential issue.

^{❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.}

^{Reviewed by Cursor Bugbot for commit daf4731. Configure here.}

[Wiktor102]

This would be sooooo nice to have