Address some comments from thockin@

I could live with just a comment at the interface.  Or change bool to an enum of (Passed, Failed, Unknown) or something, and let callers explicitly handle unknown as Passed.