feat: add occurrence-aware appointment search

README.md

@@ -19,8 +19,10 @@ reader, arrows/Vim keys or Tab variants browse the day's appointments and
 appointment and press `e` to edit it or `d` to delete it. Forms use `Tab` and
 `Shift-Tab` (or arrows) between fields, `Space` for the all-day toggle,
 `Ctrl-S` to save, and `Esc` to cancel. Back in the calendar, `u` undoes the
-last successful mutation and `Ctrl-R` redoes it. Press `?` for help and `q` to
-quit.
+last successful mutation and `Ctrl-R` redoes it. Press `/` to search titles,
+descriptions, locations, and calendar IDs. Search results use arrows or
+`j`/`k`; `Enter` jumps to the exact occurrence and `Esc` returns to the month.
+Press `?` for help and `q` to quit.
 
 ## Build and run
 
@@ -41,6 +43,11 @@ weekly/monthly/yearly selectors, `EXDATE`, floating times, UTC, and system IANA
 `TZID` names. Recurring instances are individually navigable; edit and delete
 clearly operate on the entire series.
 
+Search expands recurring matches within five years on either side of the
+currently selected date. This finite window keeps unbounded recurrence rules
+responsive while one-time and recurring results share the same chronological
+result list.
+
 Calendars containing features this version cannot preserve—such as `RDATE`,
 detached recurrence overrides, ordinal `BYDAY`, embedded `VTIMEZONE`
 definitions, alarms, or attendees—remain browsable but read-only. This guard