Struct TimeSnapshot 

pub struct TimeSnapshot { /* private fields */ }

One read-only index of current entries and retained time History (T014).

Implementations

impl TimeSnapshot

pub fn of(issues: &[Issue]) -> Self

Index the current entries and time History of the issues a caller holds (T014).

One pass over the slice: each entry is resolved once (including the identity it is attributed to, which every later grouping and comparison reuses), and each issue’s time events are read once. Entries come out in data-model §6 order, so the same issues always produce the same bytes — which is what makes CLI, TUI, MCP and portable output agree on them (NFR-003).

pub fn entries(&self) -> &[IndexedEntry]

Every indexed entry, in the snapshot’s deterministic order.

pub fn issues(&self) -> &[u32]

Every issue number the snapshot holds, ascending.

pub fn holds_issue(&self, number: u32) -> bool

Whether the snapshot holds this issue — with or without entries.

pub fn deletions_on(&self, issue: u32) -> &[TimeDeletion]

The prior values deletions left in one issue’s History, in History order.

pub fn corrections_on(&self, issue: u32) -> usize

How many corrections one issue’s History retains.

pub fn total(&self, filter: &TimeFilter) -> TimeTotal

The typed total for one scope (T015).

A refused filter yields one total whose state is TimeTotalState::InvalidFilter and whose findings are the refusals — no entry is evaluated, so an invalid bound can never be read as “no bound”. A selector naming an issue this snapshot does not hold yields TimeTotalState::UnknownIssue for the same reason.

pub fn totals(&self, filters: &[TimeFilter]) -> Vec<TimeTotal>

Every requested scope, evaluated against this one snapshot (T014).

The filters are answered in the order they were given and each is derived from the same index, so a set of scopes costs no second scan, no second read and no second opinion.

pub fn by_issue(&self, filter: &TimeFilter) -> Vec<TimeTotal>

One total per issue the snapshot holds (T014, FR-003).

Every issue appears, including an issue holding no entry — its total is TimeTotalState::Nothing with zero counts, which is a real answer and not an absence to hide. An entry whose date falls outside a period is still this issue’s entry, so a period-bounded breakdown keeps the issue and reports nothing inside the period, rather than making the issue vanish.

pub fn by_assignee(&self, filter: &TimeFilter) -> Vec<TimeTotal>

One total per identity that did work in scope (T014, FR-003).

ada and @Ada are one identity, through the identity model the rest of the crate uses; an entry whose author names no identity is shown under TimeGroup::Unattributed rather than dropped.

pub fn by_date(&self, filter: &TimeFilter) -> Vec<TimeTotal>

One total per calendar date in scope (T014, FR-003).

A date outside a period gets no group at all — a group whose key is a date the period excludes would contradict itself — while an entry the period cannot place (no date, or a date the validator refuses) is shown under TimeGroup::Undated and counted, so the breakdown never hides it.

pub fn audit(&self, filter: &TimeFilter) -> TimeAudit

The explicit audit view for one scope (T017).

Trait Implementations

impl Clone for TimeSnapshot

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 TimeSnapshot

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

Formats the value using the given formatter.

impl Default for TimeSnapshot

fn default() -> Self

Returns the “default value” for a type.

impl Eq for TimeSnapshot

impl PartialEq for TimeSnapshot

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TimeSnapshot