maint: clean up source code
maint: comment source code
maint: document more
feat: improve flags
feat: replace uuid dep with custom id generator
