Proper github event detection

- developer api docs were misleading; need to introspect the delivered
  object for recognized objects/keys, and react to those.
- return proper errors, to better disambiguate.