Audit or rewrite a GitHub README against the repository itself. Maps source-of-truth files, verifies documentation claims with safe command evidence, labels untested and contradicted paths, produces a corrected README, and runs a final honesty audit so polished text is never mistaken for observed behaviour.