Struct FieldProvenance 

pub struct FieldProvenance {
    pub path: String,
    pub source_type: EvidenceLevel,
    pub source_reference: Option<String>,
    pub source_value: Option<String>,
    pub method: String,
    pub sample_id: Option<String>,
    pub batch_id: Option<String>,
    pub test_method: Option<String>,
    pub conditions: Option<MeasurementConditions>,
    pub retrieved_at: Option<String>,
    pub confidence: ConfidenceLevel,
    pub warnings: Vec<String>,
}

A single field’s origin: where its value came from, how, and how confident the generator is in it. One FieldProvenance per populated field.

path uses dot-separated MHLW JSON key names (the same names #[serde(rename = "...")] puts on the wire in official_sds.json), with [i] for array indices — e.g. "Composition.CompositionAndConcentration[0].SubstanceIdentifiers.SubstanceNames.GenericName". This is the one canonical path convention for this feature; see path_helpers below and tests::path_convention_is_stable.

Fields

path: String

source_type: EvidenceLevel

source_reference: Option<String>

source_value: Option<String>

method: String

sample_id: Option<String>

batch_id: Option<String>

test_method: Option<String>

conditions: Option<MeasurementConditions>

retrieved_at: Option<String>

Deliberately left None by every code path in this commit — no live timestamp is generated, so repeated generation from the same input produces byte-identical report JSON.

confidence: ConfidenceLevel

warnings: Vec<String>

Implementations

impl FieldProvenance

pub fn supplied(path: impl Into<String>, method: impl Into<String>) -> Self

A value the caller typed into ProductInput directly — trade name, supplier contact fields, component name/CAS/concentration. Always UnverifiedUserInput / Unverified confidence: structural validation (commit #8) confirms the shape is well-formed, not that the content is factually correct.

pub fn from_cas_resolver( path: impl Into<String>, pubchem_cid: Option<u64>, ) -> Self

A value returned by the existing CAS enrichment resolver (crate::enrichment::lookup_cas). ReferenceDatabase, not Confirmed/DeterministicCalculation — a CAS lookup result is evidence about a chemical identity candidate, not proof that the supplied product or batch actually contains that substance at the declared concentration, and this commit records the resolver’s returned value rather than recalculating it from structure.

pub fn from_measured_evidence( path: impl Into<String>, source: &EvidenceSource, method: Option<&str>, sample_id: Option<&str>, batch_id: Option<&str>, conditions: &MeasurementConditions, ) -> Self

A property resolved from caller-supplied measured-value evidence (flash point, boiling point, vapor pressure, explosive limits) that fully satisfied its FieldPolicy — see super::resolve::resolve_measured_properties. confidence: High and source_type taken directly from the super::EvidenceSource that resolved it (ProductTestReport/EquivalentBatchTestReport/ SupplierSpecification, whichever this property’s policy accepted) — never upgraded to a status the evidence itself doesn’t support.

pub fn from_test_result_evidence( path: impl Into<String>, source: &EvidenceSource, result: &TestResultEvidence, ) -> Self

Same as Self::from_measured_evidence for the three free-text-only properties (self-reactivity, oxidizing properties, metal corrosivity), whose evidence is a super::TestResultEvidence rather than a numeric value.

pub fn source_smiles( pubchem_cid: Option<u64>, used_connectivity_fallback: bool, ) -> Self

The candidate’s own structure as PubChem returned it, before any normalization — ReferenceDatabase, same evidence level as Self::from_cas_resolver, never Confirmed. Applies equally to either PubChem representation actually used as the normalization input: the full SMILES property (stereochemistry/isotopes where represented) or, only as a fallback, ConnectivitySMILES (connectivity only) — neither is chematic’s separately-provenanced, DeterministicCalculation-level canonical form (see Self::canonical_smiles). used_connectivity_fallback records which one so the report can disclose when stereochemistry/isotope information may not be represented.

pub fn canonical_smiles(pubchem_cid: Option<u64>, warnings: Vec<String>) -> Self

The chematic-canonicalized SMILES actually written into official_sds.json’s SMILES field. DeterministicCalculation — a canonical form is a deterministic transformation for this chematic version and input, not proof the underlying chemical identity is confirmed. Never Confirmed/ProductTestReport/ EquivalentBatchTestReport — the evidence level is hardcoded here, not something a caller can override.

Trait Implementations

impl Clone for FieldProvenance

fn clone(&self) -> FieldProvenance

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldProvenance

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for FieldProvenance

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for FieldProvenance

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

where __S: Serializer,

Serialize this value into the given Serde serializer.