Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
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.mdnew file mode 100644index 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.tsindex 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.tsxindex 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.tsxindex 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.tsxindex 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/popoverimport { 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.poindex 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.tsmsgid "About"msgstr "حول"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "Join us on Discord"msgstr "انضم إلينا على Discord"diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.poindex 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.tsmsgid "About"msgstr "সম্পর্কে"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "Join us on Discord"msgstr "Discord-এ আমাদের সঙ্গে যোগ দিন"diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.poindex 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.tsmsgid "About"msgstr "About"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "Acerca de"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "À propos"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "परिचय"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "Join us on Discord"msgstr "Discord पर हमसे जुड़ें"diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.poindex 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.tsmsgid "About"msgstr "Tentang"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "정보"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "Join us on Discord"msgstr "Discord에서 함께하기"diff --git a/packages/app/src/locales/pl/messages.po b/packages/app/src/locales/pl/messages.poindex 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.tsmsgid "About"msgstr "O programie"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr ""#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "Documentation"msgstr ""@@ -8072,6 +8076,8 @@ msgstr ""msgid "Item {0}"msgstr ""+#: src/components/AppMenubar.tsx+#: src/components/command-palette-commands.ts#: src/components/SubscribeCard.tsxmsgid "Join us on Discord"msgstr ""diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.poindex 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.tsmsgid "About"msgstr "Sobre"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "تعارف"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "关于"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.poindex 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.tsmsgid "About"msgstr "關於"#: src/lib/native-menu-catalog.ts+#: src/lib/platform-labels.tsmsgid "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.tsxmsgid "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.tsxmsgid "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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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.tsnew file mode 100644index 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.tsnew file mode 100644index 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.tsindex 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());