Caching - PilotWatt

Stub — intended for contributors and technical readers.

PilotWatt uses Upstash Redis (not in-process memory) so serverless instances share cache.

Key pattern	TTL	Contents
`foxess:state:{userId}`	5 min	Live energy state
`octopus:rates`	30 min	Agile slots (shared)
`solar:forecast:{userId}`	1 h	Hourly radiation + kWh
`earnings:*:{userId}`	30 min – 7 d	Today/month/slot aggregates
`earnings:summary:v1:{userId}:{YYYY-MM}`	30 min	Home hero monthly summary
`settings:public:{userId}`	5 min	Non-secret settings only

Never cached: decrypted FoxESS / Octopus credentials. Source of truth: lib/infrastructure/cache.ts.

⌘I