Files
hermes-agent/tests/hermes_state/test_no_more_rows_retry.py
teknium1 d10bb2ab6f test: make tests/ mirror the source tree; drop issue numbers from filenames
`scripts/run_tests.sh tests/<dir>/` is how a change gets its regression
coverage run, so a test filed under the wrong directory is a test nobody
runs when that code changes. Two kinds of drift had accumulated.

Parallel directories for one source package, folded into the mirror:
  tests/acp        -> tests/acp_adapter   (its __init__/conftest move with it)
  tests/cli        -> tests/hermes_cli    (prompt_toolkit fixture merged into
                                           hermes_cli/conftest.py)
  tests/run_agent  -> tests/agent         (backoff fixture becomes
                                           agent/conftest.py)
  tests/relay      -> tests/gateway/relay
  tests/state      -> tests/hermes_state

246 loose files at tests/ root, routed by the package they import/patch:
hermes_cli, hermes_state, agent, gateway, tools, plugins, tui_gateway, cron.
Installer and desktop-update script tests go to tests/scripts/{install,
desktop_update}/. 43 tests of root-level modules (batch_runner, utils,
hermes_constants, packaging) stay at the root.

Filenames drop their issue numbers (95 files: test_89315_x.py -> test_x.py);
the number stays in the module docstring where it has context.

Collisions: test_cli_skin_integration.py existed in both tests/ and tests/cli
with different subsets — merged into one (10 tests, all kept);
run_agent/test_pre_compress_memory_context.py -> agent/..._handoff.py;
tests/test_account_usage.py -> agent/test_account_usage_fetch.py;
tests/test_web_server.py -> hermes_cli/test_web_server_ws_ping.py.
Deleted: test_minisweagent_path.py (empty since PR #2804),
test_model_picker_scroll.py (tested a private copy of the logic, imported
nothing), test_process_loop_event_loop_warning.py (asserted asyncio behaviour,
imported nothing from Hermes).

Repo-root path arithmetic (Path(__file__).parents[N], dirname chains) is
bumped for the 202 files that changed depth and verified by evaluating every
such expression against the new location. classify_changes' desktop-updater
lane prefix, tests-os.yml's ignore glob and every in-tree path comment follow
the moves. tests/test_tests_tree_layout.py keeps the tree from drifting back.
2026-09-13 09:18:02 -07:00

93 lines
3.6 KiB
Python

"""Retry of transient 'no more rows available' engine errors (#74934 port).
Under dual gateway/agent WAL contention (FTS5 trigram sync holding the
write lock on large appends), the SQLite engine can raise a transient
'no more rows available' error. The exception CLASS varies with the
SQLite build — some surface it as ``sqlite3.InterfaceError``, which is a
sibling of ``DatabaseError`` (not a subclass) and therefore escaped both
existing retry branches in ``_execute_write`` on attempt 0, killing the
turn as ``session_persistence_failed`` while the identical write would
have succeeded milliseconds later.
The fix is message-scoped, not class-scoped: any ``sqlite3.Error`` whose
text contains 'no more rows available' retries within the existing
deadline/patience loop; every other error propagates untouched.
"""
import sqlite3
import pytest
from hermes_state import SessionDB
@pytest.fixture
def db(tmp_path, monkeypatch):
# Keep retries fast: tiny jitter, short-but-sufficient patience.
monkeypatch.setattr(SessionDB, "_WRITE_PATIENCE_S", 2.0)
monkeypatch.setattr(SessionDB, "_WRITE_RETRY_MIN_S", 0.001)
monkeypatch.setattr(SessionDB, "_WRITE_RETRY_MAX_S", 0.005)
d = SessionDB(db_path=tmp_path / "state.db")
yield d
d.close()
class TestNoMoreRowsRetry:
def test_transient_interface_error_is_retried_to_success(self, db):
"""InterfaceError('no more rows available') must be retried inside
the deadline/patience loop and succeed once the contention clears."""
calls = {"n": 0}
def flaky(conn):
calls["n"] += 1
if calls["n"] <= 3:
raise sqlite3.InterfaceError("no more rows available")
conn.execute(
"INSERT INTO state_meta (key, value) VALUES ('nmr', 'ok') "
"ON CONFLICT(key) DO UPDATE SET value=excluded.value"
)
return "done"
assert db._execute_write(flaky) == "done"
assert calls["n"] == 4
assert db.get_meta("nmr") == "ok"
def test_unrelated_interface_error_propagates_immediately(self, db):
"""The catch-all is message-scoped: an InterfaceError with any other
text must escape on the first attempt, not be swallowed/retried."""
calls = {"n": 0}
def broken(conn):
calls["n"] += 1
raise sqlite3.InterfaceError("bad parameter or other API misuse")
with pytest.raises(sqlite3.InterfaceError, match="bad parameter"):
db._execute_write(broken)
assert calls["n"] == 1
def test_no_more_rows_via_database_error_is_retried(self, db):
"""Some builds raise the same transient message through the generic
DatabaseError class — it must ride the same retry loop instead of
being misrouted into the FTS-corruption rebuild path."""
calls = {"n": 0}
def flaky(conn):
calls["n"] += 1
if calls["n"] <= 2:
raise sqlite3.DatabaseError("no more rows available")
return "ok"
assert db._execute_write(flaky) == "ok"
assert calls["n"] == 3
def test_exhausted_patience_propagates_the_transient_error(self, db, monkeypatch):
"""If contention never clears within the patience budget, the
original error must surface rather than looping forever."""
monkeypatch.setattr(SessionDB, "_WRITE_PATIENCE_S", 0.05)
def always(conn):
raise sqlite3.InterfaceError("no more rows available")
with pytest.raises(sqlite3.InterfaceError, match="no more rows"):
db._execute_write(always)