docs: document live notes commands and calendar range/cleanup commands

update_live_notes/set_segment_note; import_pst's new rangeDays param;
new cleanup_calendar_events command.

docs/04-api-contracts.md

@@ -26,6 +26,15 @@ resume_recording(input: { meetingId: MeetingId }): void
 set_recording_retention(input: { meetingId: MeetingId; record: boolean }): void  // toggle mid-meeting (FR-REC-1)
 acknowledge_recording_consent(): void                                            // one-time (FR-REC-2)
 
+// ---- Live notes (Granola-style redesign, `03-data-model.md`'s manual_notes.json) ----
+// Both are live-session only (err "no matching active recording" once finalized — post-finalize,
+// notes.md is the single editable document and `update_notes` is the command for it).
+update_live_notes(input: { meetingId: MeetingId; markdown: string }): void       // freeform notes typed while recording
+// anchorMs: the clicked transcript segment's start_ms, not its id (survives re-transcription).
+// text: "" clears that moment's note. Merged into notes.md right after the transcript paragraph
+// covering anchorMs when the meeting finalizes (notes::MarkdownNotes::merge).
+set_segment_note(input: { meetingId: MeetingId; anchorMs: number; text: string }): void
+
 // ---- Hardware ----
 hardware_status(): { backends: BackendInfo[]; active: BackendId; modelSize: string; estRtf: number }
 set_preferred_backend(input: { backend: BackendId | "auto" }): void
@@ -83,9 +92,19 @@ llm_setup_suggestions(): { ollamaInstalled: boolean; installUrl: string; suggest
 pull_ollama_model(input: { model: string }): void  // guided download via Ollama's own /api/pull; emits model://progress (T5.7)
 
 // ---- Calendar / .pst ----
-import_pst(input: { path: string; password?: string }): number   // eventsImported; emits pst://progress (FR-CAL-1)
+// rangeDays: only import events starting within the last N days; omitted imports the full mailbox
+// history. Bug fix: a long-lived .pst has no natural upper bound on history (every recurring
+// series expands to its cap, T4.1's RECURRENCE_MAX_OCCURRENCES, plus every one-off entry the file
+// ever held, e.g. a decade of Outlook's auto-generated yearly holidays) -- unbounded import could
+// produce tens of thousands of rows. Settings.pst_import_range_days persists the last choice and
+// applies it to pst_auto_sync's startup re-import too.
+import_pst(input: { path: string; password?: string; rangeDays?: number }): number   // eventsImported; emits pst://progress (FR-CAL-1)
 list_calendar_events(input: { from?: number; to?: number }): CalendarEvent[]
 get_calendar_event(input: { eventId: string }): { event: CalendarEvent; participants: Participant[] }  // pre-meeting panel + naming dropdown (FR-CAL-3, FR-SPK-4)
+// olderThanDays omitted deletes every unlinked event ("Delete all"); Some(n) only those starting
+// more than n days ago. An event attached to a recorded meeting (meetings.calendar_event_id) is
+// always kept regardless of the choice -- protected reports how many were skipped for that reason.
+cleanup_calendar_events(input: { olderThanDays?: number }): { deleted: number; protected: number }
 attach_meeting_to_event(input: { meetingId: MeetingId; eventId: string }): void
 // Optional MS Graph calendar source (M4.4, T8.9, FR-CAL-6): opt-in, explicit consent (OAuth PKCE
 // + Microsoft's own consent screen), metadata-only (subject/organizer/start/end/attendees, never
@@ -240,6 +259,9 @@ pub trait NotesRenderer: Send + Sync {
     fn to_markdown(&self, t: &Transcript, speakers: &[SpeakerInfo], s: Option<&Summary>) -> String;
     fn export(&self, md: &str, dest: &Path, fmt: ExportFormat) -> Result<PathBuf, NotesError>;
 }
+// MarkdownNotes::merge(segments, speakers, manual: &ManualNotes, summary, template) -> String is an
+// inherent method (not part of the trait — only one renderer needs it): what `stop_recording` calls
+// instead of `to_markdown` to fold manual_notes.json into the generated notes.md (see 03-data-model.md).
 
 // sync/mod.rs
 // One impl per provider; `WebDavTarget` covers Nextcloud/ownCloud/Cloudreve/Seafile/Synology.