feat: improve document management usability for issue 781

src/main/services/workspace-file-metadata.ts

@@ -0,0 +1,31 @@
+import { stat } from 'node:fs/promises'
+import type {
+  WorkspaceDirectoryListResult,
+  WorkspaceDirectoryTarget,
+  WorkspaceEntry
+} from '../../shared/workspace-file'
+import { listWorkspaceDirectory as listWorkspaceDirectoryWithoutMetadata } from './workspace-files'
+
+async function withEntryMetadata(entry: WorkspaceEntry): Promise<WorkspaceEntry> {
+  try {
+    const info = await stat(entry.path)
+    return {
+      ...entry,
+      mtimeMs: info.mtimeMs,
+      size: info.isFile() ? info.size : 0
+    }
+  } catch {
+    return entry
+  }
+}
+
+export async function listWorkspaceDirectory(
+  payload: WorkspaceDirectoryTarget
+): Promise<WorkspaceDirectoryListResult> {
+  const result = await listWorkspaceDirectoryWithoutMetadata(payload)
+  if (!result.ok) return result
+  return {
+    ...result,
+    entries: await Promise.all(result.entries.map(withEntryMetadata))
+  }
+}

src/main/services/workspace-service.ts

@@ -1,3 +1,4 @@
 export * from './workspace-paths'
 export * from './workspace-editors'
 export * from './workspace-files'
+export { listWorkspaceDirectory } from './workspace-file-metadata'

src/renderer/src/App.tsx

@@ -1,5 +1,6 @@
 import { lazy, Suspense } from 'react'
 import { AppErrorBoundary } from './components/AppErrorBoundary'
+import './lib/issue-781-document-usability'
 
 const AppShell = lazy(() => import('./AppShell'))
 

src/renderer/src/components/chat/ChatFileTreePanel.test.ts

@@ -1,17 +1,21 @@
 import { describe, expect, it } from 'vitest'
 import type { WorkspaceEntry } from '@shared/workspace-file'
 import {
+  compareChatFileTreeEntriesByModified,
   formatChatFileTreeUnsupportedMessage,
   isChatFileTreeIgnoredDirectory,
-  isChatFileTreePreviewableEntry
+  isChatFileTreePreviewableEntry,
+  sortChatFileTreeEntries
 } from './ChatFileTreePanel'
 
 function entry(overrides: Partial<WorkspaceEntry> & Pick<WorkspaceEntry, 'name' | 'type'>): WorkspaceEntry {
   return {
     name: overrides.name,
     type: overrides.type,
     path: overrides.path ?? `/tmp/project/${overrides.name}`,
-    ext: overrides.ext ?? ''
+    ext: overrides.ext ?? '',
+    ...(overrides.mtimeMs === undefined ? {} : { mtimeMs: overrides.mtimeMs }),
+    ...(overrides.size === undefined ? {} : { size: overrides.size })
   }
 }
 
@@ -31,4 +35,26 @@ describe('ChatFileTreePanel helpers', () => {
   it('formats unsupported preview titles without leaking UI state', () => {
     expect(formatChatFileTreeUnsupportedMessage('logo.png')).toContain('logo.png')
   })
+
+  it('sorts files by newest mtime before falling back to name', () => {
+    expect([
+      entry({ name: 'old.md', type: 'file', mtimeMs: 100 }),
+      entry({ name: 'new.md', type: 'file', mtimeMs: 300 }),
+      entry({ name: 'same-b.md', type: 'file', mtimeMs: 200 }),
+      entry({ name: 'same-a.md', type: 'file', mtimeMs: 200 })
+    ].sort(compareChatFileTreeEntriesByModified).map((item) => item.name)).toEqual([
+      'new.md',
+      'same-a.md',
+      'same-b.md',
+      'old.md'
+    ])
+  })
+
+  it('keeps directories before files in modified sort mode', () => {
+    expect(sortChatFileTreeEntries([
+      entry({ name: 'new.md', type: 'file', mtimeMs: 300 }),
+      entry({ name: 'docs', type: 'directory', mtimeMs: 100 }),
+      entry({ name: 'old.md', type: 'file', mtimeMs: 50 })
+    ], 'modified').map((item) => item.name)).toEqual(['docs', 'new.md', 'old.md'])
+  })
 })