Module ops 

Mutating verbs: create, update, and move issues between projects.

Structs

CreateOpts

Optional fields on a new issue.

RejectOpts

Optional fields on reject.

UpdateOutcome

What an update changed, plus advice about issues left dangling by it.

UpdatePred

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_body with the recorded identity passed in.

claim

Take an issue: move it to STARTED and stamp the claim.

claim_as

claim with an explicit identity instead of crate::config::identity.

create

Append a new TODO issue to the project’s file and return the status text.

fold

Fold an inbox-convention org file into tracked issues.

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 src and 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.toml and 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

update with an explicit identity instead of crate::config::identity.

update_as_pred

update_as with a last-seen predicate.

update_pred

update with a last-seen predicate.