more tests and doc update for new tool init/setup/validate