Improve DatabaseShell code comments and exceptions

Summary:
Documentation of this class now fully contains type hinting.

Side edit: references variable should also be
initialized before method call.

Test Plan:
This is a no op change.

./artisan db:shell

Reviewers: dereckson

Differential Revision: http://devcentral.nasqueron.org/D422