pub fn refresh(
index: &mut Index,
basis: &Basis,
delivery: &Delivery,
) -> Result<ReconcileReport>Expand description
Reverify a retained index, refresh requested content, and persist according to delivery.
A partial pass retains its verified facts and may save only the content tier beside a compatible complete snapshot. The returned report describes metadata changes.
The metadata write is owed by the index, not by the pass: a pass that mutated the entry tier without writing it – because it was partial, or its policy does not write – leaves the index holding facts the snapshot lacks, and the next complete pass under a writing policy writes them even when it changed nothing itself. Only a completed write clears that debt, so a failed one is retried by the next pass as well.