{"repo":"NousResearch/hermes-agent","public_id":"102198","display_label":"state.db page-0 corruption during graceful shutdown","summary":"A bug where cron or deferred workers write to state.db after SIGTERM can corrupt its first page, causing 'file is not a database' on next start. Related work addresses quiescing background workers before DB close and quarantining already-corrupted databases instead of opening them destructively.","subsystem":null,"counts":{"members":5,"open_issues":0,"open_issues_distinct":0,"open_prs":0,"closed_issues":1,"merged_prs":2,"attempt_prs":2},"landed_fix":{"status":"merged_to_main","basis":"structural","pr":106587},"resolution":{"state":"unresolved","by":null},"freshness":{"state":"verified","last_verified_at":"2026-09-19T18:57:44+00:00","is_stale":false},"grouping":{"backbone":"STRUCTURAL_SPANNING","link_density":0.4},"fix_edges":[{"issue_number":102198,"pr_number":106587,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false},{"issue_number":102198,"pr_number":116296,"tier":"verified","basis":"superseded_ref","confidence":0.9,"recoverable_from_timeline":false}],"members":[{"kind":"issue","number":102198,"title":"[Bug] state.db page 0 clobbered by a write ~0.9s after SIGTERM during graceful shutdown → \"file is not a database\" on next start","url":null,"state":"closed"},{"kind":"pr","number":102212,"title":"fix(state): quarantine invalid state db header","url":null,"state":"closed","close_reason":{"refs":[{"kind":"commit","value":"d15c61b5dc","number":0},{"kind":"pr","value":"#106587","number":106587},{"kind":"pr","value":"#102198","number":102198},{"kind":"pr","value":"#106587","number":106587}],"category":"superseded_by_pr","implication":"superseded"},"merged":false},{"kind":"pr","number":102219,"title":"run: quiesce cron/deferred workers before DB close to prevent page-0 corruption","url":null,"state":"closed","close_reason":{"refs":[{"kind":"pr","value":"#116296","number":116296},{"kind":"pr","value":"#102198","number":102198}],"category":"merged_via","implication":"superseded"},"merged":false},{"kind":"pr","number":106587,"title":"A state.db with a clobbered first page is quarantined with its WAL instead of opened destructively (refs #102198, salvage #102212)","url":null,"state":"merged","close_reason":{"category":"merged","implication":"superseded"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["hermes_state.py","hermes_state_dbfile.py","tests/test_zeroed_state_db.py"]},{"kind":"pr","number":116296,"title":"Gateway shutdown no longer closes state.db under a live cron or API-server writer (#102198, salvage #102219)","url":null,"state":"merged","close_reason":{"category":"merged","implication":"superseded"},"merged":true,"is_fix_pr":true,"fix_tier":"verified","files_changed":["gateway/run_shutdown.py","tests/gateway/test_shutdown_executor_quiesce.py"]}],"trust":{"default_tier":"verified","includes_suggested":false}}