calendula/.planning/STATE.md

# Calendula — Current State

*Last updated: 2026-06-17*

## Status

**Milestone:** 2 (write support) **complete** — v2.0.0 shipped 2026-06-11;
v2.1.0 (month event grid, drawer view tabs, cursor fix) shipped 2026-06-15.
**Phase:** post-2.1 backlog work. v2.2.0 (tap-to-create in day/week + local
calendar management) and v2.3.0 (Material 3 grouped-list redesign of Settings,
the calendar manager and the navigation drawer) both shipped 2026-06-16;
v2.4.0 (per-event colors) and v2.5.0 (jump-to-date, Agenda view, home-screen
agenda + month widgets, and a "New event" launcher shortcut) shipped
2026-06-17. The backlog is now organised by theme in `ROADMAP.md`.

## Progress

- [x] Design spec written and committed (`docs/superpowers/specs/2026-06-08-calendar-app-design.md`)
- [x] V1 design decisions resolved (App name "Calendula", icon, seed color)
- [x] Plan 01 written and executed — foundation lands (theme, icon, i18n, Hilt, DataStore, CI green)
- [x] Plan 02 written and executed — data layer + permission flow + debug screen
- [x] Month view (S1) — 6-week grid, event dots, today marker, swipe nav, three states (replaces debug screen)
- [x] Week view (S2) — time schedule with overlap-resolved lanes, all-day strip, swipe nav, three states
- [x] Day view (S3) — single-column slice reusing the week layout
- [x] View-switcher (M1) wired — cycles Month ↔ Week ↔ Day
- [x] Event-detail screen (S4) — full-screen, humanized recurrence
- [x] Filter sheet (M3) — per-calendar visibility, grouped by account, persisted, applied centrally in the repository
- [x] Settings (M4) — appearance (theme, dynamic colour, week start), language (per-app locales), about
- [~] Jump-to-date (M2) — **cut from scope**; "Today" half shipped in v0.5, date-picker dropped
- [x] Full event read (v0.6) — reminders, status, availability, access level,
  attendee role + self-response, foreign timezone, and linkified description
  URLs in the detail view; new domain enums + mapper unit tests. (A dedicated
  URL field was cut — no `CalendarContract` column backs it.)

- [x] v1.1 write foundation — `WRITE_CALENDAR` (onboarding asks READ+WRITE,
  only READ gates; contextual upgrade for v1.0 installs), read-only-calendar
  detection (`CALENDAR_ACCESS_LEVEL` → `canModifyContents`, actions hidden for
  WebCal/birthday calendars), delete from the detail screen (recurring:
  "only this event" via cancelled exception / "all events in the series"),
  repository + mapper tests

- [x] v1.2 create event — full-screen `EventEditScreen` (title, all-day,
  M3 date/time pickers with duration-preserving start moves, writable-only
  calendar picker preselecting the last-used calendar, location, description),
  "+" FAB on all three views prefilled with the visible day, `insertEvent`
  with provider-correct all-day normalisation (UTC midnights, exclusive end),
  domain/mapper/repository tests

