Notes on framework; adding nil to entities should raise helpful error; beginning swipe at state_machine support