{ "contract": "calee.event-occurrence-identity", "contractVersion": 3, "documentation": "contracts/event-occurrence-identity/v3/README.md", "issue": "CaleeAdmin/calee-hub-core#573", "supersedes": { "contractVersion": 2, "fixture": "contracts/event-occurrence-identity/v2/contract.json", "fixtureSha256": "b392100c19e5e841b787117d29545d1cf1adbedfbd8abd2a1dba9633e0a2fd73", "frozen": true, "note": "v2 is frozen and stays executable, exactly as v1 did when v2 superseded it. v3 does not rewrite either.", "lineage": [ { "contractVersion": 1, "fixture": "contracts/event-occurrence-identity/v1/contract.json", "fixtureSha256": "930d09c6760b88bb335c550afa52d100e19b7c888d72f35743653e2b0e1028f3", "frozen": true }, { "contractVersion": 2, "fixture": "contracts/event-occurrence-identity/v2/contract.json", "fixtureSha256": "b392100c19e5e841b787117d29545d1cf1adbedfbd8abd2a1dba9633e0a2fd73", "frozen": true } ] }, "semanticDelta": { "summary": "v2 semantics plus ONE deliberate expansion: the single Windows timezone ID v2 listed in windowsIdentityExclusions -- Paraguay Standard Time -> America/Asuncion -- is identity-eligible. windowsIdentityExclusions is therefore EMPTY and every one of the 139 pinned mappings may mint portable identity. The mapping artifact, the resolution ladder, the eligibility RULE and everything else in v2 carry forward unchanged; only the exclusion LIST changed.", "widened": [ { "from": "unsupported_tzid", "to": "ok", "condition": "the stated TZID is exactly the Windows timezone ID `Paraguay Standard Time` (case-insensitive, trimmed), which v2 listed in windowsIdentityExclusions and v3 does not", "windowsId": "Paraguay Standard Time", "iana": "America/Asuncion", "v2Case": "windows-tzid-identity-ineligible", "v2Scenario": "windows-identity-ineligible-series", "prerequisite": "CaleeAdmin/CaleeMobile#607: CaleeMobile's bundled timezone data moved to tzdb 2025b, and its occurrence-identity timezone matrix reproduces the PHP reference for all 139 mapped destinations with zero timezone-data divergences." } ], "widenedWindowsIds": [ "Paraguay Standard Time" ], "notWidened": [ { "stays": "unsupported_tzid", "condition": "the stated TZID is a Windows-shaped name the pinned mapping does not contain", "note": "v3 empties the exclusion list. It does not widen the map, and it does not widen the guessing." }, { "stays": "unsupported_tzid", "condition": "the calendar/source timezone context is a Windows timezone ID", "note": "The mapping is reached from the property's OWN stated TZID only, exactly as in v2. A floating value cannot acquire an identity from a Windows name its source never stated." }, { "stays": "as in v2", "condition": "every other v2 refusal: malformed values, abbreviations, numeric offsets, floating values without context, all-day shape mismatches", "note": "v2 -> v3 widens EXACTLY ONE Windows ID. A v3 implementation that turned any other v2 refusal into a success is wrong, and the v2 -> v3 compatibility suite in each repository pins the widened set by name." } ], "unchanged": [ "UID semantics", "all-day semantics", "malformed-value handling", "explicit-Z precedence", "property-TZID precedence", "the pinned Windows mapping artifact (139 entries, same bytes, same SHA-256)", "the Windows identity-eligibility RULE (present in the mapping AND absent from windowsIdentityExclusions)", "the resolution ladder and its order", "detached override identity", "cancellation semantics", "EXDATE semantics", "floating-without-context refusal", "the identity triple and its separate transport", "the canonical identity formats" ] }, "v1Compatibility": { "invariant": "every source shape v1 could identify produces the SAME canonical identity under v3", "statement": "For every v1 fixture case whose status is ok, the v3 implementation MUST report status ok and the byte-identical canonicalIdentity. The only intended widenings relative to v1 are the v2 widening (a SUPPORTED Windows name resolves through the pinned mapping) and the v3 widening (Paraguay Standard Time joins the supported set).", "migration": "NONE. No Event Link minted under v1 changes meaning under v3, so no link needs reissuing and no stored identity needs rewriting. A v1 link keeps resolving to the occurrence it always named.", "mechanicalTest": "Each repository executes the FROZEN v1 fixture against its v3 implementation and asserts the invariant above. If any previously successful v1 identity changes, that is a much larger migration and must not be hidden inside this contract." }, "v2Compatibility": { "invariant": "every source shape v2 could identify produces the SAME canonical identity under v3", "statement": "For every v2 fixture case whose status is ok, the v3 implementation MUST report status ok and the byte-identical canonicalIdentity. For every v2 fixture case whose status is a refusal, the v3 implementation MUST report the SAME refusal -- with exactly one exception: a case v2 refused ONLY because its stated TZID is Paraguay Standard Time is ok under v3, with the identity of the mapped America/Asuncion clock.", "widenedWindowsIds": [ "Paraguay Standard Time" ], "widenedV2IdentityCases": [ "windows-tzid-identity-ineligible", "windows-tzid-identity-ineligible-not-rescued-by-calendar" ], "widenedV2Scenarios": [ "windows-identity-ineligible-series" ], "migration": "NONE. No Event Link minted under v2 changes meaning under v3, so no link needs reissuing and no stored identity needs rewriting. A v2 link keeps resolving to the occurrence it always named. A v2 runtime executing contract version 2 MUST still refuse Paraguay Standard Time; only a runtime executing version 3 accepts it.", "mechanicalTest": "Each repository executes the FROZEN v2 fixture against its v3 implementation and asserts the invariant above, and separately asserts that the set of v2 cases whose answer changed is EXACTLY the widened set named here -- not a superset that grew by accident." }, "windowsIdentityExclusions": [], "windowsIdentityRule": { "eligible": "a Windows timezone ID is identity-eligible under this contract version when it is present in the pinned mapping artifact AND its windowsId does not appear in windowsIdentityExclusions", "ineligibleStatus": "unsupported_tzid", "ineligibleIdentity": null, "set": "mappingArtifact.count MINUS windowsIdentityExclusions", "sourceInterpretationUnaffected": "An excluded ID is still MAPPED for source interpretation: display, per-property zones and the public timeZoneResolution state all continue to report the mapped zone. A source may therefore legitimately report resolved_windows while minting no identity at all -- the same asymmetry between CLOCK AUTHORITY and IDENTITY ELIGIBILITY that #558 B2a established, now with a second reason to be on the ineligible side of it.", "scopeLimit": "This rule governs the WINDOWS-RESOLUTION rung only. A source that names the SAME destination with a portable IANA TZID is resolved by the portable rung, which v1 has always accepted and v2 does not change -- so an excluded destination remains reachable that way, and remains subject to whatever timezone-database divergence caused the exclusion. Closing that door would change a v1 answer and break links already minted, which this contract version explicitly must not do. It is the client timezone-data prerequisite (s9) that closes it, not an exclusion list.", "notARemoval": "An excluded ID MUST NOT be deleted from the mapping artifact. Deleting it would break source interpretation for a zone Calee reads correctly, and would make the artifact a function of one client's timezone database rather than of CLDR.", "v3Note": "The rule is unchanged from v2; the LIST it reads is empty. An implementation MUST still evaluate the exclusion list of the contract version it is EXECUTING -- a runtime asked to execute version 2 reads v2's list and refuses Paraguay Standard Time, the same runtime asked to execute version 3 reads this empty list and accepts it. Aliasing the two would retroactively change v2 answers, which the v2 -> v3 compatibility invariant forbids." }, "mappingArtifact": { "name": "windows-timezones.v1.json", "version": 1, "sha256": "b174be059cf8194bbf4747a6b617ed409131848a0c98228352e7d6cf3f621704", "count": 139, "identityEligibleCount": 139, "territory": "001", "lookup": "case-insensitive on the Windows ID, ASCII, after trimming surrounding whitespace", "cldr": { "source": "unicode-org/cldr common/supplemental/windowsZones.xml", "version": "release-47", "sha256": "39714d7a5a276508aeca2289a490dddb8424dea0063f3f5fbc8bd8520dcbfcba" }, "tzdb": { "source": "eggert/tz backward", "version": "2026a", "sha256": "d2f4c8953f204982ddf4dc0c2debf41b2464de376dad7d546d0fc70f889fa706" }, "requirement": "All three repositories MUST carry these exact bytes, or a representation whose equivalence to them is mechanically proven, and MUST assert this SHA-256 in their own test suite. A manually copied map without an equality test is not conformance." }, "formats": { "allDay": { "strftime": "Ymd", "pattern": "^[0-9]{8}$", "length": 8 }, "timed": { "strftime": "YmdTHisZ", "pattern": "^[0-9]{8}T[0-9]{6}Z$", "length": 16 } }, "sourceStatuses": [ "ok", "unsupported_tzid", "floating_without_context", "malformed_value", "no_source_uid" ], "identityStatuses": [ "ok", "no_calendar_reference", "no_source_uid", "no_canonical_recurrence_identity" ], "suppressionReasons": [ "cancelled", "excluded" ], "identityFields": [ "calendarRef", "sourceUid", "recurrenceId" ], "nonNormativeFields": { "description": "Local identifiers a client may keep for its own API or UI. They are NOT the Event Link identity and MUST NOT be parsed apart to recover one: a UID may legally contain the delimiter (urn:uuid:...), so no delimiter-joined composite is reversible.", "hub": [ "id", "seriesId", "occurrenceId" ], "calembed": [ "order" ], "mobile": [ "id" ] }, "resolutionOrder": [ "trailing_z_utc", "property_tzid", "property_tzid_windows_mapping", "component_dtstart_tzid", "calendar_timezone", "refuse" ], "resolutionNotes": { "trailing_z_utc": "A trailing Z designates UTC and OUTRANKS a TZID parameter on the same property (RFC 5545 3.3.5 form 2).", "component_dtstart_tzid": "Applies to RECURRENCE-ID and EXDATE only, so a property with no TZID of its own is read on the clock its series is expanded on. It never applies to DTSTART itself.", "calendar_timezone": "The explicit calendar/source timezone context supplied by the caller. There is no device, process, host or recipient fallback below it.", "refuse": "floating_without_context. An explicit but unresolvable TZID short-circuits to unsupported_tzid at step property_tzid and is NOT retried against the calendar timezone.", "property_tzid_windows_mapping": "NEW IN v2. A stated TZID that is not a portable IANA name is looked up in the pinned Windows mapping artifact before the ladder refuses it. Precedence is portable IANA first, then any source-generation embedded VTIMEZONE definition the client supports, then the pinned Windows mapping, then unresolved. The mapping never rescues a malformed value, an unknown Windows ID, an abbreviation, a numeric offset or an arbitrary string, and it never applies to an all-day value." }, "windowSemantics": { "from": "inclusive calendar date", "to": "inclusive calendar date", "note": "Every scenario window is deliberately wider than its occurrences, so windowing edge cases cannot make the three engines disagree. occurrencesAreExhaustive means the listed set is complete for that window." }, "timezoneRule": { "accepted": "the literal name UTC, or an IANA Area/Location identifier (one or more '/' separated segments of [A-Za-z0-9_+-]) that the platform timezone database resolves", "acceptedLiterals": [ "UTC" ], "acceptedPattern": "^[A-Za-z][A-Za-z0-9_+-]*(?:/[A-Za-z0-9_+-]+)+$", "rejected": "everything else, including Windows timezone names the pinned mapping does not contain, bare abbreviations and numeric UTC offsets", "rejectedStatus": "unsupported_tzid", "note": "The pattern is normative rather than deferring to the platform. Both PHP's DateTimeZone and Dart's tz.getLocation accept several non-IANA spellings, and they do not accept the same ones, so a name that resolves in one engine and not the other must be refused by both. A TZID parameter may be quoted (RFC 5545 3.1); the quotes are part of the parameter syntax, not the zone name, and MUST be stripped before this rule is applied.", "windowsMapping": { "accepted": "a Windows timezone ID present in the pinned Calee Windows->IANA mapping artifact AND absent from windowsIdentityExclusions. Presence in the mapping alone is NOT sufficient: see windowsIdentityRule.", "lookup": "case-insensitive on the Windows ID, ASCII, after trimming surrounding whitespace", "resolvesTo": "the mapped IANA Area/Location identifier, which is then resolved exactly as a portable IANA name is", "rejectedStatus": "unsupported_tzid", "note": "The mapping is a fixed, versioned artifact -- never an ICU runtime lookup, an OS mapping, a device locale, a customer country, an account timezone, fuzzy matching or string similarity. All three clients consume the SAME artifact bytes, so the runtime answer is provably identical. A Windows ID that is not in the artifact -- or that is in it but identity-ineligible -- fails closed exactly as v1 failed closed for every Windows ID." } }, "identityCases": [ { "id": "utc-timed", "description": "An explicit UTC DATE-TIME is already the canonical timed identity.", "kind": "timed", "value": "20260818T073000Z", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "utc-timed-tzid-ignored", "description": "A trailing Z designates UTC and outranks any TZID parameter on the same property.", "kind": "timed", "value": "20260818T073000Z", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "utc-named-timezone", "description": "TZID=UTC is an accepted explicit zone.", "kind": "timed", "value": "20260818T153000", "tzid": "UTC", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T153000Z" } }, { "id": "perth-timed", "description": "Australia/Perth is UTC+8 year round: 15:30 local is 07:30Z.", "kind": "timed", "value": "20260818T153000", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "sydney-aest", "description": "Australia/Sydney before DST begins on 4 October 2026 is AEST (UTC+10).", "kind": "timed", "value": "20260929T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260929T000000Z" } }, { "id": "sydney-aedt-first", "description": "The first occurrence after the transition is AEDT (UTC+11) and falls on the previous UTC day.", "kind": "timed", "value": "20261006T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20261005T230000Z" } }, { "id": "sydney-aedt-second", "description": "A second AEDT occurrence, proving the offset is not applied only at the boundary.", "kind": "timed", "value": "20261013T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20261012T230000Z" } }, { "id": "sydney-aedt-late-october", "description": "Well inside AEDT.", "kind": "timed", "value": "20261027T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20261026T230000Z" } }, { "id": "sydney-aedt-before-autumn-transition", "description": "Australia/Sydney DST ends on 5 April 2026; 30 March is still AEDT.", "kind": "timed", "value": "20260330T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260329T230000Z" } }, { "id": "sydney-aest-after-autumn-transition", "description": "6 April 2026 is back on AEST.", "kind": "timed", "value": "20260406T100000", "tzid": "Australia/Sydney", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260406T000000Z" } }, { "id": "all-day", "description": "A DATE value is a literal calendar date and is never routed through UTC.", "kind": "allDay", "value": "20260818", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818" } }, { "id": "all-day-tzid-ignored", "description": "A TZID parameter is meaningless on a DATE value and must not shift the date.", "kind": "allDay", "value": "20260818", "tzid": "Australia/Sydney", "calendarFallbackTimezone": "Pacific/Kiritimati", "expected": { "status": "ok", "canonicalIdentity": "20260818" } }, { "id": "all-day-leap-day", "description": "29 February 2028 is a real date.", "kind": "allDay", "value": "20280229", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20280229" } }, { "id": "floating-with-calendar-context", "description": "A floating value becomes portable only against an explicit calendar timezone context.", "kind": "timed", "value": "20260818T153000", "tzid": null, "calendarFallbackTimezone": "Australia/Perth", "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "floating-with-calendar-context-across-dst", "description": "The calendar timezone context is a real zone, so it observes DST.", "kind": "timed", "value": "20261006T100000", "tzid": null, "calendarFallbackTimezone": "Australia/Sydney", "expected": { "status": "ok", "canonicalIdentity": "20261005T230000Z" } }, { "id": "floating-without-context", "description": "Without a timezone context a floating value has no portable instant. It MUST NOT be resolved against the process, host, device or recipient timezone.", "kind": "timed", "value": "20260818T153000", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "floating_without_context", "canonicalIdentity": null } }, { "id": "unknown-iana-shaped-tzid", "description": "An Area/Location shaped name that no timezone database resolves.", "kind": "timed", "value": "20260818T153000", "tzid": "Mars/Olympus_Mons", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "offset-tzid", "description": "A numeric UTC offset is not an IANA identifier and does not resolve identically across the PHP and Dart timezone databases.", "kind": "timed", "value": "20260818T153000", "tzid": "+08:00", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "abbreviation-tzid", "description": "A bare abbreviation is ambiguous and is refused.", "kind": "timed", "value": "20260818T153000", "tzid": "AWST", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "unresolvable-calendar-fallback-timezone", "description": "A calendar timezone context that cannot be resolved is no context at all.", "kind": "timed", "value": "20260818T153000", "tzid": null, "calendarFallbackTimezone": "W. Australia Standard Time", "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "malformed-hour", "description": "Hour 25 is not a time. It must not roll over into another valid occurrence.", "kind": "timed", "value": "20260818T253000", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-minute", "description": "Minute 60 is not a time.", "kind": "timed", "value": "20260818T006000", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-leap-second", "description": "Second 60 is a leap second. It is not portable and is refused rather than rolled into the next minute.", "kind": "timed", "value": "20261231T235960", "tzid": "UTC", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-month", "description": "Month 13 is not a month.", "kind": "timed", "value": "20261332T120000", "tzid": "UTC", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-day-must-not-roll-over", "description": "30 February 2026 must be refused, NOT silently renamed to 2 March 2026. A malformed value must never name another valid occurrence.", "kind": "allDay", "value": "20260230", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-not-a-date", "description": "Free text is not a date.", "kind": "timed", "value": "not-a-date", "tzid": null, "calendarFallbackTimezone": "Australia/Perth", "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-empty", "description": "An empty property value carries no occurrence.", "kind": "timed", "value": "", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-date-in-timed-series", "description": "A DATE value cannot name an occurrence of a timed series; the key spaces are different and guessing one from the other invents an identity.", "kind": "timed", "value": "20260818", "tzid": "Australia/Perth", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "malformed-datetime-in-all-day-series", "description": "A DATE-TIME value cannot name an occurrence of an all-day series.", "kind": "allDay", "value": "20260818T153000", "tzid": null, "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "windows-tzid-perth", "description": "A supported Windows timezone ID resolves through the pinned Calee mapping to Australia/Perth, a fixed +08:00 zone. This is the case v1 refused; widening it is the whole of v2.", "kind": "timed", "value": "20260818T153000", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "windows-tzid-perth-acceptance", "description": "The B2b acceptance-criterion instant: 10:00 on the Perth clock is 02:00Z, never 10:00Z.", "kind": "timed", "value": "20260310T100000", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260310T020000Z" } }, { "id": "windows-tzid-lowercase", "description": "Windows ID lookup is case-insensitive after trimming, as the mapping artifact declares. IANA names remain case-sensitive.", "kind": "timed", "value": "20260818T153000", "tzid": "w. australia standard time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "windows-tzid-surrounding-whitespace", "description": "Surrounding whitespace is trimmed before the Windows lookup, as the mapping artifact declares.", "kind": "timed", "value": "20260818T153000", "tzid": " W. Australia Standard Time ", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "windows-tzid-sydney-dst", "description": "Australian DST, inside AEDT. Sydney is +11:00 on 10 March 2026.", "kind": "timed", "value": "20260310T100000", "tzid": "AUS Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260309T230000Z" } }, { "id": "windows-tzid-sydney-standard", "description": "The same Windows zone and the same wall clock outside DST. Sydney is +10:00 on 10 July 2026.", "kind": "timed", "value": "20260710T100000", "tzid": "AUS Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T000000Z" } }, { "id": "windows-tzid-sydney-dst-last-day", "description": "The last AEDT day before Australia/Sydney leaves DST on 5 April 2026.", "kind": "timed", "value": "20260401T100000", "tzid": "AUS Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260331T230000Z" } }, { "id": "windows-tzid-sydney-after-dst-end", "description": "The first AEST week after Australia/Sydney leaves DST on 5 April 2026.", "kind": "timed", "value": "20260408T100000", "tzid": "AUS Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260408T000000Z" } }, { "id": "windows-tzid-adelaide-half-hour", "description": "A half-hour zone outside DST. Adelaide is +09:30 on 10 July 2026.", "kind": "timed", "value": "20260710T100000", "tzid": "Cen. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T003000Z" } }, { "id": "windows-tzid-adelaide-half-hour-dst", "description": "The same half-hour zone inside DST. Adelaide is +10:30 on 10 February 2026.", "kind": "timed", "value": "20260210T100000", "tzid": "Cen. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260209T233000Z" } }, { "id": "windows-tzid-lord-howe", "description": "Australia/Lord_Howe, whose DST shift is 30 minutes rather than an hour.", "kind": "timed", "value": "20260210T100000", "tzid": "Lord Howe Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260209T230000Z" } }, { "id": "windows-tzid-new-york-dst", "description": "A negative-offset zone inside DST. New York is -04:00 on 10 July 2026.", "kind": "timed", "value": "20260710T100000", "tzid": "Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T140000Z" } }, { "id": "windows-tzid-new-york-standard", "description": "The same negative-offset zone outside DST. New York is -05:00 on 10 January 2026.", "kind": "timed", "value": "20260110T100000", "tzid": "Eastern Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260110T150000Z" } }, { "id": "windows-tzid-explicit-z-outranks", "description": "A trailing Z still outranks a TZID parameter, and a Windows TZID is no exception (RFC 5545 3.3.5 form 2).", "kind": "timed", "value": "20260818T073000Z", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "windows-tzid-all-day-ignored", "description": "A TZID on an all-day value is meaningless (RFC 5545 3.3.4) and a Windows TZID is no exception. It must not move the date.", "kind": "allDay", "value": "20260818", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260818" } }, { "id": "windows-tzid-with-calendar-context", "description": "A calendar timezone context does not change a SUPPORTED Windows name's answer: the source named a zone, and that zone is what the map resolves.", "kind": "timed", "value": "20260818T153000", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": "Australia/Sydney", "expected": { "status": "ok", "canonicalIdentity": "20260818T073000Z" } }, { "id": "windows-calendar-context-not-mapped", "description": "The CALENDAR-CONTEXT rung is unchanged by v2: it accepts portable names only. The mapping is reached from the property's OWN stated TZID, so a floating value cannot acquire an identity from a Windows name its source never stated.", "kind": "timed", "value": "20260310T100000", "tzid": null, "calendarFallbackTimezone": "W. Australia Standard Time", "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-tzid-paraguay-eligible", "description": "THE v3 WIDENING. Paraguay Standard Time is in the mapping and, under v3, is identity-eligible: windowsIdentityExclusions is empty. Paraguay abolished DST in 2024, so 10:00 Asuncion in July is 13:00Z on every client's timezone data. v2 refused this exact case (unsupported_tzid, identity null).", "kind": "timed", "value": "20260710T100000", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T130000Z" } }, { "id": "windows-tzid-paraguay-january-control", "description": "CONTROL on the other side of Paraguay's FORMER DST calendar. Before 2024 January was Paraguayan summer time (UTC-3) and July was standard time (UTC-4); stale timezone data that still applied the abolished rule would agree with the reference here and disagree in July. Both months must resolve to 13:00Z, so the July acceptance is not a one-date coincidence.", "kind": "timed", "value": "20260115T100000", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260115T130000Z" } }, { "id": "windows-tzid-paraguay-february-control", "description": "Second control inside the former DST season.", "kind": "timed", "value": "20260215T100000", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260215T130000Z" } }, { "id": "windows-tzid-paraguay-lowercase", "description": "The mapping lookup is case-insensitive and trimmed, and the (now empty) exclusion list is evaluated with the same normalisation, so a differently spelled Paraguay Standard Time is accepted the same way.", "kind": "timed", "value": "20260710T100000", "tzid": " paraguay standard time ", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T130000Z" } }, { "id": "windows-tzid-paraguay-with-calendar-context", "description": "A calendar timezone context does not change the answer: the source NAMED a zone, and it is the mapped zone that resolves. v2 refused this case because the exclusion applied regardless of context; v3 accepts it because the exclusion is gone -- the calendar context was never what decided.", "kind": "timed", "value": "20260710T100000", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": "America/Asuncion", "expected": { "status": "ok", "canonicalIdentity": "20260710T130000Z" } }, { "id": "windows-paraguay-calendar-context-not-mapped", "description": "The CALENDAR-CONTEXT rung is unchanged by v3: it accepts portable names only. A floating value cannot acquire an identity from a Windows name its source never stated, and Paraguay joining the eligible set does not open that door.", "kind": "timed", "value": "20260710T100000", "tzid": null, "calendarFallbackTimezone": "Paraguay Standard Time", "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-tzid-paraguay-explicit-z-outranks", "description": "A trailing Z still outranks the TZID parameter. Under v2 this case was ok because the exclusion applied only to the Windows-resolution rung; under v3 it is ok for the same reason, and the identity is byte-identical.", "kind": "timed", "value": "20260710T130000Z", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710T130000Z" } }, { "id": "windows-tzid-paraguay-all-day", "description": "An all-day value ignores its TZID entirely (RFC 5545 3.3.4). Unchanged from v2, byte-identical identity.", "kind": "allDay", "value": "20260710", "tzid": "Paraguay Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "ok", "canonicalIdentity": "20260710" } }, { "id": "windows-tzid-unknown-name", "description": "A Windows-shaped name the pinned mapping does not contain still fails closed. v2 widens the mapping, not the guessing.", "kind": "timed", "value": "20260818T153000", "tzid": "Definitely Not A Windows Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-tzid-unknown-not-rescued-by-calendar", "description": "An unknown Windows-shaped name is not rescued by the calendar timezone context either: the source named a zone, and substituting a different one invents an instant.", "kind": "timed", "value": "20260818T153000", "tzid": "Definitely Not A Windows Standard Time", "calendarFallbackTimezone": "Australia/Perth", "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-like-abbreviation", "description": "A bare abbreviation is not a Windows timezone ID and is not mapped.", "kind": "timed", "value": "20260818T153000", "tzid": "AWST", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-like-numeric-offset", "description": "A numeric UTC offset is not a Windows timezone ID and is not mapped.", "kind": "timed", "value": "20260818T153000", "tzid": "+08:00", "calendarFallbackTimezone": null, "expected": { "status": "unsupported_tzid", "canonicalIdentity": null } }, { "id": "windows-tzid-malformed-value-not-rescued", "description": "A supported Windows zone does not rescue a malformed value. 30 February is refused rather than renamed to 2 March.", "kind": "timed", "value": "20260230T100000", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } }, { "id": "windows-tzid-out-of-range-not-rescued", "description": "A supported Windows zone does not rescue an out-of-range time either.", "kind": "timed", "value": "20260818T253000", "tzid": "W. Australia Standard Time", "calendarFallbackTimezone": null, "expected": { "status": "malformed_value", "canonicalIdentity": null } } ], "uidCases": [ { "id": "uid-plain", "description": "The ordinary case.", "uidPropertyPresent": true, "uidPropertyValue": "series-one", "expected": { "status": "ok", "sourceUid": "series-one" } }, { "id": "uid-leading-space", "description": "RFC 5545 makes the bytes after the property colon the value, so a leading space belongs to the UID and MUST NOT be trimmed away.", "uidPropertyPresent": true, "uidPropertyValue": " series-one", "expected": { "status": "ok", "sourceUid": " series-one" } }, { "id": "uid-trailing-space", "description": "A trailing space likewise belongs to the UID.", "uidPropertyPresent": true, "uidPropertyValue": "series-one ", "expected": { "status": "ok", "sourceUid": "series-one " } }, { "id": "uid-internal-single-space", "description": "Internal whitespace is preserved exactly.", "uidPropertyPresent": true, "uidPropertyValue": "series one", "expected": { "status": "ok", "sourceUid": "series one" } }, { "id": "uid-internal-double-space", "description": "Internal whitespace is never collapsed.", "uidPropertyPresent": true, "uidPropertyValue": "series one", "expected": { "status": "ok", "sourceUid": "series one" } }, { "id": "uid-mixed-case", "description": "UID comparison is case sensitive.", "uidPropertyPresent": true, "uidPropertyValue": "Series-One", "expected": { "status": "ok", "sourceUid": "Series-One" } }, { "id": "uid-urn-uuid", "description": "A UID may contain colons. This is why Event Link payloads carry the UID as its own field instead of splitting a composite identifier.", "uidPropertyPresent": true, "uidPropertyValue": "urn:uuid:5b7f0f6e-3b7a-4b02-9f4e-0a6b2f1c8d31", "expected": { "status": "ok", "sourceUid": "urn:uuid:5b7f0f6e-3b7a-4b02-9f4e-0a6b2f1c8d31" } }, { "id": "uid-percent-and-plus", "description": "A UID is opaque bytes: no URL decoding, no plus-to-space translation.", "uidPropertyPresent": true, "uidPropertyValue": "a+b%20c", "expected": { "status": "ok", "sourceUid": "a+b%20c" } }, { "id": "uid-non-ascii", "description": "UTF-8 is preserved byte for byte.", "uidPropertyPresent": true, "uidPropertyValue": "série-un-événement", "expected": { "status": "ok", "sourceUid": "série-un-événement" } }, { "id": "uid-zero", "description": "The literal string \"0\" is a real UID. A language whose emptiness test treats it as falsy MUST NOT discard it and substitute a stand-in.", "uidPropertyPresent": true, "uidPropertyValue": "0", "expected": { "status": "ok", "sourceUid": "0" } }, { "id": "uid-blank", "description": "A present but empty UID is no canonical source UID. A stand-in derived from the component body MUST NOT be presented as one.", "uidPropertyPresent": true, "uidPropertyValue": "", "expected": { "status": "no_source_uid", "sourceUid": null } }, { "id": "uid-whitespace-only", "description": "A UID made only of whitespace carries no source identity.", "uidPropertyPresent": true, "uidPropertyValue": " ", "expected": { "status": "no_source_uid", "sourceUid": null } }, { "id": "uid-absent", "description": "A component with no UID property has no canonical source UID.", "uidPropertyPresent": false, "uidPropertyValue": null, "expected": { "status": "no_source_uid", "sourceUid": null } } ], "uidDistinctSets": [ { "id": "boundary-whitespace", "description": "Trimming the property value would merge three distinct source events into one shareable link.", "caseIds": [ "uid-plain", "uid-leading-space", "uid-trailing-space" ] }, { "id": "internal-whitespace", "description": "Collapsing internal whitespace would merge two distinct source events.", "caseIds": [ "uid-internal-single-space", "uid-internal-double-space" ] }, { "id": "case", "description": "Case folding would merge two distinct source events.", "caseIds": [ "uid-plain", "uid-mixed-case" ] } ], "scenarios": [ { "id": "non-recurring-perth", "description": "A non-recurring event. Identity is the calendar reference plus the source UID; there is no recurrence identity.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:event-123@contract.example", "SUMMARY:One off", "DTSTART;TZID=Australia/Perth:20260812T090000", "DTEND;TZID=Australia/Perth:20260812T100000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "event-123@contract.example", "recurrenceId": null, "startsAt": "20260812T010000Z", "allDay": false, "recurring": false, "title": "One off" } ], "suppressed": [], "forbiddenRecurrenceIds": [] } }, { "id": "non-recurring-perth-moved", "description": "The same source event an hour later. A DTSTART change MUST NOT change the logical identity, so a link shared before the change still resolves.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:event-123@contract.example", "SUMMARY:One off", "DTSTART;TZID=Australia/Perth:20260812T100000", "DTEND;TZID=Australia/Perth:20260812T110000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "event-123@contract.example", "recurrenceId": null, "startsAt": "20260812T020000Z", "allDay": false, "recurring": false, "title": "One off" } ], "suppressed": [], "forbiddenRecurrenceIds": [] } }, { "id": "perth-weekly-series", "description": "A four-occurrence Perth series with no overrides.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260804T153000Z", "20260818T153000Z" ] } }, { "id": "perth-weekly-series-other-calendar", "description": "Byte-identical source data in a different calendar. The calendar reference is part of the identity, so these occurrences are NOT the same logical occurrences as perth-weekly-series.", "calendarRef": "cal-b", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [] } }, { "id": "perth-detached-move", "description": "A detached override moved from 15:30 to 16:00 Perth. The identity comes from RECURRENCE-ID and never from the moved DTSTART, and the override REPLACES the generated occurrence rather than joining it.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - changed", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Choir - changed" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T080000Z" ] } }, { "id": "perth-detached-move-utc-recurrence-id", "description": "The same override written with a UTC RECURRENCE-ID. It names the same logical occurrence.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - changed", "RECURRENCE-ID:20260818T073000Z", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Choir - changed" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [] } }, { "id": "perth-detached-move-foreign-tzid-recurrence-id", "description": "The override names its occurrence in a DIFFERENT zone from the master's. 17:30 Australia/Sydney (AEST, UTC+10) is the same instant as 15:30 Australia/Perth (UTC+8), so it names the same logical occurrence. This pins step 2 of the resolution ladder: the property's OWN TZID wins, and an engine that reads only the component's DTSTART zone lands eight hours away.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - foreign zone override", "RECURRENCE-ID;TZID=Australia/Sydney:20260818T173000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Choir - foreign zone override" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T093000Z", "20260818T173000Z" ], "forbiddenCanonicalIdentities": [ "20260818T093000Z", "20260818T173000Z" ] } }, { "id": "perth-detached-move-inherited-tzid-recurrence-id", "description": "The override's RECURRENCE-ID carries no TZID of its own, so it is read on the clock the series is expanded on -- the master's DTSTART zone. This pins step 3 of the ladder. Reading it as UTC, or against the calendar timezone, names no occurrence of this series.", "calendarRef": "cal-a", "calendarFallbackTimezone": "Pacific/Kiritimati", "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - inherited zone override", "RECURRENCE-ID:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Choir - inherited zone override" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T153000Z", "20260818T013000Z" ], "forbiddenCanonicalIdentities": [ "20260818T153000Z", "20260818T013000Z" ] } }, { "id": "perth-detached-cancelled", "description": "A detached STATUS:CANCELLED component names the same logical occurrence and suppresses it. The occurrence is unavailable, not a different event; an Event Link resolver MUST be able to answer 'cancelled' for 20260818T073000Z rather than 'not found'.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T153000", "DTEND;TZID=Australia/Perth:20260818T163000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [] } }, { "id": "sydney-dst-forward", "description": "Australia/Sydney DST begins on 4 October 2026. Weekly expansion advances on the SOURCE wall clock, so 10:00 local stays 10:00 local and the canonical UTC identity legitimately moves by an hour. 20261006T000000Z would be the 11:00-local occurrence a UTC-stepped expansion drifts into and MUST NOT appear.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-09-01", "to": "2026-10-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:sydney-dst@contract.example", "SUMMARY:Weekly Sydney event", "DTSTART;TZID=Australia/Sydney:20260929T100000", "DTEND;TZID=Australia/Sydney:20260929T110000", "RRULE:FREQ=WEEKLY;COUNT=3", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20260929T000000Z", "startsAt": "20260929T000000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" }, { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261005T230000Z", "startsAt": "20261005T230000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" }, { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261012T230000Z", "startsAt": "20261012T230000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20261006T000000Z", "20261013T000000Z" ] } }, { "id": "sydney-dst-forward-detached-far-side", "description": "A detached override on the far side of the transition claims the AEDT occurrence it names and keeps that identity after being moved to 14:00 local.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-09-01", "to": "2026-10-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:sydney-dst@contract.example", "SUMMARY:Weekly Sydney event", "DTSTART;TZID=Australia/Sydney:20260929T100000", "DTEND;TZID=Australia/Sydney:20260929T110000", "RRULE:FREQ=WEEKLY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:sydney-dst@contract.example", "SUMMARY:Weekly Sydney event - changed", "RECURRENCE-ID;TZID=Australia/Sydney:20261006T100000", "DTSTART;TZID=Australia/Sydney:20261006T140000", "DTEND;TZID=Australia/Sydney:20261006T150000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20260929T000000Z", "startsAt": "20260929T000000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" }, { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261005T230000Z", "startsAt": "20261006T030000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event - changed" }, { "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261012T230000Z", "startsAt": "20261012T230000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20261006T000000Z" ] } }, { "id": "sydney-dst-forward-byday", "description": "The same transition through a WEEKLY;BYDAY rule. BYDAY expansion is a separate code path in every engine, and an identity minted from one path must equal the identity minted from the other -- otherwise a link shared from a BYDAY series resolves against a differently-expanded one.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-09-01", "to": "2026-10-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:sydney-dst-byday@contract.example", "SUMMARY:Sydney byday series", "DTSTART;TZID=Australia/Sydney:20260929T100000", "DTEND;TZID=Australia/Sydney:20260929T110000", "RRULE:FREQ=WEEKLY;BYDAY=TU;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:sydney-dst-byday@contract.example", "SUMMARY:Sydney byday moved", "RECURRENCE-ID;TZID=Australia/Sydney:20261006T100000", "DTSTART;TZID=Australia/Sydney:20261006T140000", "DTEND;TZID=Australia/Sydney:20261006T150000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "sydney-dst-byday@contract.example", "recurrenceId": "20260929T000000Z", "startsAt": "20260929T000000Z", "allDay": false, "recurring": true, "title": "Sydney byday series" }, { "sourceUid": "sydney-dst-byday@contract.example", "recurrenceId": "20261005T230000Z", "startsAt": "20261006T030000Z", "allDay": false, "recurring": true, "title": "Sydney byday moved" }, { "sourceUid": "sydney-dst-byday@contract.example", "recurrenceId": "20261012T230000Z", "startsAt": "20261012T230000Z", "allDay": false, "recurring": true, "title": "Sydney byday series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20261006T000000Z" ], "forbiddenCanonicalIdentities": [ "20261006T000000Z" ] } }, { "id": "floating-byday-series-without-timezone", "description": "The BYDAY path must fail closed on a floating source for the same reason the plain weekly path does. Two engines with different device or deployment timezones would otherwise mint two identities for these bytes.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-09-01", "to": "2026-10-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:floating-byday@contract.example", "SUMMARY:Floating byday series", "DTSTART:20260929T100000", "DTEND:20260929T110000", "RRULE:FREQ=WEEKLY;BYDAY=TU;COUNT=3", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "floating_without_context", "occurrencesAreExhaustive": false, "occurrences": [], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20260929T100000Z", "20260929T000000Z" ], "displayFallback": { "occurrenceCount": 3, "note": "Display parsing is unchanged. Only canonical share identity fails closed." } } }, { "id": "sydney-dst-backward", "description": "Australia/Sydney DST ends on 5 April 2026. The reverse transition is covered as well, so the wall-clock rule is not satisfied by an accidental one-way adjustment.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-04-30" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:sydney-dst-reverse@contract.example", "SUMMARY:Autumn Sydney series", "DTSTART;TZID=Australia/Sydney:20260330T100000", "DTEND;TZID=Australia/Sydney:20260330T110000", "RRULE:FREQ=WEEKLY;COUNT=3", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "sydney-dst-reverse@contract.example", "recurrenceId": "20260329T230000Z", "startsAt": "20260329T230000Z", "allDay": false, "recurring": true, "title": "Autumn Sydney series" }, { "sourceUid": "sydney-dst-reverse@contract.example", "recurrenceId": "20260406T000000Z", "startsAt": "20260406T000000Z", "allDay": false, "recurring": true, "title": "Autumn Sydney series" }, { "sourceUid": "sydney-dst-reverse@contract.example", "recurrenceId": "20260413T000000Z", "startsAt": "20260413T000000Z", "allDay": false, "recurring": true, "title": "Autumn Sydney series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260405T230000Z", "20260412T230000Z" ] } }, { "id": "sydney-exdate-across-dst", "description": "A TZID-qualified EXDATE on the far side of the transition removes the occurrence whose canonical identity is 20261005T230000Z, not the literal 20261006T000000Z the local wall time resembles.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-09-01", "to": "2026-10-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:sydney-dst-exdate@contract.example", "SUMMARY:Weekly Sydney event", "DTSTART;TZID=Australia/Sydney:20260929T100000", "DTEND;TZID=Australia/Sydney:20260929T110000", "RRULE:FREQ=WEEKLY;COUNT=3", "EXDATE;TZID=Australia/Sydney:20261006T100000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "sydney-dst-exdate@contract.example", "recurrenceId": "20260929T000000Z", "startsAt": "20260929T000000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" }, { "sourceUid": "sydney-dst-exdate@contract.example", "recurrenceId": "20261012T230000Z", "startsAt": "20261012T230000Z", "allDay": false, "recurring": true, "title": "Weekly Sydney event" } ], "suppressed": [ { "sourceUid": "sydney-dst-exdate@contract.example", "recurrenceId": "20261005T230000Z", "reason": "excluded" } ], "forbiddenRecurrenceIds": [ "20261006T000000Z" ] } }, { "id": "perth-exdate-tzid", "description": "A TZID-qualified EXDATE excludes by logical identity, not by literal wall time.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE;TZID=Australia/Perth:20260818T153000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "reason": "excluded" } ], "forbiddenRecurrenceIds": [] } }, { "id": "perth-exdate-utc", "description": "The same exclusion written as a UTC EXDATE removes the same logical occurrence.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE:20260818T073000Z", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "reason": "excluded" } ], "forbiddenRecurrenceIds": [] } }, { "id": "perth-exdate-multiple-values", "description": "Several comma-separated values on one TZID-qualified EXDATE property are each honoured.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE;TZID=Australia/Perth:20260811T153000,20260818T153000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "reason": "excluded" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "reason": "excluded" } ], "forbiddenRecurrenceIds": [] } }, { "id": "exdate-plus-detached-replacement", "description": "The producer pattern where a source excludes an occurrence and then supplies a detached replacement naming the same RECURRENCE-ID. The replacement remains valid and keeps the original logical identity.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE;TZID=Australia/Perth:20260818T153000", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - replacement", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T190000", "DTEND;TZID=Australia/Perth:20260818T200000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T110000Z", "allDay": false, "recurring": true, "title": "Choir - replacement" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [] } }, { "id": "all-day-weekly-series", "description": "All-day identities are literal calendar dates.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:allday-1@contract.example", "SUMMARY:All day series", "DTSTART;VALUE=DATE:20260804", "DTEND;VALUE=DATE:20260805", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260804", "startsAt": "20260804", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260811", "startsAt": "20260811", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260818", "startsAt": "20260818", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260825", "startsAt": "20260825", "allDay": true, "recurring": true, "title": "All day series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260803", "20260805", "20260804T000000Z" ] } }, { "id": "all-day-detached-move", "description": "An all-day override displayed on 19 August still carries the identity 20260818.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:allday-1@contract.example", "SUMMARY:All day series", "DTSTART;VALUE=DATE:20260804", "DTEND;VALUE=DATE:20260805", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:allday-1@contract.example", "SUMMARY:All day moved", "RECURRENCE-ID;VALUE=DATE:20260818", "DTSTART;VALUE=DATE:20260819", "DTEND;VALUE=DATE:20260820", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260804", "startsAt": "20260804", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260811", "startsAt": "20260811", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260818", "startsAt": "20260819", "allDay": true, "recurring": true, "title": "All day moved" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260825", "startsAt": "20260825", "allDay": true, "recurring": true, "title": "All day series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260819" ] } }, { "id": "all-day-exdate", "description": "An all-day EXDATE excludes the matching date-only identity.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:allday-1@contract.example", "SUMMARY:All day series", "DTSTART;VALUE=DATE:20260804", "DTEND;VALUE=DATE:20260805", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE;VALUE=DATE:20260818", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260804", "startsAt": "20260804", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260811", "startsAt": "20260811", "allDay": true, "recurring": true, "title": "All day series" }, { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260825", "startsAt": "20260825", "allDay": true, "recurring": true, "title": "All day series" } ], "suppressed": [ { "sourceUid": "allday-1@contract.example", "recurrenceId": "20260818", "reason": "excluded" } ], "forbiddenRecurrenceIds": [] } }, { "id": "floating-series-with-calendar-timezone", "description": "A floating series resolved against an explicit calendar timezone context.", "calendarRef": "cal-a", "calendarFallbackTimezone": "Australia/Perth", "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:floating-1@contract.example", "SUMMARY:Floating series", "DTSTART:20260804T153000", "DTEND:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:floating-1@contract.example", "SUMMARY:Floating moved", "RECURRENCE-ID:20260818T153000", "DTSTART:20260818T160000", "DTEND:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "floating-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Floating series" }, { "sourceUid": "floating-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Floating series" }, { "sourceUid": "floating-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Floating moved" }, { "sourceUid": "floating-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Floating series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T153000Z" ] } }, { "id": "floating-series-without-timezone", "description": "The same series with no timezone context anywhere. It still DISPLAYS -- each client keeps its legacy display fallback -- but it MUST NOT mint a canonical Event Link identity, because two clients with different fallbacks would mint different identities for the same source occurrence.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:floating-1@contract.example", "SUMMARY:Floating series", "DTSTART:20260804T153000", "DTEND:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "floating_without_context", "occurrencesAreExhaustive": false, "occurrences": [], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20260804T153000Z", "20260804T073000Z" ], "displayFallback": { "occurrenceCount": 4, "note": "Display parsing is unchanged. Only canonical share identity fails closed." } } }, { "id": "unsupported-tzid-series", "description": "WIDENED IN v2. The same source v1 refused: DTSTART names a SUPPORTED Windows zone, which the pinned mapping resolves to Australia/Perth. Every occurrence now mints on that clock -- 15:30 Perth is 07:30Z, never the 15:30Z a wall-time-as-UTC reading gives.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:badtz-1@contract.example", "SUMMARY:Windows tz series", "DTSTART;TZID=W. Australia Standard Time:20260804T153000", "DTEND;TZID=W. Australia Standard Time:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "badtz-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Windows tz series" }, { "sourceUid": "badtz-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Windows tz series" }, { "sourceUid": "badtz-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Windows tz series" }, { "sourceUid": "badtz-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Windows tz series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260804T153000Z", "20260811T153000Z", "20260818T153000Z", "20260825T153000Z" ], "forbiddenCanonicalIdentities": [ "20260804T153000Z" ] } }, { "id": "no-source-uid-series", "description": "A component with no UID. A stand-in identifier derived from the component body keeps display working but is NOT a canonical source UID and MUST NOT be minted into an Event Link.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "SUMMARY:No uid series", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "no_source_uid", "occurrencesAreExhaustive": false, "occurrences": [], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20260804T073000Z" ], "displayFallback": { "occurrenceCount": 4, "note": "Display parsing is unchanged. Only canonical share identity fails closed." } } }, { "id": "malformed-recurrence-id-override", "description": "A structurally impossible RECURRENCE-ID. Parsing MUST NOT fail, the four real occurrences MUST survive intact, and the malformed component MUST NOT claim any of them.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - malformed override", "RECURRENCE-ID;TZID=Australia/Perth:20261332T253000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": false, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20261332T253000Z" ], "unidentifiableComponents": [ { "recurrenceIdValue": "20261332T253000", "recurrenceIdTzid": "Australia/Perth", "kind": "timed", "expectedStatus": "malformed_value" } ] } }, { "id": "quoted-tzid-series", "description": "RFC 5545 3.1 allows a quoted parameter value and 3.2.19 shows TZID=\"America/New_York\" as a legitimate spelling. The quotes are parameter syntax, not part of the zone name. A parser that keeps them fails to resolve the zone and relabels 15:30 Perth as 15:30 UTC -- an eight-hour error with nothing logged, and a recurrence identity no other client agrees with. These identities are byte-identical to perth-weekly-series.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:quoted-1@contract.example", "SUMMARY:Quoted zone", "DTSTART;TZID=\"Australia/Perth\":20260804T153000", "DTEND;TZID=\"Australia/Perth\":20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "EXDATE;TZID=\"Australia/Perth\":20260811T153000", "END:VEVENT", "BEGIN:VEVENT", "UID:quoted-1@contract.example", "SUMMARY:Quoted zone - changed", "RECURRENCE-ID;TZID=\"Australia/Perth\":20260818T153000", "DTSTART;TZID=\"Australia/Perth\":20260818T160000", "DTEND;TZID=\"Australia/Perth\":20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "quoted-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Quoted zone" }, { "sourceUid": "quoted-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Quoted zone - changed" }, { "sourceUid": "quoted-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Quoted zone" } ], "suppressed": [ { "sourceUid": "quoted-1@contract.example", "recurrenceId": "20260811T073000Z", "reason": "excluded" } ], "forbiddenRecurrenceIds": [ "20260804T153000Z", "20260818T153000Z" ], "forbiddenCanonicalIdentities": [ "20260804T153000Z", "20260818T153000Z" ] } }, { "id": "recurrence-id-shape-mismatch", "description": "A DATE-valued RECURRENCE-ID against a TIMED master. The two key spaces are different, so the override names no occurrence of this series. It MUST NOT be converted into one by assuming a time of day, and the four real occurrences MUST survive untouched.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:choir-1@contract.example", "SUMMARY:Choir - shape mismatch", "RECURRENCE-ID;VALUE=DATE:20260818", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": false, "occurrences": [ { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Choir" }, { "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Choir" } ], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20260818" ], "unidentifiableComponents": [ { "recurrenceIdValue": "20260818", "recurrenceIdTzid": null, "kind": "timed", "expectedStatus": "malformed_value" } ] } }, { "id": "two-recurring-series-distinct-boundary-whitespace-uids", "description": "Two DIFFERENT source series at the SAME recurrence times, whose UIDs differ only in boundary whitespace, plus a detached override belonging to only one of them. Reconciliation MUST group by the exact source UID. Grouping by a trimmed UID merges the two series, and the override then replaces an occurrence of the OTHER series -- which silently loses an occurrence a link may already have been shared for. Note that two occurrences here legitimately share a recurrenceId: it is the full (calendarRef, sourceUid, recurrenceId) triple that is unique, which is why an adapter MUST index by the triple and not by recurrenceId alone.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:series-one", "SUMMARY:Plain series", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID: series-one", "SUMMARY:Leading-space series", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID: series-one", "SUMMARY:Leading-space series moved", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "series-one", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Plain series" }, { "sourceUid": "series-one", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Plain series" }, { "sourceUid": "series-one", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T073000Z", "allDay": false, "recurring": true, "title": "Plain series" }, { "sourceUid": "series-one", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Plain series" }, { "sourceUid": " series-one", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Leading-space series" }, { "sourceUid": " series-one", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Leading-space series" }, { "sourceUid": " series-one", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Leading-space series moved" }, { "sourceUid": " series-one", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Leading-space series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T153000Z", "20260818T080000Z" ], "forbiddenCanonicalIdentities": [] } }, { "id": "uid-collision-classes-through-reconciliation", "description": "Four source series whose UIDs differ only by case or by internal whitespace, at identical recurrence times. Reconciliation MUST keep all four apart. Testing the UID reader in isolation is not enough -- the collision that matters happens in the grouping step.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:series one", "SUMMARY:Single space", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=2", "END:VEVENT", "BEGIN:VEVENT", "UID:series one", "SUMMARY:Double space", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=2", "END:VEVENT", "BEGIN:VEVENT", "UID:Series-One", "SUMMARY:Mixed case", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=2", "END:VEVENT", "BEGIN:VEVENT", "UID:series-one", "SUMMARY:Lower case", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=2", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "series one", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Single space" }, { "sourceUid": "series one", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Single space" }, { "sourceUid": "series one", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Double space" }, { "sourceUid": "series one", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Double space" }, { "sourceUid": "Series-One", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Mixed case" }, { "sourceUid": "Series-One", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Mixed case" }, { "sourceUid": "series-one", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Lower case" }, { "sourceUid": "series-one", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Lower case" } ], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [] } }, { "id": "falsy-uid-zero-detached-move", "description": "A series whose UID is the literal string \"0\", with a detached override. An implementation whose emptiness test treats \"0\" as absent sends the master and its own override to two different fallback keys, so they never reconcile: the moved occurrence appears BESIDE the stale one it should replace, under a duplicate identity triple.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:0", "SUMMARY:Zero series", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:0", "SUMMARY:Zero series moved", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "0", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Zero series" }, { "sourceUid": "0", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Zero series" }, { "sourceUid": "0", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Zero series moved" }, { "sourceUid": "0", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Zero series" } ], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [] } }, { "id": "falsy-uid-zero-detached-cancelled", "description": "The same UID \"0\" series with a detached cancellation. If the master and the cancellation do not reconcile, the cancellation suppresses nothing and the occurrence stays visible.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:0", "SUMMARY:Zero series", "DTSTART;TZID=Australia/Perth:20260804T153000", "DTEND;TZID=Australia/Perth:20260804T163000", "RRULE:FREQ=WEEKLY;COUNT=4", "END:VEVENT", "BEGIN:VEVENT", "UID:0", "SUMMARY:Zero series", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T153000", "DTEND;TZID=Australia/Perth:20260818T163000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "0", "recurrenceId": "20260804T073000Z", "startsAt": "20260804T073000Z", "allDay": false, "recurring": true, "title": "Zero series" }, { "sourceUid": "0", "recurrenceId": "20260811T073000Z", "startsAt": "20260811T073000Z", "allDay": false, "recurring": true, "title": "Zero series" }, { "sourceUid": "0", "recurrenceId": "20260825T073000Z", "startsAt": "20260825T073000Z", "allDay": false, "recurring": true, "title": "Zero series" } ], "suppressed": [ { "sourceUid": "0", "recurrenceId": "20260818T073000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [] } }, { "id": "orphan-detached-override", "description": "A detached override whose master is absent from the payload keeps its own logical identity rather than being dropped or renamed.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-08-01", "to": "2026-08-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v1//EN", "BEGIN:VEVENT", "UID:orphan-1@contract.example", "SUMMARY:Orphan override", "RECURRENCE-ID;TZID=Australia/Perth:20260818T153000", "DTSTART;TZID=Australia/Perth:20260818T160000", "DTEND;TZID=Australia/Perth:20260818T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "orphan-1@contract.example", "recurrenceId": "20260818T073000Z", "startsAt": "20260818T080000Z", "allDay": false, "recurring": true, "title": "Orphan override" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260818T153000Z" ] } }, { "id": "windows-series-master", "description": "A Windows-qualified recurring master. Every occurrence is keyed on the mapped Perth clock, so 10:00 local is 02:00Z. The wall-time-as-UTC reading (10:00Z) that predated #558 B2a must appear nowhere.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260311T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260310T100000Z", "20260311T100000Z", "20260312T100000Z" ] } }, { "id": "windows-series-detached-move", "description": "The B2b acceptance criterion. A detached override carries its own Windows-qualified RECURRENCE-ID and a moved DTSTART in a DIFFERENT timezone. The identity comes from RECURRENCE-ID, so the override REPLACES the occurrence it names; the moved DTSTART never determines identity and no stale twin or orphan is emitted.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - moved", "RECURRENCE-ID;TZID=W. Australia Standard Time:20260311T100000", "DTSTART;TZID=Australia/Sydney:20260311T160000", "DTEND;TZID=Australia/Sydney:20260311T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260311T050000Z", "allDay": false, "recurring": true, "title": "Windows series - moved" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260311T050000Z", "20260311T100000Z" ] } }, { "id": "windows-series-detached-cancelled", "description": "A Windows-qualified cancellation suppresses EXACTLY the occurrence its RECURRENCE-ID names. Its neighbours stay visible and keep their own titles, so a cancellation can never take a neighbour with it.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - cancelled", "RECURRENCE-ID;TZID=W. Australia Standard Time:20260311T100000", "DTSTART;TZID=W. Australia Standard Time:20260311T100000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [ "20260311T100000Z" ] } }, { "id": "windows-adversarial-neighbour-move", "description": "ADVERSARIAL. The override moves to the wall clock of the NEXT occurrence in the same Windows zone, so its moved DTSTART resolves to 20260312T020000Z -- an identity that IS a real neighbouring occurrence. An engine that keyed the override on its moved DTSTART would replace the 12 March occurrence and leave 11 March stale; the titles below are what prove the CORRECT occurrence was the one replaced.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - moved onto neighbour clock", "RECURRENCE-ID;TZID=W. Australia Standard Time:20260311T100000", "DTSTART;TZID=W. Australia Standard Time:20260312T100000", "DTEND;TZID=W. Australia Standard Time:20260312T110000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series - moved onto neighbour clock" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260311T100000Z", "20260312T100000Z" ] } }, { "id": "windows-adversarial-neighbour-cancel", "description": "ADVERSARIAL. The cancelling component carries a moved DTSTART naming the NEXT occurrence. Only the occurrence its RECURRENCE-ID names may be suppressed; the 12 March occurrence its DTSTART names must survive, with its own title.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - cancelled", "RECURRENCE-ID;TZID=W. Australia Standard Time:20260311T100000", "DTSTART;TZID=W. Australia Standard Time:20260312T100000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [ "20260311T100000Z" ] } }, { "id": "windows-detached-utc-recurrence-id", "description": "An override written with a UTC RECURRENCE-ID names the SAME occurrence as one written with the Windows-qualified local time. The two spellings are one logical occurrence.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - moved", "RECURRENCE-ID:20260311T020000Z", "DTSTART;TZID=W. Australia Standard Time:20260311T163000", "DTEND;TZID=W. Australia Standard Time:20260311T173000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260311T083000Z", "allDay": false, "recurring": true, "title": "Windows series - moved" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260311T083000Z" ] } }, { "id": "windows-detached-inherited-tzid", "description": "A RECURRENCE-ID with no TZID of its own is read on the clock its series is expanded on -- here the master's mapped Windows zone.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series", "DTSTART;TZID=W. Australia Standard Time:20260310T100000", "DTEND;TZID=W. Australia Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:windows-series@contract.example", "SUMMARY:Windows series - moved", "RECURRENCE-ID:20260311T100000", "DTSTART;TZID=W. Australia Standard Time:20260311T163000", "DTEND;TZID=W. Australia Standard Time:20260311T173000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Windows series" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260311T083000Z", "allDay": false, "recurring": true, "title": "Windows series - moved" }, { "sourceUid": "windows-series@contract.example", "recurrenceId": "20260312T020000Z", "startsAt": "20260312T020000Z", "allDay": false, "recurring": true, "title": "Windows series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260311T083000Z", "20260311T100000Z" ] } }, { "id": "windows-quoted-tzid-series", "description": "A quoted Windows TZID parameter. The quotes are parameter syntax (RFC 5545 3.1) and are stripped before the mapping is consulted, exactly as for a quoted IANA name.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-quoted@contract.example", "SUMMARY:Quoted windows zone", "DTSTART;TZID=\"W. Australia Standard Time\":20260310T100000", "DTEND;TZID=\"W. Australia Standard Time\":20260310T110000", "RRULE:FREQ=DAILY;COUNT=2", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-quoted@contract.example", "recurrenceId": "20260310T020000Z", "startsAt": "20260310T020000Z", "allDay": false, "recurring": true, "title": "Quoted windows zone" }, { "sourceUid": "windows-quoted@contract.example", "recurrenceId": "20260311T020000Z", "startsAt": "20260311T020000Z", "allDay": false, "recurring": true, "title": "Quoted windows zone" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260310T100000Z", "20260311T100000Z" ] } }, { "id": "windows-series-across-dst", "description": "A Windows-qualified weekly series across the end of Australian DST. The rule is stepped on the SOURCE wall clock, so the canonical UTC identity legitimately moves by an hour when Sydney leaves AEDT on 5 April 2026.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-25", "to": "2026-04-15" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-dst@contract.example", "SUMMARY:Windows DST series", "DTSTART;TZID=AUS Eastern Standard Time:20260401T100000", "DTEND;TZID=AUS Eastern Standard Time:20260401T110000", "RRULE:FREQ=WEEKLY;COUNT=2", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "windows-dst@contract.example", "recurrenceId": "20260331T230000Z", "startsAt": "20260331T230000Z", "allDay": false, "recurring": true, "title": "Windows DST series" }, { "sourceUid": "windows-dst@contract.example", "recurrenceId": "20260408T000000Z", "startsAt": "20260408T000000Z", "allDay": false, "recurring": true, "title": "Windows DST series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260407T230000Z", "20260401T100000Z", "20260408T100000Z" ] } }, { "id": "windows-paraguay-series", "description": "THE v3 WIDENING, END TO END. The recurring series v2 pinned as windows-identity-ineligible-series (same source bytes apart from PRODID) now mints canonical identity on every occurrence: 10:00 Asuncion is 13:00Z. The stale-DST twin (14:00Z, what tzdb 2024a produced) and the wall-time-as-UTC reading (10:00Z) must appear nowhere.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "startsAt": "20260711T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260710T100000Z", "20260711T100000Z", "20260712T100000Z", "20260710T140000Z", "20260711T140000Z", "20260712T140000Z" ] } }, { "id": "windows-paraguay-detached-move", "description": "The #573 acceptance criterion. A detached override carries a Paraguay-qualified RECURRENCE-ID and a moved DTSTART in a DIFFERENT timezone. The identity comes from RECURRENCE-ID resolved on the mapped Asuncion clock (11 July 10:00 -> 20260711T130000Z), so the override REPLACES exactly that occurrence; the moved DTSTART's zone (Perth, 16:00 -> 08:00Z) must never identify the original, and no stale twin or orphan is emitted.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series - moved", "RECURRENCE-ID;TZID=Paraguay Standard Time:20260711T100000", "DTSTART;TZID=Australia/Perth:20260711T160000", "DTEND;TZID=Australia/Perth:20260711T170000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "startsAt": "20260711T080000Z", "allDay": false, "recurring": true, "title": "Paraguay series - moved" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260711T080000Z", "20260711T100000Z", "20260711T140000Z" ] } }, { "id": "windows-paraguay-detached-cancelled", "description": "A Paraguay-qualified cancellation suppresses EXACTLY the occurrence its RECURRENCE-ID names. Its neighbours stay visible with their own titles.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series - cancelled", "RECURRENCE-ID;TZID=Paraguay Standard Time:20260711T100000", "DTSTART;TZID=Paraguay Standard Time:20260711T100000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [ "20260711T100000Z", "20260711T140000Z" ] } }, { "id": "windows-paraguay-adversarial-neighbour-move", "description": "ADVERSARIAL. The override moves to the wall clock of the NEXT occurrence in the same Paraguay zone, so its moved DTSTART resolves to 20260712T130000Z -- an identity that IS a real neighbouring occurrence. An engine that keyed the override on its moved DTSTART would replace 12 July and leave 11 July stale; the titles below prove the CORRECT occurrence was the one replaced.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series - moved onto neighbour clock", "RECURRENCE-ID;TZID=Paraguay Standard Time:20260711T100000", "DTSTART;TZID=Paraguay Standard Time:20260712T100000", "DTEND;TZID=Paraguay Standard Time:20260712T110000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series - moved onto neighbour clock" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260711T100000Z", "20260712T100000Z", "20260711T140000Z" ] } }, { "id": "windows-paraguay-adversarial-neighbour-cancel", "description": "ADVERSARIAL. The cancelling component carries a moved DTSTART naming the NEXT occurrence. Only the occurrence its RECURRENCE-ID names may be suppressed; the 12 July occurrence its DTSTART names must survive, with its own title.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series - cancelled", "RECURRENCE-ID;TZID=Paraguay Standard Time:20260711T100000", "DTSTART;TZID=Paraguay Standard Time:20260712T100000", "STATUS:CANCELLED", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "reason": "cancelled" } ], "forbiddenRecurrenceIds": [ "20260711T100000Z", "20260711T140000Z" ] } }, { "id": "windows-paraguay-detached-inherited-tzid", "description": "A RECURRENCE-ID with no TZID of its own is read on the clock its series is expanded on -- here the master's mapped Paraguay zone, now identity-eligible. The same shape v2 pinned for a supported Windows zone (windows-detached-inherited-tzid) and Hub Core #570 converged its cache on.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-07-01", "to": "2026-07-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series", "DTSTART;TZID=Paraguay Standard Time:20260710T100000", "DTEND;TZID=Paraguay Standard Time:20260710T110000", "RRULE:FREQ=DAILY;COUNT=3", "END:VEVENT", "BEGIN:VEVENT", "UID:paraguay-v3-series", "SUMMARY:Paraguay series - moved", "RECURRENCE-ID:20260711T100000", "DTSTART;TZID=Paraguay Standard Time:20260711T163000", "DTEND;TZID=Paraguay Standard Time:20260711T173000", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "ok", "occurrencesAreExhaustive": true, "occurrences": [ { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260710T130000Z", "startsAt": "20260710T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "startsAt": "20260711T193000Z", "allDay": false, "recurring": true, "title": "Paraguay series - moved" }, { "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z", "startsAt": "20260712T130000Z", "allDay": false, "recurring": true, "title": "Paraguay series" } ], "suppressed": [], "forbiddenRecurrenceIds": [ "20260711T193000Z", "20260711T100000Z", "20260711T140000Z" ] } }, { "id": "windows-unknown-tzid-series", "description": "A Windows-SHAPED name the pinned mapping does not contain still fails closed end to end: no canonical identity is minted. Failing closed on identity must not blank the calendar, so the occurrences still display.", "calendarRef": "cal-a", "calendarFallbackTimezone": null, "window": { "from": "2026-03-01", "to": "2026-03-31" }, "ics": [ "BEGIN:VCALENDAR", "VERSION:2.0", "PRODID:-//Calee//Event Occurrence Identity Contract v3//EN", "BEGIN:VEVENT", "UID:windows-unknown@contract.example", "SUMMARY:Unknown windows zone", "DTSTART;TZID=Definitely Not A Windows Standard Time:20260310T100000", "DTEND;TZID=Definitely Not A Windows Standard Time:20260310T110000", "RRULE:FREQ=DAILY;COUNT=2", "END:VEVENT", "END:VCALENDAR" ], "expected": { "canonicalStatus": "unsupported_tzid", "occurrencesAreExhaustive": false, "occurrences": [], "suppressed": [], "forbiddenRecurrenceIds": [], "forbiddenCanonicalIdentities": [ "20260310T100000Z", "20260310T020000Z" ], "displayFallback": { "occurrenceCount": 2, "note": "Display MAY fall back to a local reading of the wall clock; canonical identity MUST NOT. The two are allowed to disagree." } } } ], "logicalIdentityEquivalences": [ { "id": "non-recurring-survives-a-dtstart-change", "description": "The identity of a non-recurring event is the calendar reference plus the source UID. Moving it in time MUST NOT break a link shared earlier.", "members": [ { "scenario": "non-recurring-perth", "sourceUid": "event-123@contract.example", "recurrenceId": null }, { "scenario": "non-recurring-perth-moved", "sourceUid": "event-123@contract.example", "recurrenceId": null } ] }, { "id": "detached-move-keeps-the-original-identity", "description": "RECURRENCE-ID names the occurrence; the moved DTSTART only says where it now happens.", "members": [ { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "perth-detached-move", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "perth-detached-move-utc-recurrence-id", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "perth-detached-move-foreign-tzid-recurrence-id", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "perth-detached-move-inherited-tzid-recurrence-id", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "exdate-plus-detached-replacement", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" } ] }, { "id": "cancellation-keeps-the-original-identity", "description": "A cancelled occurrence is unavailable, not absent. The resolver must be able to answer 'cancelled' for the identity it names.", "members": [ { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "availability": "available" }, { "scenario": "perth-detached-cancelled", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "availability": "unavailable" } ] }, { "id": "exclusion-keeps-the-original-identity", "description": "An EXDATE removes an occurrence by naming its logical identity.", "members": [ { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "availability": "available" }, { "scenario": "perth-exdate-tzid", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "availability": "unavailable" }, { "scenario": "perth-exdate-utc", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z", "availability": "unavailable" } ] }, { "id": "all-day-move-keeps-the-original-date-identity", "description": "An all-day override displayed a day later keeps the date it was generated for.", "members": [ { "scenario": "all-day-weekly-series", "sourceUid": "allday-1@contract.example", "recurrenceId": "20260818" }, { "scenario": "all-day-detached-move", "sourceUid": "allday-1@contract.example", "recurrenceId": "20260818" } ] }, { "id": "dst-far-side-override-keeps-its-identity", "members": [ { "scenario": "sydney-dst-forward", "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261005T230000Z" }, { "scenario": "sydney-dst-forward-detached-far-side", "sourceUid": "sydney-dst@contract.example", "recurrenceId": "20261005T230000Z" } ] }, { "id": "paraguay-detached-move-keeps-the-original-identity", "description": "Under v3 a Paraguay-qualified RECURRENCE-ID names the occurrence; the moved DTSTART -- in another zone, or on the neighbour's own clock -- only says where it now happens.", "members": [ { "scenario": "windows-paraguay-series", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" }, { "scenario": "windows-paraguay-detached-move", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" }, { "scenario": "windows-paraguay-adversarial-neighbour-move", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" }, { "scenario": "windows-paraguay-detached-inherited-tzid", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" } ] }, { "id": "paraguay-cancelled-occurrence-keeps-its-identity", "description": "The suppressed Paraguay occurrence is still named by the same identity, so a link shared before the cancellation resolves to the cancelled occurrence rather than to a neighbour.", "members": [ { "scenario": "windows-paraguay-series", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" }, { "scenario": "windows-paraguay-detached-cancelled", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "availability": "suppressed" }, { "scenario": "windows-paraguay-adversarial-neighbour-cancel", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z", "availability": "suppressed" } ] } ], "logicalIdentityDistinctions": [ { "id": "calendar-reference-is-part-of-the-identity", "description": "The same UID in a different calendar is a different logical event.", "members": [ { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z" }, { "scenario": "perth-weekly-series-other-calendar", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z" } ] }, { "id": "recurrence-identity-separates-occurrences-of-one-series", "members": [ { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z" }, { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260811T073000Z" }, { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260818T073000Z" }, { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260825T073000Z" } ] }, { "id": "boundary-whitespace-uids-are-different-logical-occurrences", "description": "Same calendar, same recurrence identity, UIDs differing only in a leading space. Merging these is the defect two-recurring-series-distinct-boundary-whitespace-uids exists to catch.", "members": [ { "scenario": "two-recurring-series-distinct-boundary-whitespace-uids", "sourceUid": "series-one", "recurrenceId": "20260818T073000Z" }, { "scenario": "two-recurring-series-distinct-boundary-whitespace-uids", "sourceUid": " series-one", "recurrenceId": "20260818T073000Z" } ] }, { "id": "uid-collision-classes-stay-four-distinct-series", "members": [ { "scenario": "uid-collision-classes-through-reconciliation", "sourceUid": "series one", "recurrenceId": "20260804T073000Z" }, { "scenario": "uid-collision-classes-through-reconciliation", "sourceUid": "series one", "recurrenceId": "20260804T073000Z" }, { "scenario": "uid-collision-classes-through-reconciliation", "sourceUid": "Series-One", "recurrenceId": "20260804T073000Z" }, { "scenario": "uid-collision-classes-through-reconciliation", "sourceUid": "series-one", "recurrenceId": "20260804T073000Z" } ] }, { "id": "an-all-day-series-and-a-timed-series-do-not-share-a-key-space", "members": [ { "scenario": "all-day-weekly-series", "sourceUid": "allday-1@contract.example", "recurrenceId": "20260804" }, { "scenario": "perth-weekly-series", "sourceUid": "choir-1@contract.example", "recurrenceId": "20260804T073000Z" } ] }, { "id": "paraguay-moved-dtstart-does-not-name-the-neighbour", "description": "In the adversarial move the override's moved DTSTART resolves to the 12 July occurrence's identity. The override and the real 12 July occurrence remain two distinct logical occurrences.", "members": [ { "scenario": "windows-paraguay-adversarial-neighbour-move", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260711T130000Z" }, { "scenario": "windows-paraguay-adversarial-neighbour-move", "sourceUid": "paraguay-v3-series", "recurrenceId": "20260712T130000Z" } ] } ] }