add analytics query command with metrics/dimensions registry

[jdwit]

what

raw query engine for the youtube analytics api, plus self-documenting metrics/dimensions registry.

analytics query

direct access to the reports.query endpoint with full control over metrics, dimensions, filters, sorting, and date ranges. three output formats: table, json, csv.

# daily views and likes for the last week
ytstudio analytics query -m views,likes -d day --days 7

# top 10 videos by thumbnail CTR
ytstudio analytics query -m videoThumbnailImpressions,videoThumbnailImpressionsClickRate -d video --sort -videoThumbnailImpressions -n 10

# traffic sources for a specific video
ytstudio analytics query -m views -d insightTrafficSourceType -f video==dMH0bHeiRNg --sort -views

# csv export for spreadsheets
ytstudio analytics query -m views,likes,shares -d day --days 90 -o csv > report.csv

analytics metrics / dimensions

self-documenting registry of all 48 metrics and 25 dimensions from the youtube analytics api. browse by group, inspect individual metrics, get typo suggestions.

ytstudio analytics metrics                    # list all
ytstudio analytics metrics --group engagement # filter by group
ytstudio analytics metrics views              # detail view
ytstudio analytics dimensions --group geographic

registry module

• 48 metrics across 10 groups (views, reach, watch_time, engagement, cards, annotations, revenue, playlist, audience)
• 25 dimensions across 9 groups (time, geographic, content, traffic, playback, device, audience, sharing, ads)
• validation before api calls with fuzzy matching for typo correction
• core/monetary/filter-only flags per entry

tests

22 new tests (39 total for analytics + registry), all passing. lint clean.