# Tasks

Live checklist. `[x]` done, `[ ]` open. Update it as work finishes or is added.

## Phase 0 — structure and first page

- [x] Folder, `meta.json`, card thumbnail (`shell/images/thumbs/jentelle-belle.svg`), `ti-bell` icon, app icons
- [x] Documents: README, CLAUDE, PLAN, TASKS, DECISIONS, DATA-MODEL, DISTRIBUTION, LEARNINGS, info
- [x] Alarm list, alarm editor, arc chart with draggable start, end and bend
- [x] Cues: sound, background, voice; repeat, sprinkle and level; drag along the arc
- [x] Built-in synthesized sounds and backgrounds; user audio files; final alarm
- [x] Preview on a fast clock with a playhead; hear a single cue
- [x] Backup and import (alarms only), erase, web update check
- [x] Unit tests (arc, repeats, normalizers) and a Playwright smoke test

## Phase 1 — iterate the experience in the browser

- [ ] Review the editor with Austin on a phone and list what feels wrong (see DECISIONS.md, open questions)
- [ ] Undo and redo for chart edits
- [ ] Keyboard control of the chart (arrow keys move the selected cue or handle) and a screen-reader description of the arc
- [ ] A cue list view as an alternative to dragging (precise times, reorder, see everything at once)
- [ ] Tap an empty spot on the chart to add the armed cue kind there
- [ ] Cue fade-in and fade-out lengths; let a background start and end gradually
- [ ] More built-in sounds; categories and previews in the sound picker
- [ ] Include audio files in the backup (zip or base64) with a size warning
- [ ] The hourly time-reader as a sample routine; a timer/transition routine type beyond waking
- [ ] Alarm templates (gentle, energetic, nap) and "start from this alarm"
- [ ] Alarm on/off and per-day scheduling in the data model (the fields exist, nothing uses them yet)
- [ ] Optional service worker for offline use once the editor settles (skipped for now so changes show up immediately)
- [ ] Decide and freeze `FORMAT 1`

## Phase 2 — de-risk the native core

- [ ] Re-verify the current Android rules for exact alarms, foreground services started from an alarm, and audio focus before building
- [ ] Spike: exact alarm that starts a foreground service playing a volume ramp; test with screen off, in Doze, on two real phones
- [ ] Spike: scheduling the loud alarm independently so it fires even if the gentle sequence fails
- [ ] Spike: alarm audio stream versus media stream, silent mode and Do Not Disturb behaviour
- [ ] Spike: playing a user MP3 with a live volume envelope; pre-render versus live mixing
- [ ] Spike: on-device text to speech into an audio file
- [ ] Write up the findings in `PLAN.md` and pick the playback approach

## Phase 3 — the installable app

- [ ] New repository and Capacitor (or chosen) project wrapping this editor
- [ ] Native alarm plugin and playback service from the spike
- [ ] Permissions flow (notifications, exact alarms, battery optimization) that explains itself
- [ ] Signed release APK; keystore stored safely and backed up (losing it breaks updates)
- [ ] GitHub Releases pipeline and the in-app updater (see `DISTRIBUTION.md`)
- [ ] Install instructions page

## Phase 4 — beyond waking

- [ ] Multiple alarms with their own cues and durations
- [ ] Bedtime and meditation routines; gentle task-transition reminders and encouragements
- [ ] Spoken-time MP3 generation on the phone
- [ ] Optional wake window with sleep tracking
- [ ] iOS investigation (separate decision)
