List TaskItems

Lists TaskItems for the given tenant.

Date Range Options:

• Use dateRange for preset ranges (ThisWeek, ThisMonth, Today, etc.)
• Use startDate/endDate for custom ranges
• Date range is required when querying NotStarted tasks (or no status filter) with includeProjected=true — the engine needs a window to project recurrences into
• Date range is NOT required when includeProjected=false (materialised tasks only)
• Date range is NOT required when filtering by non-NotStarted statuses only (e.g., InProgress, Completed)
• Date range is NOT required when using isOverdue=true

Projection Without a Date Range (projectUntil):

• Set projectUntil (with includeProjected=true and no date range) to get every existing task
  plus projected recurrences from today up to that date
• Only the projected half is bounded — the materialised half stays unbounded, so nothing drops
  out of the list that a windowless includeProjected=false query would have returned
• Cannot be combined with a date range (the range already bounds projection) or with isOverdue=true;
  must be today or later and no more than 2 years ahead
• A savedFilter that asks for projected tasks but stores no date range gets a 12-month horizon
  automatically, since a saved view has nowhere to store one

Overdue Mode (isOverdue=true):

• Returns only tasks where DueDate < today
• Automatically excludes Completed and Skipped statuses unless you specify a status filter
• No date range required

Search (search):

• Matches the task name, the task code and the primary client's name; minimum 3 characters
• Secondary client links are not searched — a hit there would return a row whose displayed
  client does not contain the term
• Projected tasks are excluded whenever search is set. Projected occurrences are generated
  in memory from a recurrence, so the search cannot be applied to them; leaving projection on
  would merge unfiltered rows into a searched result. A search therefore needs no date range,
  whatever includeProjected or projectUntil ask for.

Standard Mode (includeWorkflowSteps=false, default):

• Returns only tasks (materialised and optionally projected)
• Use dateBasis to specify which date field to use for filtering: StartDate (default) or DueDate

Agenda Mode (includeWorkflowSteps=true):

• Returns both tasks AND workflow steps as TaskItemDto objects
• Tasks: Returned with all standard TaskItem properties, WorkflowStepDetails = null
• Workflow Steps: Returned with parent task properties populated, WorkflowStepDetails contains step-specific information

Supports filtering by user(s), client(s), recurring task(s), category, date range, status, and isOverdue.