Simplify the return value of get_instances()

Fixes #85
Update PHPCS rules

See #88
PHPCS fixes

Fixes #88
Improve points hooks API internals

First steps to simplify things more in the long term. May improve
performance somewhat as well. Also adds better docs.

See #86