docs: document Phase 2A comment query API implementation master
Add comprehensive documentation for comment system Phase 2A: Overview: - Complete guide from indexing (Phase 1) through query API (Phase 2A) - Implementation dates: November 4-5, 2025 - 30+ integration tests, all passing - ~4,575 total lines of code Phase 2A documentation: - Lexicon definitions (defs.json, getComments.json) - Database layer with Lemmy hot ranking algorithm - Service layer with iterative loading strategy - HTTP handlers with optional authentication - 11 integration test scenarios Hot ranking algorithm section: - Full SQL formula with explanation - Component breakdown (greatest, power, offsets) - Sort modes (hot/top/new) with examples - Path-based ordering for tree structure - Behavioral characteristics Future phases: - Phase 2B: Vote integration (2-3 hours) - Phase 2C: Post/user integration (2-3 hours) - Phase 3: Advanced features (5 sub-phases) - Distinguished comments - Search & filtering - Moderation tools - Notifications - Enhanced features - Phase 4: Namespace migration (separate task) Implementation statistics: - Phase 1: 8 files created, 1 modified (~2,175 lines) - Phase 2A: 9 files created, 6 modified (~2,400 lines) - Combined total: ~4,575 lines Command reference: - Separate test commands for Phase 1 and Phase 2A - Build and migration instructions - Environment variable setup 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>