Expand description
High-level, transactional board operations shared by every front-end
(CLI, daemon, desktop). Each function loads what it needs through Store,
mutates the in-memory model, and writes it back deterministically. Keeping
these here means the mutation rules live in exactly one place.
Structs§
- NewTicket
- Specification for a new ticket. Only
titleis required. - Ticket
Patch - A partial update to a ticket.
Nonefields are left unchanged. Forpriority, an innerSome(None)clears the value.
Functions§
- add_
attachment - Attach a file to a ticket. If a file with identical content is already tracked
in the repo, it is referenced in place (no copy); otherwise the bytes are
stored under
.wipe/media/. Returns the createdAttachment. - add_
comment - Append a comment to a ticket. Returns the new comment ID.
- add_
list - Add a new list to the end of the board. Returns the new list’s ID.
- board_
view - Load the whole board as an ordered sequence of
(list_id, tickets). - create_
label - Create a label. If
colorisNone, auto-pick the first unused palette color. - create_
ticket - Create a ticket, allocate its ID, place it on a list, and persist both the ticket file and the board. Returns the created ticket.
- delete_
identity - Remove an identity from the saved registry. Git-derived humans that aren’t in the registry can’t be removed (they’re re-discovered from history); this is meant for pruning agent identities and manual overrides.
- delete_
label - Delete a label definition and strip it from every ticket.
- delete_
ticket - Delete a ticket file and remove its card from the board.
- list_
identities - List identities: the saved registry merged with human authors discovered from git (so contributors show up without manual setup).
- move_
list - Reorder a list to a new 0-based index.
- move_
ticket - Move a ticket to
to_listat an optional 0-basedposition(appended ifNone). Removes it from whatever list currently holds it. - remove_
attachment - Detach a file from a ticket by its
path. The underlying file is left in place (it may be shared or tracked in the repo). - remove_
list - Remove a list. Fails if the list still holds cards, unless
forceis set (in which case the contained tickets are also deleted). - rename_
list - Rename a list’s display name (its ID stays stable).
- set_
label_ color - Set a label’s color. Errors if the label is not defined.
- stage_
media - Stage bytes as an
Attachmentwithout binding it to any ticket/post: if a file with identical content is already tracked in the repo it is referenced in place (no copy); otherwise the bytes are written under.wipe/media/. Shared by ticket and forum attachments. - update_
ticket - Apply a
TicketPatchand persist. Returns the updated ticket. - upsert_
identity - Create or update an identity’s display name (and optionally its kind).
Type Aliases§
- List
View - One list’s ID paired with the tickets currently on it, in card order.