dsh-session-doctor

DSH session logs are the sole medium through which humans and the system exchange memory, yet a systemic gap exists: the write path never validates message shape, so a tool-result content written as a bare string produces no error until the next load, where it surfaces as a SessionPersistenceCorruptionError that makes the entire history unavailable. dsh-session-doctor plugs this write-without-validation, explode-at-load crack.

Three capabilities work together: scan validates every frame using the same rules as the DSH loader, reporting corrupted sessions with line numbers, seq, and cause; repair losslessly wraps confirmed string-content defects (backup, frame-level rewrite, zero-fail re-verification before commit); watch (v1.1) subscribes to live session events and alerts on violations the moment they are written, catching problems before the next load. It fixes only one confirmed defect, reports all others without touching them, and has zero runtime dependencies.

Who should use it: DSH users seeing history unavailable errors can run scan and repair to restore their sessions; power users worried about third-party plugins corrupting records can enable watch for real-time sentinels; developers auditing render-contract violations can run the bundled audit script.