Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
Show file names under titles in the folder view (PRD-10217) (#8076)
Dimitri POSTOLOV1fd12768e39d
diff --git a/.changeset/folder-overview-file-names.md b/.changeset/folder-overview-file-names.mdnew file mode 100644index 000000000..9ae0c50b6--- /dev/null+++ b/.changeset/folder-overview-file-names.md@@ -0,0 +1,5 @@+---+"@inkeep/open-knowledge": patch+---++The folder view now shows a file's name under its title when the two differ, so each row matches the file tree.diff --git a/packages/app/src/components/FolderOverview.tsx b/packages/app/src/components/FolderOverview.tsxindex 7e790072f..ee8aff8ce 100644--- a/packages/app/src/components/FolderOverview.tsx+++ b/packages/app/src/components/FolderOverview.tsx@@ -241,7 +241,14 @@ export function FolderOverview({ folderPath }: { folderPath: string }) {) : (<File className="size-4 shrink-0 text-muted-foreground" />)}- <span className="truncate">{entry.title}</span>+ <span className="flex min-w-0 flex-col">+ <span className="truncate">{entry.title}</span>+ {entry.fileName && (+ <span className="truncate text-xs text-muted-foreground">+ {entry.fileName}+ </span>+ )}+ </span></a></TableCell><TableCell className="text-muted-foreground">diff --git a/packages/app/src/components/folder-overview-data.test.ts b/packages/app/src/components/folder-overview-data.test.tsindex bebecc7e6..38dfdeba4 100644--- a/packages/app/src/components/folder-overview-data.test.ts+++ b/packages/app/src/components/folder-overview-data.test.ts@@ -30,12 +30,13 @@ describe('buildFolderOverviewData', () => {expect(data.children).toEqual([{ kind: 'folder', path: 'reports/q2', name: 'q2', title: 'q2' },- { kind: 'folder', path: 'reports/q1', name: 'q1', title: 'Quarter One' },+ { kind: 'folder', path: 'reports/q1', name: 'q1', title: 'Quarter One', fileName: 'q1' },{kind: 'file',path: 'reports/monthly',name: 'monthly',title: 'Monthly Review',+ fileName: 'monthly.md',size: 150,modified: '2026-04-11T00:00:00Z',},@@ -44,6 +45,7 @@ describe('buildFolderOverviewData', () => {path: 'reports/index',name: 'index',title: 'Reports',+ fileName: 'index.md',size: 100,modified: '2026-04-10T00:00:00Z',},@@ -52,6 +54,7 @@ describe('buildFolderOverviewData', () => {path: 'reports/weekly',name: 'weekly',title: 'Weekly Review',+ fileName: 'weekly.md',size: 200,modified: '2026-04-12T00:00:00Z',},@@ -69,6 +72,29 @@ describe('buildFolderOverviewData', () => {expect(data.children[0]).toMatchObject({ kind: 'file', title: 'readme' });});+ test('file name takes the extension the listing reports', () => {+ const data = buildFolderOverviewData('docs', {+ pages: new Set(['docs/guide']),+ pageTitles: new Map([['docs/guide', 'Getting started']]),+ pageMeta: new Map([['docs/guide', { size: 1, modified: '', docExt: '.mdx' }]]),+ folderPaths: new Set(),+ });++ expect(data.children[0]).toMatchObject({ title: 'Getting started', fileName: 'guide.mdx' });+ });++ test('no file name when the title already is the full file name', () => {+ const data = buildFolderOverviewData('docs', {+ pages: new Set(['docs/notes']),+ pageTitles: new Map([['docs/notes', 'Notes.md']]),+ pageMeta: new Map(),+ folderPaths: new Set(),+ });++ expect(data.children[0]).toMatchObject({ title: 'Notes.md' });+ expect(data.children[0]?.fileName).toBeUndefined();+ });+test('content-root (empty folderPath) lists only top-level children', () => {const data = buildFolderOverviewData('', {pages: new Set(['intro', 'README', 'docs/a', 'docs/b', 'reports/q1/summary']),diff --git a/packages/app/src/components/folder-overview-data.ts b/packages/app/src/components/folder-overview-data.tsindex d2e738b58..3813eb773 100644--- a/packages/app/src/components/folder-overview-data.ts+++ b/packages/app/src/components/folder-overview-data.ts@@ -1,8 +1,17 @@+import { docNameToTreePath } from './file-tree-adapter';import type { PageMeta } from './PageListContext';export type FolderOverviewEntry =- | { kind: 'folder'; path: string; name: string; title: string }- | { kind: 'file'; path: string; name: string; title: string; size: number; modified: string };+ | { kind: 'folder'; path: string; name: string; title: string; fileName?: string }+ | {+ kind: 'file';+ path: string;+ name: string;+ title: string;+ fileName?: string;+ size: number;+ modified: string;+ };interface FolderOverviewData {title: string;@@ -41,6 +50,18 @@ function resolveTitle(return leafName;}+function fileNameUnlessTitleShowsIt(+ title: string,+ fileName: string,+ stem = fileName,+): string | undefined {+ const label = title.toLocaleLowerCase();+ if (label === stem.toLocaleLowerCase() || label === fileName.toLocaleLowerCase()) {+ return undefined;+ }+ return fileName;+}+export function buildFolderOverviewData(folderPath: string,options: {@@ -56,12 +77,16 @@ export function buildFolderOverviewData(.filter((path) => path.startsWith(prefix)).map((path) => ({ path, rel: path.slice(prefix.length) })).filter((e) => e.rel.length > 0 && !e.rel.includes('/'))- .map(({ path, rel }) => ({- kind: 'folder' as const,- path,- name: rel,- title: getFolderTitle(path, options.pageTitles),- }));+ .map(({ path, rel }) => {+ const title = getFolderTitle(path, options.pageTitles);+ return {+ kind: 'folder' as const,+ path,+ name: rel,+ title,+ fileName: fileNameUnlessTitleShowsIt(title, rel),+ };+ });const files: FolderOverviewEntry[] = [...options.pages].filter((docName) => docName.startsWith(prefix))@@ -69,11 +94,14 @@ export function buildFolderOverviewData(.filter((e) => e.rel.length > 0 && !e.rel.includes('/')).map(({ docName, rel }) => {const meta = options.pageMeta.get(docName);+ const title = resolveTitle(docName, rel, options.pageTitles);+ const fileName = docNameToTreePath(rel, meta?.docExt);return {kind: 'file' as const,path: docName,name: rel,- title: resolveTitle(docName, rel, options.pageTitles),+ title,+ fileName: fileNameUnlessTitleShowsIt(title, fileName, rel),size: meta?.size ?? 0,modified: meta?.modified ?? '',};diff --git a/packages/app/tests/stress/folder-overview-file-names.e2e.ts b/packages/app/tests/stress/folder-overview-file-names.e2e.tsnew file mode 100644index 000000000..dbec37a43--- /dev/null+++ b/packages/app/tests/stress/folder-overview-file-names.e2e.ts@@ -0,0 +1,33 @@+import { expect, test } from './_helpers';++test.describe('folder overview file names', () => {+ test('each row shows its title, with the file name under a title that differs from it', async ({+ page,+ api,+ }) => {+ await api.seedDocs([+ { name: 'overview-names/burndown', markdown: '# Burndown\n\nRemaining work.\n' },+ {+ name: 'overview-names/do-performance',+ markdown: '---\ntitle: DO performance & capacity\n---\n\nLoad numbers.\n',+ },+ {+ name: 'overview-names/plain-notes',+ markdown: 'Notes with no frontmatter and no heading.\n',+ },+ { name: 'overview-names/ui-tracker', markdown: '# OK Cloud features\n\nWhat to build.\n' },+ ]);++ await page.goto('/#/overview-names/');++ await expect(page.getByRole('table').getByRole('link')).toHaveText(+ [+ 'Burndown',+ 'DO performance & capacity\ndo-performance.md',+ 'OK Cloud features\nui-tracker.md',+ 'plain-notes',+ ],+ { useInnerText: true, timeout: 20_000 },+ );+ });+});