docs: rewrite README from source code
Replace the previous README with documentation derived from reading the actual code, including a new section covering the C client (scripts/c/hbc_mini.c). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in: