Struct DocumentResolutionIndex 

struct DocumentResolutionIndex<'a> {
    root: PathBuf,
    canonical_root: PathBuf,
    kinds_by_path: HashMap<&'a str, NodeKind>,
    casefold_path_counts: HashMap<String, u32>,
    scan_policy: &'a RootScanPolicy,
    absent_states: RefCell<BTreeMap<String, DocumentTargetUnresolvedReason>>,
}

Exact staged file inventory plus platform-aware case and root checks.

Fields

root: PathBuf

Selected source root used only for bounded filesystem checks.

canonical_root: PathBuf

Canonical selected root used to reject symlink escape.

kinds_by_path: HashMap<&'a str, NodeKind>

Exact case-preserving staged identities.

casefold_path_counts: HashMap<String, u32>

Unicode-lowercase identity counts used to refuse guesses and collisions.

scan_policy: &'a RootScanPolicy

Effective repository admission policy shared with full and incremental scans.

absent_states: RefCell<BTreeMap<String, DocumentTargetUnresolvedReason>>

Consulted non-indexed states, memoized for repeated high-fan-out references.

Implementations

impl<'a> DocumentResolutionIndex<'a>

fn new( root: &Path, nodes: &'a [Node], scan_policy: &'a RootScanPolicy, ) -> Result<Self, CliError>

Build one bounded exact-identity view from the staged source inventory.

fn unresolved_reason( &self, path: &str, ) -> Result<Option<DocumentTargetUnresolvedReason>, CliError>

Return a closed unresolved reason, or None for one exact admitted file.

fn absent_reason( &self, path: &str, ) -> Result<DocumentTargetUnresolvedReason, CliError>

Distinguish absent source from excluded or escaping filesystem state.

fn observed_absent_states( &self, ) -> Vec<(String, DocumentTargetUnresolvedReason)>

Return the bounded states actually consulted during document resolution.

fn missing_or_escaping_ancestor( &self, native: &Path, ) -> DocumentTargetUnresolvedReason

Check the nearest existing ancestor so a missing child cannot hide symlink escape.