ensured binary files are committed

do note the comment on how metadata files are considered the
authoritative source

in the process, expanded test and fixed some minor stylistic issues