Struct ProjectIndex 

pub struct ProjectIndex { /* private fields */ }

The derived project view over one snapshot of issues and the registry.

Built once and read many times. The bucket map is the NFR-001 index; the project map is IndexMap so declaration order is the display order; the label/status maps carry what a member listing needs. Nothing here is stored.

Implementations

impl ProjectIndex

pub fn build<N: ProjectNode>(config: &Config, issues: &[N]) -> Self

Build the index in one pass over the issue set.

An association whose project does not resolve is kept in Self::missing rather than dropped: a silently absent reference is the failure C-005 forbids, and validate_references reports exactly this set.

pub fn buckets(&self) -> &HashMap<ProjectId, Vec<IssueKey>>

The reverse index, as the contract spells it.

pub fn bucket(&self, id: &ProjectId) -> Option<&[IssueKey]>

The member keys of one project.

None only for a project the registry does not hold. A known project with no members returns an empty slice, so “not a project” and “a project with no members yet” stay distinguishable to a caller.

pub fn projects(&self) -> Vec<&Project>

Projects in declaration order.

pub fn project(&self, id: &ProjectId) -> Option<&Project>

One project by id.

pub fn label(&self, key: IssueKey) -> Option<&str>

The issue display label the index recorded.

pub fn status_of(&self, key: IssueKey) -> Option<&str>

An issue’s status, as the index recorded it.

pub fn missing(&self) -> &[MissingProjectReference]

The diagnosed associations of this snapshot.

pub fn resolve(&self, reference: &str) -> Result<&Project, ProjectError>

Resolve a project by id (first) or by name.

pub fn membership( &self, reference: &str, ) -> Result<ProjectMembership, ProjectError>

The ordered membership of a project.

pub fn resolved_memberships(&self) -> HashMap<u32, Vec<String>>

Every issue’s resolved project ids, in registry declaration order.

The reverse of Self::buckets: issue number -> the ids of the projects that hold it. Derived from the same buckets, so a grouping surface cannot disagree with Self::membership about who is a member; an association the registry does not hold appears in no bucket and therefore in no entry here (it is diagnosed by validate_references instead — the chosen asymmetry tix search’s project_matches documents).

Declaration order is the display order, so project_bucket_label over an entry is the same label the board’s ProjectPartition produces.

pub fn into_buckets(self) -> HashMap<ProjectId, Vec<IssueKey>>

Consume the index into its reverse map (the contract’s return shape).

pub fn into_missing(self) -> Vec<MissingProjectReference>

Consume the index into its missing-reference list.

pub fn into_projects(self) -> Vec<Project>

Consume the index into its declaration-ordered project list.

impl ProjectIndex

pub fn health<S: BuildHasher>( &self, config: &Config, reference: &str, assigned: &HashSet<u32, S>, overdue: &HashSet<u32, S>, blocked: &HashSet<u32, S>, ) -> Result<ProjectHealthReport, ProjectError>

Progress and health for one project (contract §1, FR-003).

Reads the members from the index’s bucket, so a project’s figures are a bucket lookup rather than a scan of the issue set (contract §4).

assigned, overdue, and blocked are the consumed derived facts, keyed by issue number and each produced by its owner: assigned_keys, the planning overdue read, and the relationship graph’s blocked_state. Project health counts them and never recomputes them. Completion resolves through the board’s configured completion column via the service resolution, never a literal "done".

A done issue is never counted as overdue, matching the planner’s own overdue rule: the passed set is normally already filtered, and the guard keeps the invariant true for any caller that passes a raw set.

Trait Implementations

impl Clone for ProjectIndex

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 ProjectIndex

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

Formats the value using the given formatter.

impl Eq for ProjectIndex

impl PartialEq for ProjectIndex

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for ProjectIndex