From 92443c2dcc654f9bd6051646d0862f887ecb9e02 Mon Sep 17 00:00:00 2001
From: sam ditmeijer <sam@mief.info>
Date: Mon, 22 Jun 2026 16:16:53 +0000
Subject: [PATCH] =?UTF-8?q?docs:=20README=20for=20v0.8.22=20=E2=80=94=20iT?=
 =?UTF-8?q?ip=20suppression,=20duplicate=20cleanup,=20NC32-34?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++----
 1 file changed, 36 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index 53b8977..33689ea 100644
--- a/README.md
+++ b/README.md
@@ -20,7 +20,35 @@ token).
   flow back to Outlook.
 - Recurring meetings — including exceptions, cancellations, DST transitions,
   attendees and RSVPs — are handled end-to-end.
-- An admin overview shows per-user connection status and sync health.
+- **Duplicate cleanup**: surfaces meetings that Exchange minted twice (a fresh
+  `vCal-Uid` per iTip round-trip, e.g. when a room is added to an existing
+  meeting) and lets the user remove a copy. The delete is fail-closed and
+  provenance-gated — only offered when every copy is provably a Microsoft 365
+  item — with a per-user lock against concurrent deletes.
+- An admin overview shows per-user connection status and sync health, plus an
+  hourly watcher that notifies a user (bell + optional email) if their sync
+  goes offline.
+
+## Nextcloud scheduling / iTip is deliberately turned off
+
+Microsoft 365 is the authoritative scheduler for connected users. If Nextcloud
+*also* ran its own iTip scheduling, every cross-user meeting would get a second,
+NC-minted copy and duplicate invitation emails would go out. ViaVox therefore
+suppresses Nextcloud's built-in calendar scheduling on three layers:
+
+1. **No iTip emails** — a repair step sets `dav.sendInvitations=no` on install
+   and after every migration, so Nextcloud never emails iTip
+   invitations/cancellations for connected users.
+2. **No iTip on the CalDAV path** — a Sabre plugin sets `x-nc-scheduling: false`
+   on every calendar-object `PUT`/`DELETE`, short-circuiting Nextcloud's
+   scheduler. This also prevents the 403 ("event cannot be deleted") that NC's
+   scheduler raises when a room/resource attendee is involved.
+3. **No iTip on internal paths** — a listener covers the internal
+   `ICreateFromString` paths (Talk-scheduled meetings, Calendar bookings /
+   proposals) that bypass the standard CalDAV route.
+
+Microsoft 365 owns invitations and cancellations end to end; Nextcloud mirrors
+the result without generating its own scheduling traffic.
 
 ## Install
 
@@ -30,7 +58,7 @@ token).
    `apps/viavox/appinfo/info.xml` exists:
 
    ```bash
-   tar xzf viavox-0.8.19.tgz -C /var/www/nextcloud/apps/
+   tar xzf viavox-0.8.22.tar.gz -C /var/www/nextcloud/apps/
    chown -R www-data:www-data /var/www/nextcloud/apps/viavox
    ```
 
@@ -48,12 +76,16 @@ token).
 
 ## Requirements
 
-- Nextcloud 30 or newer.
-- PHP 8.1+.
+- Nextcloud 32 – 34 (verified compatible with Nextcloud 34).
+- PHP 8.1 – 8.4.
 - A reachable ViaVox Syncer instance (separately deployed).
 - A Microsoft 365 tenant with an App Registration that has
   `Calendars.ReadWrite` delegated permission.
 
+> **Operator note:** keep `dav calendarRetentionObligation` unset (the default)
+> while the duplicate-cleanup feature is in use, so a removed copy stays
+> restorable from the Nextcloud trash bin.
+
 ## License
 
 AGPL-3.0-or-later. See `COPYING` inside the package.