[tools] polish package.json before publishing
readme updates