Initialize self. See help(type(self)) for accurate signature.

Inverse of propagate_tags for view edges: remove VIEW_PROPAGATED copies from notes embedding the wrapped views.

Wrap the current entities as a depth-0 NavigableEntitySet.

Return the wrapped entities as a set.

Return the wrapped entities as a list. Order is not guaranteed (the underlying storage is a set).

Return an arbitrary entity from the set, or None if empty.

Useful when the caller knows the navigator wraps a single entity.

Return the direct downstream neighbors of the wrapped entities.

Only one hop is followed (no recursion). Entities of any type listed in requested_entities are merged into a single NavigableEntitySet.

Return every entity transitively reachable downstream.

Traverses the lineage graph breadth-first. Each entity is visited once, annotated with its depth in the returned NavigableEntitySet. Use this for impact analysis ("what entities would be affected"). Edge-level provenance is not preserved -- if you need to know which immediate upstream caused a given downstream to be reached, use propagate_tags instead.

Return notes that embed any of the wrapped views via NoteViewModel.

Return the direct downstream resources. Empty by default; overridden by subclasses.

Return the direct downstream scenarios. Empty by default; overridden by subclasses.

Return the direct downstream views. Empty by default; overridden by subclasses.

Return every entity transitively reachable upstream.

Mirror of get_next_entities_recursive but walks the lineage graph in the opposite direction (towards ancestors).

Return the direct upstream notes. Empty by default; overridden by subclasses.

Return the resources that the wrapped views are configured against.

Return the scenarios that produced the resources of the wrapped views.

Return the direct upstream views. Empty by default; overridden by subclasses.

Return True if at least one entity is wrapped.

Return True if any direct downstream neighbor exists.

Return True if no entities are wrapped.

Propagate tags from each wrapped view to the notes embedding it, then recurse. Origin is VIEW_PROPAGATED carrying the upstream view's id. See EntityNavigator.propagate_tags for the cache/visited contract.

Build the appropriate concrete navigator for a single entity, by type and id.

Raises if the entity does not exist or if entity_type is unknown.