Prepare for crates.io publish

Add publish metadata (description, repository, homepage, documentation,
keywords, categories), include directive, crate-level docs, and README
badges.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>