Struct InboundIndex 

pub struct InboundIndex { /* private fields */ }

Repository-wide backlink index for server mode.

The server used to answer every links.json request by walking the entire repository and grepping each markdown file for references to that one page (link_grep::find_inbound_links). That is O(repository) per page, and the info panel’s mini graph requests many pages at once, so a large repo paid for a full walk per distinct page on every cache miss.

This inverts the relationship once instead: each markdown file is parsed a single time, its internal outbound links are resolved to absolute URLs, and each one is recorded as a backlink on its target. Lookups are then a hash hit. It is the same inversion build::Builder::write_link_files performs for static output, which also closes the long-standing server/build disagreement about which links produce backlinks — the grep matched on path spelling, while both inverted indexes use the renderer’s own resolution.

contributions is what makes incremental maintenance cheap: it remembers which targets a given source page currently contributes to, so a changed file’s old backlinks can be withdrawn without touching any other bucket.

Implementations

impl InboundIndex

pub fn new() -> Self

pub fn is_ready(&self) -> bool

True once the initial full-repository pass has completed.

pub fn mark_ready(&self)

Mark the index queryable. Called after the initial pass.

pub async fn wait_until_ready(&self)

Wait until the initial full-repository pass has finished.

notify_waiters() stores no permit, so interest is registered before the flag is re-checked; otherwise a build that completes in that window would leave the caller parked forever (same pattern as Repo::wait_for_scan).

pub fn set_page_links(&self, source_url: &str, links: &[OutboundLink])

Record source_url’s links, replacing whatever it contributed before.

links must already be resolved to absolute URLs (see resolve_outbound_links); external links are ignored, since only an internal target can display a backlink.

pub fn remove_page(&self, source_url: &str)

Remove every backlink contributed by source_url (the page was deleted).

pub fn get(&self, target_url: &str) -> Vec<InboundLink>

Backlinks for target_url, in from order.

pub fn source_count(&self, target_url: &str) -> usize

How many distinct pages link to target_url — a hash hit and a length, no clone. Only meaningful once Self::is_ready; a miss before then is “unknown”, not zero.

pub fn clear(&self)

Drop everything, including readiness (a full rescan rebuilds it).

pub fn target_count(&self) -> usize

Number of pages that currently have at least one backlink recorded.

Trait Implementations

impl Default for InboundIndex

fn default() -> Self

Returns the “default value” for a type.