CorrelationContext class

Manages correlation IDs for tracking operations across the application.

Correlation IDs help trace a single user action or request through multiple layers of the application (intents, state changes, effects, etc.).

This is particularly useful for:

• Debugging complex flows
• Tracing user actions in logs
• Correlating errors with their originating actions
• Performance monitoring

Example usage:

// At the start of a user action:
await CorrelationContext.runWithCorrelation(() async {
  // All code here will have access to the same correlation ID
  await controller.intent(LoginIntent());
});

// In any part of the code:
final id = CorrelationContext.current;
logger.info('Processing login', context: {'correlationId': id});