Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

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.md
new file mode 100644
index 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.ts
index 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.ts
index 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?: strin
const 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.ts
index 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.ts
index 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.ts
index 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.ts
index 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));
}