Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
fix(open-knowledge): hide seeded opencode.json from the file tree (#2184)
Andrew Mikofalvye98d25115dc9
diff --git a/.changeset/hide-opencode-json-config.md b/.changeset/hide-opencode-json-config.mdnew file mode 100644index 000000000..6aebc4e9f--- /dev/null+++ b/.changeset/hide-opencode-json-config.md@@ -0,0 +1,8 @@+---+"@inkeep/open-knowledge-core": patch+"@inkeep/open-knowledge-app": patch+---++Hide the seeded `opencode.json` agent config from the file tree++OpenKnowledge seeds `opencode.json` at the project root so OpenCode's MCP wiring works. Unlike the other agent configs (`.mcp.json`, `.cursor/`, `.codex/`), OpenCode's config filename is fixed and not dot-prefixed, so the dot-prefix "hidden file" convention skipped it and it surfaced as a normal file. A new `HIDDEN_CONFIG_BASENAMES` allowlist, consumed by `isHiddenDocName`, now classifies it as hidden everywhere the dotfile configs already are: the sidebar (behind the Show hidden files toggle), search ranking, and agent egress.diff --git a/packages/app/src/components/file-tree-utils.test.ts b/packages/app/src/components/file-tree-utils.test.tsindex 506179f25..91743d437 100644--- a/packages/app/src/components/file-tree-utils.test.ts+++ b/packages/app/src/components/file-tree-utils.test.ts@@ -96,12 +96,31 @@ describe('filterVisibleEntries', () => {).toEqual([{ kind: 'asset', path: 'images/logo.png' }]);});+ test('hides the non-dotted opencode.json agent config at root and nested', () => {+ expect(+ filterVisibleEntries([+ { kind: 'document' as const, docName: 'README' },+ { kind: 'asset' as const, path: 'opencode.json' },+ { kind: 'asset' as const, path: 'tools/opencode.json' },+ ]),+ ).toEqual([{ kind: 'document', docName: 'README' }]);+ });++ test('showHiddenFiles=true reveals opencode.json', () => {+ const entries = [+ { kind: 'document' as const, docName: 'README' },+ { kind: 'asset' as const, path: 'opencode.json' },+ ];+ expect(filterVisibleEntries(entries, true)).toEqual(entries);+ });+test('returns empty array when every entry is hidden', () => {expect(filterVisibleEntries([{ kind: 'folder' as const, path: '.claude' },{ kind: 'document' as const, docName: '.claude/agents/foo' },{ kind: 'folder' as const, path: '.codex' },+ { kind: 'asset' as const, path: 'opencode.json' },]),).toEqual([]);});diff --git a/packages/app/src/components/file-tree-utils.ts b/packages/app/src/components/file-tree-utils.tsindex e19ae1ef2..060577260 100644--- a/packages/app/src/components/file-tree-utils.ts+++ b/packages/app/src/components/file-tree-utils.ts@@ -1,4 +1,8 @@-import type { DocumentListEntry, InlineAssetMediaKind } from '@inkeep/open-knowledge-core';+import {+ type DocumentListEntry,+ type InlineAssetMediaKind,+ isHiddenDocName,+} from '@inkeep/open-knowledge-core';export interface DocumentEntry {kind: 'document';@@ -161,6 +165,6 @@ export function filterVisibleEntries<T extends { kind?: unknown; docName?: strinconst ref = entry.docName ?? entry.path ?? '';if (ref === '') return false;if (showHiddenFiles) return true;- return !ref.split('/').some((seg) => seg.startsWith('.'));+ return !isHiddenDocName(ref);});}diff --git a/packages/core/src/index.ts b/packages/core/src/index.tsindex 1e00e629f..e304ed71b 100644--- a/packages/core/src/index.ts+++ b/packages/core/src/index.ts@@ -948,7 +948,12 @@ export type {ShadowContributor,TimelineEntry,} from './types/timeline.ts';-export { isHiddenDocName, isValidDocName, validateDocName } from './util/doc-name.ts';+export {+ HIDDEN_CONFIG_BASENAMES,+ isHiddenDocName,+ isValidDocName,+ validateDocName,+} from './util/doc-name.ts';export { applyByPrefixSuffix } from './utils/apply-by-prefix-suffix.ts';export { toDesktopAssetHref } from './utils/asset-href.ts';export { ChunkedInsertError, chunkedYTextInsert } from './utils/chunked-insert.ts';diff --git a/packages/core/src/search/workspace-search.test.ts b/packages/core/src/search/workspace-search.test.tsindex 8ad3b9f58..406eea4ce 100644--- a/packages/core/src/search/workspace-search.test.ts+++ b/packages/core/src/search/workspace-search.test.ts@@ -185,6 +185,29 @@ describe('hidden / dot-path ranking — searchable but rank-deprioritized', () =expect(hiddenRank).toBeGreaterThanOrEqual(0);expect(visibleRank).toBeLessThan(hiddenRank);});++ const visibleConfigTwin = createWorkspaceSearchDocument({+ kind: 'page',+ path: 'notes/opencode',+ title: 'opencode',+ modifiedTs: 50,+ });+ const hiddenConfig = createWorkspaceSearchDocument({+ kind: 'page',+ path: 'opencode.json',+ title: 'opencode',+ modifiedTs: 50,+ });++ test('a non-dotted HIDDEN_CONFIG_BASENAMES path carries half the lexical bracket of its visible twin', () => {+ const results = searchWorkspaceDocuments([visibleConfigTwin, hiddenConfig], 'opencode', {+ intent: 'omnibar',+ });+ const v = results.find((result) => result.document.path === 'notes/opencode');+ const h = results.find((result) => result.document.path === 'opencode.json');+ expect(v?.signals.lexical).toBeGreaterThan(0);+ expect(h?.signals.lexical).toBe((v?.signals.lexical ?? 0) * 0.5);+ });});describe('canonical-kind ranking — markdown outranks a same-stem file (D5)', () => {diff --git a/packages/core/src/util/doc-name.test.ts b/packages/core/src/util/doc-name.test.tsindex f9dddb87d..f12e63ffd 100644--- a/packages/core/src/util/doc-name.test.ts+++ b/packages/core/src/util/doc-name.test.ts@@ -1,11 +1,35 @@import { describe, expect, test } from 'bun:test';-import { isHiddenDocName, isValidDocName, validateDocName } from './doc-name.ts';+import {+ HIDDEN_CONFIG_BASENAMES,+ isHiddenDocName,+ isValidDocName,+ validateDocName,+} from './doc-name.ts';describe('isHiddenDocName', () => {- for (const name of ['.cursor/skills/x', '.claude/foo', 'a/.hidden/b', '.okignore', 'a/.b'])+ for (const name of [+ '.cursor/skills/x',+ '.claude/foo',+ 'a/.hidden/b',+ '.okignore',+ 'a/.b',+ 'opencode.json',+ 'config/opencode.json',+ ])test(`hidden: ${JSON.stringify(name)}`, () => expect(isHiddenDocName(name)).toBe(true));- for (const name of ['Characters/Spike Spiegel', 'Music', 'a/b/c', 'note.with.dots'])+ for (const name of [+ 'Characters/Spike Spiegel',+ 'Music',+ 'a/b/c',+ 'note.with.dots',+ 'opencode.jsonx',+ 'opencode.json/notes',+ ])test(`visible: ${JSON.stringify(name)}`, () => expect(isHiddenDocName(name)).toBe(false));++ test('HIDDEN_CONFIG_BASENAMES contains the seeded opencode.json agent config', () => {+ expect(HIDDEN_CONFIG_BASENAMES.has('opencode.json')).toBe(true);+ });});describe('validateDocName', () => {diff --git a/packages/core/src/util/doc-name.ts b/packages/core/src/util/doc-name.tsindex b1102db51..cf39313d0 100644--- a/packages/core/src/util/doc-name.ts+++ b/packages/core/src/util/doc-name.ts@@ -39,6 +39,9 @@ export function isValidDocName(name: string): boolean {return validateDocName(name).ok;}+export const HIDDEN_CONFIG_BASENAMES: ReadonlySet<string> = new Set(['opencode.json']);+export function isHiddenDocName(name: string): boolean {- return name.split('/').some((segment) => segment.startsWith('.'));+ if (name.split('/').some((segment) => segment.startsWith('.'))) return true;+ return HIDDEN_CONFIG_BASENAMES.has(name.slice(name.lastIndexOf('/') + 1));}