# Andromida – Focus & Fix List

## 1) Onboarding walkthrough (Sherpa)
- [x] Restore Sherpa tags for focus ritual card and first habit row without triggering Swift compiler crashes.
- [x] Confirm walkthrough starts on first launch (ensure `hasCompletedOnboarding` is false in `@AppStorage`).
- [x] Add a debug-only "Reset Onboarding" action in Settings to clear `hasCompletedOnboarding`.
- [x] Verify tags visually align with the intended UI elements on iPhone 17 Pro Max.

## 2) Swift compiler stability
- [x] Identify the minimal Sherpa usage pattern that avoids the "failed to produce diagnostic" crash.
- [x] Avoid `#Preview` macro ambiguity when Sherpa is imported (use `#if DEBUG` + `PreviewProvider` or remove previews for Sherpa-tagged views).
- [x] Avoid ambiguous accessibility modifier overloads when Sherpa is imported.

## 3) Today tab UX polish
- [x] Re-add accessibility value/hint for habit rows once Sherpa-related ambiguity is resolved.
- [x] Confirm focus ritual card and habit rows still match the intended visual hierarchy after refactors.
- [x] Smart empty states: distinguish "no rituals" vs "no rituals for current time of day".
- [x] Fresh install starts clean (no pre-seeded rituals).

## 4) Settings & product readiness
- [x] Add a paid-app placeholder (e.g., "Pro unlock" copy) without backend requirements.
- [x] Confirm default settings and theme in Settings match Bedrock branding.
- [x] Wire up haptics setting to habit check-in feedback.
- [x] Wire up sound setting to habit check-in feedback.
- [x] Wire up ritual length setting to quick ritual creation.
- [x] Add daily reminder notification scheduling with time picker.

## 5) Data & defaults
- [x] Confirm seed ritual creation and quick ritual creation behave as expected.
- [x] Validate SwiftData sync (if enabled) doesn't require any external API.
- [x] Remove automatic seed rituals on fresh install.

## 6) QA checklist
- [x] First-launch walkthrough appears on a clean install.
- [x] Onboarding can be manually reset from Settings.
- [x] No build warnings or Swift compiler crashes.
- [x] iPhone 17 Pro Max simulator layout verified on Today, Rituals, Insights, Settings.

## 7) Completed enhancements
- [x] **History view** – View past/completed rituals with completion percentages.
  - [x] Scrollable month calendar grid
  - [x] Daily progress rings with color coding
  - [x] Filter by ritual using horizontal pill picker
  - [x] Tap day for detail sheet with habit list
  - [x] New History tab in tab bar
  - [x] Percentage display inside progress ring
  - [x] Comparison to weekly average badge
  - [x] Streak context badge
  - [x] Motivational messages

- [x] **Ritual management** – Create, edit, delete, and archive rituals.
  - [x] Model enhancements (isEnabled, isArchived, timeOfDay, iconName, category)
  - [x] RitualStore CRUD methods (create, update, delete, enable, archive)
  - [x] Preset library with 13 categorized presets (Health, Productivity, Mindfulness, Self-Care)
  - [x] RitualsView toolbar menu (Create New, Browse Presets)
  - [x] RitualEditSheet for create/edit form with icon picker
  - [x] PresetLibrarySheet with category tabs and detail views
  - [x] RitualDetailView action menu (Edit, Enable/Disable, Archive, Delete)
  - [x] Destructive action confirmations with history warning
  - [x] Today view filtering by isEnabled, isArchived, and timeOfDay
  - [x] Custom category input (beyond preset categories)
  - [x] Habit icon picker with 100+ icons, search, and categories
  - [x] Flexible duration: slider (7-365 days) + quick presets + custom input
  - [x] Drag-to-reorder habits

- [x] **Ritual detail enhancements**
  - [x] Time remaining countdown
  - [x] Ritual-specific streak tracking
  - [x] Milestone achievements (Day 1, Week 1, Halfway, Complete)
  - [x] Habit performance breakdown with completion rates

- [x] **Insights enhancements** – Weekly/monthly trends, streak data, charts.
  - [x] Tappable insight cards with detail sheets
  - [x] Explanations for each metric
  - [x] Per-ritual breakdowns
  - [x] Streak tracking (current & longest)
  - [x] 7-day trend chart with sparkline preview
  - [x] Trend indicators (up/down/stable) with week-over-week comparison
  - [x] Contextual tips based on performance
  - [x] Days Active breakdown showing calculation details

## 8) Future enhancements
- [ ] **HealthKit integration** – Sync habit completions (water, mindfulness, exercise) to Apple Health. See plan: `.cursor/plans/healthkit_integration_plan_ce4f933c.plan.md`
- [ ] **Widget** – Home screen widget showing today's progress.
- [ ] **Watch app** – Companion app for quick habit check-ins.
- [x] **Smart Reminders** – Time-slot based reminders (morning/midday/evening) scheduled automatically based on active rituals.
- [ ] **Export/Import** – Backup and restore ritual data.
- [ ] **Statistics** – Monthly/yearly summary views.