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

previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29

DoneOwner · Vivt_6e3f6272

Found by the safety reader on ca8f4610 (t_3f63c464) and reproduced read-only with node on 16 Oct. apps/api/tactile-api/src/utils/analytics/query.ts yearEarlier/previousYearWindow (about :102-125 on local r32/ios-r3-ship) shifts each bound back a year separately and maps Feb 29 to Feb 28. A window whose `to` lands on Feb 29 right after a Feb 28 `from` collapses: [2024-02-28T00:00Z, 2024-02-29T00:00Z) maps to [2023-02-28T00:00Z, 2023-02-28T00:00Z), zero length; [2024-02-28T12:00Z, 2024-02-29T06:00Z) maps to a reversed window. The RPC raises nothing, the prior total comes back empty and deltaPct(current, 0) reads +100. Only a window touching Feb 28 to Feb 29 in a leap year triggers it (next: 2028, or any historical custom range). Low priority, non-blocking.

Waiting on 1 · all clearAPI answers compare=previous_year with the previous period, so iOS "Same period last year" shows the wrong comparison

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

**previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29** · done

Found by the safety reader on ca8f4610 (t_3f63c464) and reproduced read-only with node on 16 Oct. apps/api/tactile-api/src/utils/analytics/query.ts yearEarlier/previousYearWindow (about :102-125 on local r32/ios-r3-ship) shifts each bound back a year separately and maps Feb 29 to Feb 28. A window whose `to` lands on Feb 29 right after a Feb 28 `from` collapses: [2024-02-28T00:00Z, 2024-02-29T00:00Z) maps to [2023-02-28T00:00Z, 2023-02-28T00:00Z), zero length; [2024-02-28T12:00Z, 2024-02-29T06:00Z) maps to a reversed window. The RPC raises nothing, the prior total comes back empty and deltaPct(current, 0) reads +100. Only a window touching Feb 28 to Feb 29 in a leap year triggers it (next: 2028, or any historical custom range). Low priority, non-blocking.

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

## Waiting on 1

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

## 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), after t_3f63c464. Commit 096683af: previousYearWindow (apps/api/tactile-api/src/utils/analytics/query.ts) sets to = from + w.durationMs when the shifted `to` is not after the shifted `from`. Acceptance, line by line: [2024-02-28T00:00Z, 2024-02-29T00:00Z) now gives p_from 2023-02-28T00:00Z, p_to 2023-03-01T00:00Z, 24 h (scans.test.ts:417); [2024-02-28T12:00Z, 2024-02-29T06:00Z) gives 2023-02-28T12:00Z to 2023-03-01T06:00Z, 18 h (:440); both assert p_from < p_to and the duration; the six existing previous_year cases stay green (scans.test.ts 31/31); verify:api-test 992/992; verify:api-check, verify:knip and tsc --noEmit rc 0. Mutations red then restored byte-identical: guard removed turns exactly the 2 new cases red (29 pass, 2 fail); the acceptance reader's boundary mutation (`<=` to `<`) turns exactly the zero-length case red (30 pass, 1 fail). The safety reader swept 65,664 windows with the guard (3-hour starts, Dec 2023 to Mar 2025, 18 lengths from 1 h to 366 d): none empty or reversed; the guard fired 35 times, only on Feb 28 to Feb 29 windows. Feb 29 still maps to Feb 28, never March 1. Readers: acceptance CONFIRMED, safety CONFIRMED. No deploy, no production read. 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. RESIDUAL, inside the documented one-day-shorter-or-longer rule and named in the PR body, not fixed here: [2024-02-28T06:00Z, 2024-02-29T12:00Z) (30 h) still compares with 6 h, and a 1-second overshoot gives a 1-second prior window. ui_check: none.

