ensure test runner can detect dispatcher failure
update readme with docs