Add more detail to the error messages that will allow much quicker debugging. Such as line numbers where the error occurs or suggested diagnostic flags.
For example, received the error message:
Error: Could not retrieve catalog from remote server: Error 400 on SERVER: Could not parse for environment pr001: Found 4 errors. Giving up in /app/puppet/environments/apps/test/pr001/manifests/params.pp on node pr.server.com
Those four errors took several hours to track down in the very large params.pp file. Having line numbers would have made the debugging task much easier.