And offer backwards compat for all of the community commands that use @synopsis?

Of course.

I'm thinking of making SynopsisParser return a Synopsis object, instead of a plain array.

LE: On the other hand, there's a case to be made for the convenience of inspecting the array directly.

The idea is to not display invalid tokens when doing wp help core download, for example.

Some bundled commands, like cache, only have a synopsis tag and no longdesc. Going to leave those as-is.

The option and *-meta subcommands are an interesting case, since the arguments are described in the class docblock, not in the method docblock.

Since this has the potential to get stale very quickly, going to merge as-is and fix issues as they come up.