direction optimizing breadth first search, rough commit

it's in an ugly state.  needs lots of api work, then doc, tests, examples,
but it's been sitting on the disk too long.
BF api doc
note potential simplification
match BreadthFirstSimple signature to BreadthFirst
another big type rename
improve DF and BF examples to show level