public api
add test for immediate dependent herald
todos