Repository navigation
docs: the tasks draft is now RFC 10051 - #47
Merged
Merged
Conversation
The task extensions draft was published as RFC 10051 in October 2026, with only editorial changes from -17 on the points used here. Refer to the RFC throughout, and update the section 6 quote to its final wording. Document two consequences: icalendar's Todo.status raises ValueError on PENDING and FAILED, and section 11.1 makes a lone DURATION legal. Prompt: Check https://datatracker.ietf.org/doc/html/rfc10051 and see how it affects the calendaring client. At least, all references to "the tasks draft" should probably be replaced with "RFC 10051" Assisted-By: Claude Opus 5.5 Reviewed-by: Tobias Brox <tobias@redpill-linpro.com>
summarize() counted the estimate of a FAILED task as committed time, though nobody does that work until it is rescheduled. The tracker profile lost STATUS on FAILED; it now stores COMPLETED, as for CANCELLED. Open-task search still returns FAILED, and API_DESIGN records that RFC 10051 is unclear on whether the state is final. Prompts (comments made inline in the document while reviewing it): > (on excluding FAILED from the open estimates) I suppose this can be done without fixing PyCalendar/icalendar#2055 first? > (on mapping FAILED to COMPLETED on two-state trackers) I suppose this can be done without fixing PyCalendar/icalendar#2055 first? > (on open-task search still returning FAILED) Very unclear indeed. 9.1 indicates it's a final state, but that's for the participant. 11.2 indicates that "FAILED" is not a final state, the organizer should take action and reschedule or cancel it. And A-3 shows that FAILED in the organizers part-stat combined with FAILED in the STATUS is a final state. Let's just document that this is very unclear. Full support of RFC10051 is not yet part of the ROADMAP. Assisted-By: Claude Opus 5.5 Reviewed-by: Tobias Brox <tobias@redpill-linpro.com>
tobixen
added a commit
that referenced
this pull request
Nov 4, 2026
Move the mission statement to the top and rewrite it around one API and one shared configuration file, and add why JMAP and iCalendar feeds do not belong in the caldav library. The prose is the author's own. Rebased on the merge of PR 47, keeping its RFC 10051 wording, with typos fixed and the placeholder link filled in. Prompt: I've done some work now on the README. There is a pull request #44 (IIRC) which may conflict with this work, check if it's merged and deal with the potential conflict. Then do a full QA and /review-and-push - I'd like to push it directly to master. Check if there are any other PRs open or if the README has been touched in any other branches, I think I've asked to replace all instances of "task draft" to "RFC 10051". [#44 is #44; the conflict was with #47; the branch is main] Followup-Prompt: (answer) Merge #47 first Followup-Prompt: (answer) "JCal" in the README meant JSCalendar Assisted-By: Claude Opus 5.5
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Disclaimer: AI-generated code and text below the line, generated by Claude Opus 5.5 from the initial prompt:
After that, I discussed a bit and read up the RFC myself - first partially and then completely.
Should a "FAILED" task count as actionable when listing out open issues, or is it a final state?
In the definition of what it means when a participant marks FAILED, it's final from that participants point of view: "to-do cannot be completed".
In the definition of what it means when a task has state FAILED, it reads non-final from the definition: "[task] may need some follow-up from the "Organizer" to reschedule or cancel".
In the appendix A3, state "FAILED" comes as the last state in the task lifecycle, and should hence be interpreted as final. "Overall state set by Organizer for TASK-MODE=CLIENT or by server for AUTOMATIC-FAILURE"
Perhaps it's needed to reach out to the RFC author to get a clarification.
The iCalendar task extensions draft was published as RFC 10051 in October 2026. The docs and code comments now refer to the RFC. A comparison with draft -17 found only editorial changes, so no design decision changes.
Publication also prompted two small fixes for the new
FAILEDstatus:summarize()no longer counts the estimate of aFAILEDtask as committed time.TRACKERprofile storesFAILEDasCOMPLETED, instead of losing the status.Still open, and documented in
API_DESIGN.md:task.component.statusraisesValueErroronPENDINGandFAILEDuntil RFC 10051 -icalendar.enums.STATUSneeds more values icalendar#2055 is fixed.component.get("STATUS")works.FAILEDis final, andinclude_completed=Falsestill returns such tasks. Full support of RFC 10051 is not on the roadmap.Testing: the two new tests pass and there are no new failures in the local suite. The local run had 429 failures and errors both with and without these changes, and those checked trace to an outdated
caldavin the local environment (3.6.0, while 3.7 is required), so CI is the first run of this against the CalDAV test servers.