Expand description
Mutating verbs: create, update, and move issues between projects.
Structs§
- Ballot
- One agent’s ballot on one issue.
- Create
Opts - Optional fields on a new issue.
- Reject
Opts - Optional fields on
reject. - Update
Outcome - What an update changed, plus advice about issues left dangling by it.
- Update
Pred - Last-seen state or generation a write must still match.
Functions§
- append_
body - Append prose to an issue’s body, stamped with the date and identity.
- append_
body_ as append_bodywith the recorded identity passed in.- ballots
- The ballots cast on one issue, in the order the drawer holds them.
- claim
- Take an issue: move it to STARTED and stamp the claim.
- claim_
as claimwith an explicit identity instead ofcrate::config::identity.- create
- Append a new TODO issue to the project’s file and return the status text.
- deed
- Cite, drop, or list the deeds an issue’s work produced.
- fold
- Fold an inbox-convention org file into tracked issues.
- is_
deed_ accession - Whether
valuelooks like something deedar can be asked for. - normalize
- Rewrite project files onto the Org / ELPA / vissue property split.
- note
- Add a dated note to the top of an issue’s logbook. State, claim, and properties stay untouched, so an agent can record progress without owning the issue.
- refile
- Move one issue’s heading to another project’s file. The id is not regenerated, so cross-project blocker edges keep resolving.
- refile_
to - Move one issue’s heading onto a destination that may live on another tracker layout. A router resolves the destination project name before calling this, so a routed name lands on its own checkout instead of growing a shadow directory under the source root.
- reject
- Cancel
srcand point it at a successor in one graph edit. - resolve_
project - Resolve the project to act on. An explicit name wins; otherwise walk up from
the current directory for
.project-ctx.tomland read[project].name. Neither available is an error, so nothing is ever guessed silently. - resolve_
terminal - Pick one terminal after a sibling close. Clears
:SIBLING_TERMINAL:. - update
- Change state, priority, or blocker edges. Adding a blocker to an open issue moves it to BLOCKED; clearing the last blocker moves it back to TODO.
- update_
as updatewith an explicit identity instead ofcrate::config::identity.- update_
as_ pred update_aswith a last-seen predicate.- update_
pred updatewith a last-seen predicate.- vote
- Cast or change one agent’s vote, or read the tally when
choiceisNone.