maint/add_warning followup

In !537 (merged) maint/add_warning got some new approach but the UX is not always great.

We should

• Replace the asserts with something that prints a sensible error message with the filename
• Replace the open-coded option parser with use of getopt