prep work for common returned value factoring
refactored return values from cortex
cleanup