major breakup of framework logic, first draft comments (gasp)