Struct ComptrollerSurfaceReport 

pub struct ComptrollerSurfaceReport {
    pub schema: String,
    pub generated_at: u64,
    pub filters: OperatorReportQuery,
    pub exposure_positions: Vec<ExposureLedgerCurrencyPosition>,
    pub decision_summary: ComptrollerDecisionSummary,
    pub settlement_reconciliation: SettlementReconciliationSummary,
    pub budget_utilization: BudgetUtilizationSummary,
    pub source_refs: ComptrollerSurfaceSourceRefs,
    pub execution_nonce_ref: Option<String>,
    pub hold_ref: Option<String>,
}

Unified spend/exposure contract: a projection over OperatorReport + ExposureLedgerReport.

Fields

schema: String

generated_at: u64

filters: OperatorReportQuery

exposure_positions: Vec<ExposureLedgerCurrencyPosition>

decision_summary: ComptrollerDecisionSummary

settlement_reconciliation: SettlementReconciliationSummary

budget_utilization: BudgetUtilizationSummary

source_refs: ComptrollerSurfaceSourceRefs

execution_nonce_ref: Option<String>

Reserved for future execution-nonce linkage; omitted until a later schema revision to avoid a governance-gated schema bump.

hold_ref: Option<String>

Reserved for future hold linkage; omitted until a later schema revision.

Implementations

impl ComptrollerSurfaceReport

pub fn from_parts( operator: &OperatorReport, exposure: &ExposureLedgerReport, ) -> Self

Compose the projection from the already-built operator + exposure read models.

pub fn validate_consistency(&self) -> Result<(), String>

Fail-closed single-domain invariant over the credit exposure positions.

Within each currency position, outstanding holds (reserved + pending) must not exceed the governed exposure ceiling. A ceiling of 0 means “no governed ceiling” and is skipped (fail-safe). This is a credit-domain-only check; it does NOT cross into kernel budget cost units, whose unit mapping to exposure units is undefined.

Trait Implementations

impl Clone for ComptrollerSurfaceReport

fn clone(&self) -> ComptrollerSurfaceReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ComptrollerSurfaceReport

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ComptrollerSurfaceReport

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ComptrollerSurfaceReport

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ComptrollerSurfaceReport

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ComptrollerSurfaceReport