crichton refactoring: fixing specs and serialization

@mdsol/hypermedia-team please review and merge!

@fosdev @sheavalentine-mdsol @jcarres-mdsol