fix: refresh button no longer crashes on large vaults (v3.13.3)

Always use folder-scoped refresh from the button, even at vault root, instead of falling back to the heavy full-vault loadFiles(). Replace flushSync with safe async yield to prevent React render crashes. Add concurrency guard to prevent overlapping refresh operations.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: eldinmiller

CHANGELOG.md

@@ -2,6 +2,15 @@
 
 All notable changes to BluePLM will be documented in this file.
 
+## [3.13.3] - 2026-02-09
+
+### Fixed
+- **Refresh button no longer crashes on large vaults**: The file browser refresh button at vault root was falling back to `loadFiles()` — a heavy full-vault reload that blocks the main process and can freeze or crash the app on large vaults (25k+ files). The button now always uses the lightweight folder-scoped refresh, which works correctly at root too
+- **Refresh button no longer crashes React**: The refresh handler used `flushSync` to force a synchronous render, which throws if called during an existing React render cycle (e.g., rapid clicks or concurrent transitions). Replaced with a safe async yield to the UI thread
+- **Rapid refresh clicks no longer corrupt file list**: Added a concurrency guard so overlapping refresh operations are skipped instead of running in parallel and corrupting state
+
+---
+
 ## [3.13.2] - 2026-02-05
 
 ### Improved

package.json

@@ -1,6 +1,6 @@
 {
   "name": "blue-plm",
-  "version": "3.13.2",
+  "version": "3.13.3",
   "description": "Open-source Product Lifecycle Management",
   "main": "dist-electron/main.js",
   "scripts": {

src/features/source/browser/FilePane.tsx

@@ -1376,12 +1376,12 @@ export function FilePane({ onRefresh, onRefreshFolder }: FilePaneProps) {
         onRefresh={() => {
           logExplorer('FilePane onRefresh', { 
             currentPath: currentPath || '(root)', 
-            useFolderRefresh: !!(currentPath && onRefreshFolder) 
+            useFolderRefresh: !!onRefreshFolder 
           })
-          // Use folder-scoped refresh when in a subfolder (faster)
-          // Fall back to full refresh at root or if folder refresh unavailable
-          if (currentPath && onRefreshFolder) {
-            onRefreshFolder(currentPath)
+          // Always use folder-scoped refresh (works at root with empty string too)
+          // Never fall back to loadFiles() which is too heavy for a refresh button
+          if (onRefreshFolder) {
+            onRefreshFolder(currentPath || '')
           } else {
             onRefresh()
           }

src/hooks/useLoadFiles.ts

@@ -1,5 +1,5 @@
 import { useCallback, startTransition } from 'react'
-import { flushSync } from 'react-dom'
+// flushSync removed - causes React crashes when called during existing render cycles
 import { usePDMStore } from '@/stores/pdmStore'
 import { getFilesLightweight, getCheckedOutUsers, getVaultFolders } from '@/lib/supabase'
 import { executeCommand } from '@/lib/commands'
@@ -1301,14 +1301,17 @@ export function useLoadFiles() {
     window.electronAPI?.log('info', '[RefreshFolder] Called with', { folderPath, vaultPath })
     if (!window.electronAPI || !vaultPath) return
 
-    // Force React to render loading state immediately before heavy work
-    // flushSync ensures the spinner is visible before the IPC call is made
-    logExplorer('refreshCurrentFolder BEFORE flushSync')
-    flushSync(() => {
-      setIsLoading(true)
-      setStatusMessage(`Refreshing folder...`)
-    })
-    logExplorer('refreshCurrentFolder AFTER flushSync')
+    // Guard against concurrent refreshes
+    if (usePDMStore.getState().isLoading) {
+      window.electronAPI?.log('info', '[RefreshFolder] Skipping - already refreshing')
+      return
+    }
+    
+    // Set loading state and yield to UI thread so spinner renders before heavy work
+    // (replaces flushSync which can crash React if called during an existing render cycle)
+    setIsLoading(true)
+    setStatusMessage(`Refreshing folder...`)
+    await new Promise(resolve => setTimeout(resolve, 0))
 
     try {
       // 1. Get existing files from store