Skip to content

Todoist active-task completeness (#99) - #617

Merged
michielbdejong merged 4 commits into
mainfrom
claude/todoist-active-tasks
Oct 15, 2026
Merged

michielbdejong merged 4 commits into
mainfrom
claude/todoist-active-tasks

Conversation

@michielbdejong

Copy link
Copy Markdown
Contributor

Documentation only: no live requests, no token, no catalog change.

completeness-ac07532b… declares, on Todoist's tasks collection, absent: removed and notFound: unavailable, with no read tombstone and no gone. Quotes from the API v1 reference, each checked word for word against the raw page with curl:

  • Get Tasks: "Get all active tasks for the user."
  • Get Task: "Returns a single active (non-completed) task by ID".
  • Close Task: "Regular tasks are marked complete and moved to history…"
  • Delete Task: "Delete a task and all of its subtasks."
  • Pagination: "When next_cursor is null, you've reached the end of the results."

A task that leaves the active list may be completed, deleted or out of reach, and its own read returns active tasks only. So:

  • absence is never a deletion;
  • a 404 is unavailable;
  • no read answer is ever classified as deleted;
  • a read that stops before a null next_cursor is not complete.

Not verified without a live account:

  • what GET /tasks/{task_id} answers for a completed, deleted or inaccessible task;
  • whether GET /tasks includes an archived project's tasks;
  • whether Tasks Completed By Completion Date (up to 3 months) lists every completion, which would tell completion from deletion.

Tests: overlays/tests/test_todoist_completeness.py (7).

Part of #99. Its fixture tests, host journey and catalog-copy items belong to the issue-tracker app and #46. If #586 lands first, keep this branch's Todoist paragraph.

🤖 Generated with Claude Code

michielbdejong and others added 4 commits October 15, 2026 16:01
Unpublished; no dated catalog selects it. Read raw with curl (no live
requests, no token): Get Tasks "Get all active tasks for the user", Get
Task "Returns a single active (non-completed) task by ID", Close Task
"Regular tasks are marked complete and moved to history", Delete Task
"Delete a task and all of its subtasks.", Archive Project "removing it
from view" for workspace projects.

The tasks collection declares absent: removed and notFound: unavailable:
a task that leaves the active list may be completed, deleted or out of
reach, and its read returns active tasks only, so neither checked nor
is_deleted can be read back; no read tombstone and no gone. Not verified,
and written down as such: the status of GET /tasks/{task_id} for a
completed, deleted or inaccessible task, whether archived projects' tasks
appear in GET /tasks, and whether the completed-tasks endpoint covers every
completion. tests/test_todoist_completeness.py (5 tests) and the
Collection completeness README section; quotes checked with
quote_audit.py.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…a deletion

Taken over from overlays worker 1. Every quote re-audited against the raw
API v1 reference with curl. The overlay header adds the documented cursor
end ("When next_cursor is null, you've reached the end of the results."),
so a read that stops earlier or fails on a page is not complete. Two
tests: no read answer is ever classified deleted (every status from 200 to
599 with active, checked, is_deleted and mismatched bodies), and the
catalog's pagination overlay pages GET /tasks by that cursor. README row
says both.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@michielbdejong
michielbdejong merged commit 085e713 into main Oct 15, 2026
23 checks passed
michielbdejong added a commit that referenced this pull request Oct 15, 2026
- Merged main: #617's Todoist row joins the table (four overlays with
  this one; five once #586 lands), and the test list names both.
- The "Issues" quote is verbatim now (double quotes, as the docs).
- "Issues are disabled for this repo" is in neither the docs nor the
  pinned OAD: the overlay cites Create an issue's "If issues are disabled
  in the repository, the API returns a 410 Gone status." and marks a read's
  410 and its body as not verified; the test relies on no body text. The
  README notes that #534's published GitHub Issues overlay makes the same
  claim (declaration unaffected: a 410 is unavailable either way).
- Cites Using pagination in the REST API for page-number paging.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
michielbdejong added a commit that referenced this pull request Oct 15, 2026
- The README's conflict with main resolved: #617's Todoist row joins the
  table (four overlays), the old Todoist paragraph goes, the Discord
  sentence stays, and the test list adds the Calendar and Todoist tests.
- "An event can leave the list without being deleted (access changed)"
  had no source: overlay and README now call it assumed, not documented.
- The overlay says the dated catalogs select neither tombstone overlay, so
  there a deletion or a move is an absence.
- The errors guide's two 404 examples are list items; the overlay quotes
  them separately instead of joining them with a semicolon.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant