chore: complete v2.3 Dashboard Polish milestone

Archive milestone artifacts (roadmap, requirements, audit, phases) to
milestones/v2.3-*. Update PROJECT.md with validated requirements and
key decisions. Reorganize ROADMAP.md with collapsed v2.3 details.
Update RETROSPECTIVE.md with v2.3 section and cross-milestone trends.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: claude

.planning/MILESTONES.md

@@ -1,5 +1,31 @@
 # Milestones: Lumio
 
+## v2.3 Dashboard Polish (Shipped: 2026-03-05)
+
+**Delivered:** Compact, visually coherent dashboard with 2x2 stat card grid, verbose localized relative time, and circular icon-only study button.
+
+**Phases completed:** 34-35 (2 plans total)
+
+**Key accomplishments:**
+
+- Dashboard 2x2 stat card grid: Repository, Cards, Last Studied, Due Today side-by-side at half width
+- Verbose localized relative time for Last Studied in both IT and EN ("ieri", "2 giorni fa", "yesterday", "2 days ago")
+- Last Studied card made non-tappable (removed study history navigation from dashboard)
+- Circular 60px play button replacing rectangular text CTA for study sessions
+- i18n cleanup: 24 verbose time keys added, unused button text keys removed
+
+**Stats:**
+
+- 15 files changed (+911 / -110 lines)
+- 2 phases, 2 plans, 4 tasks
+- 1 day (2026-03-05)
+
+**Git range:** `26a12aa` → `f9db8c2` (9 commits: 3 feat + 1 fix + 2 test + 2 docs + 1 chore)
+
+**What's next:** TBD
+
+---
+
 ## v2.2 Session Limits (Shipped: 2026-03-05)
 
 **Delivered:** Session card limit enforcement end-to-end — RPC caps cards to user-chosen limit with overdue-first priority, dashboard counter reflects session-limited count, and "Auto" label replaces infinity symbol.

.planning/PROJECT.md

@@ -2,7 +2,7 @@
 
 ## What This Is
 
-Lumio è una piattaforma di studio basata su flashcard che sfrutta l'AI per trasformare concetti in sessioni di apprendimento interattive con ripetizione spaziata. App nativa Android (React Native/Expo) bilingue IT/EN con branding Lumio, ripetizione spaziata SM-2 (carte scadute prima, nuove dopo), sessioni di studio configurabili, counter "carte da ripassare oggi" sulla dashboard, navigazione carte nei repository, storico sessioni con conteggio carte, gestione errori sync con aggiornamento token in-app, autenticazione dual-mode (Google OAuth + email/password con verifica OTP), account linking bidirezionale (Google ↔ email), password reset via OTP, e landing page con versione dinamica per il download dell'APK. Il contenuto viene dai repository Git, le domande sono pre-generate dal sistema. Il versioning è derivato da STATE.md (GSD milestone) tramite CI pipeline.
+Lumio è una piattaforma di studio basata su flashcard che sfrutta l'AI per trasformare concetti in sessioni di apprendimento interattive con ripetizione spaziata. App nativa Android (React Native/Expo) bilingue IT/EN con branding Lumio, ripetizione spaziata SM-2 (carte scadute prima, nuove dopo), sessioni di studio configurabili con cap RPC, dashboard compatta con griglia 2x2 stat cards e tempo relativo, pulsante studio circolare icon-only, navigazione carte nei repository, storico sessioni con conteggio carte, gestione errori sync con aggiornamento token in-app, autenticazione dual-mode (Google OAuth + email/password con verifica OTP), account linking bidirezionale (Google ↔ email), password reset via OTP, e landing page con versione dinamica per il download dell'APK. Il contenuto viene dai repository Git, le domande sono pre-generate dal sistema. Il versioning è derivato da STATE.md (GSD milestone) tramite CI pipeline.
 
 ## Core Value
 
@@ -89,18 +89,14 @@ Gli utenti studiano concetti tramite quiz generati dall'AI — il contenuto vien
 - ✓ Dashboard counter mostra carte della prossima sessione (LEAST capping), non debito totale — v2.2
 - ✓ Selettore "Auto" con icona sparkles al posto di "Tutte/∞" — v2.2
 - ✓ Backward-compatible AsyncStorage migration da 'all' a 'auto' — v2.2
+- ✓ Dashboard 2x2 stat card grid: "Ultimo studio" e "Da ripassare oggi" sulla stessa riga a metà larghezza — v2.3
+- ✓ Tempo relativo localizzato IT/EN su "Ultimo studio" ("ieri", "2 giorni fa", "yesterday", "2 days ago") — v2.3
+- ✓ "Ultimo studio" non navigabile (rimosso tap → storico sessioni) — v2.3
+- ✓ Pulsante studio circolare centrato con sola icona play (60px, nessun testo) — v2.3
 
 ### Active
 
