Struct ReviewState 

pub struct ReviewState {
    pub target: Option<ContentHash>,
    pub reviewers: Vec<String>,
    pub verdicts: BTreeMap<String, VerdictState>,
    pub slashes: BTreeMap<String, String>,
    pub target_ref: Option<String>,
    pub comments: Vec<CommentState>,
    pub viewed: BTreeMap<String, u64>,
    pub status: ReviewStatus,
}

Materialized state of one review: what is under review, who was asked, who has answered what, and what was said about it.

Fields

target: Option<ContentHash>

The commit under review.

reviewers: Vec<String>

Actors the review fanned out to.

verdicts: BTreeMap<String, VerdictState>

reviewer → their answer; absent = not answered yet.

slashes: BTreeMap<String, String>

reviewer → node-recorded reason for retroactively invalidating that approval. Kept separately from verdict bulk so archived rows remain compact while the append-only decision stays visible.

target_ref: Option<String>

The ref the review proposes to land on (<repo>:<refname>), or None for a review that named no destination. Policy reads this to decide whether a review is privilege-bearing.

comments: Vec<CommentState>

The discussion, in the order the sequencer admitted it (D38). Emptied by OpKind::ArchiveReview with the rest of the bulk.

viewed: BTreeMap<String, u64>

viewer → fold position of that viewer’s first recorded read . Emptied by OpKind::ArchiveReview with the rest of the bulk.

status: ReviewStatus

Live, or settled with its outcome retained. Defaults to ReviewStatus::Live, so replaying a log written before archiving existed yields exactly the previous behaviour.

Implementations

impl ReviewState

pub fn counted_approvers(&self) -> Vec<(&str, u64)>

The reviewer channels ReviewState::approval_weight actually counts: the first standing Approve from each distinct operator, in verdict order, slashes applied.

This exists so a OpKind::Submit can name the approvals its weight rested on rather than “everyone who clicked approve”. The weight is defined as this list’s length times MAX_APPROVAL_WEIGHT_PER_OPERATOR, so the number in an authorization record and the names beside it cannot drift.

Each entry pairs the channel with the fold position of the verdict being counted, because that position is what resolves the channel to a key (see View::bound_actor_at). Returning the channel alone would leave every caller to look the position up again, and the one that forgot would silently credit whatever key holds the channel today.

Meaningless on an archived review, whose verdicts are gone: the list is empty while ReviewState::approval_weight still answers from the stored total.

pub fn approval_stands(&self, reviewer: &str) -> bool

Whether reviewer has an Approve verdict that no slash has invalidated — the individual half of ReviewState::counted_approvers, used where one named approval has to be checked rather than a set.

pub fn standing_approval_at(&self, reviewer: &str) -> Option<u64>

The fold position of reviewer’s standing approval, or None if they have none — ReviewState::approval_stands plus the one fact a caller needs to resolve it to a key (View::bound_actor_at).

The predicate is defined as this returning Some, so the two can never disagree about what “standing” means.

pub fn complete(&self) -> bool

Whether every listed reviewer has answered. An unassigned review (no reviewers yet) is never complete — vacuous truth must not turn “asked nobody” into a finished review.

pub fn approved(&self) -> bool

Whether the review is complete with no RequestChanges.

pub fn approval_weight(&self) -> usize

Approval weight after capping every operator at one unit.

Multiple agent channels under one operator/agent prefix never manufacture additional approval weight. Archived reviews return the compact weight captured before their reviewer detail was dropped.

pub fn re_review_required(&self) -> bool

Whether a retroactive invalidation requires a fresh review before the same (ref, commit) can authorize another protected landing.

Trait Implementations

impl Clone for ReviewState

fn clone(&self) -> ReviewState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ReviewState

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

Formats the value using the given formatter.

impl Default for ReviewState

fn default() -> ReviewState

Returns the “default value” for a type.

impl PartialEq for ReviewState

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ReviewState

impl StructuralPartialEq for ReviewState