re-arrange spec constants a bit. teeny progress on top-level api