dev(hansbug): Upgrade documentation system with automated RST generation and add Claude Code guidance

[HansBug]

Summary

This PR introduces significant improvements to the documentation infrastructure and developer experience:

• Automated Documentation Build System: Implemented automated RST (reStructuredText) generation scripts (auto_rst.py and auto_rst_top_index.py) that streamline the documentation build process and ensure consistency across all API documentation files
• Comprehensive Docstring Rebuild: Regenerated all Python docstrings across the entire codebase using GPT-5.2-Codex via make docs_auto, resulting in improved documentation quality, consistency, and completeness for all 264 modified files
• Claude Code Integration: Added CLAUDE.md to provide future Claude Code instances with essential commands, architecture overview, and development workflow guidance, improving AI-assisted development efficiency
• Enhanced Documentation Structure: Reorganized documentation files to better reflect the modular structure of the codebase, with improved navigation and clearer API documentation hierarchy

Changes Overview

Documentation Infrastructure (New Files)

• auto_rst.py (477 lines): Automated RST file generation from Python source files
• auto_rst_top_index.py (77 lines): Automated top-level index generation for API documentation
• docs/source/api_doc.rst (23 lines): New top-level API documentation index

Developer Experience

• CLAUDE.md (122 lines): Comprehensive guide for Claude Code with:
  • Essential commands (testing, documentation, building)
  • Architecture overview of all 21 modules
  • Development workflow and code style guidelines
  • Running single tests and coverage commands

Build System

• Updated Makefile with new targets for automated RST generation (rst_auto)
• Enhanced documentation build workflow with better automation support

Documentation Quality

• 264 files changed with improved docstrings across all modules:
  • hbutils/algorithm/ - Algorithm implementations
  • hbutils/binary/ - Binary I/O utilities
  • hbutils/collection/ - Data structures and sequence manipulation
  • hbutils/color/ - Color model calculations
  • hbutils/concurrent/ - Concurrency utilities
  • hbutils/config/ - Package metadata
  • hbutils/design/ - Design patterns
  • hbutils/encoding/ - Encoding and hashing
  • hbutils/expression/ - Function composition
  • hbutils/file/ - File stream management
  • hbutils/logging/ - Enhanced logging
  • hbutils/model/ - Class enhancement decorators
  • hbutils/random/ - Random generation utilities
  • hbutils/reflection/ - Object introspection
  • hbutils/scale/ - Scaled value parsing
  • hbutils/string/ - String processing
  • hbutils/system/ - OS and filesystem operations
  • hbutils/testing/ - Testing utilities

Configuration Updates

• Updated .gitignore to exclude .claude directory and .llmconfig.yaml
• Added requirements-dev.txt with development dependencies

Statistics

• 264 files changed
• 9,688 insertions(+)
• 4,872 deletions(-)
• Net change: +4,816 lines

Key Benefits

1. Improved Documentation Maintainability: Automated RST generation reduces manual effort and ensures consistency
2. Better AI-Assisted Development: Claude Code guidance enables more efficient collaboration with AI tools
3. Enhanced Code Quality: Comprehensive docstring updates improve code readability and API understanding
4. Streamlined Workflow: New Makefile targets simplify documentation generation and maintenance

Test Plan

• Verify documentation builds successfully with make docs
• Confirm RST auto-generation works with make rst_auto
• Check that all module documentation is accessible and properly formatted
• Validate that existing tests still pass with make unittest
• Review CLAUDE.md for accuracy and completeness
• Ensure .gitignore properly excludes .claude directory

Breaking Changes

None. This PR is purely additive and improves documentation infrastructure without changing any public APIs or functionality.

[codecov]

Codecov Report

❌ Patch coverage is 99.47507% with 2 lines in your changes missing coverage. Please review.
✅ Project coverage is 96.94%. Comparing base (e684860) to head (5812456).
⚠️ Report is 5 commits behind head on main.

Files with missing lines	Patch %	Lines
hbutils/concurrent/parallel.py	90.00%	1 Missing ⚠️
hbutils/encoding/int_hash.py	75.00%	1 Missing ⚠️

Additional details and impacted files

@@            Coverage Diff             @@
##             main     #125      +/-   ##
==========================================
- Coverage   96.99%   96.94%   -0.06%     
==========================================
  Files         121      121              
  Lines        4497     4515      +18     
==========================================
+ Hits         4362     4377      +15     
- Misses        135      138       +3     

Flag	Coverage Δ
unittests	96.94% <99.47%> (-0.06%)	⬇️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.