silverbullet-icalendar/conductor/product.md

Initial Concept

silverbullet-icalendar is a Plug for SilverBullet that reads external iCalendar data (.ics format) and integrates it into the SilverBullet environment.

Product Definition - SilverBullet iCalendar Plug

Vision

A reliable and seamless bridge between external iCalendar services and the SilverBullet knowledge management environment, enabling users to consolidate their scheduling data within their personal workspace.

Target Audience

• SilverBullet users who need to integrate external calendars (Google, Nextcloud, Outlook, etc.) directly into their notes and queries.

Core Goals & Features

• Reliable Multi-Source Synchronization: Support for fetching and parsing .ics data from various providers like Google Calendar and Nextcloud.
• SilverBullet Index Integration: Seamlessly index calendar events using the ical-event tag, making them instantly queryable using SilverBullet's Lua Integrated Query (LIQ).
• Robust Timezone Handling: Accurate conversion and shifting of event times to ensure consistency regardless of the source provider's configuration.
• Cache Management: Efficient local caching of calendar data with user-configurable durations and force-sync capabilities.
• Clean Indexing: Sanitization of complex iCalendar objects into flat, query-friendly metadata.

Technology Stack (Inferred)

• Language: TypeScript
• Runtime: Deno
• Platform: SilverBullet Plug API
• Parsing Library: ts-ics