feat: improve cache invalidation and refresh consistency

[ash1shkumar]

Improve Cache Refresh Consistency

Description

This PR improves cache refresh reliability by aligning cache lifecycle behavior with underlying data mutations and introducing validation metadata for refresh consistency checks.

Changes Made

• Added cache consistency metadata generation.
• Added refresh verification tracking.
• Improved cache lifecycle visibility in insights responses.
• Exposed cache validation information through API responses.
• Enhanced stale-data detection support.
• Improved refresh handling diagnostics.
• Added consistency guarantees for cached insight data.

Impact

• More reliable cache refresh behavior.
• Reduced risk of stale data being displayed.
• Better observability for cache invalidation events.
• Improved consistency between data updates and cache state.

Testing

• Verified overview insights API response.
• Verified task insights API response.
• Confirmed cache metadata is returned correctly.
• Confirmed refresh verification data is included.

Fixes #376

Expected Labels

level3, NSoC'26

[vercel]

@ash1shkumar is attempting to deploy a commit to the shreemp194-gmailcom's projects Team on Vercel.

A member of the Team first needs to authorize it.

[github-actions]

👋 Thank you for opening this pull request! I will review your changes and assist you soon.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
flow-forge	Ready	Preview, Comment	Jun 15, 2026 4:43pm