[2026-10-16 · Viv] r34 BUILT, NOT SHIPPED (batch ios-r3-ship, builder stage): commit 096683af on local r32/ios-r3-ship (head, on top of f1157a03), worktree ~/TacTile-dev/TacTile-ios-r3-ship, unpushed, no PR, gate not run, readers not yet run, so NOT closed. The change: previousYearWindow in apps/api/tactile-api/src/utils/analytics/query.ts now sets to = from + w.durationMs when the shifted `to` is not after the shifted `from`; the doc comment says the window then stops being "the same dates last year" for that case and ends on March 1 at w.to's time of day. Feb 29 still maps to Feb 28, never March 1. Two new scans.test.ts cases: a one-day window ending on Feb 29 ([2024-02-28T00:00Z, 2024-02-29T00:00Z) -> p_from 2023-02-28T00:00Z, p_to 2023-03-01T00:00Z, exactly 24 h) and an 18-hour window ([2024-02-28T12:00Z, 2024-02-29T06:00Z) -> 2023-02-28T12:00Z to 2023-03-01T06:00Z, exactly 18 h); both assert p_from < p_to and the duration. API_ROUTES.md gained one sentence on this case. Runs: scans.test.ts 31/31 (the six existing previous_year cases green), verify:api-test 992/992, verify:api-check and verify:knip rc 0, tsc --noEmit rc 0. MUTATION: guard removed -> exactly the two new cases red (29 pass, 2 fail), restored byte-identical (cmp) and 31/31 again. merge-tree against origin/main and #764: rc 0 both. Close only after t_3f63c464 closes, against the same PR, and only if both readers confirm the commit; otherwise move to local r34/ios-r3-refuted-t_6e3f6272, reset --hard f1157a03 and leave this task todo.

[2026-10-16 · Viv] r34 BUILDING (batch ios-r3-ship, builder stage): this rides the ios-r3 draft PR as one commit on top of f1157a03, per NEXT-PROMPT 16 Oct ("Then t_6e3f6272 stacks on that PR"). That meets "one commit, draft PR, gate first" with one gate instead of a second stacked PR, because ca8f4610 (t_3f63c464) and its previous_year code exist only on local r32/ios-r3-ship until that PR is open. Time box 45 minutes. Both readers must confirm the commit before it ships; if not, it moves to local r34/ios-r3-refuted-t_6e3f6272 and the five commits ship without it. Close only after t_3f63c464 closes. No deploy, no production read.

[2026-10-16 · Viv] Filed by the r33 hub closer for batch:ios-r3-ship. WAITS ON: ca8f4610 (t_3f63c464) being on a pushed PR; the code lives only on local r32/ios-r3-ship until then.

CONTEXT: previousYearWindow (apps/api/tactile-api/src/utils/analytics/query.ts, about :102-125) is what compare=previous_year resolves to. It shifts `from` and `to` independently with yearEarlier, which maps a Feb 29 bound to Feb 28. Read-only node check, 16 Oct: [2024-02-28T00:00Z, 2024-02-29T00:00Z) -> [2023-02-28T00:00Z, 2023-02-28T00:00Z) (durationMs 0); [2024-02-28T12:00Z, 2024-02-29T06:00Z) -> from 2023-02-28T12:00Z, to 2023-02-28T06:00Z (durationMs -21600000). The summary RPC raises nothing, so the previous total is empty and deltaPct(current, 0) shows +100 under a "vs. year ago" pill.

BUILD: in previousYearWindow, if the shifted `to` is not strictly after the shifted `from`, restore the original duration: to = from + w.durationMs (and say in the doc comment that the window then stops being "the same dates last year" for that one case). Keep the documented rule that a window spanning Feb 29 is one day shorter or longer, and keep Feb 29 -> Feb 28, never March 1.

FILES: apps/api/tactile-api/src/utils/analytics/query.ts; apps/api/tactile-api/tests/routes/scans.test.ts (the existing previous_year cases are the pattern); docs/analytics/API_ROUTES.md if the Feb 29 paragraph needs one more sentence.

ACCEPTANCE: new scans.test.ts cases for both windows above assert p_from < p_to and the expected duration; the six existing previous_year cases stay green; full pnpm verify:api-test passes; MUTATION: remove the guard and the two new cases go red, then restore. No deploy, no production read. Branch off the draft PR that carries ca8f4610 (or origin/main once it merges); one commit, draft PR, gate first.

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

previousYearWindow gives a zero-length or reversed prior window when the window ends on Feb 29