commands: add some docs
commands: short-circuit if we failed to parse the name/parameters
commands: increment reference count before returning

we want to return a referenced version of the command so that we can
dynamically generate commands in the future if we like.