{"repo":"NousResearch/hermes-agent","public_id":"103339","display_label":"Single-writer flock gate for state.db WAL safety","summary":"A reported bug and associated fix proposal address concurrent write access to state.db, where a second process (such as doctor --fix or schema repair) can corrupt the write-ahead log. The proposed mitigation is a lazy flock-based single-writer gate to serialize access.","subsystem":null,"counts":{"members":3,"open_issues":0,"open_issues_distinct":0,"open_prs":0,"closed_issues":1,"merged_prs":1,"attempt_prs":1},"landed_fix":{"status":"merged_to_main","basis":"structural","pr":110914,"merged_at":"2026-09-14T15:50:31+00:00"},"resolution":{"state":"unresolved","by":null},"freshness":{"state":"verified","last_verified_at":"2026-09-14T15:50:31+00:00","is_stale":false},"grouping":{"backbone":"STRUCTURAL_SPANNING","link_density":0.6666666666666666},"fix_edges":[{"issue_number":103339,"pr_number":110914,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false,"pr_merged_at":"2026-09-14T15:50:31+00:00"},{"issue_number":109786,"pr_number":110914,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false,"pr_merged_at":"2026-09-14T15:50:31+00:00"}],"members":[{"kind":"issue","number":103339,"title":"[Bug] Second writer via `doctor --fix` / `repair_state_db_schema` / hosted_rooms still corrupts live-WAL state.db — upstream guards are fail-open; proposing a lazy flock single-writer gate (field-verified)","url":null,"state":"closed"},{"kind":"pr","number":109270,"title":"fix(state): implement lazy flock single-writer gate to prevent WAL corruption","url":null,"state":"closed","close_reason":{"refs":[{"kind":"commit","value":"9b419a2d3c","number":0},{"kind":"pr","value":"#110914","number":110914},{"kind":"pr","value":"#103339","number":103339}],"category":"implemented_elsewhere","implication":"superseded"},"merged":false},{"kind":"pr","number":110914,"title":"state.db maintenance from a second process refuses any live holder (doctor --fix checkpoint, schema repair; #103339 item 2)","url":null,"state":"merged","close_reason":{"category":"merged"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["hermes_cli/doctor_state.py","hermes_state_holders.py","hermes_state_repair.py","tests/hermes_cli/test_doctor_wal_checkpoint_guard.py","tests/hermes_state/test_state_db_malformed_repair.py","tests/hermes_state/test_state_db_repair_non_destructive.py","tests/hermes_state/test_state_db_second_process_maintenance.py"]}],"trust":{"default_tier":"verified","includes_suggested":false}}