feat: add entity analytics, pluggable cache, and pitfalls docs
- Add Cache interface with MemoryCache and NoopCache implementations
- Make SocialhoseClient accept injectable cache option
- Remove Next.js next.revalidate coupling from transport
- Add entity analytics: getEntityBrief, getEntityStats, getEntityBriefs,
getCampaignIdByMatch with exact sentiment/platform faceting and
cumulative-differenced timeline
- Add 23 new tests (29 total) covering entity analytics, cache injection,
sentiment reconciliation, bounded concurrency, and timeline differencing
- Update README with entity analytics, custom caching, and pitfalls sections
- Fix CI branch: main -> master
Mo Elzubeir
252ea713b1