@neuralis/brain-core 0.1.0 → 0.2.1

package/app/filesystem/store/gitSlice.ts

@@ -5,7 +5,7 @@ import { sourceFromUri } from './helpers';
 /**
  * gitSlice (G2.1 / spellbound-heron) — client state for the read-only "Git
  * Control" sidebar panel. Mirrors `searchSlice`'s shape: a plain slice combined
- * into the single `useFilesystemStore`, with async actions calling the `../api`
+ * into each window's Files store (`createFilesystemStore`), with async actions calling the `../api`
  * git fetchers.
  *
  * The FOCUSED repo is NOT a git-slice field — it is the PAIR
@@ -18,9 +18,6 @@ import { sourceFromUri } from './helpers';
  * branch repo-correct for free. Write actions pass both explicitly.
  */
 
-let gitStatusSeq = 0;
-let gitBranchSeq = 0;
-
 export interface GitSliceState {
   gitStatus: GitControlStatus | null;
   /**
@@ -144,6 +141,9 @@ export function createGitSlice(
   set: (fn: (s: any) => any) => void,
   get: () => any,
 ): GitSliceActions {
+  // The newest status / branch request of THIS store — an older answer is dropped.
+  let gitStatusSeq = 0;
+  let gitBranchSeq = 0;
   return {
     setGitViewMode: (mode) => set(() => ({ gitViewMode: mode })),
 
@@ -196,7 +196,7 @@ export function createGitSlice(
           ...(projectId ? { projectId } : {}),
           source: slug,
           ...(repoRel ? { repo: repoRel } : {}),
-        });
+        }, get().client);
         if (mySeq !== gitStatusSeq) return;
         // `totals` rides the SAME response as the rows it sums (the server
         // computes it after its read filter and cap), so the header can never
@@ -232,7 +232,7 @@ export function createGitSlice(
           ...(projectId ? { projectId } : {}),
           source: slug,
           ...(repoRel ? { repo: repoRel } : {}),
-        });
+        }, get().client);
         if (mySeq !== gitBranchSeq) return;
         set(() => ({ gitBranches: Array.isArray(res?.branches) ? res.branches : [] }));
       } catch (error) {

package/app/filesystem/store/listSlice.ts

@@ -8,8 +8,6 @@ import {
   sourceFromUri,
 } from './helpers';
 
-const listInFlight = new Map<string, Promise<void>>();
-
 export interface ListSliceActions {
   /**
    * Load the SOURCE SUMMARIES — the registry rows the tree headers and the Sources
@@ -50,9 +48,10 @@ export interface ListSliceActions {
  * context's slice — THESE keys — there and restores it from there; a context
  * reset must never wipe it, that is the whole point of it),
  * or the named-exception list — so a new key has to be filed somewhere:
- *  - preferences, deliberately kept: `activeAgentId`/`activeProjectId` (the callers
- *    own them), `sidebarOpen`, `sidebarWidth`, `gitViewMode`, `searchMode`,
- *    `previewEditorsEnabled`, `diffViewMode`;
+ *  - preferences and window identity, deliberately kept: `activeAgentId`/
+ *    `activeProjectId` (the callers own them), `windowId` + `client` (the window
+ *    the store was created for), `sidebarOpen`, `sidebarWidth`, `gitViewMode`,
+ *    `searchMode`, `previewEditorsEnabled`, `diffViewMode`;
  *  - NOT reset, deliberately: `uploading` alone — it self-heals through the
  *    upload's `finally`, and an upload in flight across a switch must still
  *    release it.
@@ -92,10 +91,12 @@ export function contextResetPatch(): Record<string, unknown> {
     // Sources panel must not survive an agent/project switch — the panel
     // would then prefill an Add-Source form for the PREVIOUS context.
     pendingSourceSuggestion: null,
+    vectorHealthOpen: false,
     searchQuery: '',
     searchResults: [],
     searchLoading: false,
     searchError: undefined,
+    searchEffect: {},
     // Git Control state resets with the context (gitViewMode — a UI
     // preference — intentionally persists, mirroring searchMode).
     gitStatus: null,
@@ -228,6 +229,9 @@ export function createListSlice(
   set: (fn: (s: any) => any) => void,
   get: () => any,
 ): ListSliceActions {
+  // The root-listing dedup belongs to ONE store (one Files window): two windows
+  // listing the same agent must each get their own answer into their own store.
+  const listInFlight = new Map<string, Promise<void>>();
   return {
     async loadList({ agentId, projectId, userId, withCounts }) {
       if (!agentId) return;
@@ -310,7 +314,7 @@ export function createListSlice(
             sources_only: true,
             recursive: false,
             ...(withCounts ? { include_counts: true } : {}),
-          });
+          }, get().client);
         } catch {
           set(() => ({ snapshotError: 'Filesystem service unavailable', sourcesLoading: false }));
           return;

package/app/filesystem/store/searchSlice.ts

@@ -1,8 +1,6 @@
 import { searchFiles } from '../api';
 import { sourceRootUri } from './helpers';
 
-let searchSeq = 0;
-
 export type SearchSliceHit = {
   id: string;
   uri: string;
@@ -13,6 +11,16 @@ export type SearchSliceHit = {
   chunk_end?: number;
   match_type?: 'semantic' | 'keyword' | 'hybrid';
   score?: number;
+  /** `current`, or why the point's semantic embedding is not (`missing` / `stale` / …). */
+  embedding_status?: string;
+};
+
+/** What the last search ran as, when that differs from what was asked (or carries a warning). */
+export type SearchEffect = {
+  requestedMode?: string;
+  effectiveMode?: string;
+  embeddingDegraded?: string;
+  warning?: string;
 };
 
 /** UI search modes → wire `search_mode`: keyword→filter, semantic→semantic, grep→grep. */
