feat(analytics): sticky range + sortable per-model table columns

[jasnoorgill]

Summary

Two small but related client-side improvements to the analytics page,
shipped together because they share infrastructure and would otherwise
conflict on the same lines of AnalyticsPage.tsx:

1. Sticky time range — the selected 24h/7d/30d range now persists
   in localStorage so reloads and new sessions land on the user's
   last choice.
2. Sortable per-model table — every column in the "per-model
   breakdown" table (except pinned, which renders —) is now
   clickable to sort. 3-state cycle: unsorted (API order) → asc → desc → unsorted. Last selection persists in localStorage too.

Both use the same persistence shape as the existing theme toggle
and freellmapi.locale preference. Same useState + useEffect
pattern, same try/catch on every storage access.

Why combined

Originally shipped as PR #462 (sticky range only). Adding the sort
work on top of #462's branch required a rebase that would have
re-written #462's commits — at that point the cleanest move was a
single PR covering both. The two features are thematically adjacent
(analytics-page UX) and small individually, so combining avoids
two PRs reviewing the same file.

Changes

File	Change
client/src/pages/AnalyticsPage.tsx	+188 / -11. Added useMemo to imports, STORAGE_KEY/loadStoredRange/sort types, SortableHeader helper component, sort state + persistence effect, onHeaderClick reducer, sortedByModel memoized sort, replaced 8 of 9 column headers with <SortableHeader> (pinned stays static), added lucide-react ArrowUp/ArrowDown/ChevronsUpDown imports.

1 file, +188 / -11 across 2 commits.

Sort behavior

State	Indicator	Order
Unsorted	ChevronsUpDown (faded)	API-returned (requests DESC)
Asc	ArrowUp	A→Z / 0→9
Desc	ArrowDown	Z→A / 9→0

• Click another column → starts at asc on the new column.
• Click the same column three times → back to API order, storage
  key removed.
• Null values sort last in both directions (Excel/Sheets convention).
• Right-aligned columns flip the indicator with flex-row-reverse so
  the label stays closest to the data.
• aria-sort attribute is set on each header button for screen readers.

pinned is intentionally not sortable: it renders — for zero-pinned
rows, and the 0/>0 distinction is meaningless to sort on.

localStorage keys

Key	Value	When written
freellmapi.analytics.range	'24h' | '7d' | '30d'	On range change
freellmapi.analytics.byModelSort	{"column": "...", "direction": "asc"|"desc"} or absent	On sort change (removed on unsort)

Both keys are validated against an allowlist on read so a corrupted
entry falls back to the default rather than crashing the page. Both
writes are wrapped in try/catch for SSR / private-mode safety.

Test plan

• npx tsc -b in client/ — clean, 0 errors.
• npx tsc -b in server/ — 9 errors in server/src/routes/keys.ts
  from upstream's multer typing bug (PR I added Agnes AI, but it doesn’t appear in the model list. #438, pre-existing on
  origin/main at 340f414). Not introduced by this PR —
  same errors reproduce on a clean git checkout origin/main.
• npx vitest run in server/ — 524/524 passing, 0 regressions.
• Live verification: deployed on integration/all-my-prs @ d08383b.
  Service running on PID 864746, client bundle has both
  freellmapi.analytics.range and freellmapi.analytics.byModelSort
  storage keys + the sort logic.

Manual smoke:

1. Open /analytics, click 30d. Hard-reload — opens on 30d.
2. Click any column header (e.g. "Latency") — sorts asc, indicator
   shows ↑, header text darkens.
3. Click again — sorts desc, indicator shows ↓.
4. Click a third time — back to API order, indicator faded.
5. Click a different column — starts at asc on the new column.
6. Reload — your last sort is restored.
7. Hard-reload after clicking through to unsort — the key is
   removed from localStorage, the page loads in API order.

Compatibility

No breaking changes. Defaults are unchanged (7d range, API-natural
row order). The persistence is additive. New localStorage keys
are namespaced under freellmapi.* per the existing convention.

Supersedes

Closes #462 — the sticky-range half of this work is included here.

References operator sessions 2026-07-04. No upstream issue number
yet — happy to file one if requested.

[tashfeenahmed]

Thanks, the sticky range and sortable columns work looks good and CI was green. Main has since shipped the redesigned Analytics page (#467) plus a new Recent Calls table (#474), so this now conflicts on AnalyticsPage.tsx. Could you rebase onto latest main and re-apply the sticky range and sort on the new table layout? Happy to merge once it's green again.

[jasnoorgill]

Rebased, filed #490 Thanks Jasnoor

…

On Tue, Jul 7, 2026 at 2:10 AM Tashfeen ***@***.***> wrote: *tashfeenahmed* left a comment (tashfeenahmed/freellmapi#463) <#463 (comment)> Thanks, the sticky range and sortable columns work looks good and CI was green. Main has since shipped the redesigned Analytics page (#467 <#467>) plus a new Recent Calls table (#474 <#474>), so this now conflicts on AnalyticsPage.tsx. Could you rebase onto latest main and re-apply the sticky range and sort on the new table layout? Happy to merge once it's green again. — Reply to this email directly, view it on GitHub <#463?email_source=notifications&email_token=ABJ5OOWG6FSMCJSLSTEWIGT5DQFCRA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBZG42DCMZWGIY2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KYZTPN52GK4S7MNWGSY3L#issuecomment-4897413621>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/ABJ5OOQDK35CHVXY53A5VEL5DQFCRAVCNFSNUABGKJSXA33TNF2G64TZHMYTEMJXGA2DAMJYGU5US43TOVSTWNBYGA4DSMJVGI4DRILWAI> . Triage notifications, keep track of coding agent tasks and review pull requests on the go with GitHub Mobile for iOS <https://github.com/notifications/mobile/ios/ABJ5OOW5P7AOY3T2FBRXZ5T5DQFCRA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBZG42DCMZWGIY2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2KUZTPN52GK4S7NFXXG> and Android <https://github.com/notifications/mobile/android/ABJ5OOXE67WROI4FUS6JHWD5DQFCRA5CNFSNUABFM5UWIORPF5TWS5BNNB2WEL2JONZXKZKDN5WW2ZLOOQXTIOBZG42DCMZWGIY2M4TFMFZW63VGMF2XI2DPOKSWK5TFNZ2K4ZTPN52GK4S7MFXGI4TPNFSA>. Download it today! You are receiving this because you authored the thread.Message ID: ***@***.***>