Command

PePersonal JEJust Electrolyte RTRelease Timer TtTacTile CSClearSource AtAthletic

TacTile›Launch TacTile›Analytics UI·18 in this wave

Approve: Analytics UITo do · blocker Define what 'basic analytics' means for the v1.0 cut lineTo do Settings page completion (analytics-specific)To do Enforce design tokens in all chartsBlocked Complete FilterBar componentTo do Complete EntitySelector componentDone Wire EntitySelector into Deep Dive pageTo do Wire EntitySelector into Compare pageTo do Build Goals page UITo do Resolve s1-4-3 (AI Builder) blocked itemBlocked Mobile responsive pass on all pagesTo do Empty/loading/error states for all pagesTo do Fix MetricCard sparkline renderingDone Replace dashboard hardcoded metricsDone Add Playwright tests for analytics pagesTo do web: text-success / text-destructive / text-warning are used in 10 files but the theme defines none of them, so they render uncolouredTo do Wire trend data into MetricCard's new sparkline (Overview, Family detail, widget registry)To do Wire EntitySelector into DeepDivePage and ComparePage (replace the placeholder)To do

Wave

Analytics UI

Live on all four surfaces. Now cut-list item #1 for scope reduction, since the AI Agent moved off the drop ladder — ship basic, defer advanced. The "what counts as basic" line is an open decision in this wave and should be drawn before anyone builds to it. Note apps/web already has Gate.tsx and usePlan.ts, so web tier-gating exists — iOS is the surface missing it.

TacTile › Launch TacTile › Analytics UI

3/18 done15 open1 open blocker

Selected taskclear

Wire trend data into MetricCard's new sparkline (Overview, Family detail, widget registry)

To doOwner · Vivt_3094d500

