must_read
Lists open items in a scope by category counts or headers, surfaces pinned mandatory-reading memories, and flags overdue checkpoints; read every pin before acting.
Instructions
What is still open in a scope: counts per category, or one category's headers.
Without type: {"categories": [{"type", "count"}, ...]} for task,
anti_pattern, handoff, note and diagram, in that order, leaving out the
empty ones, plus "pinned" -- the same shape, counting the memories a
person pinned as mandatory reading -- when any pin is in scope. A pinned
memory still counts in its category. With type: {"type", "total",
"items", "next_offset"} -- one page of headers (uid, title, domain,
tags, est_tokens; a task adds progress {done, total} and doing, its
items in progress as {id, n}), newest first, a task by its latest item
update. Open a header with get_memory(uid). A page holds at most limit
headers and ends early at the size budget; next_offset is absent on
the last page.
Every pin listed is read with get_memory(uid) before acting, none skipped.
Pending means: a task that is open; an active anti_pattern, handoff or note that is not contradicted; an active diagram.
overdue, present only when non-empty, lists the checkpoints in scope
that stayed open past the age limit, with an alert to relay to the
user: memai refuses new writes under each until it is settled.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | task, anti_pattern, handoff, note or diagram; any other type is an error. Empty returns the counts. | |
| limit | No | headers per page, 1 to 50. | |
| domain | No | covers its subdomains and what is cross-listed there; empty is the whole project. A pin is in scope when it is global, or when the memory's domain or one of its also paths is the asked domain or above it; the whole project counts global pins only. | |
| offset | No | where the page of headers starts. | |
| pinned | No | true narrows the page to the pins of that type, and also accepts checkpoint and reasoning. |