{"repo":"NousResearch/hermes-agent","public_id":"100871","display_label":"SQLite read errors on WSL2/ZFS filesystem edge cases","summary":"These issues and fixes concern SQLite I/O errors and read connection instability encountered in multi-process or WAL-mode scenarios on WSL2 (ext4-on-vhdx) and OpenZFS filesystems. The work spans bug reports, related issue references, and proposed fixes for session and state database read paths.","subsystem":null,"counts":{"members":4,"open_issues":0,"open_issues_distinct":0,"open_prs":0,"closed_issues":1,"merged_prs":1,"attempt_prs":2},"landed_fix":{"status":"merged_to_main","basis":"structural","pr":108082,"merged_at":"2026-09-11T13:23:24+00:00"},"resolution":{"state":"resolved","by":"pr-108082"},"freshness":{"state":"verified","last_verified_at":"2026-09-11T13:23:24+00:00","is_stale":false},"grouping":{"backbone":"STRUCTURAL_SPANNING","link_density":0.5},"fix_edges":[{"issue_number":30816,"pr_number":108082,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false,"pr_merged_at":"2026-09-11T13:23:24+00:00"},{"issue_number":86515,"pr_number":108082,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true,"pr_merged_at":"2026-09-11T13:23:24+00:00"},{"issue_number":100871,"pr_number":108082,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true,"pr_merged_at":"2026-09-11T13:23:24+00:00"},{"issue_number":105567,"pr_number":108082,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true,"pr_merged_at":"2026-09-11T13:23:24+00:00"},{"issue_number":107401,"pr_number":108082,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true,"pr_merged_at":"2026-09-11T13:23:24+00:00"},{"issue_number":108031,"pr_number":108082,"tier":"verified","basis":"closing_ref","confidence":0.95,"recoverable_from_timeline":true,"pr_merged_at":"2026-09-11T13:23:24+00:00"}],"members":[{"kind":"issue","number":100871,"title":"[Bug] Repeated SQLITE_IOERR in SessionDB.get_session read path on WSL2 (ext4-on-vhdx), multi-process, starting at 0.21.0 — WAL stable but DELETE fallback collapses read throughput ~30000x","url":null,"state":"closed"},{"kind":"pr","number":100882,"title":"fix(sessions): keep WSL recovery alive through transient read IOERR","url":null,"state":"closed","close_reason":{"refs":[{"kind":"commit","value":"d956e05e5e","number":0},{"kind":"pr","value":"#108082","number":108082}],"category":"implemented_elsewhere","implication":"superseded"},"merged":false},{"kind":"pr","number":100883,"title":"fix(state): pooled read connections survive transient EIO (WSL2/vhdx, ZFS)","url":null,"state":"closed","close_reason":{"refs":[{"kind":"commit","value":"d956e05e5e","number":0},{"kind":"pr","value":"#108082","number":108082}],"category":"implemented_elsewhere","implication":"superseded"},"merged":false},{"kind":"pr","number":108082,"title":"state.db no longer wedges on a healthy WAL: OpenZFS/close() false DeletedWalGenerationError, unconfirmed-WAL read pool, transient read IOERR, stale lock banner (#107401 #105567 #86515 #100871 #108031, salvage #107411 #105578 #105711 #106958)","url":null,"state":"merged","close_reason":{"category":"merged"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["agent/turn_explainers.py","contributors/emails/[redacted:email]","contributors/emails/nikkoxgonzales@users.noreply.github.com","gateway/run_notifications.py","hermes_state.py","hermes_state_dbfile.py","hermes_state_errors.py","hermes_state_readpool.py","hermes_state_wal.py","tests/gateway/test_session_db_warning_recheck.py","tests/hermes_state/test_deleted_wal_generation_guard.py","tests/hermes_state/test_read_path_transient_ioerr.py","tests/hermes_state/test_wal_active_confirmed.py","tests/run_agent/test_turn_completion_explainer.py","tests/test_hermes_state_wal_fallback.py"]}],"trust":{"default_tier":"verified","includes_suggested":false}}