Enhance Rakefile

This commit adds 'puppet-syntax' to the Rakefile for syntax checking.

We also re-enable a couple sane puppet-lint checks that were disabled.
More comprehensive, robust Gemfile

This commit adds a few needed/nice gems to the Gemfile and also cleans up
some logic there.
Move spec.opts to .rspec

spec.opts has been deprecated for a long time.