From a7421dc7d2f0659a016092db6fc154526c8734b3 Mon Sep 17 00:00:00 2001
From: teknium1 <127238744+teknium1@users.noreply.github.com>
Date: Fri, 29 May 2026 19:52:09 -0700
Subject: [PATCH] fix(session): point no-FTS5 warning at the supported install

When FTS5 is missing the warning now explains the likely cause (an
unsupported / pip-managed Python whose bundled SQLite lacks FTS5) and
links the supported install at hermes-agent.nousresearch.com, instead
of just logging the raw error.
---
 hermes_state.py | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/hermes_state.py b/hermes_state.py
index 71a89a286..19f207632 100644
--- a/hermes_state.py
+++ b/hermes_state.py
@@ -736,7 +736,13 @@ class SessionDB:
                 if "fts5" not in err and "no such module" not in err:
                     raise
                 logger.warning(
-                    "SQLite FTS5 unavailable for %s; full-text search disabled: %s",
+                    "SQLite FTS5 unavailable for %s; full-text session search "
+                    "disabled. This usually means Hermes is running on an "
+                    "unsupported install (e.g. a pip-installed or pip-managed "
+                    "Python whose bundled SQLite lacks FTS5) rather than a "
+                    "mainline install. Some features may be missing or behave "
+                    "differently. Install the supported way: "
+                    "https://hermes-agent.nousresearch.com (underlying error: %s)",
                     self.db_path,
                     fts_exc,
                 )