Refresh a repository README so it matches current package metadata, public APIs, examples, configuration, workflows, and validation commands. Use when README content is stale, incomplete, or inconsistent with code.