- [x] v1.3 edit event (shipped 2026-06-11) — `EventEditScreen` reused for
  edit (detail-screen Edit action, `canModify`-gated, contextual WRITE
  upgrade), dirty-checked partial `update` on the Events row (recurring:
  series DTSTART moves by the user's delta, DURATION instead of DTEND),
  reminder diff by minutes (kept rows keep their method), simple recurrence
  picker (FREQ/INTERVAL/UNTIL/COUNT; complex RRULEs preserved verbatim and
  shown humanized), `EventFormField.Recurrence` incl. settings default,
  recurrence also available on create; domain/mapper/repository tests.
  Review round 1: weekly BYDAY day-toggles in the custom picker ("every week
  on Mon+Fri"). Review rounds 2–4: occurrence edit pulled forward from v2.0
  and made three-way like delete ("this" = exception row via
  `CONTENT_EXCEPTION_URI`, "this and following" = series split, "all" =
  series update); delete equally three-way (truncation via RRULE UNTIL);
  the edit-scope question moved to save time (Google model) — dirty
  recurring saves park in `SaveUiState.AwaitingScope`, a changed rule drops
  the "only this event" option

- [x] v1.4 reminder notifications (shipped 2026-06-11) — exported
  `EVENT_REMINDER` receiver → `CalendarAlerts` (SCHEDULED & due) →
  dedicated channel, tap opens detail (singleTop deep link); best-effort
  FIRED marking; one-time onboarding step requesting `POST_NOTIFICATIONS`
  with duplicate-reminders warning; Settings mirror. Provider only fires
  `METHOD_ALERT` rows (AOSP-verified), so email reminders never reach us

- [x] v2.0 conflict dialog + store polish (shipped 2026-06-11 as v2.0.0) —
  `EditSnapshot` compare on save (overwrite/discard; deleted → close),
  quick-add cut, calendar-switch → v3 backlog; F-Droid/README copy
  refreshed, fastlane screenshots DE+EN captured on-device

- [x] v2.1 (shipped 2026-06-15) — month grid shows real events as
  continuous multi-day bars; navigation-drawer View section
  (Month/Week/Day); cursor-jump fix in event text fields

- [x] v2.2 (shipped 2026-06-16) — tap an empty slot in day/week to create
  (prefilled with that day + tapped hour, snapped to the hour); local
  calendar management in a full-screen editor from Settings →
  Calendars: create/rename/recolor/delete device-only calendars
  (`ACCOUNT_TYPE_LOCAL`, sync-adapter insert) with name, pastel-previewed
  colour, and description (stored in `CAL_SYNC1`); synced calendars listed
  read-only grouped by account with a per-account "manage in source app"
  deep-link (resolved from the account's authenticator: DAVx5/ICSx5/…) and
  an add-account shortcut. Shared `InlineTextField` extracted to `ui.common`

- [x] v2.3 settings/calendars/drawer redesign (shipped 2026-06-16) — adopted a
  shared Material 3 grouped-list blueprint, modelled on the ReFra gallery app
  and extracted to `ui/common/GroupedList.kt` (`CollapsingScaffold` with a
  `LargeTopAppBar` exit-until-collapsed title; `GroupedRow` with Position-based
  corner grouping, press-animated corners, `selected` + `minHeight` knobs).
    - Settings: category hub (About card on top → version mark at the foot) with
      sliding sub-pages (Appearance / New event form / Notifications); token-
      based icon chips; theme/week-start/language pickers migrated from
      `DropdownMenu` to OptionCard dialogs. New `ic_gitea.xml` (Simple Icons,
      verbatim path) for the About "Source" button; en+de strings.
    - Calendar manager: same collapsing scaffold + grouped rows; shared
      `CalendarColorChip` (neutral chip, pastelised calendar glyph).
    - Navigation drawer: branded header, grouped View switcher (active view
      highlighted via `secondaryContainer`), the filter list restyled to
      grouped rows with a trailing checkbox; the whole drawer scrolls as one.
    - Cards use `surfaceContainerHigh` for readable contrast against `surface`.
    - Donate button on the About card deferred (target still TBD).

- [x] v2.4 per-event color (shipped 2026-06-17) — an optional "Color" field in
  the event form. Read/render already resolved `EVENT_COLOR` with a calendar
  fallback; this adds the write side and the picker. Palette-backed calendars
  (Google, some CalDAV) pick from the account's `Colors` (`TYPE_EVENT`) and
  write `EVENT_COLOR_KEY` so the color round-trips through sync; local
  calendars write a raw `EVENT_COLOR` from the shared `CALENDAR_COLOR_PALETTE`
  (extracted with the swatch row to `ui/common/ColorSwatchRow.kt`). Switching
  calendars resets the choice (a key is account-scoped). A settings toggle
  ("Allow colors on unsupported calendars", off by default) extends the raw
  path to synced calendars with no palette, with an honest "may not survive
  sync" warning on the picker and in Settings. Color writes flow through
  insert / dirty-checked update / occurrence-exception; mapper + form tests.

## Next

1. Monitor the F-Droid build/publish for the v2.4.0 tag
2. Decide the "Locations & People" and "remote calendar create/edit"
   go/no-go calls (both hinge on the INTERNET permission) — see `ROADMAP.md`
3. **Duplicate event** and **jump-to-date** are the cheap follow-ups; then
   agenda view (strategic, backs a future widget). Full ranked sequence in
   `ROADMAP.md` → "Near-term sequence".