Follow-up from t_d418bceb (r38, 2026-10-21): MetricCard now takes an optional trend?: readonly number[] | null and draws a sparkline when given 2+ finite points (branch r38/metriccard-sparkline, commit 65abe629), but no caller passes it, so no user sees one. Callers: OverviewPage.tsx:84-104 and :175-177, FamilyDetailPage.tsx:71-74 (both held by #649 at filing), widgetRegistry.tsx:194 MetricCardWidget. Done when: each MetricCard on desktop web Analytics Overview and Family detail passes a real per-metric series from the data the page already loads (no new API unless one is required, then say so), a render test proves a path appears for a metric with data and none without, and a Kaitlynn QA card (desktop web, after merge and deploy) is filed with a dep edge.

No dependencies in this wave — nothing gates it, and nothing waits on it.

Show the prompt

You are Viv, the agent for the TacTile lane of Command.

Open the lane and work there:

```bash
cd ~/Command/tactile && claude
```

Read that lane's CLAUDE.md and lane.json before you touch anything — they
carry your identity, your scope, and the hazards specific to this lane.
Read state from the hub (https://internal.tactile.to) or ask. Never guess at it.

## The task

**Wire trend data into MetricCard's new sparkline (Overview, Family detail, widget registry)** · to do

Follow-up from t_d418bceb (r38, 2026-10-21): MetricCard now takes an optional trend?: readonly number[] | null and draws a sparkline when given 2+ finite points (branch r38/metriccard-sparkline, commit 65abe629), but no caller passes it, so no user sees one. Callers: OverviewPage.tsx:84-104 and :175-177, FamilyDetailPage.tsx:71-74 (both held by #649 at filing), widgetRegistry.tsx:194 MetricCardWidget. Done when: each MetricCard on desktop web Analytics Overview and Family detail passes a real per-metric series from the data the page already loads (no new API unless one is required, then say so), a render test proves a path appears for a metric with data and none without, and a Kaitlynn QA card (desktop web, after merge and deploy) is filed with a dep edge.

Where it sits: TacTile › Launch TacTile › Analytics UI

## The brief on file

[2026-10-23 · Viv] r40 NOTE (status unchanged, task stays open): commit shipped on a draft PR; both readers REFUTED the task. Not merged, not deployed.

LANDED: PR #788 https://github.com/TacTile-dev/TacTile/pull/788, stacked on #776 (base r38/metriccard-sparkline 65abe629). Branch r40/stack-776-sparkline-callers, head e34c002d7dd4a7a57776f025cba9ef49c9faa176 (amended from 4c7af7fa), one commit, 4 files (+269/-4): apps/web/features/analytics/components/widgetRegistry.tsx, apps/web/features/analytics/lib/metricTrends.ts (new), apps/web/features/analytics/pages/OverviewPage.tsx, tests/unit/metric-card-trend-callers.test.ts. Overview: 6 of 8 cards (Scans, Unique Visitors, NFC taps, QR scans, Link opens, Direct) take a real series from the useTimeline the page already loads; Repeat Visitors and New Visitors pass null. The dashboard metric-card widget now makes its own /scans/timeline request (no live desktop page renders that widget today).

EVIDENCE: metric-card-trend-callers 5/5; with metric-card-sparkline 13/13; 14 related files 129/129; verify:unit rc=0, 236 files, 4703 tests. Mutations red then green: W1 (widget returns null without data) -> 1 failed / 4 passed, while the old test stayed 5/5 green (the gap the safety reader found is closed); W2, W3 and O1 (Overview Scans trend dropped) -> 1 failed each. Gate: 1 full run, start load1 2.53, rc=0, 55 of 56, only verify:secrets-rotation.

READERS on the task (re-review on e34c002d; both CONFIRMED the commit): SAFETY REFUTED - "Overview: 6 of 8 MetricCards get a real series. Repeat Visitors and New Visitors pass null" and "Family detail is not wired on the branch." ACCEPTANCE REFUTED (fixable=false) - "3 clauses unmet, 2 of them not fixable tonight without a Matthew decision and a migration."

CI: no CI: non-main base, the local gate is the check.

DONE-WHEN CLAUSES UNMET:
1. "each MetricCard on desktop web Analytics Overview ... passes a real per-metric series": Repeat Visitors and New Visitors pass null. No endpoint has a per-bucket repeat/new count (TimelineRow, apps/api/tactile-api/src/routes/analytics/scans.ts:122-127). A series needs a migration redefining public.analytics_scans_timeline plus API and SDK changes. Matthew decides: accept null for these two cards, or authorize that change.
2. "... and Family detail": not wired on the branch. Any edit to FamilyDetailPage.tsx adds a 7th conflicting file against CONFLICTING #649 (fix/qa-web-20260921, add/add against merge-base 1d960865), and #649 is not r40/*. A ready patch is held at /private/tmp/claude-503/r40/s776fix/family-detail.patch (7/7, Family Scans trend-drop mutation red). It adds one new client request to the EXISTING GET /api/analytics/families/:id/timeline, which is not "data the page already loads", so it also needs a yes from Matthew.
3. "a Kaitlynn QA card (desktop web, after merge and deploy) is filed with a dep edge": not filed. The card text is drafted (held by the orchestrator); file it only after a complete change merges and deploys.
MET: "a render test proves a path appears for a metric with data and none without", for Overview and the widget.

NEXT SESSION: (a) Matthew rebases or closes #649, or accepts one more conflict there; (b) Matthew answers the Family timeline request and the Repeat/New question; (c) apply family-detail.patch as a follow-up commit on #788's branch and re-run both readers; (d) after merge and deploy, file the Kaitlynn card with a dep edge on this task.
Test gap (SAFETY reader, mutation J): dropping destination_hash/trigger_id/campaign_id from the widget's useTimeline query stays green.

[2026-10-21 · Viv] Filed by r38. HELD at filing: OverviewPage.tsx and FamilyDetailPage.tsx by #649; widgetRegistry.tsx was free. Stack on the t_d418bceb PR's branch or wait for it to merge.

## How to work this

- Do the work, don't just plan it. If the fix is obvious and safe, make it.
- Surface anything needing Matthew's sign-off instead of deciding it yourself.
- Short replies. Lead with the answer, then stop.
- Finish by saying what changed, what you verified, and what you'd do next.

To doIn progressDoneBlockedPick a wave on the left · tap a task to expand it

Lanes

Analytics UI

Wire trend data into MetricCard's new sparkline (Overview, Family detail, widget registry)