fix(rag): coalesce _sync_rag_engine calls via token + dirty flag

src/app_controller.py

@@ -800,6 +800,9 @@ class AppController:
   self._pending_dialog_lock:       threading.Lock = threading.Lock()
   self._api_event_queue_lock:      threading.Lock = threading.Lock()
   self._rag_engine_lock:           threading.Lock = threading.Lock()
+  self._rag_sync_token:            int = 0
+  self._rag_sync_dirty:            bool = False
+  self._rag_sync_lock:             threading.Lock = threading.Lock()
   self._project_switch_lock:       threading.Lock = threading.Lock()
   self._project_switch_in_progress: bool = False
   self._project_switch_pending_path:  Optional[str] = None
@@ -1457,26 +1460,30 @@ class AppController:
  def rag_enabled(self) -> bool:
   return self.rag_config.enabled if self.rag_config else False
 
- def _sync_rag_engine(self):
-  """
-  Re-initializes the RAG engine in a background thread to avoid blocking the UI.
-  """
-  self._set_rag_status("initializing...")
-  def _task():
+ def _sync_rag_engine(self) -> None:
+  """Coalesces multiple rapid setter calls into a single engine rebuild. The token + dirty flag pattern ensures that N setters in quick succession produce ONE sync, not N parallel syncs."""
+  with self._rag_sync_lock:
+   self._rag_sync_token += 1
+   self._rag_sync_dirty = True
+   token = self._rag_sync_token
+  self.submit_io(lambda: self._do_rag_sync(token))
+
+ def _do_rag_sync(self, token: int) -> None:
+  """Worker for the coalesced RAG sync. Loops if new setters arrive mid-sync, returns early if a newer sync supersedes us."""
+  while True:
+   with self._rag_sync_lock:
+    if token != self._rag_sync_token:
+     return
+    self._rag_sync_dirty = False
+   self._set_rag_status("initializing...")
    try:
     from src import rag_engine
     engine = rag_engine.RAGEngine(self.rag_config, self.active_project_root)
-    # If the engine's embedding provider failed to initialize
-    # (e.g. local embedding but sentence-transformers not installed),
-    # the engine is in a broken state even though __init__ returned.
-    # Surface this as an error instead of reporting 'ready' (which
-    # would let the user trigger RAG queries that silently fail).
     if engine.embedding_provider is None:
      self._set_rag_status("error: RAG embedding provider failed to initialize (e.g. missing dependencies)")
      return
     with self._rag_engine_lock:
      self.rag_engine = engine
-    # If the engine is empty and we have files, trigger indexing
     if self.rag_engine and self.rag_engine.is_empty() and self.files:
      self._rebuild_rag_index()
     else:
@@ -1485,8 +1492,11 @@ class AppController:
     self._set_rag_status(f"error: {e}")
     sys.stderr.write(f"[DEBUG RAG] Failed to sync engine: {e}\n")
     sys.stderr.flush()
-
-  self.submit_io(_task)
+   with self._rag_sync_lock:
+    if not self._rag_sync_dirty:
+     return
+    token = self._rag_sync_token
+    self._rag_sync_dirty = False
 
  @property
  def rag_enabled(self) -> bool: