No wonder the “internet" recommends to write an API definition in a strictly typed language and then use some tool to generate the spec from that... the JSON Spec is so incredibly squishy. *sigh* Ahh well... I might do the crazy thing of generating the code from the spec and then generate the spec from my generated code and offer it to the Blues folks... :P
(I have opened so many issues on their JSON Spec repo already… I am sure they are “happy" :P)