-## Current Milestone: v2.3 Dashboard Polish
-
-**Goal:** Rendere la dashboard visivamente coerente e compatta con layout a griglia uniforme, tempo relativo, e pulsante studio minimale.
-
-**Target features:**
-- Layout 2-colonne per "Ultimo studio" e "Da ripassare oggi" (come Repository/Schede)
-- Tempo relativo su "Ultimo studio" ("ieri", "2 giorni fa", "un'ora fa")
-- Rimozione navigazione storico sessioni da "Ultimo studio"
-- Pulsante studio circolare centrale con sola icona play
+(None — planning next milestone)
 
 ### Out of Scope
 
@@ -131,16 +127,16 @@ Gli utenti studiano concetti tramite quiz generati dall'AI — il contenuto vien
 
 ## Context
 
-**Stato attuale (post v2.2):**
+**Stato attuale (post v2.3):**
 - Monorepo pnpm: apps/android (Expo/React Native), apps/landing (static HTML), packages/core, packages/shared
 - Backend Supabase: auth (Google OAuth + email/password), DB, storage, edge functions, Docora webhook + study_sessions + card_review_schedule tables
 - Tech stack: Expo SDK 54, React Native 0.81, react-navigation, @lumio/core, i18n-js, react-native-marked, supermemo@2.0.23, vitest@4.0.18
 - CI/CD: lint → build-apk → deploy-landing → deploy-migrations → deploy-functions (version from STATE.md)
 - Versioning: STATE.md milestone → extract-version.cjs → version.ts, APK versionName, landing page, edge function
 - Auth: dual-mode Google OAuth + email/password con OTP verification, password reset, account linking bidirezionale
-- App bilingue IT/EN con branding Lumio, ripetizione spaziata SM-2, sessioni configurabili con cap RPC, card browse, study history con conteggio carte, studio forward-only, sync error handling con token update in-app, dashboard session-aware
-- ~19,800 LOC (TS/TSX/SQL)
-- 10 milestones shipped: v1.1 (native app), v1.2 (polish & i18n), v1.3 (bugfix & UX), v1.4 (card browse & stats), v1.5 (study UX fixes), v1.6 (sync error handling), v1.7 (GSD versioning), v2.0 (spaced repetition), v2.1 (email auth), v2.2 (session limits)
+- App bilingue IT/EN con branding Lumio, ripetizione spaziata SM-2, sessioni configurabili con cap RPC, dashboard compatta 2x2 con tempo relativo e pulsante circolare, card browse, study history con conteggio carte, studio forward-only, sync error handling con token update in-app
+- ~20,600 LOC (TS/TSX/SQL)
+- 11 milestones shipped: v1.1 (native app), v1.2 (polish & i18n), v1.3 (bugfix & UX), v1.4 (card browse & stats), v1.5 (study UX fixes), v1.6 (sync error handling), v1.7 (GSD versioning), v2.0 (spaced repetition), v2.1 (email auth), v2.2 (session limits), v2.3 (dashboard polish)
 
 ## Constraints
 
@@ -220,6 +216,11 @@ Gli utenti studiano concetti tramite quiz generati dall'AI — il contenuto vien
 | LEAST(total, p_limit) for count capping | Simpler than IF/ELSE with separate queries for scalar cap | ✓ Good — v2.2 |
 | Hardcoded 'Auto' label (universal across languages) | "Auto" is understood in both IT and EN, no translation needed | ✓ Good — v2.2 |
 | AsyncStorage backward-compat migration 'all' → 'auto' | Read old value, return new enum value silently | ✓ Good — v2.2 |
+| Verbose relative time keys alongside abbreviated | Backwards compat for StudyHistoryScreen, new verbose keys for dashboard | ✓ Good — v2.3 |
+| justNow threshold extended to <5min | Less jittery display for recent sessions | ✓ Good — v2.3 |
+| Always relative time (no absolute date fallback) | Simpler code, consistent UX — even "years ago" is relative | ✓ Good — v2.3 |
+| 60px circular play button (borderRadius 30) | Middle of 56-64 range, visually prominent centered CTA | ✓ Good — v2.3 |
+| Removed unused i18n keys after button text removal | Clean codebase, no orphaned translations | ✓ Good — v2.3 |
 
 ---
-*Last updated: 2026-03-05 after v2.3 milestone start*
+*Last updated: 2026-03-05 after v2.3 milestone completion*

