# NousResearch/hermes-agent · Non-destructive state.db repair safety fixes

## Open now

- Nothing open on GitHub.

A cluster of bugs and fixes addressing how automatic repair of state.db handles errors, ensuring canonical data is not destroyed during or after an unsuccessful repair attempt. Multiple incremental fixes refine the repair boundary and retry behavior.

## TL;DR

- 6 member(s): 0 open issue(s), 1 closed issue(s), 0 open PR(s), 1 merged PR(s), 4 PR(s) closed without merging.
- A fix was merged to main in PR #93353. Verify it addresses your case.
- **Recommended:** read PR #93353 (and any competing PRs below) before filing. Confirm the merged change covers your symptom.

## Maintainer resolution verdict

- Internal-tracker verdict over this cluster's issue members: `resolved` · deciding PR(s): `pr-93353`. This is distinct from the fix status above. Weigh it yourself.

## How this cluster was grouped

- Link evidence (`STRUCTURAL_SPANNING`): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
- Pairwise link density `0.33`: the share of member pairs that carry a link, counting a structural link in full and a relevance-only link at 0.36. `1.00` means every pair is linked.

## Closed / duplicate issues

- #93064: \[Bug\]: state.db automatic repair can destroy canonical data before proving recovery

## Prior & competing PRs

- **#93353: fix(state): failed state.db repair no longer destroys canonical data; gateway retries failed SessionDB opens (#93064, #93088)**. merged to main · fix tier `verified`
  - maintainer direction: category `merged`; implication `superseded`
  - files: `gateway/readiness.py`, `gateway/run.py`, `gateway/session.py`, `gateway/session_db_recovery.py`, `gateway/status.py`, `hermes_state.py`, `tests/gateway/test_readiness.py`, `tests/gateway/test_session_db_recovery.py`, `tests/test_state_db_repair_non_destructive.py`, `tests/test_state_db_write_durability.py`
- **#87409: fix(state): a failed schema repair must not destroy the database**. closed without merge
  - maintainer direction: category `superseded_by_pr`; implication `superseded`; refs `#93353`, `#93268`
- **#93260: fix(state): complete non-destructive repair boundary**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `#87409`
- **#93268: fix(state): make automatic repair non-destructive**. closed without merge
  - maintainer direction: category `uncategorized`; implication `needs_llm`; refs `650cf3348f8b3912e09da43b8ab96c62d88de2df`, `53390e28404b7f2ef3cc9281e2f63f6ff18ae0b8`, `53390e28404b7f2ef3cc9281e2f63f6ff18ae0b8`, `#87409`, `#87409`, `#93268`
- **#93275: fix(state): repair malformed databases on isolated candidates**. closed without merge
  - maintainer direction: category `implemented_elsewhere`; implication `superseded`; refs `#93353`, `#93268`

## Fix status

- Merged to main in PR #93353 (cited above). No release data is tracked. Verify downstream.
- Fix last verified (merged) `2026-08-24`.
- Subsystem: `hermes_cli/data`