Module service 

Use case (application service).

High-level operations called from CLI/TUI. Combine the domain layer and persistence layer.

Structs

AddItemOutcome

Result of adding a PBI, including warning-only dependency-cycle information.

Board

Board data with columns ordered according to config.toml.

BoardColumn

One board column with its status and PBIs in ascending rank order.

BoardQuery

Filtering, scope, and sorting options for board. The default includes all PBIs and columns.

Burndown

Sprint burndown summary.

BurndownDay

Observation points for one day of burndown.

CycleTimeFilter

Optional filters for Cycle/Lead Time aggregation.

CycleTimeReport

Results of Cycle Time / Lead Time analysis.

DependencyOutcome

Result of add_dependency, including the updated PBI and any cycle warning.

DisplaySettings

Display settings for the show command.

DurationSummary

Summary statistics for a Duration sample.

Forest

Parent/child forest over a set of items, classified by membership in that set.

ItemDetail

Result of item_detail, with bidirectional links in ascending rank order.

ItemEdit

Fields to update with edit_item. A None field remains unchanged.

LinkOutcome

Result of link_commits or unlink_commits, including the updated PBI and changed SHAs.

ListFilter

Filters for list_items. Empty fields do not filter their corresponding property.

NewItem

Optional fields for add_item. Unspecified fields use their domain defaults.

RebalanceOutcome

Result of rebalance. Indicates the status of resolution of rank bloat.

ScanOutcome

Result of scan_commits, listing new (PBI ID, SHA) links.

SearchFilter

A validated search filter over a PBI and its assigned sprint metadata.

TuiSettings

Settings required to launch the interactive Kanban view.

VelocityReport

Velocity summary for the selected recent sprints.

VelocitySprint

Velocity and estimate coverage for one sprint.

WipViolation

A column whose item count exceeds its WIP limit.

Enums

BurndownMetric

The metric a burndown chart tracks.

EditOutcome

Result of apply_item_edit.

InitOutcome

Result of init_board.

LabelMatch

Matching mode for a multi-label filter.

MigrateOutcome

Result of migrate_storage.

RemoveOutcome

Result of remove_item.

ReorderTarget

Specify the destination of reorder_item (how to change rank).

SearchMode

Search interpretation used by list, board, and Kanban filters.

SortKey

Sort key used within a board column.

Functions

add_dependency

Add dependency dep to the PBI id and return DependencyOutcome.

add_item

Add a PBI to the board in project_dir and return the saved BacklogItem.

add_item_with_outcome

Add a PBI and report warning-only dependency cycles.

apply_item_edit

Validate Markdown edited with $EDITOR, apply permitted fields to PBI id, and save it.

assign_sprint

Assign PBI item_id to sprint sprint_id and return the saved BacklogItem.

assign_sprint_by_status

Assign matching PBIs to a sprint in backlog rank order.

assign_sprint_raw

Assign a PBI from a raw CLI sprint ID, validating its grammar and existence before saving.

board

Load the board in project_dir, grouping PBIs in the column order from config.toml.

build_forest

Classify items into a Forest by parent membership within the same set.

burndown

Calculate the burndown for sprint sprint_id in project_dir.

check_wip

Load the board in project_dir and return the columns that exceed the WIP limit.

clear_common_dod

Delete a board’s common DoD. true if it exists, false (idempotent) if it does not exist.

close_sprint

Close the sprint (active → closed). Returns the saved Sprint.

common_dod

Load the board’s common DoD, returning None when the file is absent or empty.

create_sprint

Create a sprint on the board in project_dir and return the saved Sprint.

cycle_time

Aggregate Cycle/Lead Time for completed PBIs matching filter in project_dir.

delete_sprint

Delete a sprint and clear its assignment from every PBI that references it.

display_settings

Read display settings from the board. Return crate::error::Error::NotInitialized when it is uninitialized.

edit_item

Update the specified fields of PBI id, refresh updated, and return the saved BacklogItem.

edit_sprint

Update the title, goal, and/or planned period of an existing sprint.

hierarchical

Reorder items into canonical hierarchical priority order.

hierarchical_order

Pre-order traversal of the fully-expanded forest: every root in input order, each parent immediately followed by its subtree (children in input order). Cycle-only items are appended at the end so no item is lost.

init_board

Initialize .pinto/ (config.toml and tasks/) in project_dir.

item_detail

Load PBI id with backward links (children and dependents).

item_edit_template

Format PBI id as the Markdown template used for $EDITOR editing.

link_commits

Add commit SHAs in shas to PBI id and return LinkOutcome.

list_items

Return PBIs from project_dir in canonical hierarchical priority order.

list_sprints

Return sprints from project_dir in ascending creation-time order.

lock_board

Acquire the board write lock for a caller that needs a consistent board snapshot.

migrate_storage

Migrate from the current backend to target and switch the save location of config.toml.

move_item

Move PBI id to workflow status to and return the saved BacklogItem.

rebalance

Reassign oversized ranks within each (status, parent) sibling scope.

remove_dependency

Remove dependency dep from PBI id and return the saved BacklogItem.

remove_item

Delete PBI with id. The default is archive backup, and if permanent is true, physical deletion is performed.

reorder_item

Sort the PBI by id within its sibling group and return the saved BacklogItem. Change only rank; keep status and parent.

scan_commits

Scan git log and associate commits whose messages contain a PBI ID.

set_common_dod

Replace the board’s common DoD and return the written file path.

set_sprint_capacity

Update sprint capacity settings and return the calculated capacity.

show_item

Load PBI id from the board in project_dir.

sprint_capacity

Return the configured capacity for a sprint.

start_sprint

Start a sprint (planned → active). Returns the saved Sprint.

template_body

Read .pinto/templates/<kind>/<name>.md as plain text.

tui_settings

Read TUI settings from the board. Return crate::error::Error::NotInitialized when it is uninitialized.

unassign_sprint

Remove PBI item_id from sprint sprint_id and return the saved BacklogItem.

unlink_commits

Remove commits matching the SHA prefixes in shas from PBI id and return LinkOutcome.

velocity

Aggregate velocity for the most recent recent sprints in project_dir.

wip_violations

Compare each column limit in config with the corresponding item count and return the columns that exceed their limits.