calendar

Managing a calendar inside a dsh workflow normally forces you to spin up a separate scheduling service or pull in a long dependency chain just to talk to one provider. dsh-calendar replaces that with a single self-contained npm package that has zero runtime dependencies. It speaks standard CalDAV (REPORT, PROPFIND, GET, PUT, DELETE) to Google Calendar, iCloud, Nextcloud, or any self-hosted CalDAV server, and covers the full event lifecycle of listing, creating, updating, deleting, and searching through ten purpose-built cal_* tools. Credentials are resolved from environment variables, the dsh credential service, or a local chmod-0600 store, and a built-in redact helper guarantees that secrets never appear in logs.

The engine goes well beyond a thin CalDAV wrapper. A from-scratch RFC 5545 recurrence expander supports every FREQ from SECONDLY through YEARLY along with ordinal BYDAY, BYSETPOS, EXDATE, and RDATE; editing or deleting a single occurrence writes a RECURRENCE-ID override and leaves the series master untouched. Conflict detection flags overlapping spans across timed, all-day, and recurring instances. The embedded timezone engine ships IANA rules for 2000 through 2100 with deterministic DST fold and gap resolution, so wall-clock to UTC conversion requires no external library. On the cultural side, lunar-month conversion is computed astronomically via Meeus truncated new-moon and solar-longitude series, covering the entire 2000-2100 range including leap months. Chinese statutory and traditional holidays, the sexagenary cycle, and zodiac (anchored at Lichun) are all first-class citizens, and cal_remind output feeds directly into dsh schedule_create to register session-local reminders in the event timezone.

If you are building a scheduling assistant inside dsh, need accurate Chinese lunar-calendar and holiday context without a hard-coded table, or want to juggle multiple CalDAV sources without standing up a separate backend, dsh-calendar gives you a production-ready, dependency-free calendar layer that plugs into the dsh toolchain out of the box.