Result filtering on search (also known as Partial Search)

First take at refactoring search to allow selective results, rather than returning the whole thing.
how about "--filter" or "--partial" which is a little neat ?