pkg/

Package auth implements the interactive Proton login flow, session teardown, and key unlocking for proton-cal.

Package calcolor is the fixed Proton Calendar accent-color palette with friendly names.

Package calendar implements Proton Calendar listing, selection, and the calendar key unlock chain on top of the raw papi client.

Package caljson holds the machine-readable JSON shapes for calendars and events, shared by the CLI's -o json output and the MCP server's structured tool results so both surfaces emit one schema.

Package calsvc is the shared service layer between the user-facing frontends (the CLI and the MCP server) and the calendar/event domain packages.

Package caltypes defines the plain event-row wire types shared by the recurrence and event packages.

Package cli implements the proton-cal cobra commands.

Package config manages the proton-cal configuration directory:

Package event implements Proton Calendar event operations: querying, decrypting, creating, updating and deleting events, including the recurrence orchestration (exception rows, EXDATEs, series cleanup).

Package eventview holds the shared, surface-independent semantics for presenting a decrypted event: name lookups (attendee status, conference provider), identity formatting, and resolving effective reminders and color from the event plus its calendar defaults.

Package ical builds and parses the four iCalendar VEVENT fragments that Proton Calendar stores per event (shared-signed, shared-encrypted, calendar-signed, calendar-encrypted).

Package icaltime is the single codec for the iCalendar date/time forms produced by Proton clients, plus timezone-loading helpers shared by the ical, recurrence, event and frontend packages.

Package mcpserver implements the proton-cal MCP (Model Context Protocol) stdio server, exposing Proton Calendar tools (list calendars, list / create / update / delete events) over stdin/stdout JSON-RPC so AI tools (Claude Code, opencode, ...) can use the calendar natively.

Package papi wraps go-proton-api's Manager/Client and adds a raw request path for the calendar endpoints go-proton-api does not implement (most importantly PUT /calendar/v1/{id}/events/sync, and GET /calendar/v1 whose response shape go-proton-api's types no longer match).

Package pgp implements the crypto layer for Proton Calendar events.

Package recurrence provides client-side recurrence handling for Proton Calendar events.

Package reminders parses user-facing reminder specifications into the caltypes.Notification wire form.