dsh-session-health

DSH session files use a multi-frame zstd format for storage, but standard decoders often only read the first frame, leading to misjudgments like empty or corrupted sessions. This creates challenges for troubleshooting and automated management. The dsh-session-health plugin addresses this pain point by performing independent frame-level scanning to analyze the internal structure of session files, identifying issues such as tearing, corruption, empty sessions, or oversized frames, and outputting clear health reports with actionable cleanup suggestions.

The plugin's core strength lies in its safe and thorough diagnostic approach. It strictly adheres to a read-only principle, never modifying any files, ensuring zero risk during diagnosis. It also employs path containment and real-path checks to prevent security issues like directory traversal. For deeper insights, an optional deep mode attempts to decode session headers and event structures, providing richer analysis when available. All results are presented in structured JSON, making it easy to integrate into monitoring or operational workflows.

Whether you're a DSH system administrator needing to regularly check session file health to prevent issues, a developer debugging session persistence bugs and seeking quick anomaly detection, or an AI model requiring assessment of session data completeness in automated tasks, this plugin offers reliable support. It transforms session health checking from ad-hoc scripts into a repeatable, trustworthy tool.