.planning/RETROSPECTIVE.md

@@ -126,6 +126,44 @@
 
 ---
 
+## Milestone: v2.3 — Dashboard Polish
+
+**Shipped:** 2026-03-05
+**Phases:** 2 | **Plans:** 2 | **Sessions:** ~1
+
+### What Was Built
+- Dashboard 2x2 stat card grid with compact StatCard variant for half-width layout
+- Verbose localized relative time for Last Studied in both IT and EN (24 new i18n keys)
+- Last Studied card made non-tappable (removed study history navigation from dashboard)
+- Circular 60px play button replacing rectangular text CTA for study sessions
+- i18n cleanup: removed unused button text keys
+
+### What Worked
+- Minimal scope (2 phases, 4 requirements) — shipped same day as v2.2, zero deviations
+- Compact StatCard prop is reusable for future half-width card layouts
+- justNow threshold extension (5min) reduces jitter for "just studied" display
+- Phase 35 UAT caught vertical centering and disabled state issues — fixed in single commit
+
+### What Was Inefficient
+- Nothing notable — clean execution, same-day completion
+
+### Patterns Established
+- compact StatCard prop: fontSize 18 value, wider skeleton — use for half-width cards
+- Verbose relative time i18n: singular (oneMinuteAgo) vs plural (minutesAgo) key pattern
+- Circular CTA: wrap TouchableOpacity in centering View container with generous vertical spacing
+
+### Key Lessons
+1. Pure UI polish milestones are fast and low-risk — 2 phases in ~4 minutes total execution
+2. Keeping abbreviated time keys for backwards compat avoids breaking existing screens
+3. UAT on UI changes catches visual issues (centering, disabled state) that code review misses
+
+### Cost Observations
+- Model mix: 80% opus, 20% sonnet (quality profile)
+- Sessions: ~1 (same day as v2.2)
+- Notable: Fastest milestone — 2 phases, 2 plans, 4 tasks, ~4 minutes total execution time
+
+---
+
 ## Cross-Milestone Trends
 
 ### Process Evolution
@@ -135,6 +173,7 @@
 | v2.0 | ~4 | 4 | First milestone with audit-before-complete workflow; gap closure pattern |
 | v2.1 | ~5 | 5 | Largest since v1.1; post-ship quick fixes revealed UAT gaps |
 | v2.2 | ~2 | 2 | Cleanest milestone — zero deviations, zero issues |
+| v2.3 | ~1 | 2 | Fastest milestone — pure UI polish, same-day ship |
 
 ### Cumulative Quality
 
@@ -143,6 +182,7 @@
 | v2.0 | 10 (SM-2 unit) | SRS module only | supermemo@2.0.23, vitest@4.0.18 |
 | v2.1 | — | Auth flows (manual) | — |
 | v2.2 | — | Session limit (manual) | — |
+| v2.3 | — | UI polish (UAT) | — |
 
 ### Top Lessons (Verified Across Milestones)
 
@@ -151,3 +191,4 @@
 3. Small gap closure plans are more efficient than trying to get everything right in the first pass (v2.0)
 4. Small, focused milestones execute cleanly with near-zero overhead (v2.2)
 5. Reusing patterns across phases in the same milestone accelerates development (v2.2)
+6. Pure UI polish milestones are fast, low-risk, and benefit most from UAT (v2.3)

.planning/ROADMAP.md

@@ -129,46 +129,17 @@ Full details: `.planning/milestones/v2.2-ROADMAP.md`
 
 </details>
 
-### v2.3 Dashboard Polish (Complete)
-
-**Milestone Goal:** Rendere la dashboard visivamente coerente e compatta con layout a griglia uniforme, tempo relativo, e pulsante studio minimale.
-
-- [x] **Phase 34: Dashboard Stat Cards** - Two-column layout with relative time and non-navigable last-studied card (completed 2026-03-05)
-- [x] **Phase 35: Study Button Redesign** - Circular centered play button replacing text button (completed 2026-03-05)
-
-## Phase Details
-
-### Phase 34: Dashboard Stat Cards
-**Goal**: Users see a compact, uniform dashboard with stat cards on a single row and human-friendly timestamps
-**Depends on**: Nothing (first phase of v2.3)
-**Requirements**: DASH-01, DASH-02, DASH-03
-**Success Criteria** (what must be TRUE):
-  1. "Ultimo studio" and "Da ripassare oggi" cards sit side-by-side on the same row, each at half width, matching the existing Repository/Schede row layout
-  2. "Ultimo studio" card shows localized relative time (IT: "ieri", "2 giorni fa"; EN: "yesterday", "2 days ago") instead of absolute date
-  3. Tapping "Ultimo studio" card does nothing -- no navigation to study history
-  4. Both cards render correctly in light and dark mode at various text lengths
-**Plans**: 1 plan
-
-Plans:
-- [x] 34-01-PLAN.md — Two-column stat layout with verbose relative time and compact cards
-
-### Phase 35: Study Button Redesign
-**Goal**: Users start study sessions from a clean, icon-only circular button
-**Depends on**: Nothing (independent of Phase 34)
-**Requirements**: STUD-01
-**Success Criteria** (what must be TRUE):
-  1. Study button is a centered circle with only a play icon (no text label)
-  2. Tapping the button starts a study session (same behavior as current button)
-  3. Button is visually prominent and centered below the stat cards in both themes
-**Plans**: 1 plan
-
-Plans:
-- [x] 35-01-PLAN.md — Circular play button with i18n cleanup
+<details>
+<summary>✅ v2.3 Dashboard Polish (Phases 34-35) — SHIPPED 2026-03-05</summary>
 
