KiCad - the KiCad Bridge

@@ -37,6 +37,44 @@ KICAD_SYMBOL_EDITOR_CMD_ID = 20011  # Project Manager > Tools > Symbol Editor SW_RESTORE = 9 GW_OWNER = 4 ++def _symbol_on_disk_but_not_in_editor(kicad_info: dict, name: str) -> bool:+    """True when `name` IS in the Adom library file but a Symbol Editor that+    opened earlier cannot see it.++    A Symbol Editor builds its library tree once, at open. Symbols added to+    Adom.kicad_sym after that are invisible to it until it reopens, which looks+    exactly like a failed background search and is the reason 0.9.192 stopped+    reporting it as one. Only the disk half is checked here: the caller reaches+    this after both background attempts already failed to find it in the tree."""+    if not name:+        return False+    try:+        import adom_library+        paths = adom_library._get_paths(kicad_info)+        if not paths:+            return False+        _table, lib_path = paths+        return name.lower() in {s.lower() for s in adom_library.list_symbols(lib_path)}+    except Exception:+        return False+++def _close_symbol_editor(hwnd: int) -> bool:+    """Ask an open Symbol Editor to close, so the next open re-indexes the+    libraries. WM_CLOSE, not a kill: KiCad gets to run its own shutdown (and to+    put up a save prompt, which the caller will see in the next screenshot)."""+    WM_CLOSE = 0x0010+    try:+        user32.PostMessageW(hwnd, WM_CLOSE, 0, 0)+    except Exception:+        return False+    for _ in range(24):  # up to ~12s for KiCad to tear the frame down+        time.sleep(0.5)+        if not user32.IsWindow(hwnd):+            return True+    return False+ if IS_WINDOWS:     user32 = ctypes.windll.user32     kernel32 = ctypes.windll.kernel32@@ -391,8 +429,10 @@ def handle_open_symbol_editor(kicad_info: dict, args: dict) -> dict:     symbol_name = args.get("symbolName", "")     library_name = args.get("libraryName", "") -    # Check if the symbol is already loaded in the Symbol Editor-    if symbol_name:+    # Check if the symbol is already loaded in the Symbol Editor.+    # rescan:true skips this: the caller is asking for a re-index precisely+    # because they do not trust what this editor currently has.+    if symbol_name and not args.get("rescan"):         sym_hwnd = _find_symbol_editor()         if sym_hwnd:             windows = _find_windows_by_title("Symbol Editor")@@ -408,6 +448,20 @@ def handle_open_symbol_editor(kicad_info: dict, args: dict) -> dict:      sym_hwnd = _find_symbol_editor()     pathways_tried: list[str] = []+    rescanned = False++    # 0.9.192: rescan:true is the remedy for errorCode library_cache_stale. An+    # editor only indexes its libraries at open, so the ONLY way to make it see a+    # newly installed symbol is to close it and let the flow below open a fresh+    # one. Opt-in, because it closes a window the user may be working in and+    # costs the cold library-index time (#35).+    if sym_hwnd and args.get("rescan"):+        if _close_symbol_editor(sym_hwnd):+            rescanned = True+            sym_hwnd = 0+            pathways_tried.append("rescan-closed-stale-editor")+        else:+            pathways_tried.append("rescan-close-failed")      if not sym_hwnd:         # Phase 3 Tier 1: try the reverse bridge first. Two sub-paths@@ -636,6 +690,7 @@ def handle_open_symbol_editor(kicad_info: dict, args: dict) -> dict:             "success": True,             "output": f"Symbol '{search_text}' loaded (background win32 path): {_get_symbol_editor_title()}",             "via": "win32-background",+            "rescanned": rescanned,         }      # BACKGROUND-FIRST CONTRACT (John, 2026-08-14): the win32 tier above is the@@ -657,17 +712,42 @@ def handle_open_symbol_editor(kicad_info: dict, args: dict) -> dict:                       f"{_get_symbol_editor_title()}",             "via": "win32-background",             "attempts": 2,+            "rescanned": rescanned,         }      if not args.get("allowFocusSteal"):+        # 0.9.192: before blaming the search tier, ask whether the symbol is even+        # in the editor's world. A Symbol Editor indexes its libraries ONCE when+        # it opens; a symbol added to Adom.kicad_sym afterwards is on disk but+        # not in that editor's tree, so no amount of filtering will ever find it.+        # Reproduced live: RP2040 (present when the editor opened) loads first+        # try; COL0-TEST, installed minutes later, fails forever. Reporting that+        # as "didn't load in the background" sends the caller to retry a call+        # that cannot succeed.+        stale = _symbol_on_disk_but_not_in_editor(kicad_info, symbol_name or search_text)+        if stale:+            return {+                "success": False, "editorOpened": True, "symbolLoaded": False,+                "attempts": 2,+                "errorCode": "library_cache_stale",+                "error": f"'{search_text}' exists in the Adom library on disk but the open "+                         f"Symbol Editor cannot see it: that editor indexed its libraries when "+                         f"it opened, before this symbol was added "+                         f"(title: {_get_symbol_editor_title() or 'unknown'})",+                "_hint": ("This is not a search-timing failure and retrying will never fix it. "+                          "The Symbol Editor has to re-index, which only happens when it opens. "+                          "Close the Symbol Editor and call again, or pass rescan:true to have "+                          "the bridge close and reopen it for you (that costs the cold "+                          "library-index time, roughly a minute - wiki issue #35)."),+            }         return {             "success": False, "editorOpened": True, "symbolLoaded": False,             "attempts": 2,             "error": f"Symbol Editor open but '{search_text}' didn't load in the background "                      f"after two attempts (title: {_get_symbol_editor_title() or 'unknown'})",             "_hint": ("Two background attempts did not confirm, so a third is unlikely to "-                      "help - check that the symbol really exists in this library "-                      "(kicad_list_symbols). The keystroke fallback "+                      "help - check that the symbol really exists in this library. "+                      "The keystroke fallback "                       "is disabled by default because it needs to foreground the window (rude while "                       "you're typing) — pass allowFocusSteal:true ONLY if you accept a focus grab, "                       "or foreground:true to bring the editor to you and load it yourself."),