docs: rewrite README for two-table architecture

Updated for events/gauges split, event-specific columns,
daily MV, query-time aggregation, billing methods, and
complete API reference with examples.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: lohanidamodar