readme edits
json-output: cleanup for better interactive consistency