API v1 spec

This is still a work-in-progress, but any feedback is more than welcome.
is this not a shared field because you anticipate Commands that don't operate on Units? if so, anything in mind?