Skip to main content

Module work_item

Module work_item 

Source
Expand description

Cooperative work items — phases, epics, stories, tasks, issues, bugs, and milestones — with WBS hierarchy, PDM dependencies, and a replay-safe Kanban board.

A WorkItem is created once (immutable core). Status transitions are separate immutable WorkItemStatusEvent records; the current status is a derived projection — the latest event per work item — never a mutated field. Deduping events by stable id before deriving makes the board invariant under duplicated, reordered, or replayed sync frames (plan §8.3/§8.4).

Re-exports§

pub use crate::work_graph::detect_semantic_conflicts;
pub use crate::work_graph::merge_dependencies;
pub use crate::work_graph::DepKind;
pub use crate::work_graph::Lag;
pub use crate::work_graph::SemanticConflict;
pub use crate::work_graph::TaskConstraint;
pub use crate::work_graph::TaskRef;
pub use crate::work_graph::ThreePointEstimate;
pub use crate::work_graph::TimeEntry;
pub use crate::work_graph::WorkDependency;

Structs§

BoardCard
A card as rendered on the board.
BoardColumn
A Kanban column: a status and the cards currently in it.
WorkItem
The immutable core of a work item. Its status is derived from status events, not stored here.
WorkItemStatusEvent
An immutable status transition for a work item. The board derives the current status as the latest event per work item.

Enums§

WorkItemPriority
WorkItemStatus
Kanban lifecycle status. ORDER gives the canonical column ordering for board rendering.
WorkItemType
The kind of work item across WBS and Agile/Kanban views.

Functions§

build_work_item_envelope
Builds work-item-envelope.
build_work_item_status_envelope
Builds work-item-status-envelope.
current_status
The current status of a work item = the latest event (by time, then id) for it, or Todo if it has no status events yet. Pure over the unique-event-id set (duplicates collapse first).
derive_board
Derive the Kanban board for a set of work items and their status events.
merge_status_events
Merge status-event sets add-wins by stable id (never re-apply), deterministically ordered by (time, id). Idempotent and order-independent — the basis for replay-safe board derivation.
parse_work_item_status_summary
Parses work-item-status-summary.
parse_work_item_summary
Reconstruct a WorkItem from a stored/transmitted summary JSON (fields not in the summary take their defaults). Returns None on malformed input.
work_item_record_id
work-item-record ID.
work_item_status_record_id
work-item-status-record ID.
work_item_status_summary
Work-item status summary.
work_item_summary
Work-item summary (lossless across WBS and PDM fields).