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

Inverse of propagate_tags for scenario edges: remove SCENARIO_PROPAGATED copies from produced resources and attached notes, then recurse downstream.

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 attached to the wrapped scenarios via NoteScenario.

Return all the resources generated by the wrapped scenarios.

Return scenarios that consume any resource produced by the wrapped scenarios.

Return views of the resources produced by the wrapped scenarios.

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 resources consumed by the wrapped scenarios via input tasks.

Walks TaskModel.source_config_id of the scenarios' input tasks.

Return scenarios that produced any resource consumed by the wrapped scenarios.

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 scenario to its produced resources and attached notes, then recurse downstream. Origin is SCENARIO_PROPAGATED with the upstream scenario'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.