Struct IngestReport 

pub struct IngestReport {
    pub batch_id: String,
    pub documents_total: usize,
    pub skipped: usize,
    pub succeeded: usize,
    pub rejected: usize,
    pub failed: Vec<IngestFailure>,
    pub entities_total: usize,
    pub edges_total: usize,
    pub dry_run: bool,
    pub hub_degree: Vec<HubDegree>,
}

Aggregate result returned by crate::semantic::SemanticMemory::ingest_documents.

In dry-run mode (dry_run = true), entities_total and edges_total are projected post-sanitization counts and hub_degree contains the top-N entities by degree. No writes occur.

In live mode, entities_total and edges_total reflect actual upserts/inserts.

Dry-run accuracy

Dry-run counts are post-sanitization but pre-quality-gate upper bounds. The live write path applies self-loop rejection and admission control in insert_edges / upsert_entities that may reduce the final entity and edge counts relative to the dry-run projection. Rejected documents do NOT contribute to entities_total or edges_total in either mode.

Fields

batch_id: String

Batch identifier shared by all documents processed in this call.

documents_total: usize

Total number of documents in the input (after intra-batch dedup).

skipped: usize

Number of documents skipped (already ingested or intra-batch duplicate).

succeeded: usize

Number of documents successfully processed.

rejected: usize

Number of documents rejected by the post-extract validator (sanitizer).

Rejected documents write nothing to the graph or ledger and contribute zero to entities_total / edges_total. They are distinct from failed documents, which represent extraction or storage errors.

failed: Vec<IngestFailure>

Per-document failure records.

entities_total: usize

Total entities upserted (live) or projected (dry-run).

Excludes rejected documents. In dry-run mode this is a post-sanitization upper bound; the live run may produce fewer entities after admission control.

edges_total: usize

Total edges inserted (live) or projected (dry-run).

Excludes rejected documents. In dry-run mode this is a post-sanitization upper bound; the live run may produce fewer edges after self-loop rejection and admission control.

dry_run: bool

true when ingest_documents was called with dry_run = true.

hub_degree: Vec<HubDegree>

Top-N entities by projected edge degree. Populated only in dry-run mode (FR-026).

Degrees are computed from post-sanitization extractor output (rejected documents do not contribute). They represent pre-quality-gate upper bounds — not the final graph topology.

Trait Implementations

impl Clone for IngestReport

fn clone(&self) -> IngestReport

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IngestReport

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

Formats the value using the given formatter.

impl Default for IngestReport

fn default() -> IngestReport

Returns the “default value” for a type.