odysseus/docs/discovery/domains/calendar.md

Calendar

Features in this document are generated from ../feature-catalog.json, the canonical inventory.

CALENDAR-001 — CalDAV Calendar Synchronization & Account Setup

• Domain: calendar
• Status: verified
• Evidence Maturity: E0
• Commit Verified: d8a2059df8e53bc7275c45339849d14c8651e73c
• Runtime Validation: pending — Requires a controlled external CalDAV server.

Purpose

Connects to remote CalDAV servers (Apple iCloud, Nextcloud, Google) to sync calendar event feeds.

Evidence summary

• routes/calendar_routes.py — setup_calendar_routes — Exposes CalDAV setup and manual sync trigger routes.
• src/caldav_sync.py — CalDavSync — Fetches and parses remote iCalendar VEVENT objects.

Unknowns

• Invalid SSL certificates on self-hosted CalDAV servers.

CALENDAR-002 — Calendar Event Operations & iCalendar Parsing

• Domain: calendar
• Status: verified
• Evidence Maturity: E0
• Commit Verified: d8a2059df8e53bc7275c45339849d14c8651e73c
• Runtime Validation: not-required — No separate environment-dependent runtime validation was identified during this documentation pass.

Purpose

Creates, updates, deletes, and displays calendar events with timezone conversion and reminder notifications.

Evidence summary

• routes/calendar_routes.py — @router.get('/events') — Fetches calendar events for requested date window.
• src/tools/calendar.py — CalendarTool — Agent tool for creating and modifying calendar entries.

Unknowns

• Recurring RRULE event expansion calculation bugs across leap years.