yearcycle

type Event struct {
	// Key is a stable lookup identifier derived from the SUMMARY, e.g.
	// "dpia-review". Controls reference this key instead of raw calendar UIDs.
	Key string
	// Title is the human-readable event title (SUMMARY).
	Title string
	// Month is the 1-based month in which the event occurs (1 = January).
	Month time.Month
	// Day within the month.
	Day int
	// Frequency describes the recurrence: "monthly", "quarterly", "yearly", etc.
	Frequency string
	// CalendarURL links to the source calendar entry (if available).
	CalendarURL string
}

type YearCycle struct {
	// Title for the calendar source.
	Title string
	// CalendarURL is the public URL of the iCal feed.
	CalendarURL string
	// Events projected onto a single year, sorted by month then day.
	Events []Event
}