complete rewrite of algorithm to fix issue #1. add more info to 'debug' render
update readme