---
title: Tasks — Reference
---

# Tasks — Reference

The Tasks page shows all tasks across every workstream and domain, with live
filtering, a status distribution chart, and a blocked-tasks highlight section.

---

## Task statuses

| Status | Meaning |
|--------|---------|
| **todo** | Not yet started |
| **in_progress** | Actively being worked on |
| **blocked** | Cannot proceed — has a blocking reason |
| **done** | Completed |
| **cancelled** | Dropped; not counted toward totals |

---

## Task priorities

| Priority | Use for |
|----------|---------|
| **critical** | Must be resolved immediately; blocks a release or governance gate |
| **high** | Should be resolved this session or next |
| **medium** | Normal backlog priority |
| **low** | Nice-to-have; deferred is acceptable |

---

## Filter bar

| Filter | Effect |
|--------|--------|
| **Status** | Multi-select — show only chosen statuses |
| **Priority** | Multi-select — show only chosen priorities |
| **Domain** | Multi-select — filter by domain slug |
| **Assignee** | Case-insensitive substring match on the assignee field |

All filters are applied client-side after each poll.

---

## Status Distribution chart

A horizontal bar chart (Observable Plot) showing the count of filtered tasks
per status, colour-coded:

| Colour | Status |
|--------|--------|
| grey-blue | todo |
| blue | in_progress |
| red | blocked |
| green | done |
| light grey | cancelled |

---

## Blocked Tasks section

Shows cards for every task currently in `blocked` status within the active
filter. Each card displays:

- Priority badge and status
- Domain and workstream context
- Task title
- Blocking reason (amber background)

---

## KPI sidebar card

Shows four counts for the unfiltered dataset: open (todo + in_progress +
blocked), blocked, in progress, done, and a done-% of total.

---

## Sorting

Tasks are sorted by status (blocked first, then in_progress, todo, done,
cancelled) then by priority (critical → high → medium → low) within each
status group.

---

## Data sources

Polls every **15 seconds**:
- `GET /tasks/?limit=500`
- `GET /workstreams/`
- `GET /topics/`