wip-Development

working on tests next
The conditional triggers if num_found == num_required and there are no required_ids. Am I misunderstanding what required_ids is? If it's some sort of mutable countdown, that's an antipattern -- you should accumulate stuff that was found, then compare it against some target. Otherwise changing the target becomes virtually impossible.