Command

PePersonal JEJust Electrolyte RTRelease Timer TtTacTile CSClearSource AtAthletic

TacTile›Launch TacTile›iOS›iOS — Settings, Analytics & tools build·133 in this wave

Approve: iOS Settings, Analytics & toolsTo do · blocker Pro-gate Deep Dive, Compare, Map, and Overview to match backend's plus-tier requirementDone · blocker Decide fate of ProfilePhotoCropReviewView (ship or delete)To do Decide fate of Analytics Overview tab (ship or delete)To do Decide fate of legacy Dashboards widget system (~15 files)To do Decide Goals v2 scope (recurrence, prefill, streak history, sort, status, taxonomy)To do Add re-edit support for saved ConnectCards and Social Hub destinationsDone Build proposed-data mapping layer for native AI proposal cardsDone Decide routing for 'Program NFC Tag' hub tileTo do Build iOS NFC tap-to-write re-encode, password-protect, and mode persistenceTo do Verify analytics numbers against ground truth (not just rendering)To do Define real scope of the destination-analytics pipeline before it's built blindTo do Verify no analytics events are recorded for free accountsTo do Fix unregistered tactile:// URL scheme breaking every AI card "Open in editor" handoffDone Agent sessions: add the PATCH-title and hard-DELETE routes (route layer only — the DB is ready)Done Money display: no currency column on payments, forced 2-decimal formatting, and silent "$" fallback on bad currency codesTo do insights.ts calls callAnthropicMessages directly instead of createModelProvider, violating ADR-0001's amendmentDone Fix stale 'coming soon' copy on Company Info cardDone Produce real Quick Tutorial product walkthrough videoTo do Host and wire real Quick Tutorial videoTo do Delete dead stub properties in SettingsHostViewModelDone Analytics dead-code sweep — Deep Dive legacy + stale commentsTo do Fix 'Set goal' button closure-binding bug in Deep DiveTo do Wire custom date-range Apply in Dashboards device distribution widgetDone Decide fate of Map breadcrumb drill-down featureTo do Fix deprecated GeoTableWidget rendering during loading windowDone Add filter-aware empty state copy to Goals listTo do Fix scoped-goal display name resolution in Goal SheetDone Decide fate of multi-entity Compare dashboard widget conceptTo do Decide fate of Sources dashboard tile (needs new API endpoint)To do Add rename/delete UI for dashboardsDone Decide whether dashboard share/export is in scopeTo do Decide Pro-lock widget scope for Dashboards paletteTo do Fix duplicate widget title bug in Dashboard tilesDone Surface tier-verification error in AnalyticsProGateDone Wire Mute Destination to real persisted stateDone Wire menu destination edit submission (currently a no-op stub)Done Delete dead ConnectCard editor files (FieldEditorView, CardPreviewView, CardStyleSheet)Done AI surface dead-code and stale-comment sweepDone Fix GalleryCard empty state at zero proposed itemsDone Decide real scope for QRLaunchpad Share & ExportTo do Sign off: Settings surfaces not flagged in this auditTo do Sign off: Analytics files/widgets confirmed clean in this auditTo do Sign off: ConnectCard field editors and models confirmed cleanTo do Sign off: AI stubbed-banner behavior confirmed working as intendedTo do Sign off: QR generator and NFC stamp-test harness confirmed clean outside tracked gapsTo do Wire in or remove orphaned AnalyticsKitRealtimeScreen per decisionDone Build real AI Q&A dashboard widget or remove per decisionTo do Build multi-entity Compare dashboard widget or remove per decisionTo do Build Sources dashboard tile backend + wiring or remove per decisionTo do Build dashboard share/export or confirm out of scope per decisionTo do Mark specific widgets Pro-exclusive or remove lock machinery per decisionTo do Wire Map breadcrumb drill-down or remove per decisionTo do Decide: delete the preview-only Analytics widget island (7 files, 8 uncalled client methods)To do Android: two more places show a plan refusal (403) as a generic failure - Assets Families tab, Home insight cardDone A/B variant assignment hashes the daily visitor_hash, so one visitor can change variant from one day to the nextTo do Android: add a ViewModel test that generateInsight() maps a tier refusal to the Pro upsellDone iOS: pin the Deep Dive fetch set with a stubbed-client test (6 requests for account/trigger/destination, 7 for campaign/group)To do iOS Deep Dive trigger hero shows a change percentage without checking the Worker honoured the compare windowDone previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29Done Android Activity chart overlays a "last year" line even when the Worker answered the previous periodTo do Wire ProfilePhotoCropReviewView Save + Change Photo buttonsTo do Fix Contact Support photo-library attachment (picker bound to nil)Done Build Segment + Zapier analytics connectorsBlocked Notify user when custom domain provisioning completesBlocked Wire in or remove Analytics Overview tab per decisionTo do Build real custom-range comparison in Deep Dive (Compare sheet + Activity widget)To do Wire 'Continue conversation' CTA to real Insights screenTo do Show real errors instead of fake seed data in Deep Dive asset pickerDone Wire real Avg-time-to-arrive / Next-action KPIs or remove tilesDone Fix Live Activity Feed entity scoping and add loading/error stateBlocked Decide whether Compare tab should be Pro-gatedDone Surface real errors instead of fake totals in Compare tabDone Fix Real-time tab mock-data fallbacks and missing connection/error UIDone Decide fate of orphaned AnalyticsKitRealtimeScreen.swiftDone Fix Map tab hardcoded mock country data and missing error stateDone Wire Dashboards Geo widget tile actions (view full map, granularity chips)To do Delete confirmed-dead legacy Dashboards widget codeTo do Add loading state and surface errors in Goals listDone Fix Goal Sheet stale error state and build asset-picker retry chipDone Build approved Goals v2 scope itemsTo do Wire Dashboards 'Pick a goal' pill and remove hardcoded fallback progressDone Decide fate of AI Q&A dashboard widget stubTo do Decide fate of ConnectCard photo field typeTo do Fix Preview Destination to show real saved card, not fake demo dataDone Persist Destination Name/Description edits on Save and CloseDone Replace AgentConnectCard's hardcoded fake account name with real OAuth dataBlocked Complete AgentDraftStore seeding for remaining proposal card typesDone Wire real 'Send test event' for WebhookCardDone Decide when to build the real Webhook destination connectorTo do Wire agent pending-approvals badge to real pending countTo do Decide whether Approvals Inbox needs Tweak supportDone Add Tweak support to Approvals InboxTo do Build real rename/delete endpoints for agent sessionsDone Auto-refresh QR image after white-label domain reprogramBlocked Build real Static Program flow in NFCStampTestViewTo do Build real Bulk Program flow in NFCStampTestViewTo do Fix NFC Lock Tag toggle (silent no-op, no persistence)Done Build real QR export per decided scopeTo do Decide the account-timezone plan for analytics day-boundariesTo do Wire the account-timezone decision into rollups and AnalyticsRangeTo do QA: brand-new zero-scan account across every Analytics tabBlocked Load-test analytics queries against a high-volume partitioned accountBlocked Verify AI proposal card "Open in editor" handoffs are dead on iPhoneDone Cards whose tweak feedback sends a placeholder instead of the user's edit (iOS #240 defect b, remaining)Done Source-attribution RPC pivot labels don't match the API's by_campaign/by_group keysDone iOS Dashboards "Top performers" tile 400s for a family/campaign-scoped assetTo do is_first_seen only detects "first scan today", not "first scan ever"Done visitor_year_hash keys on browser major version, so browser auto-updates and shared IPs silently reshuffle unique-visitor countsTo do UA parser misclassifies iPad Safari as desktop macOS and Android tablets as mobileDone "hybrid" trigger medium renders as "unknown" on iOS and AndroidTo do Android 24h analytics chart always requests day granularity, never hourlyDone Android goal editor has no "daily" recurrence optionDone Android shows generic 403 error cards instead of an upsell on Free-tier Deep Dive/Compare/Goals/MapDone Android AI Insights 403 (Free/Plus) shows as a generic "couldn't generate" failure, not an upsellDone Android Deep Dive geo region/city drill-down hard-caps at 8 rows with no way to see moreDone Android analytics map has no centroid for Iceland, Luxembourg, Croatia, Costa Rica or EstoniaDone iOS Trigger Mix / Compare NFC% gauge silently excludes link and direct opensDone iOS Deep Dive fetches trigger/destination/campaign/group-scoped data that no live screen ever rendersTo do web-mobile production deploy is 3 months and 89 commits behind origin/main's analytics featureDone destinations.total_opens is read by two endpoints but never incremented anywhereBlocked analytics_rollups_daily and analytics_alerts have no readers anywhere in the appTo do document/notes/video/audio destinations never fire the funnel beacon — Deep Dive funnel widget is permanently all-zero for themDone Decide: Families Leaderboard on iOS (Deep Dive + Dashboards tile) - the roster request can only 400To do Pin the first-seen call site in events.ts: swapping visitor_year_hash for visitor_hash leaves every test greenDone Plus promises "AI analytics (Basic)" but AI Insights is Pro-only: align server or plan listsTo do iOS Activity widget Custom range shows page-level priors under a Custom labelTo do API answers compare=previous_year with the previous period, so iOS "Same period last year" shows the wrong comparisonDone Check the funnel beacon is accepted from a browser: sendBeacon sends credentials and utils/cors.ts sets no Access-Control-Allow-CredentialsDone Run the fixed funnel beacon in WebKit and Firefox: the t_e9f24402 browser run was Chromium 143 onlyBlocked Android Activity "Same period last year" totals row compares with the previous period until the API deploys; no meta.compare checkDone Geo tile: Region and City chips leave the Analytics tile on an endless skeleton (tile VM loads countries only)To do QA: opening a document, note, video or audio link now counts as a view in Analytics (desktop web)Blocked

