- more specs, mocked out github calls, refactoring
- readme update