Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Add About, docs and Discord to the desktop Help menu (PRD-8957) (#5796)

Andrew Mikofalvy013eb0d25bb1
diff --git a/.changeset/desktop-help-menu-links.md b/.changeset/desktop-help-menu-links.md
new file mode 100644
index 000000000..ce88b5c81
--- /dev/null
+++ b/.changeset/desktop-help-menu-links.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge-desktop": patch
+---
+
+The desktop Help menu now includes About on Windows and Linux, plus links to the documentation and Discord.
diff --git a/knip.config.ts b/knip.config.ts
index 65f0e8807..d3638888e 100644
--- a/knip.config.ts
+++ b/knip.config.ts
@@ -147,11 +147,15 @@ export default {
'packages/server': {
entry: ['src/**/*.test.ts', 'src/parse-worker.ts'],
project: 'src/**',
- ignoreDependencies: ['@types/shell-quote'],
+ ignoreDependencies: [
+ '@types/shell-quote',
+ ],
},
'packages/cli': {
entry: ['src/**/*.test.ts', 'scripts/*.ts', 'tests/**/*.ts', 'src/parse-worker.ts'],
- ignoreDependencies: ['yjs'],
+ ignoreDependencies: [
+ 'yjs',
+ ],
},
'packages/desktop': {
entry: [
diff --git a/packages/app/src/components/AppMenubar.dom.test.tsx b/packages/app/src/components/AppMenubar.dom.test.tsx
index 19d385ac8..95a7e0bc2 100644
--- a/packages/app/src/components/AppMenubar.dom.test.tsx
+++ b/packages/app/src/components/AppMenubar.dom.test.tsx
@@ -96,6 +96,47 @@ describe('AppMenubar Help menu', () => {
expect(screen.getByRole('menuitem', { name: 'Send feedback…' })).not.toBeNull();
expect(screen.getByRole('menuitem', { name: 'OpenKnowledge on GitHub' })).not.toBeNull();
});
+
+ test('lists the resource links after GitHub and ends with About', async () => {
+ installBridge('win32');
+ await openHelpMenu();
+
+ const labels = within(screen.getByRole('menu'))
+ .getAllByRole('menuitem')
+ .map((item) => item.textContent);
+ expect(labels).toEqual([
+ 'OpenKnowledge on GitHub',
+ 'Documentation',
+ 'Join us on Discord',
+ 'Report a bug…Ctrl+Shift+D',
+ 'Send feedback…',
+ 'About OpenKnowledge',
+ ]);
+ });
+
+ test.each([
+ ['Documentation', 'open-docs'],
+ ['Join us on Discord', 'open-discord'],
+ ] as const)('%s dispatches the %s command', async (name, command) => {
+ const dispatch = installBridge('win32');
+ await openHelpMenu();
+
+ await userEvent.click(screen.getByRole('menuitem', { name }));
+
+ expect(dispatch).toHaveBeenCalledWith({ kind: 'command', command });
+ });
+
+ test.each([
+ ['win32', 'About OpenKnowledge'],
+ ['linux', 'About'],
+ ] as const)('About on %s reads "%s" and dispatches the about role', async (platform, name) => {
+ const dispatch = installBridge(platform);
+ await openHelpMenu();
+
+ await userEvent.click(screen.getByRole('menuitem', { name }));
+
+ expect(dispatch).toHaveBeenCalledWith({ kind: 'role', role: 'about' });
+ });
});
describe('AppMenubar View navigation history', () => {
diff --git a/packages/app/src/components/AppMenubar.tsx b/packages/app/src/components/AppMenubar.tsx
index b302ec3bc..e9be8b357 100644
--- a/packages/app/src/components/AppMenubar.tsx
+++ b/packages/app/src/components/AppMenubar.tsx
@@ -19,7 +19,7 @@ import type {
OkMenuRendererSnapshot,
OkMenuUiDispatchRequest,
} from '@/lib/desktop-bridge-types';
-import { moveToTrashLabel, revealInFileManagerLabel } from '@/lib/platform-labels';
+import { aboutAppLabel, moveToTrashLabel, revealInFileManagerLabel } from '@/lib/platform-labels';
export function AppMenubar() {
const { t } = useLingui();
@@ -347,6 +347,12 @@ export function AppMenubar() {
<MenubarItem onSelect={() => dispatch({ kind: 'command', command: 'open-github' })}>
{t`OpenKnowledge on GitHub`}
</MenubarItem>
+ <MenubarItem onSelect={() => dispatch({ kind: 'command', command: 'open-docs' })}>
+ {t`Documentation`}
+ </MenubarItem>
+ <MenubarItem onSelect={() => dispatch({ kind: 'command', command: 'open-discord' })}>
+ {t`Join us on Discord`}
+ </MenubarItem>
<MenubarItem onSelect={() => dispatch({ kind: 'menu-action', action: 'report-bug' })}>
{t`Report a bug…`}
<MenubarShortcut>Ctrl+Shift+D</MenubarShortcut>
@@ -364,6 +370,10 @@ export function AppMenubar() {
</MenubarItem>
</>
)}
+ <MenubarSeparator />
+ <MenubarItem onSelect={() => dispatch({ kind: 'role', role: 'about' })}>
+ {aboutAppLabel(bridge.platform)}
+ </MenubarItem>
</MenubarContent>
</MenubarMenu>
</Menubar>
diff --git a/packages/app/src/components/HelpPopover.tsx b/packages/app/src/components/HelpPopover.tsx
index ff47169ff..ef5ba6eed 100644
--- a/packages/app/src/components/HelpPopover.tsx
+++ b/packages/app/src/components/HelpPopover.tsx
@@ -23,7 +23,7 @@ import { Popover, PopoverContent, PopoverTrigger } from '@/components/ui/popover
import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';
import { dispatchExternalLinkClick } from '@/lib/external-link';
import { feedbackNudgeStore } from '@/lib/feedback-nudge-store';
-import { DISCORD_INVITE_URL, GITHUB_REPO_URL, X_PROFILE_URL } from '@/lib/social-links';
+import { DISCORD_INVITE_URL, DOCS_URL, GITHUB_REPO_URL, X_PROFILE_URL } from '@/lib/social-links';
import { subscribeCardStore } from '@/lib/subscribe-card-store';
import { cn } from '@/lib/utils';
import { FeedbackFormDialog } from './FeedbackFormDialog';
@@ -48,7 +48,7 @@ const sections: ResourceSection[] = [
key: 'resources',
heading: msg`Resources`,
links: [
- { label: msg`Docs`, href: 'https://openknowledge.ai/docs', icon: BookOpen },
+ { label: msg`Docs`, href: DOCS_URL, icon: BookOpen },
{ label: msg`Download app`, href: 'https://openknowledge.ai/download', icon: Download },
],
},
diff --git a/packages/app/src/components/command-palette-commands.ts b/packages/app/src/components/command-palette-commands.ts
index 92e733064..66cc7b782 100644
--- a/packages/app/src/components/command-palette-commands.ts
+++ b/packages/app/src/components/command-palette-commands.ts
@@ -5,11 +5,16 @@ import {
evaluateCommandAvailability,
} from '@inkeep/open-knowledge-core/commands/command-identity';
import { SHOW_INSTALL_SKILL } from '@inkeep/open-knowledge-core/constants/feature-flags';
-import { OPEN_KNOWLEDGE_GITHUB_URL } from '@inkeep/open-knowledge-core/constants/menu-labels';
+import {
+ OPEN_KNOWLEDGE_DISCORD_URL,
+ OPEN_KNOWLEDGE_DOCS_URL,
+ OPEN_KNOWLEDGE_GITHUB_URL,
+} from '@inkeep/open-knowledge-core/constants/menu-labels';
import type { MessageDescriptor } from '@lingui/core';
import { msg, t } from '@lingui/core/macro';
import {
Blocks,
+ BookOpen,
Bug,
ChevronLeft,
ChevronRight,
@@ -45,6 +50,7 @@ import {
} from 'lucide-react';
import type { ComponentType } from 'react';
import { requestDocPanelTab } from '@/components/doc-panel-events';
+import { DiscordIcon } from '@/components/icons/discord';
import { GithubIcon } from '@/components/icons/github';
import type { ResolvedNavigationTarget } from '@/components/navigation-targets';
import { requestSkillsDockExpanded } from '@/components/skills-dock-expanded-store';
@@ -168,6 +174,8 @@ const PALETTE_COMMAND_LABELS = {
setUpIntegrations: msg`Set up OpenKnowledge integrations`,
checkSpelling: msg`Check spelling while typing`,
openOnGithub: msg`OpenKnowledge on GitHub`,
+ openDocs: msg`Documentation`,
+ joinDiscord: msg`Join us on Discord`,
} as const satisfies Record<string, MessageDescriptor>;
export type PaletteLabelKey = keyof typeof PALETTE_COMMAND_LABELS;
@@ -247,6 +255,8 @@ const COMMAND_ICONS: Record<string, ComponentType<{ className?: string }>> = {
'set-up-integrations': Blocks,
'toggle-spell-check': SpellCheck,
'open-github': GithubIcon,
+ 'open-docs': BookOpen,
+ 'open-discord': DiscordIcon,
};
const COMMAND_DISPATCH: Record<string, (ctx: PaletteCommandContext) => void> = {
@@ -337,6 +347,8 @@ const COMMAND_DISPATCH: Record<string, (ctx: PaletteCommandContext) => void> = {
await ctx.bridge?.spellcheck.toggle();
}),
'open-github': (ctx) => ctx.openExternalUrl(OPEN_KNOWLEDGE_GITHUB_URL),
+ 'open-docs': (ctx) => ctx.openExternalUrl(OPEN_KNOWLEDGE_DOCS_URL),
+ 'open-discord': (ctx) => ctx.openExternalUrl(OPEN_KNOWLEDGE_DISCORD_URL),
};
function paletteCoreContext(ctx: PaletteCommandContext): CommandContext {
diff --git a/packages/app/src/lib/command-menu-parity.uncached.test.ts b/packages/app/src/lib/command-menu-parity.uncached.test.ts
index 5d2d4288e..3000e58e2 100644
--- a/packages/app/src/lib/command-menu-parity.uncached.test.ts
+++ b/packages/app/src/lib/command-menu-parity.uncached.test.ts
@@ -91,6 +91,8 @@ const PALETTE_COMMAND_LABELS = new Set<string>([
'New Terminal',
'Kill Terminal',
'OpenKnowledge on GitHub',
+ 'Documentation',
+ 'Join us on Discord',
'Report a bug',
'Send feedback',
'Install for Claude Chat & Cowork (desktop app)',
@@ -522,6 +524,8 @@ describe('command identity registry (Phase 2b)', () => {
'set-up-integrations',
'toggle-spell-check',
'open-github',
+ 'open-docs',
+ 'open-discord',
]);
const missing = COMMAND_IDENTITIES.flatMap((cmd) =>
cmd.palette && !OVERRIDES.has(cmd.id) && cmd.menuActionId === undefined ? [cmd.id] : [],
diff --git a/packages/app/src/lib/platform-labels.ts b/packages/app/src/lib/platform-labels.ts
index f424a53e0..c56dce762 100644
--- a/packages/app/src/lib/platform-labels.ts
+++ b/packages/app/src/lib/platform-labels.ts
@@ -1,3 +1,4 @@
+import { PRODUCT_NAME } from '@inkeep/open-knowledge-core/constants/product';
import { t } from '@lingui/core/macro';
export function revealInFileManagerLabel(platform: string | null | undefined): string {
@@ -13,3 +14,9 @@ export function moveToTrashLabel(platform: string | null | undefined): string {
export function trashNounLabel(platform: string | null | undefined): string {
return platform === 'win32' ? t`Recycle Bin` : t`Trash`;
}
+
+export function aboutAppLabel(platform: string | null | undefined): string {
+ if (platform === 'linux') return t`About`;
+ const appName = PRODUCT_NAME;
+ return t`About ${appName}`;
+}
diff --git a/packages/app/src/lib/social-links.ts b/packages/app/src/lib/social-links.ts
index 09267f5ce..d9e69d7ee 100644
--- a/packages/app/src/lib/social-links.ts
+++ b/packages/app/src/lib/social-links.ts
@@ -1,3 +1,7 @@
-export const GITHUB_REPO_URL = 'https://github.com/inkeep/open-knowledge';
-export const DISCORD_INVITE_URL = 'https://discord.gg/VRKk2EaGHN';
+export {
+ OPEN_KNOWLEDGE_DISCORD_URL as DISCORD_INVITE_URL,
+ OPEN_KNOWLEDGE_DOCS_URL as DOCS_URL,
+ OPEN_KNOWLEDGE_GITHUB_URL as GITHUB_REPO_URL,
+} from '@inkeep/open-knowledge-core/constants/menu-labels';
+
export const X_PROFILE_URL = 'https://x.com/OpenKnowledge';
diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.po
index dd421bc45..0ab9e2865 100644
--- a/packages/app/src/locales/ar/messages.po
+++ b/packages/app/src/locales/ar/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "يوجد بالفعل مجلد شجرة عمل لذلك الفرع."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "حول"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "حول {appName}"
@@ -5355,6 +5357,8 @@ msgstr "هيكل الوثيقة"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "وثّق بنية هذا المستودع: أنشئ صفحة نظرة عامة ترتبط بصفحة لكل وحدة رئيسية تصف مسؤولياتها ونقاط دخولها."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "التوثيق"
@@ -8076,6 +8080,8 @@ msgstr "مائل"
msgid "Item {0}"
msgstr "العنصر {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "انضم إلينا على Discord"
diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.po
index 519b63a03..6cc3a976f 100644
--- a/packages/app/src/locales/bn/messages.po
+++ b/packages/app/src/locales/bn/messages.po
@@ -1557,10 +1557,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "ওই ব্রাঞ্চের জন্য একটি ওয়ার্কট্রি ফোল্ডার আগে থেকেই আছে।"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "সম্পর্কে"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "{appName} সম্পর্কে"
@@ -5351,6 +5353,8 @@ msgstr "নথি কাঠামো"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "এই রিপোজিটরির স্থাপত্য নথিভুক্ত করুন: একটি সংক্ষিপ্তসার পাতা তৈরি করুন যা প্রতিটি প্রধান মডিউলের পাতার সঙ্গে যুক্ত থাকে এবং তার দায়িত্ব ও প্রবেশবিন্দু বর্ণনা করে।"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "নথিপত্র"
@@ -8072,6 +8076,8 @@ msgstr "তির্যক"
msgid "Item {0}"
msgstr "আইটেম {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Discord-এ আমাদের সঙ্গে যোগ দিন"
diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.po
index 1da319910..323591b5a 100644
--- a/packages/app/src/locales/en/messages.po
+++ b/packages/app/src/locales/en/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "A worktree folder for that branch already exists."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "About"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "About {appName}"
@@ -5355,6 +5357,8 @@ msgstr "Document structure"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Documentation"
@@ -8076,6 +8080,8 @@ msgstr "Italic"
msgid "Item {0}"
msgstr "Item {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Join us on Discord"
diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.po
index 1ce84fbaf..6cbc1bc80 100644
--- a/packages/app/src/locales/es/messages.po
+++ b/packages/app/src/locales/es/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "Ya existe una carpeta de worktree para esa rama."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "Acerca de"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "Acerca de {appName}"
@@ -5355,6 +5357,8 @@ msgstr "Estructura del documento"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Documenta la arquitectura de este repositorio: crea una página general que enlace a una página por cada módulo principal describiendo sus responsabilidades y sus puntos de entrada."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Documentación"
@@ -8076,6 +8080,8 @@ msgstr "Cursiva"
msgid "Item {0}"
msgstr "Elemento {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Únete a nosotros en Discord"
diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.po
index 5a057c9f2..d2252102b 100644
--- a/packages/app/src/locales/fr/messages.po
+++ b/packages/app/src/locales/fr/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "Un dossier de worktree pour cette branche existe déjà."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "À propos"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "À propos de {appName}"
@@ -5355,6 +5357,8 @@ msgstr "Structure du document"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Documente l'architecture de ce dépôt : crée une page de synthèse qui renvoie vers une page par module principal décrivant ses responsabilités et ses points d'entrée."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Documentation"
@@ -8076,6 +8080,8 @@ msgstr "Italique"
msgid "Item {0}"
msgstr "Élément {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Rejoignez-nous sur Discord"
diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.po
index 6f4019ef4..d7cd54ce7 100644
--- a/packages/app/src/locales/hi/messages.po
+++ b/packages/app/src/locales/hi/messages.po
@@ -1557,10 +1557,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "उस ब्रांच के लिए एक वर्कट्री फ़ोल्डर पहले से मौजूद है।"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "परिचय"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "{appName} के बारे में"
@@ -5351,6 +5353,8 @@ msgstr "दस्तावेज़ संरचना"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "इस रिपॉज़िटरी की संरचना का दस्तावेज़ीकरण करें: एक सिंहावलोकन पेज बनाएँ जो हर प्रमुख मॉड्यूल के पेज से जुड़ता हो और उसकी ज़िम्मेदारियाँ तथा प्रवेश बिंदु बताता हो।"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "दस्तावेज़ीकरण"
@@ -8072,6 +8076,8 @@ msgstr "तिरछा"
msgid "Item {0}"
msgstr "आइटम {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Discord पर हमसे जुड़ें"
diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.po
index 1d66af6bb..d36403de9 100644
--- a/packages/app/src/locales/id/messages.po
+++ b/packages/app/src/locales/id/messages.po
@@ -1557,10 +1557,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "Folder worktree untuk cabang itu sudah ada."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "Tentang"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "Tentang {appName}"
@@ -5351,6 +5353,8 @@ msgstr "Struktur dokumen"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Dokumentasikan arsitektur repo ini: buat halaman ikhtisar yang menaut ke satu halaman per modul utama yang menjelaskan tanggung jawab dan titik masuknya."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Dokumentasi"
@@ -8072,6 +8076,8 @@ msgstr "Miring"
msgid "Item {0}"
msgstr "Item {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Gabung dengan kami di Discord"
diff --git a/packages/app/src/locales/ko/messages.po b/packages/app/src/locales/ko/messages.po
index 82651d7c9..9abe6570b 100644
--- a/packages/app/src/locales/ko/messages.po
+++ b/packages/app/src/locales/ko/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "해당 브랜치용 워크트리 폴더가 이미 있습니다."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "정보"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "{appName} 정보"
@@ -5355,6 +5357,8 @@ msgstr "문서 구조"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "이 리포지토리의 아키텍처를 문서화합니다. 개요 페이지를 만들고 각 주요 모듈의 책임과 진입점을 설명하는 페이지로 연결합니다."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "문서"
@@ -8076,6 +8080,8 @@ msgstr "기울임꼴"
msgid "Item {0}"
msgstr "항목 {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Discord에서 함께하기"
diff --git a/packages/app/src/locales/pl/messages.po b/packages/app/src/locales/pl/messages.po
index 4b53f14aa..63ec8f1a9 100644
--- a/packages/app/src/locales/pl/messages.po
+++ b/packages/app/src/locales/pl/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "Folder worktree dla tej gałęzi już istnieje."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "O programie"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "O programie {appName}"
@@ -5355,6 +5357,8 @@ msgstr "Struktura dokumentu"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Opisz architekturę tego repozytorium: utwórz stronę przeglądową prowadzącą do osobnej strony każdego głównego modułu, opisującą jego obowiązki i punkty wejścia."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Dokumentacja"
@@ -8076,6 +8080,8 @@ msgstr "Kursywa"
msgid "Item {0}"
msgstr "Element {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Dołącz do nas na Discordzie"
diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.po
index fbc32e363..542a70ccc 100644
--- a/packages/app/src/locales/pseudo/messages.po
+++ b/packages/app/src/locales/pseudo/messages.po
@@ -1557,10 +1557,12 @@ msgid "A worktree folder for that branch already exists."
msgstr ""
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr ""
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr ""
@@ -5351,6 +5353,8 @@ msgstr ""
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr ""
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr ""
@@ -8072,6 +8076,8 @@ msgstr ""
msgid "Item {0}"
msgstr ""
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr ""
diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.po
index 68969d2f0..81b8ad523 100644
--- a/packages/app/src/locales/pt-BR/messages.po
+++ b/packages/app/src/locales/pt-BR/messages.po
@@ -1557,10 +1557,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "Já existe uma pasta de worktree para esse ramo."
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "Sobre"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "Sobre o {appName}"
@@ -5351,6 +5353,8 @@ msgstr "Estrutura do documento"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "Documente a arquitetura deste repositório: crie uma página geral que aponte para uma página por módulo principal descrevendo suas responsabilidades e seus pontos de entrada."
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "Documentação"
@@ -8072,6 +8076,8 @@ msgstr "Itálico"
msgid "Item {0}"
msgstr "Item {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Entre no nosso Discord"
diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.po
index 387923e49..abb722a10 100644
--- a/packages/app/src/locales/ur/messages.po
+++ b/packages/app/src/locales/ur/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "اس برانچ کے لیے ورک ٹری فولڈر پہلے سے موجود ہے۔"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "تعارف"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "{appName} کے بارے میں"
@@ -5355,6 +5357,8 @@ msgstr "دستاویز کا ڈھانچہ"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "اس ریپو کے ڈھانچے کی دستاویز بنائیں: ایک جائزہ صفحہ بنائیں جو ہر بڑے ماڈیول کے صفحے سے جڑا ہو اور اس کی ذمہ داریاں اور داخلی نقاط بیان کرے۔"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "دستاویزات"
@@ -8076,6 +8080,8 @@ msgstr "ترچھا"
msgid "Item {0}"
msgstr "آئٹم {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "Discord پر ہمارے ساتھ شامل ہوں"
diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.po
index 1b7047546..58adc1661 100644
--- a/packages/app/src/locales/zh-Hans/messages.po
+++ b/packages/app/src/locales/zh-Hans/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "该分支的 worktree 文件夹已存在。"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "关于"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "关于 {appName}"
@@ -5355,6 +5357,8 @@ msgstr "文件结构"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "记录这个仓库的架构:创建一页总览,链接到每个主要模块的页面,说明各自的职责和入口。"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "文档"
@@ -8076,6 +8080,8 @@ msgstr "斜体"
msgid "Item {0}"
msgstr "项目 {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "来 Discord 加入我们"
diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.po
index c8c266462..c2313d9e4 100644
--- a/packages/app/src/locales/zh-Hant/messages.po
+++ b/packages/app/src/locales/zh-Hant/messages.po
@@ -1561,10 +1561,12 @@ msgid "A worktree folder for that branch already exists."
msgstr "該分支的 worktree 資料夾已存在。"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About"
msgstr "關於"
#: src/lib/native-menu-catalog.ts
+#: src/lib/platform-labels.ts
msgid "About {appName}"
msgstr "關於 {appName}"
@@ -5355,6 +5357,8 @@ msgstr "文件結構"
msgid "Document the architecture of this repo: create an overview page that links to a page per major module describing its responsibilities and entry points."
msgstr "記錄這個儲存庫的架構:建立一頁總覽,連到每個主要模組的頁面,說明各自的職責和進入點。"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/settings/markdownlint-rule-browser.tsx
msgid "Documentation"
msgstr "說明文件"
@@ -8076,6 +8080,8 @@ msgstr "斜體"
msgid "Item {0}"
msgstr "項目 {0}"
+#: src/components/AppMenubar.tsx
+#: src/components/command-palette-commands.ts
#: src/components/SubscribeCard.tsx
msgid "Join us on Discord"
msgstr "來 Discord 加入我們"
diff --git a/packages/app/tests/integration/bug3-source-mode-writeback.test.ts b/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
index a50b00123..4549c74b3 100644
--- a/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
+++ b/packages/app/tests/integration/bug3-source-mode-writeback.test.ts
@@ -1,3 +1,4 @@
+
import { readFileSync } from 'node:fs';
import { join } from 'node:path';
import { setTimeout as wait } from 'node:timers/promises';
diff --git a/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts b/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
index 6fcdc23f2..4fc2c11f9 100644
--- a/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
+++ b/packages/app/tests/integration/indented-jsx-byte-sacred.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { normalizeBridge } from '@inkeep/open-knowledge-core';
import { updateYFragment } from '@tiptap/y-tiptap';
diff --git a/packages/app/tests/integration/interior-edit-freshness.test.ts b/packages/app/tests/integration/interior-edit-freshness.test.ts
index 40b5cdfd6..9f2f6feb6 100644
--- a/packages/app/tests/integration/interior-edit-freshness.test.ts
+++ b/packages/app/tests/integration/interior-edit-freshness.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts b/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
index 93666af70..2a085742b 100644
--- a/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
+++ b/packages/app/tests/integration/keystroke-cadence-danger-space.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/producer-guard-wiring.test.ts b/packages/app/tests/integration/producer-guard-wiring.test.ts
index 867598d34..878d5196b 100644
--- a/packages/app/tests/integration/producer-guard-wiring.test.ts
+++ b/packages/app/tests/integration/producer-guard-wiring.test.ts
@@ -1,3 +1,4 @@
+
import { setTimeout as wait } from 'node:timers/promises';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
diff --git a/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts b/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
index 0970ac12f..4ada3cf26 100644
--- a/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
+++ b/packages/app/tests/integration/qa-039-reconciliation-counters-http.test.ts
@@ -1,3 +1,4 @@
+
import { randomUUID } from 'node:crypto';
import { afterEach, describe, expect, test } from 'vitest';
import { agentWriteMd, createTestServer, type TestServer } from './test-harness';
diff --git a/packages/app/tests/integration/qa-045-restore-after-gc.test.ts b/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
index b632185e1..cbe2b705f 100644
--- a/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
+++ b/packages/app/tests/integration/qa-045-restore-after-gc.test.ts
@@ -1,3 +1,4 @@
+
import { execFileSync } from 'node:child_process';
import { randomUUID } from 'node:crypto';
import { join } from 'node:path';
diff --git a/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts b/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
index c530ce4ba..89bc9b4d9 100644
--- a/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
+++ b/packages/app/tests/integration/qa-050-rollback-undo-shipped-path.test.ts
@@ -1,3 +1,4 @@
+
import { randomUUID } from 'node:crypto';
import { afterAll, afterEach, beforeAll, describe, expect, test } from 'vitest';
import type * as Y from 'yjs';
diff --git a/packages/app/tests/integration/undo-after-rollback.test.ts b/packages/app/tests/integration/undo-after-rollback.test.ts
index d3767adc9..a78aeb0e4 100644
--- a/packages/app/tests/integration/undo-after-rollback.test.ts
+++ b/packages/app/tests/integration/undo-after-rollback.test.ts
@@ -1,3 +1,4 @@
+
import { ROLLBACK_ORIGIN } from '@inkeep/open-knowledge-server';
import { afterAll, beforeAll, describe, expect, test } from 'vitest';
import * as Y from 'yjs';
diff --git a/packages/app/tests/integration/undo-recycle-reset.test.ts b/packages/app/tests/integration/undo-recycle-reset.test.ts
index b076f955c..e7cc69c3f 100644
--- a/packages/app/tests/integration/undo-recycle-reset.test.ts
+++ b/packages/app/tests/integration/undo-recycle-reset.test.ts
@@ -1,3 +1,4 @@
+
import { writeFileSync } from 'node:fs';
import { join } from 'node:path';
import { setTimeout as wait } from 'node:timers/promises';
diff --git a/packages/app/tests/integration/undo-rederive-survival.test.ts b/packages/app/tests/integration/undo-rederive-survival.test.ts
index 7935e35f8..9ddcd0730 100644
--- a/packages/app/tests/integration/undo-rederive-survival.test.ts
+++ b/packages/app/tests/integration/undo-rederive-survival.test.ts
@@ -1,3 +1,4 @@
+
import { prependFrontmatter } from '@inkeep/open-knowledge-core';
import { Plugin, PluginKey } from '@tiptap/pm/state';
import { updateYFragment, yXmlFragmentToProseMirrorRootNode } from '@tiptap/y-tiptap';
diff --git a/packages/core/src/bridge/compose.ts b/packages/core/src/bridge/compose.ts
index f4cc8a286..2a597ec3d 100644
--- a/packages/core/src/bridge/compose.ts
+++ b/packages/core/src/bridge/compose.ts
@@ -1,3 +1,4 @@
+
import { prependFrontmatter, stripFrontmatter } from '../extensions/frontmatter.ts';
export type ComposeAdjustment = 'none' | 'body' | 'frontmatter' | 'unresolved';
diff --git a/packages/core/src/bridge/doc-boundary-space.ts b/packages/core/src/bridge/doc-boundary-space.ts
index 8fb428b90..01ef76a9f 100644
--- a/packages/core/src/bridge/doc-boundary-space.ts
+++ b/packages/core/src/bridge/doc-boundary-space.ts
@@ -1,3 +1,4 @@
+
import { FRONTMATTER_RE, stripFrontmatter } from '../extensions/frontmatter.ts';
import { carriedEdgeEmpties, type DocEdgeEmpties } from '../markdown/doc-edge-blank-runs.ts';
diff --git a/packages/core/src/commands/command-identity.ts b/packages/core/src/commands/command-identity.ts
index 3f8e2854a..e679f12aa 100644
--- a/packages/core/src/commands/command-identity.ts
+++ b/packages/core/src/commands/command-identity.ts
@@ -324,7 +324,7 @@ export const COMMAND_IDENTITIES: readonly CommandIdentity[] = [
shortcutDesktopOnly: true,
availability: { host: 'desktop' },
palette: { group: 'project', visibility: 'always' },
- menu: [{ section: 'help-links', order: 1, ellipsis: true, accelerator: 'CmdOrCtrl+Shift+D' }],
+ menu: [{ section: 'help-links', order: 3, ellipsis: true, accelerator: 'CmdOrCtrl+Shift+D' }],
},
{
id: 'bug-report-history',
@@ -340,7 +340,7 @@ export const COMMAND_IDENTITIES: readonly CommandIdentity[] = [
keywords: ['feedback', 'suggestion', 'idea', 'rate', 'survey', 'contact', 'give'],
availability: {},
palette: { group: 'project', visibility: 'always' },
- menu: [{ section: 'help-links', order: 2, ellipsis: true }],
+ menu: [{ section: 'help-links', order: 4, ellipsis: true }],
},
{
id: 'new-from-template',
@@ -655,6 +655,22 @@ export const COMMAND_IDENTITIES: readonly CommandIdentity[] = [
palette: { group: 'app', visibility: 'search-only' },
menu: [{ section: 'help-links', order: 0 }],
},
+ {
+ id: 'open-docs',
+ labelKey: 'openDocs',
+ keywords: ['docs', 'documentation', 'help', 'guide', 'manual'],
+ availability: {},
+ palette: { group: 'app', visibility: 'search-only' },
+ menu: [{ section: 'help-links', order: 1 }],
+ },
+ {
+ id: 'open-discord',
+ labelKey: 'joinDiscord',
+ keywords: ['discord', 'community', 'chat', 'support', 'join'],
+ availability: {},
+ palette: { group: 'app', visibility: 'search-only' },
+ menu: [{ section: 'help-links', order: 2 }],
+ },
{
id: 'uninstall',
keywords: [],
diff --git a/packages/core/src/constants/menu-labels.ts b/packages/core/src/constants/menu-labels.ts
index 1525ec8d2..15f17b3b2 100644
--- a/packages/core/src/constants/menu-labels.ts
+++ b/packages/core/src/constants/menu-labels.ts
@@ -30,6 +30,8 @@ export const MENU_LABELS = {
killTerminal: 'Kill Terminal',
checkSpelling: 'Check spelling while typing',
openOnGithub: 'OpenKnowledge on GitHub',
+ openDocs: 'Documentation',
+ joinDiscord: 'Join us on Discord',
reportBug: 'Report a bug',
bugReportHistory: 'Bug report history',
sendFeedback: 'Send feedback',
@@ -78,3 +80,5 @@ export function menuLabelForPlatform(key: MenuLabelKey, platform: string): strin
}
export const OPEN_KNOWLEDGE_GITHUB_URL = 'https://github.com/inkeep/open-knowledge';
+export const OPEN_KNOWLEDGE_DOCS_URL = 'https://openknowledge.ai/docs';
+export const OPEN_KNOWLEDGE_DISCORD_URL = 'https://discord.gg/VRKk2EaGHN';
diff --git a/packages/core/src/desktop-bridge.ts b/packages/core/src/desktop-bridge.ts
index fda83c6c7..7a5eb0ef0 100644
--- a/packages/core/src/desktop-bridge.ts
+++ b/packages/core/src/desktop-bridge.ts
@@ -748,7 +748,8 @@ export type OkMenuDispatchRole =
| 'toggleFullScreen'
| 'minimize'
| 'close'
- | 'quit';
+ | 'quit'
+ | 'about';
export type OkMenuDispatchCommand =
| 'open-navigator'
@@ -758,6 +759,8 @@ export type OkMenuDispatchCommand =
| 'check-for-updates'
| 'reconfigure-mcp-wiring'
| 'open-github'
+ | 'open-docs'
+ | 'open-discord'
| 'toggle-spell-check';
export type OkMenuDispatchRequest =
diff --git a/packages/core/src/index.ts b/packages/core/src/index.ts
index 4c9385f1c..d28ff1984 100644
--- a/packages/core/src/index.ts
+++ b/packages/core/src/index.ts
@@ -502,6 +502,8 @@ export {
MENU_LABELS,
type MenuLabelKey,
menuLabelForPlatform,
+ OPEN_KNOWLEDGE_DISCORD_URL,
+ OPEN_KNOWLEDGE_DOCS_URL,
OPEN_KNOWLEDGE_GITHUB_URL,
PLATFORM_MENU_LABELS,
} from './constants/menu-labels.ts';
diff --git a/packages/core/src/markdown/comment-promoter.ts b/packages/core/src/markdown/comment-promoter.ts
index fc267cbea..fb0ba5a7c 100644
--- a/packages/core/src/markdown/comment-promoter.ts
+++ b/packages/core/src/markdown/comment-promoter.ts
@@ -1,3 +1,4 @@
+
import type { Nodes, Paragraph, PhrasingContent, Root, RootContent, Text } from 'mdast';
import { SKIP, visit } from 'unist-util-visit';
import type { VFile } from 'vfile';
diff --git a/packages/core/src/markdown/merged-walker.ts b/packages/core/src/markdown/merged-walker.ts
index bfd7e3109..fa3cfcd86 100644
--- a/packages/core/src/markdown/merged-walker.ts
+++ b/packages/core/src/markdown/merged-walker.ts
@@ -1,3 +1,4 @@
+
import type { Nodes, Parent, Root } from 'mdast';
import { SKIP, visit } from 'unist-util-visit';
import type { VFile } from 'vfile';
diff --git a/packages/core/src/markdown/safe-url.ts b/packages/core/src/markdown/safe-url.ts
index 4d3250d3a..8be632ba4 100644
--- a/packages/core/src/markdown/safe-url.ts
+++ b/packages/core/src/markdown/safe-url.ts
@@ -1,3 +1,4 @@
+
export const SAFE_URL_SCHEMES = ['https', 'http', 'mailto', 'tel', 'ftp', 'sms'] as const;
const SCHEME_ALT = SAFE_URL_SCHEMES.map((s) => `${s}:`).join('|');
diff --git a/packages/core/tests/contract/subpath-types/consumer.ts b/packages/core/tests/contract/subpath-types/consumer.ts
index 78f64d25d..952385d23 100644
--- a/packages/core/tests/contract/subpath-types/consumer.ts
+++ b/packages/core/tests/contract/subpath-types/consumer.ts
@@ -194,7 +194,11 @@ export type {
SERVER_TIMEOUT_ERROR_PREFIX,
SERVER_UNREACHABLE_ERROR_PREFIX,
} from '@inkeep/open-knowledge-core/constants/mcp';
-export type { OPEN_KNOWLEDGE_GITHUB_URL } from '@inkeep/open-knowledge-core/constants/menu-labels';
+export type {
+ OPEN_KNOWLEDGE_DISCORD_URL,
+ OPEN_KNOWLEDGE_DOCS_URL,
+ OPEN_KNOWLEDGE_GITHUB_URL,
+} from '@inkeep/open-knowledge-core/constants/menu-labels';
export type { NativeMenuLabelKey } from '@inkeep/open-knowledge-core/constants/native-menu-labels';
export type {
PREVIEW_EMBED_STARTERS,
diff --git a/packages/desktop/src/main/index.ts b/packages/desktop/src/main/index.ts
index 061340c44..3707215a0 100644
--- a/packages/desktop/src/main/index.ts
+++ b/packages/desktop/src/main/index.ts
@@ -151,7 +151,6 @@ import { type EntryPoint, isEntryPoint } from '../shared/entry-point.ts';
import type {
EditorActiveTargetSnapshot,
MenuDispatchCommand,
- MenuDispatchRole,
OnboardingShowPayload,
RecentProject,
} from '../shared/ipc-channels.ts';
@@ -367,6 +366,8 @@ import {
originForMenuDispatch,
resolveMenuActionTarget,
} from './menu-action-target.ts';
+import { menuDispatchHelpLinkUrl } from './menu-dispatch-help-link.ts';
+import { applyMenuDispatchRole } from './menu-dispatch-role.ts';
import type { MenuTranslator } from './menu-translator.ts';
import { beginNavigatorHandoff, createNavigatorWindow } from './navigator-window.ts';
import {
@@ -2459,70 +2460,17 @@ async function runMenuDispatchCommand(
reconfigureMcpWiringNow(pickLoadedRendererForMcpDialog());
return;
case 'open-github':
- void shell.openExternal('https://github.com/inkeep/open-knowledge');
+ case 'open-docs':
+ case 'open-discord':
+ void shell.openExternal(menuDispatchHelpLinkUrl(command));
return;
case 'toggle-spell-check':
setSpellCheckEnabledAppWide(!appState.spellCheckEnabled);
return;
- }
-}
-
-function applyMenuDispatchRole(role: MenuDispatchRole, sender: Electron.WebContents): void {
- if (role === 'quit') {
- app.quit();
- return;
- }
- const win = BrowserWindow.fromWebContents(sender) ?? BrowserWindow.getFocusedWindow();
- if (!win || win.isDestroyed()) return;
- const wc = win.webContents;
- switch (role) {
- case 'undo':
- wc.undo();
- return;
- case 'redo':
- wc.redo();
- return;
- case 'cut':
- wc.cut();
- return;
- case 'copy':
- wc.copy();
- return;
- case 'paste':
- wc.paste();
- return;
- case 'selectAll':
- wc.selectAll();
- return;
- case 'reload':
- wc.reload();
- return;
- case 'forceReload':
- wc.reloadIgnoringCache();
- return;
- case 'toggleDevTools':
- if (!app.isPackaged || DESKTOP_VARIANT.name !== 'stable') {
- wc.toggleDevTools();
- }
- return;
- case 'resetZoom':
- wc.setZoomLevel(0);
- return;
- case 'zoomIn':
- wc.setZoomLevel(wc.getZoomLevel() + 0.5);
- return;
- case 'zoomOut':
- wc.setZoomLevel(wc.getZoomLevel() - 0.5);
- return;
- case 'toggleFullScreen':
- win.setFullScreen(!win.isFullScreen());
- return;
- case 'minimize':
- win.minimize();
- return;
- case 'close':
- win.close();
- return;
+ default: {
+ const _exhaustive: never = command;
+ return _exhaustive;
+ }
}
}
@@ -4625,7 +4573,13 @@ function registerIpcHandlers() {
await runMenuDispatchCommand(request.command, event.sender);
return undefined;
case 'role':
- applyMenuDispatchRole(request.role, event.sender);
+ applyMenuDispatchRole(request.role, event.sender, {
+ quit: () => app.quit(),
+ showAboutPanel: () => app.showAboutPanel(),
+ resolveWindow: (sender) =>
+ BrowserWindow.fromWebContents(sender) ?? BrowserWindow.getFocusedWindow(),
+ devToolsAllowed: !app.isPackaged || DESKTOP_VARIANT.name !== 'stable',
+ });
return undefined;
case 'spelling-languages-query':
return querySpellingLanguages(spellcheckLanguagesDeps);
diff --git a/packages/desktop/src/main/menu-dispatch-help-link.ts b/packages/desktop/src/main/menu-dispatch-help-link.ts
new file mode 100644
index 000000000..0fcb1715c
--- /dev/null
+++ b/packages/desktop/src/main/menu-dispatch-help-link.ts
@@ -0,0 +1,21 @@
+import {
+ OPEN_KNOWLEDGE_DISCORD_URL,
+ OPEN_KNOWLEDGE_DOCS_URL,
+ OPEN_KNOWLEDGE_GITHUB_URL,
+} from '@inkeep/open-knowledge-core';
+import type { MenuDispatchCommand } from '../shared/ipc-channels.ts';
+
+export type MenuDispatchHelpLinkCommand = Extract<
+ MenuDispatchCommand,
+ 'open-github' | 'open-docs' | 'open-discord'
+>;
+
+const HELP_LINK_URLS: Readonly<Record<MenuDispatchHelpLinkCommand, string>> = {
+ 'open-github': OPEN_KNOWLEDGE_GITHUB_URL,
+ 'open-docs': OPEN_KNOWLEDGE_DOCS_URL,
+ 'open-discord': OPEN_KNOWLEDGE_DISCORD_URL,
+};
+
+export function menuDispatchHelpLinkUrl(command: MenuDispatchHelpLinkCommand): string {
+ return HELP_LINK_URLS[command];
+}
diff --git a/packages/desktop/src/main/menu-dispatch-role.ts b/packages/desktop/src/main/menu-dispatch-role.ts
new file mode 100644
index 000000000..71f312dad
--- /dev/null
+++ b/packages/desktop/src/main/menu-dispatch-role.ts
@@ -0,0 +1,78 @@
+import type { BrowserWindow, WebContents } from 'electron';
+import type { MenuDispatchRole } from '../shared/ipc-channels.ts';
+
+export interface MenuDispatchRoleDeps {
+ quit(): void;
+ showAboutPanel(): void;
+ resolveWindow(sender: WebContents): BrowserWindow | null;
+ readonly devToolsAllowed: boolean;
+}
+
+export function applyMenuDispatchRole(
+ role: MenuDispatchRole,
+ sender: WebContents,
+ deps: MenuDispatchRoleDeps,
+): void {
+ if (role === 'quit') {
+ deps.quit();
+ return;
+ }
+ if (role === 'about') {
+ deps.showAboutPanel();
+ return;
+ }
+ const win = deps.resolveWindow(sender);
+ if (!win || win.isDestroyed()) return;
+ const wc = win.webContents;
+ switch (role) {
+ case 'undo':
+ wc.undo();
+ return;
+ case 'redo':
+ wc.redo();
+ return;
+ case 'cut':
+ wc.cut();
+ return;
+ case 'copy':
+ wc.copy();
+ return;
+ case 'paste':
+ wc.paste();
+ return;
+ case 'selectAll':
+ wc.selectAll();
+ return;
+ case 'reload':
+ wc.reload();
+ return;
+ case 'forceReload':
+ wc.reloadIgnoringCache();
+ return;
+ case 'toggleDevTools':
+ if (deps.devToolsAllowed) {
+ wc.toggleDevTools();
+ }
+ return;
+ case 'resetZoom':
+ wc.setZoomLevel(0);
+ return;
+ case 'zoomIn':
+ wc.setZoomLevel(wc.getZoomLevel() + 0.5);
+ return;
+ case 'zoomOut':
+ wc.setZoomLevel(wc.getZoomLevel() - 0.5);
+ return;
+ case 'toggleFullScreen':
+ win.setFullScreen(!win.isFullScreen());
+ return;
+ case 'minimize':
+ win.minimize();
+ return;
+ case 'close':
+ win.close();
+ return;
+ default:
+ role satisfies never;
+ }
+}
diff --git a/packages/desktop/src/main/menu.ts b/packages/desktop/src/main/menu.ts
index aa300b07a..c7ab88b63 100644
--- a/packages/desktop/src/main/menu.ts
+++ b/packages/desktop/src/main/menu.ts
@@ -9,6 +9,8 @@ import {
type MenuSection,
menuLabelForPlatform,
NATIVE_MENU_LABELS,
+ OPEN_KNOWLEDGE_DISCORD_URL,
+ OPEN_KNOWLEDGE_DOCS_URL,
OPEN_KNOWLEDGE_GITHUB_URL,
SHOW_INSTALL_SKILL,
type TerminalPlacement,
@@ -324,6 +326,8 @@ const MENU_BINDINGS: Record<string, MenuCommandBinding> = {
enabled: (d) => d.onCollapseAll !== undefined,
},
'open-github': { click: (d) => () => d.openExternalUrl(OPEN_KNOWLEDGE_GITHUB_URL) },
+ 'open-docs': { click: (d) => () => d.openExternalUrl(OPEN_KNOWLEDGE_DOCS_URL) },
+ 'open-discord': { click: (d) => () => d.openExternalUrl(OPEN_KNOWLEDGE_DISCORD_URL) },
'report-bug': { click: (d) => () => d.onReportBug?.() },
'send-feedback': { click: (d) => () => d.onSendFeedback?.() },
'install-claude-desktop': {
@@ -619,6 +623,7 @@ export function buildMenuTemplate(deps: MenuDeps): MenuItemConstructorOptions[]
...withTrailingSep(leafOf('help-install')),
...leafOf('help-links'),
...withLeadingSep(leafOf('help-updates')),
+ ...(isMac ? [] : [{ type: 'separator' as const }, roleItem('about')]),
],
},
];
diff --git a/packages/desktop/tests/main/menu-dispatch-help-link.test.ts b/packages/desktop/tests/main/menu-dispatch-help-link.test.ts
new file mode 100644
index 000000000..e441b3204
--- /dev/null
+++ b/packages/desktop/tests/main/menu-dispatch-help-link.test.ts
@@ -0,0 +1,12 @@
+import { describe, expect, test } from 'vitest';
+import { menuDispatchHelpLinkUrl } from '../../src/main/menu-dispatch-help-link.ts';
+
+describe('menuDispatchHelpLinkUrl', () => {
+ test.each([
+ ['open-github', 'https://github.com/inkeep/open-knowledge'],
+ ['open-docs', 'https://openknowledge.ai/docs'],
+ ['open-discord', 'https://discord.gg/VRKk2EaGHN'],
+ ] as const)('%s opens %s', (command, url) => {
+ expect(menuDispatchHelpLinkUrl(command)).toBe(url);
+ });
+});
diff --git a/packages/desktop/tests/main/menu-dispatch-role.test.ts b/packages/desktop/tests/main/menu-dispatch-role.test.ts
new file mode 100644
index 000000000..5a6e3d3af
--- /dev/null
+++ b/packages/desktop/tests/main/menu-dispatch-role.test.ts
@@ -0,0 +1,105 @@
+import type { BrowserWindow, WebContents } from 'electron';
+import { describe, expect, test, vi } from 'vitest';
+import {
+ applyMenuDispatchRole,
+ type MenuDispatchRoleDeps,
+} from '../../src/main/menu-dispatch-role.ts';
+
+function makeWindow() {
+ const webContents = {
+ undo: vi.fn(),
+ toggleDevTools: vi.fn(),
+ getZoomLevel: vi.fn(() => 1),
+ setZoomLevel: vi.fn(),
+ };
+ const win = {
+ webContents,
+ isDestroyed: vi.fn(() => false),
+ isFullScreen: vi.fn(() => false),
+ setFullScreen: vi.fn(),
+ minimize: vi.fn(),
+ close: vi.fn(),
+ };
+ return { win, webContents };
+}
+
+function makeDeps(overrides: Partial<MenuDispatchRoleDeps> = {}): MenuDispatchRoleDeps {
+ return {
+ quit: vi.fn(),
+ showAboutPanel: vi.fn(),
+ resolveWindow: vi.fn(() => null),
+ devToolsAllowed: true,
+ ...overrides,
+ };
+}
+
+const sender = {} as WebContents;
+
+describe('applyMenuDispatchRole', () => {
+ test('about shows the about panel without needing a window', () => {
+ const deps = makeDeps();
+
+ applyMenuDispatchRole('about', sender, deps);
+
+ expect(deps.showAboutPanel).toHaveBeenCalledTimes(1);
+ expect(deps.resolveWindow).not.toHaveBeenCalled();
+ expect(deps.quit).not.toHaveBeenCalled();
+ });
+
+ test('quit quits the app without needing a window', () => {
+ const deps = makeDeps();
+
+ applyMenuDispatchRole('quit', sender, deps);
+
+ expect(deps.quit).toHaveBeenCalledTimes(1);
+ expect(deps.showAboutPanel).not.toHaveBeenCalled();
+ });
+
+ test('window roles act on the resolved window', () => {
+ const { win, webContents } = makeWindow();
+ const deps = makeDeps({ resolveWindow: vi.fn(() => win as unknown as BrowserWindow) });
+
+ applyMenuDispatchRole('undo', sender, deps);
+ applyMenuDispatchRole('zoomIn', sender, deps);
+ applyMenuDispatchRole('toggleFullScreen', sender, deps);
+
+ expect(deps.resolveWindow).toHaveBeenCalledWith(sender);
+ expect(webContents.undo).toHaveBeenCalledTimes(1);
+ expect(webContents.setZoomLevel).toHaveBeenCalledWith(1.5);
+ expect(win.setFullScreen).toHaveBeenCalledWith(true);
+ });
+
+ test('toggleDevTools toggles dev tools when they are allowed', () => {
+ const { win, webContents } = makeWindow();
+ const deps = makeDeps({
+ resolveWindow: vi.fn(() => win as unknown as BrowserWindow),
+ devToolsAllowed: true,
+ });
+
+ applyMenuDispatchRole('toggleDevTools', sender, deps);
+
+ expect(webContents.toggleDevTools).toHaveBeenCalledTimes(1);
+ });
+
+ test('toggleDevTools is a no-op when dev tools are not allowed', () => {
+ const { win, webContents } = makeWindow();
+ const deps = makeDeps({
+ resolveWindow: vi.fn(() => win as unknown as BrowserWindow),
+ devToolsAllowed: false,
+ });
+
+ applyMenuDispatchRole('toggleDevTools', sender, deps);
+
+ expect(webContents.toggleDevTools).not.toHaveBeenCalled();
+ });
+
+ test('window roles do nothing when no live window resolves', () => {
+ const { win } = makeWindow();
+ win.isDestroyed.mockReturnValue(true);
+ const deps = makeDeps({ resolveWindow: vi.fn(() => win as unknown as BrowserWindow) });
+
+ applyMenuDispatchRole('minimize', sender, deps);
+
+ expect(win.minimize).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/desktop/tests/main/menu.test.ts b/packages/desktop/tests/main/menu.test.ts
index 38dd82196..ab5c81676 100644
--- a/packages/desktop/tests/main/menu.test.ts
+++ b/packages/desktop/tests/main/menu.test.ts
@@ -403,6 +403,60 @@ describe('buildMenuTemplate', () => {
});
});
+ describe('Help resource links', () => {
+ function helpSubmenu(platform: NodeJS.Platform, deps: MenuDeps): MenuItemConstructorOptions[] {
+ const template = buildMenuTemplateForPlatform(platform, deps);
+ const sub = template.find((t) => t.label === 'Help')?.submenu;
+ if (!Array.isArray(sub)) throw new Error('Help submenu missing');
+ return sub;
+ }
+
+ test('Documentation and Discord follow GitHub, ahead of the bug and feedback rows', () => {
+ const labels = helpSubmenu('darwin', makeDeps())
+ .map((item) => item.label)
+ .filter((label) => label !== undefined);
+ expect(labels.slice(0, 5)).toEqual([
+ 'OpenKnowledge on GitHub',
+ 'Documentation',
+ 'Join us on Discord',
+ 'Report a bug…',
+ 'Send feedback…',
+ ]);
+ });
+
+ test.each([
+ ['Documentation', 'https://openknowledge.ai/docs'],
+ ['Join us on Discord', 'https://discord.gg/VRKk2EaGHN'],
+ ])('%s opens %s externally', (label, url) => {
+ const openExternalUrl = vi.fn(() => {});
+ const item = helpSubmenu('darwin', makeDeps({ openExternalUrl })).find(
+ (i) => i.label === label,
+ );
+ if (!item || typeof item.click !== 'function') throw new Error(`${label} click missing`);
+ (item.click as () => void)();
+ expect(openExternalUrl).toHaveBeenCalledWith(url);
+ });
+
+ test.each([
+ ['win32', 'About OpenKnowledge'],
+ ['linux', 'About'],
+ ] as const)('%s ends the Help menu with a separated About entry', (platform, label) => {
+ const sub = helpSubmenu(platform, makeDeps({ onCheckForUpdates: vi.fn(() => {}) }));
+ expect(sub.at(-1)).toMatchObject({ role: 'about', label });
+ expect(sub.at(-2)?.type).toBe('separator');
+ });
+
+ test('macOS keeps About in the App menu only', () => {
+ const deps = makeDeps();
+ const template = buildMenuTemplateForPlatform('darwin', deps);
+ const help = template.find((t) => t.label === 'Help')?.submenu;
+ const appMenu = template.find((t) => t.label === deps.appName)?.submenu;
+ if (!Array.isArray(help) || !Array.isArray(appMenu)) throw new Error('menus missing');
+ expect(help.some((i) => i.role === 'about')).toBe(false);
+ expect(appMenu.some((i) => i.role === 'about')).toBe(true);
+ });
+ });
+
describe('Uninstall OpenKnowledge… menu item', () => {
test('omitted entirely when onUninstall dep is undefined', () => {
const template = buildMenuTemplate(makeDeps());