Struct Planner 

pub struct Planner { /* private fields */ }

A working snapshot of the planning registry, bound to a repo root.

Implementations

impl Planner

pub fn load() -> Result<Self>

Load the planning registry from tix.toml in the current directory, on the crate-wide assumption that commands run from the repo root.

pub fn load_from(path: &Path) -> Result<Self>

Load the planning registry from an explicit config path.

pub fn from_config(config: Config, root: PathBuf) -> Self

Build a planner from an already-loaded config (used by tix init and tests). The config is not persisted here; mutators save on demand.

pub fn config(&self) -> &Config

The backing config this planner currently mirrors.

pub fn category_resolution(&self) -> CategoryResolution

The resolution this planner’s board maps through.

Built here rather than stored, because a Planner is a short-lived view over a config and caching it would be the per-object rebuild the service’s “built once per config load” rule exists to avoid. The expensive part of a sweep is not building this — it is a handful of hash inserts per column — it is not re-deriving it per issue, and that is what callers do wrong.

pub fn milestones_dir(&self) -> PathBuf

The resolved milestones directory, relative to the repo root.

pub fn team(&self, label: &str) -> Option<&Team>

Look up a team by label.

pub fn cycle(&self, name: &str) -> Option<&PlanningCycle>

Look up a cycle by name.

pub fn cycle_names(&self) -> Vec<String>

Cycle names in declaration order.

pub fn is_overdue(issue: &Issue, today: &str) -> bool

pub fn cycle_expired(cycle: &PlanningCycle, today: &str) -> bool

pub fn successor<'a>( &'a self, cycle: &str, today: &str, ) -> Option<(&'a str, &'a PlanningCycle)>

pub fn overdue_batch(&self, store: &Store, today: &str) -> Vec<Issue>

pub fn rollover_plan(&self, store: &Store, today: &str) -> Vec<RolloverTarget>

pub fn cycle_progress(&self, store: &Store, name: &str) -> Progress

pub fn milestone_progress(&self, store: &Store, name: &str) -> Progress

pub fn next_cycle_name(&mut self) -> String

The next auto cycle name. Skips forward past any existing Cycle N keys and permanently bumps [planning].cycle_number one past the returned name, per the seed’s cycle_number = 1 successor semantics. The bump is persisted by the mutator that calls this.

pub fn add_cycle(&mut self, name: Option<String>) -> Result<String>

Create a named or auto cycle. An explicit name must not collide with the current auto-counter successor (Cycle {cycle_number}), a config error, so hand-authored keys and generated ones never overlap.

pub fn rename_cycle(&mut self, old: &str, new: &str) -> Result<()>

Rename a cycle, moving its declaration order slot and rebasing default_cycle when it pointed at the old name.

pub fn delete_impact(&self, store: &Store, name: &str) -> Result<Impact>

pub fn rename_cycle_cascade( &mut self, store: &Store, old: &str, new: &str, ) -> Result<RenameImpact>

pub fn set_cycle_fields( &mut self, name: &str, description: Option<&str>, start_date: Option<&str>, due_date: Option<&str>, ) -> Result<()>

pub fn delete_cycle(&mut self, name: &str) -> Result<()>

pub fn add_team_member(&mut self, label: &str, member: &str) -> Result<()>

Add a member to a team, creating the team when absent. Duplicate members and blank inputs are rejected.

pub fn list_milestones(&self) -> Result<Vec<Milestone>>

All milestones, sorted by filename (which sorts by target_date then slug — the registry is a directory listing, never a stored list).

pub fn milestone_names(&self) -> Result<Vec<String>>

Milestone names in listing order.

pub fn milestone(&self, name: &str) -> Result<Milestone>

Look up a milestone by its frontmatter name.

pub fn create_milestone_file( &self, name: &str, target_date: Option<&str>, description: Option<&str>, ) -> Result<PathBuf>

Create a milestone registry file. The filename is {created}-{slug}.md where created is today’s date; an optional target_date is stored in the frontmatter and must be a valid YYYY-MM-DD calendar date when given (FR-007). The markdown body is the optional description. Refuses to overwrite an existing file.

pub fn rename_milestone_file( &self, old: &Milestone, new_name: &str, ) -> Result<PathBuf>

Rename a milestone file, keeping the created date prefix, bumping updated and rebasing the frontmatter name; the body is preserved verbatim (the cascade back into referencing issues is FR-009/IC-08 work that lives in the issue layer, not the registry).

pub fn milestone_delete_impact( &self, store: &Store, name: &str, ) -> Result<Impact>

pub fn rename_milestone_cascade( &self, store: &Store, old: &Milestone, new_name: &str, ) -> Result<RenameImpact>

pub fn update_milestone( &self, name: &str, target_date: Option<&str>, description: Option<&str>, ) -> Result<()>

pub fn delete_milestone(&self, name: &str) -> Result<String>

Trait Implementations

impl Clone for Planner

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Planner

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.