fixed doc block
extracted a Vcs\Repository interface
extracted more interfaces - that's an intermediate step until we can clearly identify the interfaces