notes
makefile tweaks
notes cleanup
extract debug helpers into a module