Struct Document 

pub struct Document {
    pub schema_version: String,
    pub parser: ParserInfo,
    pub profile: ProfileRef,
    pub source: SourceInfo,
    pub config_sha256: String,
    pub payload_sha256: String,
    pub fingerprint: String,
    pub payload: Payload,
    pub diagnostics: Option<Value>,
}

Top-level document artifact (ethos.json).

Fields

schema_version: String

Contract schema version.

parser: ParserInfo

Producing parser.

profile: ProfileRef

Deterministic profile identity.

source: SourceInfo

Source identity.

config_sha256: String

sha256 of c14n(effective-config subset).

payload_sha256: String

sha256 of c14n(stable payload projection).

fingerprint: String

Composite document fingerprint (sha256:…).

payload: Payload

The emitted payload; payload_sha256 binds its stable projection.

diagnostics: Option<Value>

Runtime-only diagnostics; excluded from canonical equality and all fingerprints. Omitted by default (--diagnostics opts in) so default outputs are byte-identical.

Implementations

impl Document

pub fn payload_c14n(&self) -> Result<Vec<u8>, EthosError>

c14n bytes of the emitted payload.

pub fn payload_fingerprint_c14n(&self) -> Result<Vec<u8>, EthosError>

Stable c14n bytes of the payload projection used by fingerprints and G3.

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

Recompute payload_sha256 from the stable payload projection.

pub fn compute_payload_sha256_for_payload( payload: &Payload, ) -> Result<String, EthosError>

Compute payload_sha256 for an assembled payload before the envelope exists.

pub fn payload_fingerprint_value(&self) -> Result<Value, EthosError>

Build the stable payload projection used by payload_sha256.

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

Recompute the raw payload hash for diagnostics only.

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

Recompute the composite fingerprint from embedded envelope fields.

pub fn verify_integrity(&self) -> Result<(), EthosError>

Verify internal hash consistency (used by ethos fingerprint): embedded payload_sha256 and fingerprint match recomputation.

Trait Implementations

impl Clone for Document

fn clone(&self) -> Document

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Document

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Document

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl GroundingSource for Document

Ethos output is itself just another grounding source (PRD §1.5): the verify layer sees Ethos through the same trait as any foreign parser.

fn parser(&self) -> ParserIdentity

Identity of the producing parser (+ adapter when foreign).

fn capabilities(&self) -> Capabilities

Capability declaration; drives explicit verification downgrades.

fn fingerprint(&self) -> Option<String>

Document fingerprint when the source declares one (sha256:… for Ethos).

fn pages(&self) -> Vec<PageGeometry>

Page geometry, ascending page index.

fn elements(&self) -> Vec<GroundingElement>

Elements in the source’s canonical order.

fn element_by_id(&self, id: &str) -> Option<GroundingElement>

Element lookup by id. Default: linear scan over Self::elements.

fn spans(&self) -> Vec<GroundingSpan>

Spans, when capability spans is true. Default: none.

fn tables(&self) -> Vec<GroundingTable>

Tables, when the source models them. Default: none (verification of table_cell claims downgrades accordingly).

fn crop_ref(&self, _page: &str, _bbox: [i64; 4]) -> Option<String>

Stable crop reference for an evidence region, when crop_support is true. The verify layer treats this as an opaque audit pointer; sources own how the referenced crop artifact is generated and stored.

impl PartialEq for Document

fn eq(&self, other: &Document) -> 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 Serialize for Document

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 Document