Skip to content

Feature Map

haakooto edited this page Oct 25, 2026 · 13 revisions

Feature map

What is actually built, versus what is just planned. A ledger, not a roadmap, grouped by the build order in the design spec. For what comes next, see the Roadmap. The v0.5 ledger is in git history.

2026-10-25, rev 21 (calendar files and richer repeats approved, #33 #43) · 67 tracked items · chainlang: 54/54 tests passing

Approved WIP Lacking Planned Deferred Declined
58 0 3 0 5 1

Status key

  • ✓ Approved: built, tested, confirmed working on the device
  • ◐ WIP: built, not yet verified (or partly built)
  • ✕ Lacking: known gap, no fix yet
  • Planned: designed, no code
  • Deferred: pushed out past 1.0
  • ✕ Declined: decided against

Foundation

Build step 1. Confirmed on-device.

Feature Status Note
Five-pane bottom navigation ✓ Approved Confirmed on-device: panes switch correctly. Still to check: pane stays put when changing language
Theme tokens: system / light / dark / AMOLED ✓ Approved Spec §15 palette. The first frame waits for settings, so a dark-theme user never sees a light flash
i18n: English + Norwegian ✓ Approved All strings in strings.xml with an nb translation
Per-app language ✓ Approved System LocaleManager API, so it also shows in system settings. Needs a device check
Settings: 24 h, first day of week, haptics, version ✓ Approved Stored in DataStore (relay_settings). Version comes from git
Room + migration test harness ✓ Approved Migrations confirmed in practice: every alpha installed over the last on-device (v1 to v5). The instrumented MigrationTest still needs an emulator to run
chainlang carried over ✓ Approved Moved to com.relay.chainlang, 30/30 tests passing. The v1.0 language changes (ref arithmetic, fractional range, step labels) come in step 4
Separate install from v0.5 ✓ Approved applicationId com.relay.app, so v0.5 keeps working alongside until you uninstall it

Alarms + firing module

Build step 2. Spec §04, §13. Confirmed on-device.

Feature Status Note
Plain alarm: create / edit / delete / toggle ✓ Approved List sorted by next fire, with "rings in" and a set-for toast. New alarms open straight into the time picker
One-off (delete or disable after firing) and repeating (weekdays, end date / count) ✓ Approved One-off keeps its row until the ring is over, so snooze works, then deletes or switches off
Schedule exceptions: skip or retime dates, apply to several alarms ✓ Approved Accepted on-device without a dedicated test pass
Full-screen ringing over the lock screen ✓ Approved Confirmed on-device: wakes the screen and shows over the lock screen
Continuous looping audio, volume ramp, vibration ✓ Approved Looping and the volume ramp confirmed on-device. Vibration not confirmed yet (low priority)
Snooze with per-alarm length and max count ✓ Approved Snooze and dismiss confirmed on-device. Length now takes any number (1 to 240 min); max snoozes has None. Still to check: the limit, custom length
Upcoming-alarm notification with Dismiss now ✓ Approved Accepted on-device without a dedicated test pass
Late-fire notice ✓ Approved Accepted on-device without a dedicated test pass
Reschedule on boot, time change, time-zone change, update ✓ Approved Also on every app start, since a force-stop clears alarms silently. Covered by unit tests, including the fire-vs-restart race
Several things ringing at once, stacked ✓ Approved Stacked cards on the ringing screen, each dismissed on its own. Ring timeout (default 10 min) stops and notifies
Alarms after a reboot, before the first unlock ✕ Lacking Relay isn't direct-boot aware yet, so alarms are re-armed only after you unlock once. Needs device-protected storage for the schedule table

Timers

Build step 3. Spec §05. Confirmed on-device.

Feature Status Note
Persisted run engine, driven by exact alarms ✓ Approved One exact alarm (setAlarmClock) per run for the current step end; state in Room. Seamless steps advance from the scheduled end, so late alarms don't stretch a relay. 11 unit tests
Timer: Start (unsaved, with label) / Save (library) ✓ Approved Start keeps the label on an unsaved run; Save needs a unique, script-safe label. Labels on unsaved runs are free text
Parallel runs of one definition ✓ Approved Each start is its own run with its own card and notification
Quick-start buttons (4, configurable) ✓ Approved v1.1: moved out of the + menu to small buttons left of the +, one tap. Durations editable in Settings
Run controls and Stop / Restart / +1 min at completion ✓ Approved Pause, resume, reset (to the start, paused), +1 min, stop. At the end: Stop / Restart / +1 min through the ringing screen
A run left waiting at a boundary or the end, after a reboot ✕ Lacking Shows on the Timers pane and in its notification, but doesn't ring again
Library with headers and drag-to-reorder ✓ Approved Drag-to-reorder and header up/down reused from v0.5
Draft editing (definition changes only on Save) ✓ Approved Editors work on a copy; Save writes it. Start from an editor runs the draft

Relays

Build step 4. Spec §05, §06. Confirmed on-device.

Feature Status Note
Relay definitions, transition mode, seamless tone ✓ Approved Transition mode, seamless cue (previewed when picked), default sound and vibration
Ref arithmetic (Test2 - 2), fractional range, step labels ✓ Approved All in chainlang, 19 new tests. Steps that come out at 0 or less are rejected
Plan check across references (size and depth) ✓ Approved PlanBuilder counts and depth-checks the expanded plan, and fails safely on a cycle. 10 unit tests
Per-step sound / transition override ✓ Approved Tap a step in the live preview. Provisional UI, per spec
Editor: auto-close, auto-indent, autocomplete, live preview, syntax help ✓ Approved Auto-close ( and ", type-over, auto-indent, empty-pair delete (13 unit tests), suggestion chips for names and functions, highlighting, syntax help
Renaming updates relays that use the old label ✓ Approved Token-aware: quoted labels are left alone. Deleting asks first and names the relays that would break
Error messages from the relay language in Norwegian ✕ Lacking chainlang messages are English only; the module has no Android strings

Scheduled targets

Build step 5. Spec §04. Confirmed on-device.

Feature Status Note
Alarm fires a Timer / Relay (library or inline) ✓ Approved "When it goes off": Ring, or start a timer or relay, saved or built inline. Starts quietly at the alarm time; if it can't start (deleted, broken), it rings and says why. Room v6
Alarm starts a Stopwatch ✓ Approved Name, start offset (may be negative) and tags; it starts counting at the alarm time
Save an inline target to the library ✓ Approved "Save to library" turns the inline timer or relay into a saved one, which the alarm then uses
Notify target ✓ Approved A heads-up notification instead of ringing, for alarms and calendar reminders (#14). Confirmed on the device

Stopwatch

Build step 6. Spec §07. Confirmed on-device.

Feature Status Note
Multiple, name, t₀, lap / pause / restart / delete ✓ Approved Add with optional name and start offset; starts at once. Restart goes back to t₀, clears laps, keeps running if it was
Persisted in Room ✓ Approved Wall-clock based, so a running stopwatch keeps counting across a reboot. 7 unit tests
Lap notes ✓ Approved Tap a lap to add or edit its note; lap times stay read-only. First lap measured from t₀
Ongoing notification with Lap / Pause ✓ Approved Counting chronometer with Lap and Pause, only while running
Stopwatch tags and one-tap tagged laps ✓ Approved Per-stopwatch tag list; laps take tags alongside notes; a Lap button per tag while running
Lap corrections: remove, insert, adjust ✓ Approved Boundary edits that keep the total; never below zero; optional label; ★ on changed laps. 13 unit tests on the logic
Correction history with unlimited undo and redo ✓ Approved Per stopwatch; undone entries greyed until a new correction; survives new laps; cleared by restart
Lap chart with tag filter and stats ✓ Approved Bars per lap in order, tap for the exact time, dashed average; count, average, fastest, slowest
Editing recorded lap times ✕ Declined A stopwatch is a factual record

Clock + widgets

Build step 7. Spec §08, §09. Confirmed on-device.

Feature Status Note
Large main clock + locations list ✓ Approved Main clock in the chosen style, then cities with day and offset ("Tomorrow, +9 h"). Search the time-zone database; swipe to delete, long-press to drag
Home clock while travelling ✓ Approved Settings → Home time zone. Shown at the top of the cities when the phone is in a different zone
ClockStyle: digital and analogue options, colors ✓ Approved Fonts: system, serif, mono, 7-segment (DSEG7) and a display face (Fraunces), both bundled under the SIL OFL. Analogue: hands, marks, face, second hand. A colour per element: Auto, palette, or custom. One renderer for app and widgets
Per-instance widgets with style and location ✓ Approved Each widget is drawn as a bitmap from its own settings, so fonts, gradients and borders match the app. Configure on placement and from "Widget settings"; tap opens the app on the last pane (v1.1, see below); minute ticks via a non-wakeup alarm
World-clock list and next-alarm widgets Deferred After 1.0
Export stopwatch laps (CSV) Deferred After 1.0

v1.1

Requested after the v1.0 device test. Code written 2026-10-24, not yet compiled (no JDK/SDK on the Pi) or device-tested.

Feature Status Note
Open on the last pane ✓ Approved App icon and widget tap open the last of Alarms / Timers / Stopwatch / Clock (Settings isn't remembered). Stored in DataStore last_pane
Timer length keypad ✓ Approved Own keypad: digits, h/m/s, backspace (long-press clears), +1m/+5m/+10m. Keyboard icon swaps to full text. New timers open empty with the keypad up, length first
Warned timer ✓ Approved "Warn before the end" + cue on a timer: runs as two seamless steps, one countdown to the real end. DB v7 (warnSeconds, warnTone) with migration and test. 3 PlanBuilder tests
Running timer / stopwatch notifications visible ✓ Approved Were on a LOW channel, so Android folded them under "Silent". New default-importance channels (timers_running, stopwatch_running) with no sound or vibration; old channels deleted

After 1.0

Feature Status Note
Bedtime Deferred Feasibility spike first
Automation: standard clock intents, batch import, AppFunctions Deferred Spec §12
Scheduled actions: webhooks and Tasker Deferred Not designed yet. Outbound twin of the automation item
Calendar pane: events and reminders ✓ Approved Spec §10b, #14. Month grid, events and reminders with weekly/monthly/yearly repeats; reminders are ordinary schedules. Settings moved to a header gear. Liked on the device
Calendars: colours, defaults, show/hide ✓ Approved #34. Personal, Birthdays, Alarms to start; every item and alarm in one; colours on dots, rows and widgets; per-widget calendar ticks. Confirmed on the device, v9 update included
Calendar files (.ics) ✓ Approved #33. Import (open, share or pick; update by UID; odd repeats kept as a note) and export (a calendar or one item); read-only subscriptions to an https/webcal address, refreshed on open after 6 h. Confirmed on the device; odd-repeat and oversized files not tried there (unit-tested)
Richer repeats ✓ Approved #43. Every N days/weeks/months/years, the nth or last weekday, the last day, a count; one RRULE evaluator for grid, widgets and reminders. Confirmed on the device
Multi-day items as one entry ✓ Approved #35. One bar across the days in the grid and month widget; listed once with its dates. Confirmed on the device
Calendar widgets (agenda and month) ✓ Approved Spec §10b, #15. Native Glance: a 7-day agenda and a month grid with coloured day labels, each with its own calendars and frame; month/year picker in the pane. Confirmed on the device after layout fixes
Google Calendar link ✓ Approved Spec §10b, #16. CalendarContract, no OAuth: phone calendars read in as ticked, read-only calendars; a Relay calendar can copy its items to one. Both confirmed on the device

Relay · feature map · a living ledger, not a roadmap; update it as things move

Clone this wiki locally