Skip to main content

StandardReviewBriefOutput

Type Alias StandardReviewBriefOutput 

Source
pub type StandardReviewBriefOutput = ReviewBriefOutput<FocusMap, WeakeningSignal, RoutingFacts, DecisionSurface>;
Expand description

The standard audit brief payload shape used by the CLI, schema emitter, API, and agent-facing review surfaces.

Aliased Type§

pub struct StandardReviewBriefOutput {
    pub schema_version: ReviewBriefSchemaVersion,
    pub version: String,
    pub command: String,
    pub triage: DiffTriage,
    pub graph_facts: GraphFacts,
    pub partition: PartitionFacts,
    pub impact_closure: ImpactClosureFacts,
    pub focus: FocusMap,
    pub deltas: ReviewDeltas,
    pub weakening: Vec<WeakeningSignal>,
    pub routing: RoutingFacts,
    pub decisions: DecisionSurface,
}

Fields§

§schema_version: ReviewBriefSchemaVersion

Independently-versioned brief schema version.

§version: String

Fallow CLI version that produced this output.

§command: String

Command discriminator singleton: always "audit-brief".

§triage: DiffTriage§graph_facts: GraphFacts

Stage 1: graph orientation facts.

§partition: PartitionFacts

Stage 2: the partition + order (by-module units + dependency-sensible review order). The backbone the directed-review loop hands the agent.

§impact_closure: ImpactClosureFacts

Stage 3: the impact closure (affected-not-shown + coordination gap).

§focus: FocusMap

Stage 4: the weighted focus map. A composite attention score per changed-file unit (fan-in/out + security taint + risk zone + change shape), with review-here / not-prioritized labels (NEVER skip in free mode), a per-unit confidence flag, and the FULL deprioritized escape-hatch list so every de-prioritized piece is reachable. Stage 4 sits UNDER the decision surface as drill-down.

§deltas: ReviewDeltas

6.A: diff-aware deterministic deltas (boundary/cycle introduced + exports-aware public-API surface delta), new-vs-pre-existing.

§weakening: Vec<WeakeningSignal>

6.F, headline: reviewer-private weakening signals (tests removed/skipped, thresholds lowered, suppressions added, security steps removed). Advisory, never gates, never auto-posted.

§routing: RoutingFacts

6.D: ownership-aware reviewer routing (per-file expert + bus-factor).

§decisions: DecisionSurface

6.G, the APEX: the decision surface. The ranked, capped, signal_id-anchored set of consequential structural decisions, each framed as a judgment question with its routed expert. This is the only thing the brief visibly leads with; the stages above are its drill-down derivation.