Struct SourceBindingCache 

struct SourceBindingCache<'a> {
    retained_limit: u64,
    root: &'a Path,
    nodes: Arc<BTreeMap<&'a str, &'a Node>>,
    direct_paths: Option<BTreeSet<&'a str>>,
    captured: BTreeMap<String, Arc<CapturedSourceGraph>>,
    cargo_cohorts: BTreeMap<String, Arc<CargoRootCohortIndex>>,
    work: SourceRecoveryWork,
    retained_bytes: u64,
}

Per-operation captured source cache, limited to requested projection/context paths.

Fields

retained_limit: u64

Allowance after subtracting coexisting publication owners.

root: &'a Path

Exact selected checkout.

nodes: Arc<BTreeMap<&'a str, &'a Node>>

Captured file inventory, used to reject changed or unindexed source.

direct_paths: Option<BTreeSet<&'a str>>

Direct paths for incremental work; absence means a full candidate set.

captured: BTreeMap<String, Arc<CapturedSourceGraph>>

One immutable parse per required unchanged path.

cargo_cohorts: BTreeMap<String, Arc<CargoRootCohortIndex>>

Derived Cargo cohorts retain no second manifest graph or parser facts.

work: SourceRecoveryWork

Additional actual parser work, separate from reused fresh sidecars.

retained_bytes: u64

Bounded owned source graphs/evidence retained during projection.

Implementations

impl SourceBindingCache<'_>

fn reserve_cohort_bytes(&mut self, bytes: u64) -> Result<(), CliError>

Reserve a derived cache or temporary construction before inserting it.

fn cohort( &mut self, project: ProjectInstanceId, package: &PackageOwner, directory: &str, kind: CohortKind, ) -> Result<Option<Arc<CargoRootCohort>>, CliError>

Admit one shared key; an invalid identity retains exact file causes instead.

pub(super) fn cargo_root_cohorts( &mut self, project: ProjectInstanceId, package: &PackageOwner, targets: &SourceCargoTargets, packages: &PackageIndex, control: &IndexWorkControl, ) -> Result<Arc<CargoRootCohortIndex>, CliError>

Cache only derived roots, sharing the already captured manifest’s parse.

impl<'a> SourceBindingCache<'a>

fn new( root: &'a Path, nodes: &'a [Node], direct_paths: Option<&BTreeSet<String>>, ) -> Self

Index captured metadata once without reading any source file.

fn set_retained_limit(&mut self, limit: u64) -> Result<(), CliError>

Update a phase allowance without discarding already retained cache owners.

fn capture( &mut self, path: &str, control: &IndexWorkControl, ) -> Result<Arc<CapturedSourceGraph>, CliError>

Recover only an explicitly requested source, preserving its original parser order.