Module hints 

Cache Hints Parser

Parses SQL comments to extract cache control hints.

Supported Hints

/* helios:cache=skip */          -- Skip caching entirely
/* helios:cache_ttl=60 */        -- Override TTL (seconds)
/* helios:cache=semantic */      -- Enable semantic caching
/* helios:cache_tables=a,b */    -- Override table dependencies
/* helios:cache_refresh */       -- Force cache refresh

Structs

CacheHint

Parsed cache hints from a SQL query

Enums

CacheLevelHint

Hint for specific cache level

Functions

is_cacheable_query

Check if a query is cacheable (SELECT, VALUES, etc.)

is_write_operation

Check if SQL is a write operation (for cache invalidation)

parse_cache_hints

Parse cache hints from a SQL query

strip_hints

Strip cache hints from SQL query