[GuillaumeRx]

Explanation

Second step of the output revamp: errors tell the user what is wrong and how to fix it.

• An error prints as a short title with its Caused by: lines. The stack trace only shows with DEBUG=create-release-branch:*.
• Errors that the user can act on extend a new UserFacingError class and describe themselves.
• Release rule errors are now data: { packageName, problem, hint }. The texts are rewritten to say what to do next.
• Release spec problems are listed by line and package, with a dimmed hint under each one, and the path of the kept release spec at the end. An invalid YAML file shows where the parser stopped.
• The release UI keeps the same JSON shape for its error messages.

References

• Part of the output revamp stack
• Depends on feat(create-release-branch): render the CLI output with clack #159

Checklist

• I've updated the test suite for new or updated code as appropriate
• I've updated documentation (JSDoc, Markdown, etc.) for new or updated code as appropriate
• I've communicated my changes to consumers by updating changelogs for packages I've changed
• I've introduced breaking changes in this PR and have prepared draft pull requests for clients and consumer packages to resolve them