LLM Wiki is a cross-platform desktop application that turns your documents into an organized, interlinked knowledge base — automatically. Instead of traditional RAG (retrieve-and-answer from scratch every time), the LLM incrementally builds and maintains a persistent wiki from your sources。
TypeScript
perf: centralize project file tree refresh
nash_su5bf5dd4bc02f
diff --git a/src/components/chat/chat-message.tsx b/src/components/chat/chat-message.tsxindex aa8b3bb8..718a99bb 100644--- a/src/components/chat/chat-message.tsx+++ b/src/components/chat/chat-message.tsx@@ -32,6 +32,7 @@ import { inferWikiTypeFromPath } from "@/lib/wiki-page-types"import { cleanAssistantContentForWikiSave, titleFromCleanAssistantContent } from "@/lib/chat-save-to-wiki"import type { ChatAgentEvent, ChatAgentEventStage, ChatAgentStep } from "@/lib/chat-agent"import { filterRawSourceTree } from "@/lib/source-filter"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"// Module-level cache of source file nameslet cachedSourceFiles: string[] = []@@ -229,7 +230,6 @@ function CopyButton({ content }: { content: string }) {function SaveToWikiButton({ content, visible }: { content: string; visible: boolean }) {const project = useWikiStore((s) => s.project)- const setFileTree = useWikiStore((s) => s.setFileTree)const [saved, setSaved] = useState(false)const [saving, setSaving] = useState(false)@@ -294,9 +294,7 @@ function SaveToWikiButton({ content, visible }: { content: string; visible: boolawait writeFile(logPath, logContent.trimEnd() + "\n" + logEntry)// Refresh file tree and update graph- const tree = await listDirectory(pp)- setFileTree(tree)- useWikiStore.getState().bumpDataVersion()+ await refreshProjectFileTree(pp, { bumpDataVersion: true })setSaved(true)setTimeout(() => setSaved(false), 2000)@@ -314,7 +312,7 @@ function SaveToWikiButton({ content, visible }: { content: string; visible: bool} finally {setSaving(false)}- }, [project, content, saving, setFileTree])+ }, [project, content, saving])if (!visible && !saved) return nulldiff --git a/src/components/chat/chat-panel.tsx b/src/components/chat/chat-panel.tsxindex eff0dffd..558d766d 100644--- a/src/components/chat/chat-panel.tsx+++ b/src/components/chat/chat-panel.tsx@@ -9,7 +9,7 @@ import { useWikiStore } from "@/stores/wiki-store"import { isReasoningOnlyResponseError, streamChat } from "@/lib/llm-client"import { supportsImageInput } from "@/lib/llm-providers"import { executeIngestWrites } from "@/lib/ingest"-import { listDirectory, deleteFile } from "@/commands/fs"+import { deleteFile } from "@/commands/fs"import { getFileName, normalizePath } from "@/lib/path-utils"import { hasConfiguredAnyTxt } from "@/lib/anytxt-search"import { buildChatAgentMessages, type ChatAgentEvent } from "@/lib/chat-agent"@@ -18,6 +18,7 @@ import { WikiReader } from "@/components/editor/wiki-reader"import { FrontmatterPanel } from "@/components/editor/frontmatter-panel"import { parseFrontmatter } from "@/lib/frontmatter"import { getFileCategory } from "@/lib/file-types"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"// Store the page mapping from the last query so SourceFilesBar can show which pages were citedexport let lastQueryPages: { title: string; path: string }[] = []@@ -155,7 +156,6 @@ export function ChatPanel() {const searchApiConfig = useWikiStore((s) => s.searchApiConfig)const anyTxtAvailable = hasConfiguredAnyTxt(searchApiConfig.anyTxt)const imageInputAvailable = supportsImageInput(llmConfig)- const setFileTree = useWikiStore((s) => s.setFileTree)const abortRef = useRef<AbortController | null>(null)const runIdRef = useRef(0)@@ -360,16 +360,11 @@ export function ChatPanel() {const pp = normalizePath(project.path)try {await executeIngestWrites(pp, llmConfig, undefined, undefined)- try {- const tree = await listDirectory(pp)- setFileTree(tree)- } catch {- // ignore- }+ await refreshProjectFileTree(pp)} catch (err) {console.error("Failed to write to wiki:", err)}- }, [project, llmConfig, setFileTree])+ }, [project, llmConfig])const hasAssistantMessages = activeMessages.some((m) => m.role === "assistant")const showWriteButton = mode === "ingest" && !isStreaming && hasAssistantMessagesdiff --git a/src/components/layout/app-layout.tsx b/src/components/layout/app-layout.tsxindex 7dcb6945..65499e73 100644--- a/src/components/layout/app-layout.tsx+++ b/src/components/layout/app-layout.tsx@@ -1,7 +1,6 @@import { useCallback, useEffect, useRef, useState } from "react"import { useWikiStore } from "@/stores/wiki-store"-import { listDirectory } from "@/commands/fs"-import { normalizePath } from "@/lib/path-utils"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"import { IconSidebar } from "./icon-sidebar"import { UpdateBanner } from "./update-banner"import { SidebarPanel } from "./sidebar-panel"@@ -16,31 +15,10 @@ interface AppLayoutProps {onSwitchProject: () => void}-async function loadDirectoryWithRetry(- path: string,- options: Parameters<typeof listDirectory>[1],- attempts = 2,-): Promise<Awaited<ReturnType<typeof listDirectory>>> {- let lastError: unknown- for (let i = 0; i < attempts; i += 1) {- try {- return await listDirectory(path, options)- } catch (err) {- lastError = err- if (i < attempts - 1) {- await new Promise((resolve) => setTimeout(resolve, 250))- }- }- }- throw lastError-}-export function AppLayout({ onSwitchProject }: AppLayoutProps) {const project = useWikiStore((s) => s.project)const activeView = useWikiStore((s) => s.activeView)const researchPanelOpen = useResearchStore((s) => s.panelOpen)- const setFileTree = useWikiStore((s) => s.setFileTree)- const setProjectPathIndexFromTree = useWikiStore((s) => s.setProjectPathIndexFromTree)const [leftWidth, setLeftWidth] = useState(220)const [rightWidth, setRightWidth] = useState(400)const isDraggingLeft = useRef(false)@@ -49,26 +27,11 @@ export function AppLayout({ onSwitchProject }: AppLayoutProps) {const loadFileTree = useCallback(async () => {if (!project) return- const projectId = project.id- const projectPath = normalizePath(project.path)- setFileTree([], { syncPathIndex: false })- try {- const tree = await listDirectory(projectPath, { maxDepth: 2 })- if (useWikiStore.getState().project?.id !== projectId) return- setFileTree(tree)- } catch (err) {- console.error("Failed to load file tree:", err)- }-- loadDirectoryWithRetry(projectPath, undefined, 3)- .then((tree) => {- if (useWikiStore.getState().project?.id !== projectId) return- setProjectPathIndexFromTree(tree)- })- .catch((err) => {- console.error("Failed to build project path index:", err)- })- }, [project, setFileTree, setProjectPathIndexFromTree])+ await refreshProjectFileTree(project.path, {+ projectId: project.id,+ clearDisplayTreeFirst: true,+ })+ }, [project])useEffect(() => {loadFileTree()diff --git a/src/components/layout/knowledge-tree.tsx b/src/components/layout/knowledge-tree.tsxindex 93b0d14a..c055abbb 100644--- a/src/components/layout/knowledge-tree.tsx+++ b/src/components/layout/knowledge-tree.tsx@@ -8,6 +8,7 @@ import { useWikiStore } from "@/stores/wiki-store"import { readFile, listDirectory } from "@/commands/fs"import type { FileNode } from "@/types/wiki"import { normalizePath } from "@/lib/path-utils"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"import { cascadeDeleteWikiPagesWithRefs } from "@/lib/wiki-page-delete"import { inferWikiTypeFromPath, wikiTypeLabel } from "@/lib/wiki-page-types"import { filterRawSourceTree } from "@/lib/source-filter"@@ -43,8 +44,6 @@ export function KnowledgeTree() {const setSelectedFile = useWikiStore((s) => s.setSelectedFile)const openPathInPreview = useWikiStore((s) => s.openPathInPreview)const fileTree = useWikiStore((s) => s.fileTree)- const setFileTree = useWikiStore((s) => s.setFileTree)- const bumpDataVersion = useWikiStore((s) => s.bumpDataVersion)const [pages, setPages] = useState<WikiPageInfo[]>([])const [expandedTypes, setExpandedTypes] = useState<Set<string>>(new Set(["overview", "entity", "concept", "source"]))// Two-stage delete: first click arms the row, second click executes.@@ -104,12 +103,13 @@ export function KnowledgeTree() {// Refresh: page list, file tree, any data-version subscribers.await loadPages()try {- const tree = await listDirectory(pp)- setFileTree(tree)+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })} catch {// non-critical}- bumpDataVersion()if (selectedFile === pagePath) setSelectedFile(null)} catch (err) {console.error("[KnowledgeTree] delete failed:", err)@@ -118,7 +118,7 @@ export function KnowledgeTree() {setDeletingPath(null)}},- [project, armedPath, loadPages, selectedFile, setSelectedFile, setFileTree, bumpDataVersion],+ [project, armedPath, loadPages, selectedFile, setSelectedFile],)if (!project) {diff --git a/src/components/lint/lint-view.tsx b/src/components/lint/lint-view.tsxindex c2966620..9f4f20eb 100644--- a/src/components/lint/lint-view.tsx+++ b/src/components/lint/lint-view.tsx@@ -18,8 +18,9 @@ import { useReviewStore } from "@/stores/review-store"import { useLintStore, type LintItem } from "@/stores/lint-store"import { runStructuralLint, runSemanticLint } from "@/lib/lint"import { hasUsableLlm } from "@/lib/has-usable-llm"-import { readFile, writeFile, listDirectory } from "@/commands/fs"+import { readFile, writeFile } from "@/commands/fs"import { normalizePath } from "@/lib/path-utils"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"import {appendWikilink,ensureBrokenLinkStub,@@ -54,8 +55,6 @@ export function LintView() {const project = useWikiStore((s) => s.project)const llmConfig = useWikiStore((s) => s.llmConfig)const openFileInPreview = useWikiStore((s) => s.openFileInPreview)- const setFileTree = useWikiStore((s) => s.setFileTree)- const bumpDataVersion = useWikiStore((s) => s.bumpDataVersion)// Dynamic type config based on i18nconst typeConfig = useMemo(() => ({@@ -212,9 +211,10 @@ export function LintView() {}// Refresh tree- const tree = await listDirectory(pp)- setFileTree(tree)- bumpDataVersion()+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })} catch (err) {console.error("Fix failed:", err)setFixError(err instanceof Error ? err.message : String(err))@@ -242,9 +242,10 @@ export function LintView() {)await cascadeDeleteWikiPagesWithRefs(pp, [pagePath])useLintStore.getState().removeItem(item.id)- const tree = await listDirectory(pp)- setFileTree(tree)- bumpDataVersion()+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })} catch (err) {console.error("Delete failed:", err)}diff --git a/src/components/review/review-view.tsx b/src/components/review/review-view.tsxindex 0d198282..fc1c2e83 100644--- a/src/components/review/review-view.tsx+++ b/src/components/review/review-view.tsx@@ -15,8 +15,9 @@ import {import { Button } from "@/components/ui/button"import { useReviewStore, type ReviewItem } from "@/stores/review-store"import { useWikiStore } from "@/stores/wiki-store"-import { writeFile, readFile, listDirectory, deleteFile } from "@/commands/fs"+import { writeFile, readFile, deleteFile } from "@/commands/fs"import { normalizePath } from "@/lib/path-utils"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"import { hasConfiguredDeepResearchSources } from "@/lib/web-search"import { makeQueryFileName } from "@/lib/wiki-filename"import { createReviewPageDrafts } from "@/lib/review-create-page"@@ -39,7 +40,6 @@ export function ReviewView() {const clearResolved = useReviewStore((s) => s.clearResolved)const setItems = useReviewStore((s) => s.setItems)const project = useWikiStore((s) => s.project)- const setFileTree = useWikiStore((s) => s.setFileTree)const [refreshing, setRefreshing] = useState(false)// Reload review items from disk. The review pane has no equivalent of@@ -116,11 +116,11 @@ export function ReviewView() {try { logContent = await readFile(logPath) } catch { logContent = "# Wiki Log\n" }await writeFile(logPath, logContent.trimEnd() + `\n- ${date}: Saved query page \`${fileName}\`\n`)- // Refresh tree- const tree = await listDirectory(pp)- setFileTree(tree)+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })useWikiStore.getState().openFileInPreview(filePath, pageContent)- useWikiStore.getState().bumpDataVersion()resolveItem(id, "Saved to Wiki")} catch (err) {@@ -154,8 +154,10 @@ export function ReviewView() {const filePath = action.slice(7)try {await deleteFile(filePath)- const tree = await listDirectory(pp)- setFileTree(tree)+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })resolveItem(id, "Deleted")} catch (err) {console.error("Failed to delete:", err)@@ -237,12 +239,12 @@ export function ReviewView() {const logDate = created[0]?.date ?? makeQueryFileName("review").dateawait writeFile(logPath, logContent.trimEnd() + `\n- ${logDate}: Created ${created.length} page${created.length === 1 ? "" : "s"} from review: ${createdNames}\n`)- // Refresh- const tree = await listDirectory(pp)- setFileTree(tree)+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })const first = created[0]if (first) useWikiStore.getState().openFileInPreview(first.filePath, first.pageContent)- useWikiStore.getState().bumpDataVersion()resolveItem(id, created.length === 1? `Created: wiki/${created[0].dir}/${created[0].fileName}`@@ -257,7 +259,7 @@ export function ReviewView() {} else {resolveItem(id, action)}- }, [project, items, resolveItem, setFileTree])+ }, [project, items, resolveItem])const pending = items.filter((i) => !i.resolved)const resolved = items.filter((i) => i.resolved)diff --git a/src/components/sources/sources-view.tsx b/src/components/sources/sources-view.tsxindex 3f102f85..177d69df 100644--- a/src/components/sources/sources-view.tsx+++ b/src/components/sources/sources-view.tsx@@ -20,6 +20,7 @@ import {importSourceFolder,} from "@/lib/source-lifecycle"import { filterRawSourceTree } from "@/lib/source-filter"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"const SOURCE_TREE_INITIAL_ROWS = 160const SOURCE_TREE_LOAD_BATCH = 160@@ -30,7 +31,6 @@ export function SourcesView() {const selectedFile = useWikiStore((s) => s.selectedFile)const setSelectedFile = useWikiStore((s) => s.setSelectedFile)const openFileInPreview = useWikiStore((s) => s.openFileInPreview)- const setFileTree = useWikiStore((s) => s.setFileTree)const llmConfig = useWikiStore((s) => s.llmConfig)const sourceWatchConfig = useWikiStore((s) => s.sourceWatchConfig)const dataVersion = useWikiStore((s) => s.dataVersion)@@ -187,9 +187,10 @@ export function SourcesView() {// Step 8: Refresh everything (UI side — must run with parent// context, hence kept here rather than inside the helper).await loadSources()- const tree = await listDirectory(pp)- setFileTree(tree)- useWikiStore.getState().bumpDataVersion()+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })if (selectedFile === node.path ||result.deletedWikiPaths.includes(selectedFile ?? "")@@ -222,9 +223,10 @@ export function SourcesView() {try {const result = await deleteSourceFolder(pp, folder)await loadSources()- const tree = await listDirectory(pp)- setFileTree(tree)- useWikiStore.getState().bumpDataVersion()+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })if (selectedFile?.startsWith(folder.path + "/") ||result.deletedWikiPaths.includes(selectedFile ?? "")diff --git a/src/lib/clip-watcher.ts b/src/lib/clip-watcher.tsindex 3e5923e1..47a12e19 100644--- a/src/lib/clip-watcher.ts+++ b/src/lib/clip-watcher.ts@@ -1,7 +1,7 @@import { useWikiStore } from "@/stores/wiki-store"import { enqueueIngest } from "./ingest-queue"-import { listDirectory } from "@/commands/fs"import { hasUsableLlm } from "@/lib/has-usable-llm"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"const POLL_INTERVAL = 3000 // Check every 3 secondslet intervalId: ReturnType<typeof setInterval> | null = null@@ -29,12 +29,7 @@ export function startClipWatcher() {// Refresh file tree if clip is for current projectif (project && clipProjectPath === project.path) {- try {- const tree = await listDirectory(project.path)- store.setFileTree(tree)- } catch {- // ignore- }+ await refreshProjectFileTree(project.path, { projectId: project.id })// Enqueue (not auto-ingest directly) so the task lands in the// persisted queue, shows up in the activity panel, and survivesdiff --git a/src/lib/deep-research.ts b/src/lib/deep-research.tsindex febc12b4..4d635907 100644--- a/src/lib/deep-research.ts+++ b/src/lib/deep-research.ts@@ -2,12 +2,13 @@ import { anyTxtSearchSmart, hasConfiguredAnyTxt } from "./anytxt-search"import { hasConfiguredSearchProvider, resolveSearchConfig, webSearch } from "./web-search"import { streamChat } from "./llm-client"import { autoIngest, currentWikiDate } from "./ingest"-import { writeFile, readFile, listDirectory } from "@/commands/fs"+import { writeFile, readFile } from "@/commands/fs"import { useWikiStore, type LlmConfig, type SearchApiConfig } from "@/stores/wiki-store"import { useResearchStore } from "@/stores/research-store"import { normalizePath } from "@/lib/path-utils"import { buildLanguageDirective } from "@/lib/output-language"import { makeQueryFileName } from "@/lib/wiki-filename"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"const MAX_RESEARCH_SOURCES = 20@@ -328,13 +329,8 @@ async function executeResearch(savedPath,})) return- // Refresh treetry {- const tree = await listDirectory(pp)- if (isActiveProjectPath(pp)) {- useWikiStore.getState().setFileTree(tree)- useWikiStore.getState().bumpDataVersion()- }+ await refreshProjectFileTree(pp, { bumpDataVersion: true })} catch {// ignore}diff --git a/src/lib/ingest.ts b/src/lib/ingest.tsindex 07c1e1c9..47e1e9d5 100644--- a/src/lib/ingest.ts+++ b/src/lib/ingest.ts@@ -39,6 +39,7 @@ import { captionMarkdownImages, loadCaptionCache } from "@/lib/image-caption-pipimport type { MultimodalConfig } from "@/stores/wiki-store"import { GENERATION_WIKI_TYPES } from "@/lib/wiki-page-types"import { computeContextBudget } from "@/lib/context-budget"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"const LONG_SOURCE_MIN_BUDGET = 8_000const LONG_SOURCE_MAX_SINGLE_PASS_BUDGET = 300_000@@ -1109,9 +1110,7 @@ async function autoIngestImpl(if (writtenPaths.length > 0) {try {- const tree = await listDirectory(pp)- useWikiStore.getState().setFileTree(tree)- useWikiStore.getState().bumpDataVersion()+ await refreshProjectFileTree(pp, { bumpDataVersion: true })} catch {// ignore}diff --git a/src/lib/project-file-sync.test.ts b/src/lib/project-file-sync.test.tsindex 7f5c1538..3453e7a5 100644--- a/src/lib/project-file-sync.test.ts+++ b/src/lib/project-file-sync.test.ts@@ -486,7 +486,8 @@ describe("project file sync", () => {await rescanProjectFileSync(project)- expect(mocks.listDirectory).toHaveBeenCalledWith("/tmp/a")+ expect(mocks.listDirectory).toHaveBeenNthCalledWith(1, "/tmp/a", { maxDepth: 2 })+ expect(mocks.listDirectory).toHaveBeenNthCalledWith(2, "/tmp/a", undefined)})it("manual rescan respects auto ingest disabled", async () => {diff --git a/src/lib/project-file-sync.ts b/src/lib/project-file-sync.tsindex f879b55f..f0710532 100644--- a/src/lib/project-file-sync.ts+++ b/src/lib/project-file-sync.ts@@ -1,5 +1,5 @@import { listen, type UnlistenFn } from "@tauri-apps/api/event"-import { readFile, listDirectory } from "@/commands/fs"+import { readFile } from "@/commands/fs"import {rescanProjectFiles,startProjectFileWatcher,@@ -19,6 +19,7 @@ import {isIngestableSourcePath,} from "@/lib/source-lifecycle"import { isPathAllowedBySourceWatch, normalizeSourceWatchConfig } from "@/lib/source-watch-config"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"let unlistenQueue: UnlistenFn | null = nulllet unlistenChanged: UnlistenFn | null = null@@ -184,14 +185,10 @@ async function processFileChangeBatch(async function refreshAfterFileChanges(project: WikiProject, relativePaths: string[]): Promise<void> {const pp = normalizePath(project.path)const store = useWikiStore.getState()- try {- const tree = await listDirectory(pp)- useWikiStore.getState().setFileTree(tree)- } catch (err) {- console.warn("[file-sync] failed to refresh file tree:", err)- }-- store.bumpDataVersion()+ await refreshProjectFileTree(pp, {+ projectId: project.id,+ bumpDataVersion: true,+ })const selected = store.selectedFile ? normalizePath(store.selectedFile) : nullif (!selected) returndiff --git a/src/lib/project-file-tree-refresh.test.ts b/src/lib/project-file-tree-refresh.test.tsnew file mode 100644index 00000000..d3c36685--- /dev/null+++ b/src/lib/project-file-tree-refresh.test.ts@@ -0,0 +1,104 @@+import { beforeEach, describe, expect, it, vi } from "vitest"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"+import { useWikiStore } from "@/stores/wiki-store"+import type { FileNode, WikiProject } from "@/types/wiki"++const mocks = vi.hoisted(() => ({+ listDirectory: vi.fn(),+}))++vi.mock("@/commands/fs", () => ({+ listDirectory: mocks.listDirectory,+}))++const project: WikiProject = {+ id: "project-1",+ name: "Project",+ path: "/tmp/project",+}++const shallowTree: FileNode[] = [+ {+ name: "wiki",+ path: "/tmp/project/wiki",+ is_dir: true,+ children: [],+ },+]++const fullTree: FileNode[] = [+ {+ name: "wiki",+ path: "/tmp/project/wiki",+ is_dir: true,+ children: [+ {+ name: "entities",+ path: "/tmp/project/wiki/entities",+ is_dir: true,+ children: [+ {+ name: "alpha.md",+ path: "/tmp/project/wiki/entities/alpha.md",+ is_dir: false,+ },+ ],+ },+ ],+ },+]++async function flushMicrotasks() {+ await Promise.resolve()+ await Promise.resolve()+}++describe("refreshProjectFileTree", () => {+ beforeEach(() => {+ mocks.listDirectory.mockReset()+ useWikiStore.setState({+ project,+ fileTree: [],+ projectPathIndex: { byPath: new Map(), filesByName: new Map() },+ dataVersion: 0,+ })+ })++ it("updates the visible tree shallowly and refreshes the full resolver index in the background", async () => {+ mocks.listDirectory.mockImplementation(async (_path: string, options?: { maxDepth?: number }) =>+ options?.maxDepth === 2 ? shallowTree : fullTree+ )++ await refreshProjectFileTree(project.path, {+ projectId: project.id,+ bumpDataVersion: true,+ })+ await flushMicrotasks()++ expect(mocks.listDirectory).toHaveBeenNthCalledWith(1, project.path, { maxDepth: 2 })+ expect(mocks.listDirectory).toHaveBeenNthCalledWith(2, project.path, undefined)+ expect(useWikiStore.getState().fileTree).toEqual(shallowTree)+ expect(useWikiStore.getState().projectPathIndex.byPath.has("/tmp/project/wiki/entities/alpha.md")).toBe(true)+ expect(useWikiStore.getState().dataVersion).toBe(1)+ })++ it("does not write stale results after the active project changes", async () => {+ mocks.listDirectory.mockImplementation(async (_path: string, options?: { maxDepth?: number }) =>+ options?.maxDepth === 2 ? shallowTree : fullTree+ )+ useWikiStore.setState({+ project: { ...project, id: "other-project", path: "/tmp/other" },+ })++ await refreshProjectFileTree(project.path, {+ projectId: project.id,+ clearDisplayTreeFirst: true,+ bumpDataVersion: true,+ })+ await flushMicrotasks()++ expect(useWikiStore.getState().fileTree).toEqual([])+ expect(useWikiStore.getState().projectPathIndex.byPath.size).toBe(0)+ expect(useWikiStore.getState().dataVersion).toBe(0)+ })+})diff --git a/src/lib/project-file-tree-refresh.ts b/src/lib/project-file-tree-refresh.tsnew file mode 100644index 00000000..29c2e8a6--- /dev/null+++ b/src/lib/project-file-tree-refresh.ts@@ -0,0 +1,77 @@+import { listDirectory } from "@/commands/fs"+import { useWikiStore } from "@/stores/wiki-store"+import { normalizePath } from "@/lib/path-utils"++export interface RefreshProjectFileTreeOptions {+ projectId?: string+ clearDisplayTreeFirst?: boolean+ bumpDataVersion?: boolean+ refreshDisplayTree?: boolean+ refreshPathIndex?: boolean+}++async function listDirectoryWithRetry(+ path: string,+ options: Parameters<typeof listDirectory>[1],+ attempts = 3,+): Promise<Awaited<ReturnType<typeof listDirectory>>> {+ let lastError: unknown+ for (let i = 0; i < attempts; i += 1) {+ try {+ return await listDirectory(path, options)+ } catch (err) {+ lastError = err+ if (i < attempts - 1) {+ await new Promise((resolve) => setTimeout(resolve, 250))+ }+ }+ }+ throw lastError+}++function isStillCurrentProject(projectId: string | undefined, projectPath: string): boolean {+ const current = useWikiStore.getState().project+ if (!current) return false+ if (projectId && current.id !== projectId) return false+ return normalizePath(current.path) === projectPath+}++export async function refreshProjectFileTree(+ projectPath: string,+ options: RefreshProjectFileTreeOptions = {},+): Promise<void> {+ const normalizedProjectPath = normalizePath(projectPath)+ const currentProjectId = options.projectId ?? useWikiStore.getState().project?.id+ const refreshDisplayTree = options.refreshDisplayTree ?? true+ const refreshPathIndex = options.refreshPathIndex ?? true++ if (options.clearDisplayTreeFirst && isStillCurrentProject(currentProjectId, normalizedProjectPath)) {+ useWikiStore.getState().setFileTree([], { syncPathIndex: false })+ }++ if (refreshDisplayTree) {+ try {+ const shallowTree = await listDirectory(normalizedProjectPath, { maxDepth: 2 })+ if (isStillCurrentProject(currentProjectId, normalizedProjectPath)) {+ useWikiStore.getState().setFileTree(shallowTree)+ }+ } catch (err) {+ console.error("Failed to refresh project file tree:", err)+ }+ }++ if (refreshPathIndex) {+ listDirectoryWithRetry(normalizedProjectPath, undefined, 3)+ .then((fullTree) => {+ if (!isStillCurrentProject(currentProjectId, normalizedProjectPath)) return+ useWikiStore.getState().setProjectPathIndexFromTree(fullTree)+ })+ .catch((err) => {+ console.error("Failed to refresh project path index:", err)+ })+ }++ if (options.bumpDataVersion && isStillCurrentProject(currentProjectId, normalizedProjectPath)) {+ useWikiStore.getState().bumpDataVersion()+ }+}diff --git a/src/lib/scheduled-import.ts b/src/lib/scheduled-import.tsindex 543c653f..0844cc5b 100644--- a/src/lib/scheduled-import.ts+++ b/src/lib/scheduled-import.ts@@ -21,6 +21,7 @@ import {isIngestableSourcePath,} from "@/lib/source-lifecycle"import { useActivityStore } from "@/stores/activity-store"+import { refreshProjectFileTree } from "@/lib/project-file-tree-refresh"interface ImportDb {files: Record<string, string>@@ -413,9 +414,10 @@ export async function scanAndImport(for (const file of changedFiles) {nextDb.files[file.key] = file.md5}- const projectTree = await listDirectory(projectPath)- useWikiStore.getState().setFileTree(projectTree)- useWikiStore.getState().bumpDataVersion()+ await refreshProjectFileTree(projectPath, {+ projectId: project.id,+ bumpDataVersion: true,+ })} else {console.warn("[scheduled-import] LLM is not configured; changed files were not marked imported")}