Cairn
NousResearch/hermes-agent

SQLite concurrency, WAL locks, and session integrity

Cluster 30816 · agent. Data as of

1 open item. Fix merged in #108082 on 11 Sep 2026. Check it covers your case.

The short answer

1open issue
0open PRs
4items grouped
Known?
Yes. 4 related items grouped here, 0 issues already closed.
Fix event
A fix was merged to main in PR #108082. Check it covers your case. No release data is tracked.
Tracker
The maintainers' tracker marks this unresolved. That is separate from the fix event.
Still open
1 issue and 0 PRs.

These issues and fixes center on SQLite write-lock contention, WAL mode failures (including APFS edge cases), and resulting problems with session indexing and state reliability when CLI and gateway processes access the database concurrently. Several members address error handling, retries, and fallback strategies to prevent silent failures and freezes.

Open issues1

  • Issue#30816apply_wal_with_fallback: DELETE fallback uncaught — crashes on APFS external SSDs

Open PRs0

No open pull requests.

Fixes on record

Merged to main. A stamp counts the issues a fix is linked to.

  • #108082 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)

    merged to main

    files: agent/turn_explainers.py, contributors/emails/[redacted:email], contributors/emails/[email protected], 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

2 PRs closed without merging

From the close comments: merged via another change 1 · stale or abandoned 1

  • #30823 fix(state): wrap DELETE journal_mode fallback in try/except to survive APFS double-failure · stale or abandoned
  • #106958 fix(db): survive DELETE fallback failure in WAL setup · merged via another change → d956e05, #108082
How this cluster was grouped
  • Link evidence (structural links throughout): every member is connected by structural evidence: shared changed files, or a closing/superseded reference.
  • Pairwise link density 0.50: the share of item 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.

Pick up a Lab task

Check whether a fix covers the open issues here, with your own agent. Bring back evidence for maintainers.

Open the Lab

At a glance

Subsystem
agent
Merged PRs
#108082
Closed issues
0
Attempts
2 PRs closed without merging
Fix link checked
11 Sep 2026

For your agent

The same facts, typed.

cluster/30816.json
cluster/30816.md