pathBetween

fun pathBetween(entityIdA: String, entityIdB: String, minAuthority: AuthorityTier? = null): List<GraphPath>

The paths connecting entityIdA to entityIdB; an empty list when none exists (never throws).

Routes to a native GraphQueryCapable store for unscoped queries, and for context-scoped queries when the store declares GraphQueryCapable.honorsContextFilter; otherwise runs bounded, cycle-safe BFS over ACTIVE proposition edges. This query's own maxDepth ceiling is passed along to the native adapter too, so it bounds the walk to the same hop ceiling the portable path uses. When minAuthority is set, the native adapter is consulted only if it declares GraphQueryCapable.honorsAuthorityFilter; otherwise the portable path applies the floor (re-resolving authority from provenance), as in neighborhood.

The return type is a list because a native graph adapter may enumerate multiple paths, but the portable default body returns at most a single path: the first shortest path BFS discovers (an empty list when the targets are unreachable within the hop ceiling). Full multi-path enumeration is left to native adapters; the default body never fabricates additional paths.

Legacy-edge behaviour: same as neighborhood — propositions with no provenance resolve to AuthorityTier.UNKNOWN and are dropped by any non-null minAuthority floor.