(null);
+ const listboxId = useId();
+
+ useEffect(() => {
+ if (debounceRef.current !== null) {
+ window.clearTimeout(debounceRef.current);
+ }
+
+ const query = value.trim();
+ if (disabled || !query) {
+ setSuggestions([]);
+ setSuggestionsOpen(false);
+ setHighlightedIndex(-1);
+ return;
+ }
+
+ debounceRef.current = window.setTimeout(() => {
+ abortRef.current?.abort();
+ const controller = new AbortController();
+ abortRef.current = controller;
+
+ fetch("/api/graph/search", {
+ method: "POST",
+ headers: { "Content-Type": "application/json" },
+ body: JSON.stringify({ query, limit: SUGGESTION_LIMIT }),
+ signal: controller.signal,
+ })
+ .then((response) => (response.ok ? response.json() : null))
+ .then((data: { results?: SearchResult[] } | null) => {
+ if (!data) return;
+ setSuggestions(data.results ?? []);
+ setSuggestionsOpen(true);
+ setHighlightedIndex(-1);
+ })
+ .catch((suggestionError: unknown) => {
+ if (suggestionError instanceof DOMException && suggestionError.name === "AbortError") {
+ return;
+ }
+ });
+ }, SUGGESTION_DEBOUNCE_MS);
+
+ return () => {
+ if (debounceRef.current !== null) {
+ window.clearTimeout(debounceRef.current);
+ }
+ };
+ }, [value, disabled]);
+
+ useEffect(() => () => abortRef.current?.abort(), []);
+
+ const closeSuggestions = () => {
+ setSuggestionsOpen(false);
+ setHighlightedIndex(-1);
+ };
+
+ const selectSuggestion = (result: SearchResult) => {
+ setSuggestions([]);
+ closeSuggestions();
+ onSelectSuggestion(result);
+ };
+
return (
);
}
@@ -578,6 +702,7 @@ const HUD_CSS = `
gap: 10px;
}
.explore-search-command {
+ position: relative;
min-width: 0;
height: 43px;
display: grid;
@@ -593,6 +718,50 @@ const HUD_CSS = `
color: ${GRAPH_THEME.ui.text.muted};
box-shadow: inset 0 1px 0 rgba(255,255,255,0.045), 0 14px 30px rgba(0,0,0,0.16);
}
+ .explore-search-suggestions {
+ position: absolute;
+ top: calc(100% + 6px);
+ left: 0;
+ right: 0;
+ z-index: 30;
+ margin: 0;
+ padding: 6px;
+ list-style: none;
+ max-height: 288px;
+ overflow-y: auto;
+ border-radius: 14px;
+ border: 1px solid ${GRAPH_THEME.ui.control.inputBorder};
+ background: ${GRAPH_THEME.ui.surface.cardStrong};
+ box-shadow: 0 18px 40px rgba(0,0,0,0.32), inset 0 1px 0 rgba(255,255,255,0.04);
+ }
+ .explore-search-suggestions li {
+ display: flex;
+ align-items: baseline;
+ justify-content: space-between;
+ gap: 10px;
+ padding: 8px 10px;
+ border-radius: 10px;
+ cursor: pointer;
+ color: ${GRAPH_THEME.ui.text.body};
+ }
+ .explore-search-suggestions li[data-highlighted="true"] {
+ background: ${GRAPH_THEME.ui.control.hoverBg};
+ }
+ .explore-search-suggestion-label {
+ min-width: 0;
+ overflow: hidden;
+ text-overflow: ellipsis;
+ white-space: nowrap;
+ font-size: 13px;
+ font-weight: 600;
+ }
+ .explore-search-suggestion-type {
+ flex-shrink: 0;
+ font-size: 11px;
+ color: ${GRAPH_THEME.ui.text.subtle};
+ text-transform: uppercase;
+ letter-spacing: 0.04em;
+ }
.explore-search-command:focus-within {
border-color: ${GRAPH_THEME.ui.control.activeBorder};
box-shadow: inset 0 1px 0 rgba(255,255,255,0.06), 0 0 0 1px ${GRAPH_THEME.ui.control.focusRing}, 0 16px 32px rgba(0,0,0,0.18);
@@ -2786,6 +2955,10 @@ export function GraphWorkspace({ externalFocusNodeId, externalFocusToken }: Grap
disabled={searchDisabled}
onChange={setSearchQuery}
onSubmit={() => void handleSearch()}
+ onSelectSuggestion={(result) => {
+ setSearchQuery("");
+ focusNode(result.node.id);
+ }}
/>
From bc75758929da77f0cef2f387c095d0ee42518e69 Mon Sep 17 00:00:00 2001
From: Zohaib Hassnain <109234410+ZohaibHassan16@users.noreply.github.com>
Date: Fri, 14 Aug 2026 15:27:21 +0500
Subject: [PATCH 5/6] fix(explorer): abort stale typeahead requests and clear
suggestions on error
Clearing the search box while a suggestion fetch was in flight never
aborted it, so a late response could reopen the dropdown with results
for a query that was no longer typed. A non-OK response also left
whatever suggestions were already on screen untouched instead of
clearing them. Abort on every effect cleanup (not just unmount) and
clear suggestions on any non-abort failure.
---
.../GraphWorkspace/GraphWorkspace.tsx | 17 ++++++++++++-----
1 file changed, 12 insertions(+), 5 deletions(-)
diff --git a/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
index bb6ebf59..d38d21ad 100644
--- a/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
+++ b/explorer/src/workspaces/GraphWorkspace/GraphWorkspace.tsx
@@ -313,6 +313,7 @@ function SearchCommandBar({
const query = value.trim();
if (disabled || !query) {
+ abortRef.current?.abort();
setSuggestions([]);
setSuggestionsOpen(false);
setHighlightedIndex(-1);
@@ -330,9 +331,13 @@ function SearchCommandBar({
body: JSON.stringify({ query, limit: SUGGESTION_LIMIT }),
signal: controller.signal,
})
- .then((response) => (response.ok ? response.json() : null))
- .then((data: { results?: SearchResult[] } | null) => {
- if (!data) return;
+ .then((response) => {
+ if (!response.ok) {
+ throw new Error(`Search failed with status ${response.status}`);
+ }
+ return response.json();
+ })
+ .then((data: { results?: SearchResult[] }) => {
setSuggestions(data.results ?? []);
setSuggestionsOpen(true);
setHighlightedIndex(-1);
@@ -341,6 +346,9 @@ function SearchCommandBar({
if (suggestionError instanceof DOMException && suggestionError.name === "AbortError") {
return;
}
+ setSuggestions([]);
+ setSuggestionsOpen(false);
+ setHighlightedIndex(-1);
});
}, SUGGESTION_DEBOUNCE_MS);
@@ -348,11 +356,10 @@ function SearchCommandBar({
if (debounceRef.current !== null) {
window.clearTimeout(debounceRef.current);
}
+ abortRef.current?.abort();
};
}, [value, disabled]);
- useEffect(() => () => abortRef.current?.abort(), []);
-
const closeSuggestions = () => {
setSuggestionsOpen(false);
setHighlightedIndex(-1);
From 262cae4000c0f1cb52e8f68b9a109017dadf6294 Mon Sep 17 00:00:00 2001
From: KaifAhmad1
Date: Fri, 14 Aug 2026 17:28:00 +0530
Subject: [PATCH 6/6] docs(changelog): add entry for Explorer backend failure
states fix
Documents the (#980, closes #977) fix in the Unreleased/Fixed section.
---
CHANGELOG.md | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 023332ee..76a189d9 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -52,6 +52,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
### Fixed
+- **Explorer UI hid backend failures: graph load hung forever, landing page always showed "System Online"** (#980, closes #977) by @ZohaibHassan16, reviewed by @Sameer6305
+ - `GraphWorkspace.tsx` only destructured `{ data, isLoading, isFetching }` from `useLoadGraph()`, ignoring the `isError`/`error`/`refetch` that `useQuery` (`retry: 0`) already returned. Combined with `GraphLoadingOverlay` having no error prop and `showLoadingOverlay` staying true whenever `loadingProgress` held a stale frame, a backend-down or failed fetch left the graph workspace stuck on the last progress frame indefinitely, with no error message and no way to recover short of a full page reload
+ - `GraphLoadingOverlay` now accepts `error`/`onRetry` and renders an error card with the real fetch error message and a Retry button (`refetch()`) instead of the stuck progress UI
+ - The landing page's `WelcomeScreen` replaced its hardcoded `ready: boolean` (and hardcoded "System Online" text) with a real `checking` / `online` / `offline` status derived from the same connectivity probe already driving the 4th metric card, so the status dot, text, and metric can no longer drift apart or lie about connectivity
+ - **Smaller fixes bundled in the same PR**: search results are now dismissible (previously stayed open indefinitely, pushing the graph down); relevance scores display as rounded whole numbers instead of `96.900`/`138.000`; added a debounced (250ms) typeahead combobox to graph search with arrow-key navigation, `aria-activedescendant`, and Escape-to-close, using the existing `/api/graph/search` endpoint
+ - **Fixed during review** (Qodo): the typeahead's debounced fetch had no `AbortController`, so a fast-typing user could have a stale suggestion response resolve after a newer one, replacing correct suggestions with outdated ones. In-flight requests are now aborted on every re-debounce and when the query is cleared after a selection
+ - **Noted during review** (@Sameer6305): `GraphWorkspaceShell.tsx` contains a third, unused implementation of the same graph-loading/error-handling logic this PR fixes — the issue itself named "two copies that drifted apart" as the root cause the original bug slipped through. Deliberately left out of this PR's scope and tracked separately in #981 rather than blocking this fix
+ - `npx tsc -b`: clean; `test:graph-store`/`test:graph-workspace`/`test:plugin-registry`: 42 passed; `npm run build`: succeeds
+
- **`VectorManager.maintain_store()`/`collect_statistics()` crashed with `AttributeError` on persistent `VectorStore` backends** (#914, closes #855) by @yunaremaia, with fixes by @Sameer6305
- Both methods accessed `store.vectors`/`store.metadata` directly, which are only initialized for the `inmemory` backend — any persistent backend (FAISS, Qdrant, Pinecone, Milvus, SQLite, PgVector, Weaviate) crashed immediately. Same root cause as the #839/#843/#845/#848 cluster, but `VectorManager` operates on a `VectorStore` instance from the outside, so the fix needed a public accessor rather than another internal guard
- Added a backend-agnostic `VectorStore.count()`: the `inmemory` backend counts its local dict; persistent backends delegate to a `count()` on the wrapped backend store when one exists, or raise `NotImplementedError` — following the `get_vector()`/`get_metadata()` precedent from #843, a missing/uninitialized backend store is never silently reported as an empty, healthy store