Wave

iOS — Settings, Analytics & tools build

Remaining build work across Settings, Analytics, ConnectCard, the AI panel, and QR/NFC programming. Everything marked 'coming soon' here is intended to ship.

TacTile › Launch TacTile › iOS › iOS — Settings, Analytics & tools build

60/133 done73 open1 open blocker

Selected taskclear

API answers compare=previous_year with the previous period, so iOS "Same period last year" shows the wrong comparison

DoneOwner · Vivt_3f63c464

iOS sends compare=previous_year; the Worker has no such window and, with compareToPrevious=true, compares against the previous period while the pill says "year ago".

Unlocks 2Android Activity "Same period last year" totals row compares with the previous period until the API deploys; no meta.compare check previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29

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

**API answers compare=previous_year with the previous period, so iOS "Same period last year" shows the wrong comparison** · done

iOS sends compare=previous_year; the Worker has no such window and, with compareToPrevious=true, compares against the previous period while the pill says "year ago".

Where it sits: TacTile › Launch TacTile › iOS › iOS — Settings, Analytics & tools build

## Unlocks 2

- Android Activity "Same period last year" totals row compares with the previous period until the API deploys; no meta.compare check
- previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29

## The brief on file

[2026-10-17 · Viv] r34 CLOSER: CLOSED against draft PR #773 https://github.com/TacTile-dev/TacTile/pull/773 (r32/ios-r3-ship, head 096683af, base main, MERGEABLE; NOT merged, NOT deployed). Commit ca8f4610. Done-when, clause by clause: (1) API: scans.test.ts:342 asserts compare=previous_year returns the window exactly one year earlier plus meta.compare.kind "previous_year"; scans.test.ts 31/31 and verify:api-test 992/992 on the PR head. (2) iOS: test_confirmsCompare_previousYearWithoutEcho_isNotConfirmed passes in a REAL simulator (iPhone 17 Pro, iOS 26.5, Xcode 27.1): AnalyticsWireDecodeTests Executed 28 tests, with 0 failures. (3) Mutations red then restored byte-identical: iOS (confirmsCompare(.previousYear) returns true) turns the three previousYear confirmsCompare tests red (the acceptance reader's run alone: 4 failures, those three plus the previous_year hero test); API (previous_year answered with previousWindow()) turns 7 of 31 scans.test.ts red (5 at ca8f4610, 2 more once the Feb 29 cases landed). Stubs and mocks only; nothing signed in to production. Readers on the head: acceptance CONFIRMED, safety CONFIRMED (no other route leaks: only scans.ts uses resolveComparison; groups.ts honours previous_period only). Gate: two full runs at 096683af, run 2 exit 0 "passing with known-red: verify:secrets-rotation"; run 1 red on that plus the known tsc --showConfig flake (#762), which passed alone. merge-tree clean against origin/main 4f2c1d6b and #764. CI on #773 at 096683af, read Sat 17 Oct 11:21 PDT: build & test, changes, dep-scan, semgrep, static-firewall, playwright, swift-parity and the ios workflow all pass; verify fails only at the step "Secrets rotation audit" (the sanctioned red, t_3e28c5b5; named with gh api on the job steps); no review comments. CARRIES FOR MATTHEW: no iOS build with the custom range ships before the API deploys (production runs 938b9a6c; deploy is yours, runbook #732); the Android "Last yr" row (AnalyticsViewModel.kt:169 and :516, ActivityWidget.kt:172 and :177) changes to last year only on that deploy (guard t_c2531060); Feb 29 maps to Feb 28; ca8f4610 supersedes 000ea44e's message on previous_year. ui_check: none (API change), so no Kaitlynn card.