-## Progress
+- [x] Phase 34: Dashboard Stat Cards (1 plan) — completed 2026-03-05
+- [x] Phase 35: Study Button Redesign (1 plan) — completed 2026-03-05
+
+Full details: `.planning/milestones/v2.3-ROADMAP.md`
 
-**Execution Order:**
-Phases execute in numeric order: 34 -> 35
+</details>
+
+## Progress
 
 | Phase | Milestone | Plans Complete | Status | Completed |
 |-------|-----------|----------------|--------|-----------|
@@ -182,9 +153,8 @@ Phases execute in numeric order: 34 -> 35
 | 23-26. Spaced Repetition | v2.0 | 8/8 | Complete | 2026-02-26 |
 | 27-31. Email Auth | v2.1 | 10/10 | Complete | 2026-03-02 |
 | 32-33. Session Limits | v2.2 | 2/2 | Complete | 2026-03-05 |
-| 34. Dashboard Stat Cards | v2.3 | 1/1 | Complete | 2026-03-05 |
-| 35. Study Button Redesign | v2.3 | Complete    | 2026-03-05 | 2026-03-05 |
+| 34-35. Dashboard Polish | v2.3 | 2/2 | Complete | 2026-03-05 |
 
 ---
 *Roadmap created: 2026-01-29*
-*v2.3 roadmap added: 2026-03-05*
+*Last updated: 2026-03-05 after v2.3 milestone completion*

.planning/STATE.md

@@ -4,7 +4,7 @@ milestone: v2.3
 milestone_name: Dashboard Polish
 status: completed
 stopped_at: Completed 35-01-PLAN.md
-last_updated: "2026-03-05T17:37:25.269Z"
+last_updated: "2026-03-05T18:09:23.987Z"
 last_activity: 2026-03-05 — Completed 35-01 Study Button Redesign plan
 progress:
   total_phases: 2
@@ -21,7 +21,7 @@ progress:
 See: .planning/PROJECT.md (updated 2026-03-05)
 
 **Core value:** Gli utenti studiano concetti tramite quiz generati dall'AI -- il contenuto viene dai repository Git, le domande vengono generate e pre-cachate dal sistema.
-**Current focus:** v2.3 Dashboard Polish — Phase 35 Plan 01 complete (milestone complete)
+**Current focus:** Planning next milestone
 
 ## Current Position
 
@@ -36,7 +36,7 @@ Progress: [██████████] 100%
 
 **Velocity:**
 - Total plans completed: 70 (across v1.1-v2.3)
-- Total milestones shipped: 10
+- Total milestones shipped: 11
 - Timeline: 35 days (2026-01-29 to 2026-03-05)
 
 | Phase | Plan | Duration | Tasks | Files |
@@ -64,7 +64,7 @@ None.
 
 ### Blockers/Concerns
 
-None — v2.2 milestone audit passed with 5/5 requirements satisfied.
+None — v2.3 milestone audit passed with 4/4 requirements satisfied.
 
 ### Quick Tasks Completed
 

.planning/config.json

@@ -6,7 +6,8 @@
   "workflow": {
     "research": false,
     "plan_check": true,
-    "verifier": true
+    "verifier": true,
+    "_auto_chain_active": false
   },
   "granularity": "standard"
 }

.planning/milestones/v2.3-MILESTONE-AUDIT.md

