@neuralis/brain-core 0.1.0 → 0.2.1

package/app/filesystem/ui/SourcesPanel.tsx

@@ -44,6 +44,7 @@ import {
   type IndexPurgeSelector,
   cancelSync,
   getSyncStatus,
+  startReembed,
   resetSync,
   browseDirectories,
   listSourceKinds,
@@ -70,6 +71,7 @@ import type {
   HierarchicalPermissionsRecord,
   PathPermissionRecord,
   SyncMediaRecord,
+  SyncJobSnapshotRecord,
 } from '../domain/types';
 
 type Props = {
@@ -113,7 +115,7 @@ type AddDraftState = {
    * in the Policy editor after saving.
    */
   policies: PathPermissionRecord[];
-  /** R2b — create this local source as a WASM-package source (owner/admin). */
+  /** R2b — create this local source as a package source too (owner/admin). */
   recognizesPackages: boolean;
 };
 
@@ -329,6 +331,26 @@ function mediaSkipLine(skipped: { textOnlyModel: number; off: number; tooLarge:
   return parts.length > 0 ? parts.join(' · ') : null;
 }
 
+/**
+ * The source's semantic-embedding line, or `null` when nothing is owed.
+ * OFF is the platform's LIVE intent (`embedding_enabled`), never a last pass's
+ * echo — a watcher pass that changed nothing must not erase it. Off is a
+ * choice, said neutrally. The last pass's OTHER reasons (`quota`,
+ * `credentials`, …) are owed work and read amber. The data landed either way.
+ */
+export function embeddingLine(reasons: string[] | undefined, enabled: boolean | undefined): { text: string; attention: boolean } | null {
+  if (enabled === false) return { text: 'Semantic embedding off — text and field search only', attention: false };
+  const owed = (reasons ?? []).filter((reason) => reason !== 'disabled');
+  if (owed.length === 0) return null;
+  return { text: `Semantic embedding pending: ${owed.join(', ')} — files are indexed and text-searchable`, attention: true };
+}
+
+/** The last run's binary line, or `null` when none was skipped. */
+export function binarySkipLine(count: number | undefined): string | null {
+  if (!count) return null;
+  return `${count} binary file${count === 1 ? '' : 's'} not indexed`;
+}
+
 /**
  * Does this save change what the row's NUMBERS would report?
  *
@@ -448,6 +470,7 @@ const textareaCls = cn(
 // ---------------------------------------------------------------------------
 
 export function SourcesPanel(props: Props) {
+  const client = useFilesystemStore((s) => s.client);
   const { agentId, projectId, isDocker } = props;
   const open = useFilesystemStore((s) => s.workspacePanels.sources);
   const setWorkspacePanelOpen = useFilesystemStore((s) => s.setWorkspacePanelOpen);
@@ -507,6 +530,10 @@ export function SourcesPanel(props: Props) {
   const [resettingSource, setResettingSource] = useState<string | null>(null);
   /** Source whose "Re-embed…" dialog is open (estimate → confirm). */
   const [reembedFor, setReembedFor] = useState<string | null>(null);
+  /** Source whose "Embed pending…" dialog is open (estimate → confirm). */
+  const [embedPendingFor, setEmbedPendingFor] = useState<string | null>(null);
+  /** An embedding-only pass that ended `paused`, by source → its reason (cleared on Resume). */
+  const [embeddingPaused, setEmbeddingPaused] = useState<Record<string, string>>({});
   const [purgeFor, setPurgeFor] = useState<string | null>(null);
   const [purgeKind, setPurgeKind] = useState<'source' | 'folder' | 'file'>('source');
   const [purgeUri, setPurgeUri] = useState('');
@@ -531,7 +558,8 @@ export function SourcesPanel(props: Props) {
     return () => { mountedRef.current = false; };
   }, []);
   const [addCreating, setAddCreating] = useState(false);
-  const [healthOpen, setHealthOpen] = useState(false);
+  const healthOpen = useFilesystemStore((s) => s.vectorHealthOpen);
+  const setVectorHealthOpen = useFilesystemStore((s) => s.setVectorHealthOpen);
   const [mountOpen, setMountOpen] = useState(false);
   const [browseOpen, setBrowseOpen] = useState(false);
   const [browseEntries, setBrowseEntries] = useState<Array<{ name: string; path: string }>>([]);
@@ -550,7 +578,7 @@ export function SourcesPanel(props: Props) {
   // schema-driven picker (replacing the old hardcoded KIND_META).
   useEffect(() => {
     let cancelled = false;
-    listSourceKinds()
+    listSourceKinds(client)
       .then((res) => {
         if (cancelled) return;
         setKinds(res.kinds ?? []);
@@ -677,8 +705,8 @@ export function SourcesPanel(props: Props) {
           agentId,
           projectId,
           scope: activeScope,
-        }),
-        listDiscoverableSources({ agentId, projectId })
+        }, client),
+        listDiscoverableSources({ agentId, projectId }, client)
           .catch(() => ({ suggestions: [] as DiscoverableSourceSuggestion[] })),
       ]);
       setConfigs(next);
@@ -719,7 +747,7 @@ export function SourcesPanel(props: Props) {
     });
     if (alreadyLoading) return;
     try {
-      const info = await fetchSourceCounts(agentId, projectId ?? undefined, source);
+      const info = await fetchSourceCounts(agentId, projectId ?? undefined, source, client);
       if (info) setCountsBySource((prev) => ({ ...prev, [source]: info }));
     } catch {
       // Count failure is non-fatal — the row still works, the stats row just stays blank.
@@ -766,7 +794,7 @@ export function SourcesPanel(props: Props) {
   useEffect(() => {
     if (!showAddForm || !isDocker || !canMount) return;
     setDockerMountsLoading(true);
-    browseDirectories({ path: '/mounts', agentId, ...(projectId ? { projectId } : {}) })
+    browseDirectories({ path: '/mounts', agentId, ...(projectId ? { projectId } : {}) }, client)
       .then((result) => {
         // Filter out volumes already configured as sources
         const configuredSources = new Set(configs.map((c) => c.source));
@@ -878,7 +906,7 @@ export function SourcesPanel(props: Props) {
         agentId,
         ...(projectId ? { projectId } : {}),
         config: { ...payload, ...(clearSync ? { clearSync: true } : {}) },
-      });
+      }, client);
       setConfigs((s) => s.map((e) => (e.source === updated.source ? updated : e)));
       setDrafts((s) => ({ ...s, [updated.source]: buildDraft(updated) }));
       // Counted refresh ONLY when the save moved the sync FILTER set — that is
@@ -916,7 +944,7 @@ export function SourcesPanel(props: Props) {
           agentId,
           ...(projectId ? { projectId } : {}),
           config: { ...currentDraft, permissions: nextPerms },
-        });
+        }, client);
         setConfigs((s) => s.map((e) => (e.source === updated.source ? updated : e)));
         setDrafts((s) => ({ ...s, [updated.source]: buildDraft(updated) }));
         // A permissions edit moves no number: the indexed count is a
@@ -939,7 +967,7 @@ export function SourcesPanel(props: Props) {
    * pending/running so the row spinner reflects the real run (Cancel stays
    * available the whole time), then surface a failed job's error.
    */
-  const pollSyncJob = useCallback(async (source: string): Promise<void> => {
+  const pollSyncJob = useCallback(async (source: string): Promise<SyncJobSnapshotRecord | null> => {
     const POLL_MS = 1_500;
     const MAX_POLLS = 2_400; // 60 min safety bound — repo-sized syncs are long
     for (let i = 0; i < MAX_POLLS; i++) {
@@ -949,16 +977,18 @@ export function SourcesPanel(props: Props) {
       // wanted the answer had unmounted — once per sync, per source. The ref
       // is cleared on UNMOUNT ONLY (never in a dependency-change cleanup), so a
       // live poll is never dropped while the panel is still mounted.
-      if (!mountedRef.current) return;
-      const status = await getSyncStatus({ agentId, ...(projectId ? { projectId } : {}), source });
+      if (!mountedRef.current) return null;
+      const status = await getSyncStatus({ agentId, ...(projectId ? { projectId } : {}), source }, client);
       const job = status.job;
-      if (!job) return;
+      if (!job) return null;
       if (job.status === 'pending' || job.status === 'running') continue;
       if (job.status === 'failed') {
         throw new Error(job.error ?? job.result?.error ?? 'Sync failed');
       }
-      return;
+      // `paused` is terminal, not a failure: an embedding-only pass names why.
+      return job;
     }
+    return null;
   }, [agentId, projectId]);
 
   // EVERY hook is above this line. It used to sit ~110 lines higher, with
@@ -976,7 +1006,7 @@ export function SourcesPanel(props: Props) {
     setSyncingSource(source);
     setError(null);
     try {
-      await triggerSourceSync({ agentId, ...(projectId ? { projectId } : {}), source });
+      await triggerSourceSync({ agentId, ...(projectId ? { projectId } : {}), source }, client);
       await pollSyncJob(source);
       await load();
       await refresh({ agentId, projectId, withCounts: true });
@@ -990,7 +1020,7 @@ export function SourcesPanel(props: Props) {
 
   const handleCancelSync = async (source?: string) => {
     try {
-      await cancelSync({ agentId, ...(projectId ? { projectId } : {}), ...(source ? { source } : {}) });
+      await cancelSync({ agentId, ...(projectId ? { projectId } : {}), ...(source ? { source } : {}) }, client);
       // The polling loop in handleSync/handleReindex observes the cancelled
       // status and clears the spinner; clear eagerly for instant feedback.
       setSyncingSource(null);
@@ -1009,7 +1039,12 @@ export function SourcesPanel(props: Props) {
     setError(null);
     try {
       await enqueue();
-      await pollSyncJob(source);
+      const job = await pollSyncJob(source);
+      const paused = job?.status === 'paused' ? job.result?.embedding?.pausedReason ?? 'paused' : null;
+      setEmbeddingPaused((prev) => {
+        const { [source]: _previous, ...rest } = prev;
+        return paused ? { ...rest, [source]: paused } : rest;
+      });
       await load();
       await refresh({ agentId, projectId, withCounts: true });
       clearCachedCounts(source);
@@ -1020,11 +1055,19 @@ export function SourcesPanel(props: Props) {
     }
   };
 
+  /** Resume a paused embedding-only pass: the same owed-only apply, already confirmed once. */
+  const handleResumeEmbedding = (source: string) =>
+    followReindex(
+      source,
+      () => startReembed({ agentId, ...(projectId ? { projectId } : {}), source }, 'pending', client),
+      'Embedding failed',
+    );
+
   /** "Rescan changes" — changed files are embedded again; unchanged ones keep their vectors. */
   const handleReindex = (source: string) =>
     followReindex(
       source,
-      () => reindexSource({ agentId, ...(projectId ? { projectId } : {}), source }),
+      () => reindexSource({ agentId, ...(projectId ? { projectId } : {}), source }, client),
       'Rescan failed',
     );
 
@@ -1034,7 +1077,7 @@ export function SourcesPanel(props: Props) {
     setPurgeBusy(true);
     setError(null);
     try {
-      const counts = await purgeSourceIndex({ agentId, ...(projectId ? { projectId } : {}), source, selector, mode, obsoleteOnly: purgeObsoleteOnly });
+      const counts = await purgeSourceIndex({ agentId, ...(projectId ? { projectId } : {}), source, selector, mode, obsoleteOnly: purgeObsoleteOnly }, client);
       if (epoch !== purgeEpoch.current) return;
       if (mode === 'estimate') setPurgeCounts(counts);
       else { setPurgeFor(null); setPurgeCounts(null); clearCachedCounts(source); await load(); await refresh({ agentId, projectId, withCounts: true }); }
@@ -1046,7 +1089,7 @@ export function SourcesPanel(props: Props) {
     setResettingSource(source);
     setError(null);
     try {
-      await resetSync({ agentId, ...(projectId ? { projectId } : {}), source });
+      await resetSync({ agentId, ...(projectId ? { projectId } : {}), source }, client);
       await load();
     } catch (err) {
       setError(err instanceof Error ? err.message : 'Reset failed');
@@ -1065,7 +1108,7 @@ export function SourcesPanel(props: Props) {
     setTogglingEnabledSource(source);
     setError(null);
     try {
-      await setSourceEnabled({ agentId, ...(projectId ? { projectId } : {}), source, enabled: next });
+      await setSourceEnabled({ agentId, ...(projectId ? { projectId } : {}), source, enabled: next }, client);
       await load();
     } catch (err) {
       setError(err instanceof Error ? err.message : 'Toggle failed');
@@ -1083,7 +1126,7 @@ export function SourcesPanel(props: Props) {
         ...(projectId ? { projectId } : {}),
         source,
         ...(opts.purgeVectors ? { purgeVectors: true } : {}),
-      });
+      }, client);
       await load();
       // The deleted row is gone; no surviving source's count moved, so the
       // refresh runs count-free. `clearCachedCounts` still drops the row's own
@@ -1109,7 +1152,7 @@ export function SourcesPanel(props: Props) {
     setBrowseLoading(true);
     setBrowseError(null);
     try {
-      const result = await browseDirectories({ path, agentId, ...(projectId ? { projectId } : {}) });
+      const result = await browseDirectories({ path, agentId, ...(projectId ? { projectId } : {}) }, client);
       setBrowseEntries(result.entries);
       setBrowsePath(path);
     } catch {
@@ -1170,7 +1213,7 @@ export function SourcesPanel(props: Props) {
         ...(isOwnerEffective && addKind === 'local' && addDraft.recognizesPackages
           ? { recognizesPackages: true }
           : {}),
-      });
+      }, client);
       setShowAddForm(false);
       {
         const reset = buildAddDraft(selectedKind, sourceKeyIds);
@@ -1335,7 +1378,7 @@ export function SourcesPanel(props: Props) {
             <>
               <div className="text-[10px] text-amber-300/70 bg-amber-500/8 rounded px-2 py-1.5">
                 Docker mode: host folders still need the CLI mount script:{' '}
-                <code className="text-amber-200/90 font-mono">pnpm neuralis:mount add</code>{' '}
+                <code className="text-amber-200/90 font-mono">neuralis mount add</code>{' '}
                 on the host, then restart the container. Package sources like Machine do not require a host path here.
               </div>
               {/* Unmounted volume mounts */}
@@ -1567,7 +1610,7 @@ export function SourcesPanel(props: Props) {
                 <span>
                   Recognize packages
                   <span className="block text-[9px] text-white/35 normal-case font-normal">
-                    Load WASM packages dropped in this folder (in addition to <code>_packages/</code>). Advertised only within this source&apos;s scope.
+                    Load packages found in this folder (in addition to <code>_packages/</code>) as soon as the source is added. Advertised only within this source&apos;s scope.
                   </span>
                 </span>
               </label>
@@ -1630,13 +1673,11 @@ export function SourcesPanel(props: Props) {
 
           return (
             <div key={fileKey(sourceRootUri(config.source))} className="rounded-sm">
-              {/* Accordion header */}
-              <button
-                type="button"
-                onClick={() => toggleSource(config.source)}
-                title={disconnected ? sourceLiveReasonLabel(config.live_reason) : undefined}
-                className="w-full flex items-center gap-2 py-2 text-left group hover:bg-white/[0.02] rounded-md px-1 transition"
-              >
+              {/* Accordion header: selection and enabled actions are siblings. */}
+              <div className="w-full flex items-center gap-2 py-2 text-left group hover:bg-white/[0.02] rounded-md px-1 transition">
+                <button type="button" onClick={() => toggleSource(config.source)} aria-expanded={isOpen}
+                  title={disconnected ? sourceLiveReasonLabel(config.live_reason) : undefined}
+                  className="min-w-0 flex-1 flex items-center gap-2">
                 {/* Git indicator (G2.1) — a GitBranch overlay on a git-repo
                     source's icon, ORTHOGONAL to the sync tone (visualTone still
                     owns the icon colour). */}
@@ -1671,6 +1712,7 @@ export function SourcesPanel(props: Props) {
                 {dirty && (
                   <span className="shrink-0 rounded px-1 py-0.5 text-[8px] font-medium text-amber-300/80 bg-amber-500/10">unsaved</span>
                 )}
+                </button>
                 {/* W3K — enabled toggle (per scope, per source). Machine sources also offer Auto. */}
                 {(() => {
                   const enabled = config.enabled ?? true;
@@ -1721,7 +1763,7 @@ export function SourcesPanel(props: Props) {
                   {describeConn(config, meta)}
                 </span>
                 <ChevronDown className={cn('h-3 w-3 text-white/25 shrink-0 transition-transform', isOpen && 'rotate-180')} />
-              </button>
+              </div>
 
               {/* Expanded body — when open it expands to full height (no clamp)
                   so every Path Rule / uri-policy is visible; the outer panel
@@ -1818,8 +1860,8 @@ export function SourcesPanel(props: Props) {
                   </div>
 
                   {/* R2b — Recognize packages toggle. Owner/admin-effective +
-                      local-kind only (server re-gates). Turns this source into a
-                      WASM-package source; advertised only within its own scope. */}
+                      local-kind only (server re-gates). Makes this source a package
+                      source too; advertised only within its own scope. */}
                   {editable && isOwnerEffective && (meta?.kind ?? config.connection.kind) === 'local' && (
                     <div className="pl-0">
                       <label className="flex items-start gap-1.5 py-1 cursor-pointer">
@@ -1833,7 +1875,7 @@ export function SourcesPanel(props: Props) {
                         <span className="text-[10px] text-white/70 leading-tight">
                           Recognize packages
                           <span className="block text-[9px] text-white/35 normal-case font-normal">
-                            Load WASM packages dropped here (additive to <code>_packages/</code>); advertised only within this source&apos;s scope. Save to apply.
+                            Load packages found in this folder (in addition to <code>_packages/</code>) — applied on save; advertised only within this source&apos;s scope.
                           </span>
                         </span>
                       </label>
@@ -2018,6 +2060,29 @@ export function SourcesPanel(props: Props) {
                                 {mediaSkipLine(config.sync?.lastSyncResult?.mediaSkipped)}
                               </div>
                             )}
+                            {binarySkipLine(config.sync?.lastSyncResult?.binarySkipped) && (
+                              <div className="text-[9px] text-white/40" role="status">
+                                {binarySkipLine(config.sync?.lastSyncResult?.binarySkipped)}
+                              </div>
+                            )}
+                            {(() => {
+                              const line = embeddingLine(config.sync?.lastSyncResult?.embeddingDegraded, config.embedding_enabled);
+                              return line ? (
+                                <div className={line.attention ? 'text-[9px] text-amber-200/70' : 'text-[9px] text-white/40'} role="status">
+                                  {line.text}
+                                </div>
+                              ) : null;
+                            })()}
+                            {embeddingPaused[config.source] && (
+                              <div className="text-[9px] text-amber-200/70 flex items-center gap-2" role="status">
+                                <span>Embedding paused: {embeddingPaused[config.source]}</span>
+                                <button type="button" disabled={reindexing}
+                                  onClick={() => void handleResumeEmbedding(config.source)}
+                                  className="h-5 px-1.5 rounded bg-white/[0.04] hover:bg-white/[0.08] text-amber-200/90 disabled:opacity-35">
+                                  Resume
+                                </button>
+                              </div>
+                            )}
                           </>
                         )}
                       </div>
@@ -2052,13 +2117,29 @@ export function SourcesPanel(props: Props) {
                             <Database className="h-2.5 w-2.5" />
                             Rescan changes
                           </button>
-                          <button type="button" disabled={reindexing}
+                          <button type="button" disabled={reindexing || config.embedding_enabled === false}
                             onClick={() => setReembedFor(config.source)}
-                            title="Embed every file of this source again with the active model — shows the estimated cost first"
+                            title={config.embedding_enabled === false
+                              ? 'Semantic embedding is off — turn it on in the platform settings first'
+                              : 'Embed every file of this source again with the active model — shows the estimated cost first'}
                             className="h-6 px-2 rounded-md bg-white/[0.04] hover:bg-white/[0.08] text-[9px] font-medium text-cyan-300/80 hover:text-cyan-200 transition disabled:opacity-35 inline-flex items-center gap-1">
                             <RefreshCcw className="h-2.5 w-2.5" />
                             Re-embed…
                           </button>
+                          {(() => {
+                            const off = config.embedding_enabled === false;
+                            return (
+                              <button type="button" disabled={reindexing || off}
+                                onClick={() => setEmbedPendingFor(config.source)}
+                                title={off
+                                  ? 'Semantic embedding is off — turn it on in the platform settings first'
+                                  : 'Embed only the files whose semantic embedding is missing or stale — shows the estimate first'}
+                                className="h-6 px-2 rounded-md bg-white/[0.04] hover:bg-white/[0.08] text-[9px] font-medium text-cyan-300/80 hover:text-cyan-200 transition disabled:opacity-35 inline-flex items-center gap-1">
+                                <Database className="h-2.5 w-2.5" />
+                                Embed pending…
+                              </button>
+                            );
+                          })()}
                           <button type="button" disabled={resettingSource === config.source}
                             onClick={() => void handleResetSync(config.source)}
                             title="Forgets what the last sync saw — the next sync compares every file again. Deletes no file and no vector."
@@ -2122,6 +2203,18 @@ export function SourcesPanel(props: Props) {
                   onConfirm={(opts) => void handleDelete(config.source, opts)}
                 />
               )}
+              {embedPendingFor === config.source && (
+                <ReembedDialog
+                  kind="pending"
+                  agentId={agentId}
+                  {...(projectId ? { projectId } : {})}
+                  target={{ source: config.source, label: config.source }}
+                  onClose={() => setEmbedPendingFor(null)}
+                  onStarted={() =>
+                    void followReindex(config.source, () => Promise.resolve(), 'Embedding failed')
+                  }
+                />
+              )}
               {reembedFor === config.source && (
                 <ReembedDialog
                   agentId={agentId}
@@ -2149,7 +2242,7 @@ export function SourcesPanel(props: Props) {
 
       {/* Vector Health */}
       <div className="border-t border-white/[0.06] pt-2 mt-3">
-        <button type="button" onClick={() => setHealthOpen((v) => !v)}
+        <button type="button" onClick={() => setVectorHealthOpen(!healthOpen)}
           className="flex items-center gap-2 py-1.5 w-full text-left">
           <Database className="h-4 w-4 text-cyan-400 shrink-0" />
           <span className="text-sm font-semibold text-white/92 flex-1">Vector Health</span>
@@ -2189,13 +2282,13 @@ export function SourcesPanel(props: Props) {
               arguments to print usage:
             </p>
             <div className="rounded bg-black/30 border border-white/[0.05] p-2">
-              <pre className="text-[11px] font-mono text-white/85 whitespace-pre-wrap break-all">pnpm neuralis:mount</pre>
+              <pre className="text-[11px] font-mono text-white/85 whitespace-pre-wrap break-all">neuralis mount</pre>
             </div>
             <div className="rounded bg-black/30 border border-white/[0.05] p-2 space-y-1">
               <div className="text-[9px] uppercase tracking-wider text-white/40 font-semibold">
                 Example — expose a host folder as a mount
               </div>
-              <pre className="text-[10px] font-mono text-white/80 whitespace-pre-wrap break-all">pnpm neuralis:mount add &lt;host-path&gt; --slug &lt;name&gt;</pre>
+              <pre className="text-[10px] font-mono text-white/80 whitespace-pre-wrap break-all">neuralis mount add &lt;host-path&gt; --slug &lt;name&gt;</pre>
               <div className="text-[9px] text-white/35 italic">
                 The CLI is infra-only: it registers the bind mount + host-pair
                 env in the machine-local compose override, never a source.

package/app/filesystem/ui/VectorHealthPanel.tsx

@@ -7,6 +7,7 @@ import { hasFeature } from '@neuralis/package-system/access';
 import { useFilesystemHost } from '../FilesystemHost';
 import { cn } from '../lib/cn';
 import { checkVectorHealth, scanVectorHealth, runHealthAction, getSourcesHealth } from '../api';
+import { useFilesystemStore } from '../store/filesystemStore';
 
 type Props = {
   agentId: string;
@@ -29,9 +30,19 @@ type HealthReport = {
     last_sync?: string;
     sync_status?: string;
   }>;
+  embedding?: { enabled: boolean; mode: 'metadata' | 'dense' | null; missing: number; stale: number };
   generatedAt?: string;
 };
 
+/** "Semantic: off / metadata only / dense (N missing · M stale)" — `null` for an older server. */
+export function semanticLine(embedding: HealthReport['embedding']): string | null {
+  if (!embedding) return null;
+  const owed = `${embedding.missing} missing · ${embedding.stale} stale`;
+  if (!embedding.enabled) return `Semantic: off — text and field search only (${owed} if turned on)`;
+  if (embedding.mode !== 'dense') return `Semantic: metadata only — no embedding model active (${owed})`;
+  return `Semantic: dense (${owed})`;
+}
+
 type ActionKind = 'gc' | 'repair-orphans' | 'repair-pending' | 'deduplicate';
 type ActionResult = Record<string, unknown>;
 
@@ -63,6 +74,7 @@ const ACTION_COPY: Record<ActionKind, { label: string; explainer: string; toolti
 };
 
 export function VectorHealthPanel({ agentId, projectId }: Props) {
+  const client = useFilesystemStore((s) => s.client);
   const host = useFilesystemHost();
   // A mirror only — the server's `drive.write` escalation is the gate.
   const canWrite = hasFeature({ grantedFeatures: [...(host.grantedFeatures ?? [])] }, 'drive.write');
@@ -98,8 +110,8 @@ export function VectorHealthPanel({ agentId, projectId }: Props) {
       // table so it surfaces real "when was this source last synced"
       // info instead of being a count-only view.
       const [data, sourcesHealth] = await Promise.all([
-        checkVectorHealth({ agentId, ...(projectId ? { projectId } : {}) }),
-        getSourcesHealth({ agentId, ...(projectId ? { projectId } : {}) })
+        checkVectorHealth({ agentId, ...(projectId ? { projectId } : {}) }, client),
+        getSourcesHealth({ agentId, ...(projectId ? { projectId } : {}) }, client)
           .catch(() => [] as Array<{ source: string; last_sync?: string; sync_status: string }>),
       ]);
       const lastSyncBySource = new Map<string, { last_sync?: string; sync_status: string }>();
@@ -128,7 +140,7 @@ export function VectorHealthPanel({ agentId, projectId }: Props) {
     setScanLoading(true);
     setError(null);
     try {
-      const result = await scanVectorHealth({ agentId, ...(projectId ? { projectId } : {}) });
+      const result = await scanVectorHealth({ agentId, ...(projectId ? { projectId } : {}) }, client);
       setScan({ orphanChunkCount: result.orphanChunkCount ?? 0, duplicateGroups: result.duplicateGroups ?? 0 });
     } catch (err) {
       setError(err instanceof Error ? err.message : 'Scan failed');
@@ -158,7 +170,7 @@ export function VectorHealthPanel({ agentId, projectId }: Props) {
     // we're actually deleting something (`dryRun=false`).
     setPrevReport(!dryRun ? report : null);
     try {
-      const result = await runHealthAction({ agentId, ...(projectId ? { projectId } : {}), action, dryRun, retentionHours });
+      const result = await runHealthAction({ agentId, ...(projectId ? { projectId } : {}), action, dryRun, retentionHours }, client);
       setActionResult(result);
       if (!dryRun) {
         void fetchReport();
@@ -239,6 +251,10 @@ export function VectorHealthPanel({ agentId, projectId }: Props) {
             ))}
           </div>
 
+          {semanticLine(report.embedding) && (
+            <div className="text-[9px] text-white/45" role="status">{semanticLine(report.embedding)}</div>
+          )}
+
           {/* Metadata */}
           <div className="flex items-center gap-3 text-[9px] text-white/35">
             <span>Total points: {report.totalPoints ?? '-'}</span>

package/app/filesystem/ui/pendingChangesModel.ts

@@ -11,6 +11,7 @@
 
 import { normalizePolicyUri } from '@neuralis/package-system/policies';
 import { ackHintFor } from '@neuralis/brain-core/domain/pending-change';
+export { acceptsAbsence } from '@neuralis/brain-core/domain/pending-change';
 import type { GitControlStatus, GitRepoInfo } from '../domain/types';
 import type { PendingChangeRecord, PendingPreview } from '../api';
 import { computeLcsDiff, type DiffHunk } from '../../cards/diffUtils';
@@ -133,17 +134,19 @@ export function isMeasuredRow(kind: ChangeItem['kind']): boolean {
 /**
  * Split the first `cap` visible, non-orphaned records into the ones the Approve
  * sweep can take as-is and the ones its record already proves need an
- * acknowledgement. `externalChanged`/`unreviewable` are known only from a preview,
- * so the sweep still reports them per record after it runs.
+ * acknowledgement. `externalChanged`/`unreviewable` are known only from a preview:
+ * a record whose ALREADY-LOADED preview (`knownPreview`, never a fetch) needs one
+ * counts as needing it; the rest the sweep hands to the review dialog after it runs.
  */
-export function splitApprovable(visible: PendingChangeRecord[], orphanIds: ReadonlySet<string>, cap = 100): {
+export function splitApprovable(visible: PendingChangeRecord[], orphanIds: ReadonlySet<string>, cap = 100,
+  knownPreview?: (id: string) => PendingPreview | undefined): {
   approvable: PendingChangeRecord[]; needsAck: PendingChangeRecord[];
 } {
   const approvable: PendingChangeRecord[] = [];
   const needsAck: PendingChangeRecord[] = [];
   for (const rec of visible) {
     if (orphanIds.has(rec.id)) continue;
-    if (ackHintFor(rec)) needsAck.push(rec);
+    if (ackHintFor(rec) || knownPreview?.(rec.id)?.requiresAcknowledgement.length) needsAck.push(rec);
     else if (approvable.length < cap) approvable.push(rec);
   }
   return { approvable, needsAck };
@@ -154,7 +157,8 @@ export type ReviewOutcome = 'ok' | 'changed' | 'needs-ack' | 'error';
 /** The refusal a review verb answered, named for the per-record result row. */
 export function classifyReviewOutcome(error: unknown): Exclude<ReviewOutcome, 'ok'> {
   const message = error instanceof Error ? error.message : String(error ?? '');
-  if (message.includes('PENDING_STATE_CHANGED')) return 'changed';
+  // The record's point moved under the preview: the same "check again" answer.
+  if (message.includes('PENDING_STATE_CHANGED') || message.includes('PENDING_GENERATION_CHANGED')) return 'changed';
   if (message.includes('CURRENT_STATE_ACKNOWLEDGEMENT_REQUIRED')) return 'needs-ack';
   return 'error';
 }