[2026-10-16 · Viv] r34 BUILDER (batch ios-r3-ship): evidence for ca8f4610, unchanged. Still local on r32/ios-r3-ship (worktree ~/TacTile-dev/TacTile-ios-r3-ship, now six commits, head 096683af), no PR, gate not run, nothing pushed, so NOT closed. Runs on the head: scans.test.ts 31/31 (29/29 on f1157a03; the two extra are t_6e3f6272's); verify:api-test 992/992 (990/990 on f1157a03); verify:api-check, verify:knip rc 0. REAL SIMULATOR (iPhone 17 Pro, iOS 26.5, dedicated sim, Xcode 27.1): AnalyticsWireDecodeTests Executed 28 tests, with 0 failures, including test_confirmsCompare_previousYearWithoutEcho_isNotConfirmed and the previous_year echo cases. MUTATIONS, each restored byte-identical (git diff --quiet rc 0): (iOS M1) confirmsCompare(.previousYear) returns true without the previous_year echo: 3 confirmsCompare tests red (previousYearWithoutEcho, previousYearWithPreviousPeriodEcho, previousYearWithCustomEcho). (API) resolveComparison answers compare=previous_year with previousWindow(): 5 of 29 scans.test.ts red (the exact-one-year-earlier case, previous_year-alone case, time-of-day case, leap-day 2028-03-07 case, Feb 29 -> Feb 28 case). merge-tree against origin/main 4f2c1d6b and against #764 (9e05ee1e): rc 0 both. Evidence: ~/TacTile-dev/evidence/r34/ios-r3-ship/. NEXT: both readers on the head, one gate, draft PR, then close against the PR. PR body: Android Last yr row changes to last year only when the API deploys (AnalyticsViewModel.kt:169 and :516 send previous_year; ActivityWidget.kt:172 and :177 read summary.previous/delta; guard t_c2531060); Feb 29 maps to Feb 28.

[2026-10-16 · Viv] r33 CLOSER: NOT CLOSED, status doing -> todo. Both readers CONFIRMED ca8f4610 (acceptance and safety): scans.test.ts 29/29, verify:api-test 990/990, AnalyticsWireDecodeTests 28/28 (macOS harness), source pins 23/23; three reader mutations red then restored; the Android finding checks out (AnalyticsViewModel.kt:169 and :516 send previous_year, ActivityWidget.kt:172 and :177 read summary.previous/delta). Close rule 3 is unmet, so I cannot close: the commit is on no pushed PR. The ship run held it behind 000ea44e (t_ad8a19ee) because it conflicts on origin/main without it. NEXT: ship 000ea44e, ca8f4610, f1157a03 as one draft PR (see t_ad8a19ee), then close this against it; Done-when needs no merge. PR body: the Android Last yr row changes to last year only when Matthew deploys the API; Feb 29 maps to Feb 28; ca8f4610 supersedes 000ea44e's message on previous_year. Safety reader's leap-day edge is filed as t_6e3f6272 (dep on this task).

[2026-10-16 · Viv] r33 SHIP JOB batch:ios-r3-ship: NOT PUSHED. Both readers CONFIRMED commit ca8f4610 (acceptance and safety), so this commit is verified and ship-ready on its own merits. It stays local because it is stacked on 000ea44e (t_ad8a19ee), and that task came back shippable=false from the ship job (acceptance REFUTED: Activity widget priors, sheet never rendered). I cherry-picked ca8f4610 onto origin/main 4f2c1d6b in a scratch worktree to test: it conflicts in scans.ts, query.ts, scans.test.ts, AnalyticsModels.swift, AnalyticsWireDecodeTests.swift and API_ROUTES.md, and tests/unit/ios-analytics-custom-compare.test.ts is deleted on main (000ea44e creates it). confirmsCompare has 0 refs on origin/main. I did not rewrite the commit to stand alone: that would be unreviewed code. Scratch worktree removed. Commit lives on local r32/ios-r3-ship in ~/TacTile-dev/TacTile-ios-r3-ship, unpushed, no PR, gate not run for it yet. NEXT: whoever decides 000ea44e ships (both readers said commit_correct true and the safety reader said safe to ship as a draft PR; only the Done-when of t_ad8a19ee is unmet, which the SHIP RULE says must not keep a gated commit off GitHub) cuts r32/ios-r3-ship-ship from origin/main and cherry-picks 000ea44e then ca8f4610 then f1157a03, one gate, one draft PR. Optional follow-up from the safety reader: leap-day guard in previousYearWindow (query.ts:102-125). PR body must say the Android Last yr row changes from previous period to last year once the API deploys, and that ca8f4610 supersedes 000ea44e's message on previous_year. Status left unchanged.

[2026-10-16 · Viv] r33 BUILT, NOT SHIPPED: commit ca8f4610 on local r32/ios-r3-ship (worktree ~/TacTile-dev/TacTile-ios-r3-ship), unpushed, no PR, gate not run, both readers still to come. Fix shape (a). resolveComparison: compare=previous_year resolves to the window shifted back one calendar year in UTC and is echoed as meta.compare.kind "previous_year"; like compare=custom it wins over compareToPrevious and switches the comparison on by itself. Feb 29 rule: a bound on Feb 29 maps to Feb 28 of the year before (date-fns subYears), never March 1. iOS: ScanSummary.confirmsCompare(.previousYear) is true only with that echo, so a build against today's Worker (prod 938b9a6c) shows no chip. EVIDENCE: scans.test.ts 29/29 (6 new), verify:api-test 990/990; AnalyticsWireDecodeTests 28/28 (5 new, run on macOS because the Xcode 27.1 update broke the simulator); source pins 23/23. MUTATIONS, each restored: resolver branch removed -> 5 API tests red; previous_year given the previous-period window -> 5 red; Feb 29 rolls to March 1 -> 1 red; 365-day shift -> 2 red; confirmsCompare(.previousYear) returns true -> 4 Swift tests red. CORRECTION to the 15 Oct note above: Android is NOT unaffected. Its Activity widget sends compare=previous_year with compareToPrevious=true (AnalyticsViewModel.kt:169, apiValue at :516) and reads summary.previous and delta (ActivityWidget.kt:172, :177), so today its "Last yr" totals row compares with the previous period. The API deploy fixes it with no Android edit; Android does not check meta.compare. Web, web-mobile and the SDK send compareToPrevious only. The API change takes effect only when Matthew deploys (runbook #732).

[2026-10-16 · Viv] r33 BUILDING (status doing) on r32/ios-r3-ship, per NEXT-PROMPT 16 Oct: that supersedes "WAITS ON ... merging" because resolveComparison and confirmsCompare live only on this branch (commit 000ea44e, unpushed). Shape (a): previous_year resolves to the same window shifted back one calendar year (UTC), echoed as meta.compare.kind "previous_year"; iOS confirmsCompare(.previousYear) then needs that echo. Android sends compare=previous and the web SDK compareToPrevious only, so both are unaffected. Time box 90 minutes. Draft PR, not merged, not deployed.

[2026-10-15 · Viv] Filed from t_ad8a19ee (r32 closer). The custom-compare commit body lists this as "not done here, on purpose"; I searched all 1,485 hub tasks for previous_year, year ago and last year and none tracks it.

WHAT IS WRONG: apps/ios/TacTileConnect/Features/Analytics/Models/AnalyticsRange.swift:138 maps CompareMode.previousYear to compare=previous_year, and AnalyticsAPIClient.swift:72-73 also sends compareToPrevious=true. On local branch r32/ios-r3-ship (commit 000ea44e) resolveComparison in apps/api/tactile-api/src/utils/analytics/query.ts knows only compare=custom and compareToPrevious=true, and its own doc comment says previous_year "does not switch comparison on by itself, and with the flag it resolves to the previous period". On origin/main (4f2c1d6b) scans.ts does the same through compareToPrevious alone. So choosing "Same period last year" in the Compare to sheet (PageRangeBar.swift, CompareSheet) returns previous-period previous/delta numbers under a pill that reads "vs. year ago". ScanSummary.confirmsCompare (AnalyticsModels.swift:143, same branch) only checks custom windows, so nothing hides the wrong chip either. Read from code, not run: no production read was made.

FIX (Viv decides; two shapes, do one): (a) API: add a previous_year window (the same window shifted back exactly one year), echo it as meta.compare.kind "previous_year", and gate the iOS chip on that echo the way custom is gated; or (b) until (a) ships, hide the "Same period last year" row. Android and the web SDK send compareToPrevious=true only, so they are unaffected.

WAITS ON: the draft PR that carries commit 000ea44e (not pushed yet; it rides r32/ios-r3-ship) merging, because both the resolver and confirmsCompare live there. Any API change here is deployed only by Matthew (runbook #732).

DONE WHEN: an API test asserts compare=previous_year returns a previous window exactly one year earlier plus meta.compare.kind "previous_year"; an iOS decode test asserts confirmsCompare(.previousYear) is false without that echo; a mutation reverting either turns its test red. Stubs and mocks only; no simulator or browser session signs in to production.

## 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

iOS — Settings, Analytics & tools build

API answers compare=previous_year with the previous period, so iOS "Same period last year" shows the wrong comparison