Function is_ancestor 

pub fn is_ancestor(ancestor: &str, descendant: &str) -> bool

Whether ancestor is reachable from descendant (merge-base --is-ancestor).

is_ancestor("origin/main", "HEAD") answers “is this branch already on top of the latest main?” — the check behind “already up to date” in gw sync and the behind-main detection in gw status.