Skip to content

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.tsx
index 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 names
let 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: bool
await 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 null
diff --git a/src/components/chat/chat-panel.tsx b/src/components/chat/chat-panel.tsx
index 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 cited
export 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 && hasAssistantMessages
diff --git a/src/components/layout/app-layout.tsx b/src/components/layout/app-layout.tsx
index 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.tsx
index 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.tsx
index 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 i18n
const 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.tsx
index 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").date
await 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.tsx
index 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 = 160
const 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.ts
index 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 seconds
let intervalId: ReturnType<typeof setInterval> | null = null
@@ -29,12 +29,7 @@ export function startClipWatcher() {
// Refresh file tree if clip is for current project
if (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 survives
diff --git a/src/lib/deep-research.ts b/src/lib/deep-research.ts
index 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 tree
try {
- 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.ts
index 07c1e1c9..47e1e9d5 100644
--- a/src/lib/ingest.ts
+++ b/src/lib/ingest.ts
@@ -39,6 +39,7 @@ import { captionMarkdownImages, loadCaptionCache } from "@/lib/image-caption-pip
import 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_000
const 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.ts
index 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.ts
index 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 = null
let 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) : null
if (!selected) return
diff --git a/src/lib/project-file-tree-refresh.test.ts b/src/lib/project-file-tree-refresh.test.ts
new file mode 100644
index 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.ts
new file mode 100644
index 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.ts
index 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")
}