@@ -0,0 +1,85 @@
+---
+milestone: v2.3
+audited: 2026-03-05T18:10:00Z
+status: passed
+scores:
+  requirements: 4/4
+  phases: 2/2
+  integration: 4/4
+  flows: 4/4
+gaps:
+  requirements: []
+  integration: []
+  flows: []
+tech_debt: []
+nyquist:
+  compliant_phases: []
+  partial_phases: []
+  missing_phases: [34-dashboard-stat-cards, 35-study-button-redesign]
+  overall: MISSING
+---
+
+# v2.3 Dashboard Polish — Milestone Audit
+
+**Audited:** 2026-03-05T18:10:00Z
+**Status:** passed
+**Milestone Goal:** Rendere la dashboard visivamente coerente e compatta con layout a griglia uniforme, tempo relativo, e pulsante studio minimale.
+
+## Requirements Coverage (4/4 Satisfied)
+
+### 3-Source Cross-Reference
+
+| REQ-ID | VERIFICATION.md | SUMMARY Frontmatter | REQUIREMENTS.md | Final Status |
+|--------|----------------|---------------------|-----------------|-------------|
+| DASH-01 | SATISFIED (34-VERIFICATION) | Listed (34-01-SUMMARY) | [x] Complete | **satisfied** |
+| DASH-02 | SATISFIED (34-VERIFICATION) | Listed (34-01-SUMMARY) | [x] Complete | **satisfied** |
+| DASH-03 | SATISFIED (34-VERIFICATION) | Listed (34-01-SUMMARY) | [x] Complete | **satisfied** |
+| STUD-01 | SATISFIED (35-VERIFICATION) | Listed (35-01-SUMMARY) | [x] Complete | **satisfied** |
+
+**Orphaned requirements:** None
+**Unsatisfied requirements:** None
+
+## Phase Verifications (2/2 Passed)
+
+| Phase | Status | Score | Gaps | Anti-Patterns |
+|-------|--------|-------|------|---------------|
+| 34 — Dashboard Stat Cards | passed | 5/5 | None | None |
+| 35 — Study Button Redesign | passed | 4/4 | None | None |
+
+## Cross-Phase Integration (4/4 Wired)
+
+| Requirement | Integration Path | Status |
+|-------------|-----------------|--------|
+| DASH-01 | `secondStatRow` layout → two `StatCard compact` children → `flex: 1` half-width | WIRED |
+| DASH-02 | `formatLastStudied()` → `t('dashboard.*Ago')` → en.ts/it.ts verbose keys → StatCard value | WIRED |
+| DASH-03 | Last Studied StatCard has no TouchableOpacity, no onPress, no StudyHistory reference | WIRED |
+| STUD-01 | `studyButtonContainer` → 60px circular TouchableOpacity → `handleStudyPress` → `navigation.navigate('Study')` | WIRED |
+
+**Cross-phase conflict check:** Both phases modify DashboardScreen.tsx. Final file shows clean sequential composition — Phase 34 fills stat grid, Phase 35 adds circle button below. No collisions.
+
+**Orphaned exports:** 0
+**Missing connections:** 0
+
+## E2E Flows (4/4 Complete)
+
+| Flow | Path | Status |
+|------|------|--------|
+| User sees 2x2 stat grid | MainNavigator → DashboardScreen → statRow + secondStatRow | Complete |
+| Last Studied shows relative time | AsyncStorage read → formatLastStudied → i18n keys → StatCard value | Complete |
+| Last Studied not tappable | No TouchableOpacity, no onPress, no StudyHistory | Complete |
+| Circular play button starts study | Circle button → handleStudyPress → navigate('Study') → StudyScreen | Complete |
+
+## Tech Debt
+
+None. The backward-compat i18n keys (mAgo, hAgo, dAgo) are still actively used by StudyHistoryScreen.
+
+## Nyquist Compliance
+
+| Phase | VALIDATION.md | Compliant | Action |
+|-------|---------------|-----------|--------|
+| 34 — Dashboard Stat Cards | missing | — | `/gsd:validate-phase 34` |
+| 35 — Study Button Redesign | missing | — | `/gsd:validate-phase 35` |
+
+---
+*Audited: 2026-03-05T18:10:00Z*
+*Auditor: Claude (audit-milestone)*

.planning/REQUIREMENTS.md .planning/milestones/v2.3-REQUIREMENTS.md.planning/REQUIREMENTS.md renamed to .planning/milestones/v2.3-REQUIREMENTS.md

@@ -1,3 +1,12 @@
+# Requirements Archive: v2.3 Dashboard Polish
+
+**Archived:** 2026-03-05
+**Status:** SHIPPED
+
+For current requirements, see `.planning/REQUIREMENTS.md`.
+
+---
+
 # Requirements: Lumio
 
 **Defined:** 2026-03-05