---
name: hydration-mismatch-forensics
description: Debug and resolve complex hydration mismatches that cause UI thrashing and content layout shifts.
---

# Hydration Mismatch Forensics

## Summary
Debug and resolve complex hydration mismatches that cause UI thrashing and content layout shifts.

## Key Capabilities
- Identify distinct mismatch types (text, attribute, structure).
- Trace server-client state divergence sources (Time, Randomness).
- Implement suppression and recovery strategies for unavoidable mismatches.

## PhD-Level Challenges
- Analyze the performance cost of hydration patching.
- Detect deeper mismatches in third-party library output.
- Automate mismatch detection in CI pipelines.

## Acceptance Criteria
- Deliver a mismatch-free console in production builds.
- Demonstrate automated detection of new mismatches.
- Document common mismatch patterns and fixes.