@@ -39,6 +47,8 @@ export interface SearchSliceState {
   searchResults: SearchSliceHit[];
   searchLoading: boolean;
   searchError?: string;
+  /** Empty when the search ran as asked, with no warning. */
+  searchEffect: SearchEffect;
 }
 
 export interface SearchSliceActions {
@@ -66,6 +76,7 @@ export const searchSliceInitial: SearchSliceState = {
   searchResults: [],
   searchLoading: false,
   searchError: undefined,
+  searchEffect: {},
 };
 
 /** Grep needs a live-connector folder scope; brain:// has no live text to scan. */
@@ -82,6 +93,8 @@ export function createSearchSlice(
   set: (fn: (s: any) => any) => void,
   get: () => any,
 ): SearchSliceActions {
+  // The newest search of THIS store — an older answer never overwrites a newer one.
+  let searchSeq = 0;
   return {
     setSearchQuery: (query) => set(() => ({ searchQuery: query })),
     setSearchMode: (mode) => set(() => ({ searchMode: mode })),
@@ -94,6 +107,7 @@ export function createSearchSlice(
         searchResults: [],
         searchLoading: false,
         searchError: undefined,
+        searchEffect: {},
       })),
 
     async runSearch({ agentId, projectId }) {
@@ -108,7 +122,7 @@ export function createSearchSlice(
           ? query.length >= 2 || glob.length >= 2
           : query.length >= 2;
       if (!agentId || !runnable) {
-        set(() => ({ searchResults: [], searchLoading: false, searchError: undefined }));
+        set(() => ({ searchResults: [], searchLoading: false, searchError: undefined, searchEffect: {} }));
         return;
       }
 
@@ -127,6 +141,7 @@ export function createSearchSlice(
           searchResults: [],
           searchLoading: false,
           searchError: 'Grep needs a non-brain folder scope — select a folder in a disk-backed source.',
+          searchEffect: {},
         }));
         return;
       }
@@ -152,7 +167,7 @@ export function createSearchSlice(
           ...(searchMode !== 'grep' && filters.createdAfter.trim() ? { created_after: filters.createdAfter.trim() } : {}),
           ...(searchMode !== 'grep' && filters.createdBefore.trim() ? { created_before: filters.createdBefore.trim() } : {}),
           limit: searchMode === 'semantic' ? 30 : 50,
-        });
+        }, get().client);
         if (mySeq !== searchSeq) return;
         const rows = res.results || [];
         // Backend error rows (grep guidance, index-unavailable) carry `error`
