Map Puppet debugging flags to YARD options

This patch configures YARD to run in debug mode if Puppet flags such as
`--debug` or `--trace` are used.