still working on the detection system. It is really boring but
important, since it is the most error prone part (file system activity
is always dangerous). finished writing the method for validating a
common state. see README for detailed file structure restrictions.