@@ -170,11 +185,18 @@ export function createSearchSlice(
             chunk_end: r.chunk_end,
             match_type: r.match_type,
             score: r.score,
+            ...(typeof r.embedding_status === 'string' ? { embedding_status: r.embedding_status } : {}),
           }));
         set(() => ({
           searchResults: hits,
           searchLoading: false,
           searchError: errorRow ? String((errorRow as any).error) : undefined,
+          searchEffect: {
+            ...(res.requested_mode ? { requestedMode: res.requested_mode } : {}),
+            ...(res.effective_mode ? { effectiveMode: res.effective_mode } : {}),
+            ...(res.embedding_degraded ? { embeddingDegraded: res.embedding_degraded } : {}),
+            ...(res.warning ? { warning: res.warning } : {}),
+          },
         }));
       } catch (error) {
         if (mySeq !== searchSeq) return;
@@ -182,6 +204,7 @@ export function createSearchSlice(
           searchResults: [],
           searchLoading: false,
           searchError: error instanceof Error ? error.message : 'Search failed',
+          searchEffect: {},
         }));
       }
     },

package/app/filesystem/ui/FileEditor.tsx

@@ -6,7 +6,7 @@ import { RefreshCw, FileCode, Pencil, Trash2, Loader2, Upload, Check, X, GitComp
 import { cn } from '../lib/cn';
 import { useFilesystemHost } from '../FilesystemHost';
 import { buildAgentIndex } from '../lib/agentUtils';
-import { useContainerWidth } from '../hooks/useContainerWidth';
+import { useContainerWidth } from '@neuralis/package-system/client';
 import { detectCodeLanguage } from '../lib/detectLanguage';
 import { parseGitLineStatus, isEmptyGitLineStatus, type GitLineStatusMap } from './codeEditor/gitLineStatus';
 import { EditorTabBar, EditorTabsMenu, TAB_SCROLLER_ATTR } from './EditorTabBar';
@@ -45,6 +45,7 @@ function normalizeUserUriInput(raw: string, fallbackUri: string): string {
 }
 
 export function FileEditor() {
+  const client = useFilesystemStore((s) => s.client);
   const openFiles = useFilesystemStore((s) => s.openFiles);
   const activeFile = useFilesystemStore((s) => s.activeFile);
   const files = useFilesystemStore((s) => s.files);
@@ -169,7 +170,7 @@ export function FileEditor() {
     }
     void (async () => {
       try {
-        const res = await getGitDiff({ agentId: targetAgentId, ...(projectId ? { projectId } : {}), source, path, staged: false });
+        const res = await getGitDiff({ agentId: targetAgentId, ...(projectId ? { projectId } : {}), source, path, staged: false }, client);
         if (cancelled) return;
         if (res && (res as { ok?: boolean }).ok === false) {
           setGitLineStatus(undefined);
@@ -243,7 +244,7 @@ export function FileEditor() {
         id: activeNode.id,
         uri: activeNode.uri,
         fields: { status: 'active' },
-      });
+      }, client);
       if (res && res.ok === false) {
         setEditError(writeRefusalMessage(res, 'Restore failed'));
         return;
@@ -275,7 +276,7 @@ export function FileEditor() {
         ...(projectId ? { projectId } : {}),
         id: activeNode.id,
         uri: activeNode.uri,
-      });
+      }, client);
       if (res && res.ok) {
         const nodeKey = activeNode.storeKey || activeFile || fileKeyFromNode(activeNode);
         if (nodeKey) {
@@ -310,7 +311,7 @@ export function FileEditor() {
         id: activeNode.id,
         uri: activeNode.uri,
         revert: true,
-      });
+      }, client);
       if (res && res.ok === false) {
         setEditError(writeRefusalMessage(res, 'Revert failed'));
         return;
@@ -434,98 +435,107 @@ export function FileEditor() {
           <div {...{ [TAB_SCROLLER_ATTR]: '' }} className="flex min-w-0 flex-1 overflow-x-auto overflow-y-hidden">
           <EditorTabBar />
           {workspacePanels.upload ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showUploadTab ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('upload')}
             >
               <Upload className="w-3.5 h-3.5 shrink-0" />
               <span className="truncate flex-1">Upload</span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Upload"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   setWorkspacePanelOpen('upload', false);
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           {supportsSources && workspacePanels.sources ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showSourcesTab ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('sources')}
             >
               <SlidersHorizontal className="w-3.5 h-3.5 shrink-0" />
               <span className="truncate flex-1">Sources</span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Sources"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   setWorkspacePanelOpen('sources', false);
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           {workspacePanels.packages ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showPackagesTab ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('packages')}
             >
               <Package className="w-3.5 h-3.5 shrink-0" />
               <span className="truncate flex-1">Packages</span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Packages"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   setWorkspacePanelOpen('packages', false);
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           {workspacePanels.pending ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showPendingTab ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('pending')}
             >
               <FileDiff className="w-3.5 h-3.5 shrink-0" />
               <span className="truncate flex-1">Changes</span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Changes"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   setWorkspacePanelOpen('pending', false);
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           {gitDiffTarget ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showGitDiff ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('git-diff')}
@@ -537,8 +547,9 @@ export function FileEditor() {
               <span className="truncate flex-1">
                 {repoQualifiedLabel(gitDiffTarget.repo, extractFilename(gitDiffTarget.path) || gitDiffTarget.path)}
               </span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Git diff"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   setGitDiffTarget(null);
@@ -546,14 +557,15 @@ export function FileEditor() {
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           {gitCommitTarget ? (
+            <div className="group flex shrink-0 items-center">
             <button
               type="button"
               className={cn(
-                'group flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
+                'flex items-center gap-1.5 px-3 py-2 text-xs min-w-[120px] max-w-[240px] rounded-lg',
                 showGitCommit ? 'bg-white/10 text-white' : 'text-white/50 hover:bg-white/5 hover:text-white/80',
               )}
               onClick={() => setActiveWorkspaceTab('git-commit')}
@@ -575,8 +587,9 @@ export function FileEditor() {
                   ? repoQualifiedLabel(gitCommitTarget.repo, `${shortSha(gitCommitTarget.sha)} ${gitCommitTarget.subject}`)
                   : repoQualifiedLabel(gitCommitTarget.repo, 'Outgoing changes')}
               </span>
-              <span
-                className="opacity-0 group-hover:opacity-100 p-0.5 rounded hover:bg-white/10"
+            </button>
+              <button type="button" aria-label="Close Git commit"
+                className="opacity-0 group-hover:opacity-100 focus-visible:opacity-100 p-0.5 rounded hover:bg-white/10"
                 onClick={(e) => {
                   e.stopPropagation();
                   // The 'file' fallback for an ACTIVE git-commit tab lives in
@@ -585,8 +598,8 @@ export function FileEditor() {
                 }}
               >
                 <X className="w-3 h-3" />
-              </span>
-            </button>
+              </button>
+            </div>
           ) : null}
           </div>
           <EditorTabsMenu />

package/app/filesystem/ui/FileTree.tsx

@@ -1,6 +1,6 @@
 'use client';
 
-import { useFilesystemStore, type SidebarView } from '../store/filesystemStore';
+import { useFilesystemStore, useFilesystemStoreApi, type SidebarView } from '../store/filesystemStore';
 import React, { useMemo, useState, useCallback, useRef, useEffect } from 'react';
 import { SkillLauncher } from '@neuralis/package-system/client';
 import { meetsRequires } from '@neuralis/package-system/access';
@@ -197,6 +197,7 @@ export function flattenSource(
 export function FileTree(props: { agentId: string; sidebarView?: SidebarView }) {
   const { agentId, sidebarView = 'tree' } = props;
   const host = useFilesystemHost();
+  const storeApi = useFilesystemStoreApi();
 
   const files = useFilesystemStore((s) => s.files);
   const folderBadges = useFilesystemStore((s) => s.folderBadges);
@@ -527,12 +528,12 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
         // Expand + load the parent so the inline input row is visible in place.
         if (!parentUri.endsWith('://') && !expanded.has(parentUri)) {
           toggleFolder(parentUri);
-          void useFilesystemStore.getState().ensureFolderLoaded({ agentId, projectId, uri: parentUri });
+          void storeApi.getState().ensureFolderLoaded({ agentId, projectId, uri: parentUri });
         }
         setCreating({ parentUri, kind });
       }
     },
-    [contextMenu, menuTargets, expanded, toggleFolder, agentId, projectId, clipboard, pasteNodes],
+    [contextMenu, menuTargets, expanded, toggleFolder, agentId, projectId, clipboard, pasteNodes, storeApi],
   );
 
   const handleCreateCommit = useCallback(
@@ -607,12 +608,12 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
     setActiveFolderPath(params.key);
     toggleFolder(params.key);
     if (wasExpanded) return;
-    await useFilesystemStore.getState().ensureFolderLoaded({
+    await storeApi.getState().ensureFolderLoaded({
       agentId,
       projectId,
       uri: params.key,
     });
-  }, [agentId, expanded, projectId, setActiveFolderPath, toggleFolder]);
+  }, [agentId, expanded, projectId, setActiveFolderPath, toggleFolder, storeApi]);
 
   const handleOpenFile = useCallback((params: { agentId: string; projectId: string | null; uri: string; readAgentId?: string }) => {
     if (params.uri) {
@@ -644,7 +645,7 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
    */
   const handleRefreshSource = useCallback(async (uriRoot: string) => {
     if (!agentId) return;
-    const store = useFilesystemStore.getState();
+    const store = storeApi.getState();
     setSourceBranchExpanded((prev) => (prev[uriRoot] ? prev : { ...prev, [uriRoot]: true }));
     if (store.loadedFolders?.[uriRoot]) {
       const source = sourceFromUri(uriRoot);
@@ -652,7 +653,7 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
       return;
     }
     await store.ensureFolderLoaded({ agentId, projectId, uri: uriRoot, force: true });
-  }, [agentId, projectId]);
+  }, [agentId, projectId, storeApi]);
 
   // Hydrate what is VISIBLE and not yet fetched.
   //
@@ -664,7 +665,7 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
   // rather than retry-looping. `ensureFolderLoaded` is itself idempotent.
   useEffect(() => {
     if (!agentId) return;
-    const state = useFilesystemStore.getState();
+    const state = storeApi.getState();
     const wanted: string[] = [];
     for (const info of sourceInfos) {
       if (sourceBranchExpanded[info.uri_root]) wanted.push(info.uri_root);
@@ -676,7 +677,7 @@ export function FileTree(props: { agentId: string; sidebarView?: SidebarView })
       if (hydration && hydration !== 'idle') continue;
       void state.ensureFolderLoaded({ agentId, projectId, uri });
     }
-  }, [agentId, projectId, sourceInfos, sourceBranchExpanded, expanded]);
+  }, [agentId, projectId, sourceInfos, sourceBranchExpanded, expanded, storeApi]);
 
   const handleMoveFileToFolder = useCallback(
     async ({ fromUri, id, toFolderUri }: { fromUri: string; id?: string; toFolderUri: string }) => {

package/app/filesystem/ui/FileTreeSearch.tsx

@@ -4,7 +4,7 @@ import React, { useEffect, useMemo, useState } from 'react';
 import { SlidersHorizontal } from 'lucide-react';
 import { useFilesystemStore } from '../store/filesystemStore';
 import { folderUri } from '../store/helpers';
-import { grepScopeFor, type SearchUiMode } from '../store/searchSlice';
+import { grepScopeFor, type SearchEffect, type SearchUiMode } from '../store/searchSlice';
 
 const MODES: Array<{ id: SearchUiMode; label: string; hint: string }> = [
   { id: 'keyword', label: 'Keyword', hint: 'Indexed word search (primary)' },
@@ -20,6 +20,19 @@ const filterInputClass =
  * input itself lives in the sidebar HEADER row (FilesystemWidget) — this
  * panel renders only while `sidebarView === 'search'`.
  */
+/**
+ * The one line that says a search did not run as asked: a semantic request
+ * answered by keyword search because embedding is unavailable (the reason is
+ * the server's), or the server's own warning. `null` when it ran as asked.
+ */
+export function searchEffectLine(effect: SearchEffect | undefined): string | null {
+  if (!effect) return null;
+  if (effect.requestedMode === 'semantic' && effect.effectiveMode && effect.effectiveMode !== 'semantic') {
+    return `Searched as keyword — semantic search unavailable${effect.embeddingDegraded ? ` (${effect.embeddingDegraded})` : ''}. Use specific words.`;
+  }
+  return effect.warning ?? null;
+}
+
 export function FileTreeSearch({ agentId }: { agentId: string }) {
   const projectId = useFilesystemStore((s) => s.activeProjectId);
   const setActiveFolderPath = useFilesystemStore((s) => s.setActiveFolderPath);
@@ -32,6 +45,8 @@ export function FileTreeSearch({ agentId }: { agentId: string }) {
   const searchResults = useFilesystemStore((s) => s.searchResults);
   const searchLoading = useFilesystemStore((s) => s.searchLoading);
   const searchError = useFilesystemStore((s) => s.searchError);
+  const searchEffect = useFilesystemStore((s) => s.searchEffect);
+  const effectLine = searchEffectLine(searchEffect);
   const runSearch = useFilesystemStore((s) => s.runSearch);
   const activeFolderPath = useFilesystemStore((s) => s.activeFolderPath);
   const sources = useFilesystemStore((s) => s.sources);
@@ -185,9 +200,15 @@ export function FileTreeSearch({ agentId }: { agentId: string }) {
       ) : searchError ? (
         <div className="px-2 py-3 text-[11px] text-red-300/70">{searchError}</div>
       ) : searchResults.length === 0 ? (
-        <div className="px-2 py-3 text-[11px] text-white/35">No matches</div>
+        <div className="px-2 py-3 text-[11px] text-white/35">
+          {effectLine ? <div role="status" className="mb-1 text-[10px] text-amber-200/70">{effectLine}</div> : null}
+          No matches
+        </div>
       ) : (
         <div className="space-y-1">
+          {effectLine ? (
+            <div role="status" className="px-2 py-1 text-[10px] text-amber-200/70">{effectLine}</div>
+          ) : null}
           {searchResults.map((result) => (
             <button
               key={`${result.id}:${result.uri}:${result.chunk_start ?? ''}`}
@@ -203,6 +224,12 @@ export function FileTreeSearch({ agentId }: { agentId: string }) {
                 {typeof result.score === 'number' ? (
                   <span className="text-[9px] text-white/30 shrink-0">{result.score.toFixed(2)}</span>
                 ) : null}
+                {result.embedding_status === 'missing' || result.embedding_status === 'stale' ? (
+                  <span className="text-[9px] px-1 py-0.5 rounded bg-white/[0.06] text-white/40 shrink-0"
+                    title="This file is text-searchable; its semantic embedding is not current">
+                    embedding {result.embedding_status}
+                  </span>
+                ) : null}
                 {result.match_type ? (
                   <span className="text-[9px] px-1 py-0.5 rounded bg-white/[0.06] text-white/40 shrink-0">
                     {result.match_type === 'hybrid' ? 'H' : result.match_type === 'semantic' ? 'S' : 'K'}

package/app/filesystem/ui/GitCommitChangesView.tsx

@@ -16,6 +16,7 @@ import type { GitCommitFileChange, GitCommitTarget } from '../domain/types';
 import { useVisibleDiffCards, type VisibleDiffQueue } from '../hooks/useVisibleDiffCards';
 import { GitFileDiff } from './GitFileDiff';
 import { shortSha, type GitFileDiffMode } from './gitFileDiffMode';
+import { useFilesystemStore } from '../store/filesystemStore';
 
 /**
  * GitCommitChangesView (G2.4/C2+C3 / cobalt-wren) — the multi-file stacked
@@ -182,6 +183,7 @@ export function GitCommitChangesView({
   agentId: string | null;
   projectId: string | null;
 }): React.ReactElement {
+  const client = useFilesystemStore((s) => s.client);
   const [scrollRoot, setScrollRoot] = useState<HTMLDivElement | null>(null);
   const queue = useVisibleDiffCards(scrollRoot);
   const [state, setState] = useState<ListState>({ phase: 'loading' });
@@ -211,7 +213,7 @@ export function GitCommitChangesView({
             source,
             ...(repo ? { repo } : {}),
             sha: target.sha,
-          });
+          }, client);
           if (cancelled) return;
           if (res.ok === false) {
             setState({ phase: 'unavailable' });
@@ -228,7 +230,7 @@ export function GitCommitChangesView({
               ...(repo ? { repo } : {}),
               maxCount: 1,
               ref: target.sha,
-            });
+            }, client);
             const head = Array.isArray(log?.commits) ? log.commits[0] : undefined;
             if (!cancelled && head) setMeta({ author: head.author, date: head.date });
           } catch {
@@ -240,7 +242,7 @@ export function GitCommitChangesView({
             ...(projectId ? { projectId } : {}),
             source,
             ...(repo ? { repo } : {}),
-          });
+          }, client);
           if (cancelled) return;
           // 3b: a deep-fail is a typed `{ok:false,'unavailable'}` refusal now — treat
           // it like no-upstream (nothing to show), never crash on a missing files[].