Expand description
Read-only verbs. Every function returns its text instead of printing, so a CLI, an MCP server, and a library caller share one implementation.
Re-exports§
Structs§
- Check
Report - Outcome of
check: the findings, and how many were errors.
Constants§
- GRAPH_
FOOTER - The line that closes a DOT document.
- GRAPH_
HEADER - The whole blocker and parent graph as Graphviz DOT. Node fill encodes state.
- ROADMAP_
HEADER - A markdown roadmap grouped by project and state. Closed items collapse into one section so the document stays about live work.
Functions§
- agenda
- Dated open work in the next
daysdays, plus anything already overdue. Dated open work, grouped the way Org does: deadline, then scheduled, then appointment. Overdue deadlines are first. - ancestors
- Transitive blocker ancestors, limited to a bounded number of hops.
- backlinks
- Every issue referring to
target_idthrough a blocker edge, a parent link, a discovered-from or pivoted-to property, or a body mention. The relation is named on the row. - check
- Validate the corpus: every parent and blocker id resolves, dates parse, open issues carry a creation date, and ids are unique across projects.
- children
- Issues whose
:PARENT:points atparent_id. - claims
- Every live claim, oldest first: the who-holds-what view. A claim is live while its issue is STARTED or BLOCKED (release happens on TODO, DONE, or CANCELLED), so this is the working set, not history.
- consensus
- The DeGroot consensus over an issue’s ballots, weighted by who the group listens to.
- count
- The matching issue count and nothing else, for shell pipelines.
- cycles
- Cycles in the blocker graph, one per line, or a line saying there are none.
- export
- One JSON object per line: every property, the logbook, the body, and the file line range. Round-trippable, and the seam other tools consume.
- export_
by_ project - The same lines as
export, grouped by project, from one read. - graph
- A DOT graph of the corpus: one node per issue, blocker and parent edges.
- graph_
body - The nodes and edges of the graph, without the enclosing
digraphblock. - impact
- Transitive issues waiting on this issue, limited to a bounded number of hops.
- list
- One row per issue: id, state, priority cookie, title.
- plan_
consensus - What a plan’s children hold, child by child.
- ready
- Actionable issues: TODO or STARTED with no open blocker.
- recall
- The working set for one issue: the plan around it, the deeds its declared inputs produced, and what it has produced itself.
- recall_
deeds - Just the deed accessions
recallfound, inputs first, one per line. - roadmap
- A markdown roadmap of active and closed work, with its title.
- roadmap_
body - The roadmap’s project sections, without the document title.
- search
- Case-insensitive substring scan over id, title, properties, and body. Linear in the corpus, which is the right cost until the issue count climbs.
- show
- One issue’s metadata, file range, and body text.
- stale
- Open issues whose
:CREATED:is at leastdaysold. An issue without a parseable date is never stale, because its age is unknown. - tree
- Children and blockers below
root_id, as indented text or Graphviz DOT.