Add hourly past-24-hour usage view

[juliusmarminge]

What Changed

• Added hourly usage aggregation and formatting for the past 24 hours across the server, shared packages, web, and mobile clients.
• Updated usage charts and state handling to display the new time-series data.
• Added usage documentation and focused aggregation, chart, formatting, and merge tests.
• Simplified mobile settings-sheet navigation and related thread/input layouts.
• Updated mobile and web dependencies and package patches.

Why

Users can now see recent usage trends with hourly resolution instead of relying only on broader totals. The shared aggregation and formatting logic keeps the web and mobile views consistent, while the focused tests cover the new data shapes and rendering behavior.

The accompanying mobile changes align settings navigation with the revised sheet structure and simplify thread interaction layouts and dependency maintenance.

UI Changes

• Updated the web Usage page and provider charts.
• Added the hourly past-24-hour usage view to mobile.
• Updated mobile settings navigation and thread/input layouts.
• Before/after screenshots and an interaction video should be added for the affected usage and mobile UI changes.

Checklist

• This PR is small and focused
• I explained what changed and why
• I included before/after screenshots for any UI changes
• I included a video for animation/interaction changes

---

Note

Medium Risk
Touches usage contract version 4 and server aggregation; older environments may show as stale until upgraded, but daily paths stay backward compatible.

Overview
Adds a Past 24h range that shows usage in rolling hourly buckets instead of calendar days, on web and mobile.

The usage contract moves to v4 with optional resolution, sinceTime, and untilTime, plus optional hourStart on buckets. The server validates hourly windows (≤24h, inclusive start / exclusive end) and aggregates into fixed hour buckets anchored to the window start. Shared code adds hour enumeration/formatting (including DST fall-back labels) and merged.hourly alongside existing daily rollups. Client useUsage cache keys include the new window fields; refresh rebuilds the rolling window when bounds would otherwise stay stale.

Charts, breakdown tables, and “per active period” metrics switch between hourly and daily when that range is selected. User docs for reviewing usage are added.

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

Note

Add hourly Past 24h usage view to web and mobile

• Adds a 'Past 24h' window option to the Usage page (web and mobile) that fetches and displays hourly buckets instead of daily totals.
• Extends makeWindow in usageFormat.ts to support 'hour' resolution, producing a minute-aligned rolling 24-hour window with sinceTime/untilTime bounds.
• Adds enumerateHourStarts, formatHourShort, formatRelativeHourShort, and formatDateTimeShort helpers for labeling hourly chart axes and tooltips, including DST-safe formatting.
• Extends mergeUsage to populate a hourly totals array from hourStart-keyed buckets, and updates UsageService.readSummary on the server to validate and aggregate hourly requests with strict start-inclusive/end-exclusive semantics.
• Bumps USAGE_CONTRACT_VERSION from 3 to 4 and adds UsageResolution, hourStart, and time-bound fields to the wire contract; older clients default to daily resolution.

^{Macroscope summarized 026b57a.}

[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: 06ec955a-41a0-4aa9-8fba-5b03f479e052

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.}

[github-actions]

Thread transfer impact

✅ Thread transfer remains within every enforced ceiling.

Provider	Metric	Main baseline	This PR	Impact	PR ceiling
Codex	Total thread wire	11.3 KiB	11.3 KiB	−9 B (−0.1%)	15.1 KiB	✅
Codex	Thread snapshot wire	5.5 KiB	5.5 KiB	+4 B (+0.1%)	7.3 KiB	✅
Codex	Live turn WebSocket wire	5.9 KiB	5.9 KiB	−13 B (−0.2%)	7.8 KiB	✅
Codex	Live turn WebSocket decoded	49.7 KiB	49.7 KiB	0 B (0.0%)	66.4 KiB	✅
Codex	Live turn messages	16	16	0 (0.0%)	21	✅
Claude	Total thread wire	11.3 KiB	11.3 KiB	+13 B (+0.1%)	15.1 KiB	✅
Claude	Thread snapshot wire	5.5 KiB	5.5 KiB	+11 B (+0.2%)	7.3 KiB	✅
Claude	Live turn WebSocket wire	5.9 KiB	5.9 KiB	+2 B (+0.0%)	7.8 KiB	✅
Claude	Live turn WebSocket decoded	50.6 KiB	50.6 KiB	0 B (0.0%)	66.4 KiB	✅
Claude	Live turn messages	16	16	0 (0.0%)	21	✅

Baseline: 6676f9c · PR result: 026b57a · Source CI: success

Scenario and decoded snapshot size

10 historical turns, 5 command tools per turn, 878.9 KiB retained MCP result per historical turn, and a 1.05 MiB retained result in the measured turn.

• Codex decoded thread snapshot: 94.6 KiB
• Claude decoded thread snapshot: 95.4 KiB

Updated in place by a trusted workflow. PR artifacts are strictly validated and never executed.

[macroscopeapp]

Approvability

Verdict: Needs human review

This PR introduces a new 'Past 24h' hourly usage feature with changes across contracts (version bump), server aggregation, web/mobile UIs, and shared utilities. New user-facing features with cross-cutting changes warrant human review.

^{You can customize Macroscope's approvability policy. Learn more.}