Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Open user-level Settings from the project navigator (PRD-9072) (#5811)

Andrew Mikofalvy11148713f3a6
diff --git a/.changeset/prd-9072-navigator-user-settings.md b/.changeset/prd-9072-navigator-user-settings.md
new file mode 100644
index 000000000..f102b00a5
--- /dev/null
+++ b/.changeset/prd-9072-navigator-user-settings.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": patch
+---
+
+Settings… in the project navigator now opens Settings with your preferences and hotkeys instead of the integrations dialog. Use Set up OpenKnowledge integrations… to connect AI tools.
diff --git a/docs/content/get-started/quickstart.mdx b/docs/content/get-started/quickstart.mdx
index a18b0d110..731c15fa5 100644
--- a/docs/content/get-started/quickstart.mdx
+++ b/docs/content/get-started/quickstart.mdx
@@ -35,7 +35,7 @@ Download the installer for your platform. On a Mac, the desktop app needs macOS
### Create a new project
-- Open the OpenKnowledge app. On first launch, a setup dialog offers to connect your AI tools to OpenKnowledge and to add the `ok` command to your terminal. Every option starts unchecked: tick the ones you want, then click **Finish setup**. If you skip it, re-open it later from **File → Set up OpenKnowledge integrations…**. On supported desktop installations, **Settings…** from the project navigator also opens this customization dialog; [Settings in an editor](/docs/reference/configuration) opens the full settings pane.
+- Open the OpenKnowledge app. On first launch, a setup dialog offers to connect your AI tools to OpenKnowledge and to add the `ok` command to your terminal. Every option starts unchecked: tick the ones you want, then click **Finish setup**. If you skip it, re-open it later from **File → Set up OpenKnowledge integrations…**. **Settings…** from the project navigator opens your user-level preferences and hotkeys; [Settings in an editor](/docs/reference/configuration) opens the full settings pane.
- You'll then land on the launcher. To follow this guide, choose **Create new project** — or pick a starter pack from the **or use a starter pack** line beneath the cards (for example **Knowledge base**) to scaffold ready-made folders and templates up front and skip the Initialize step below. The count at the end of that line opens the full set of packs.
- Type a name for your project (for example, *Team Wiki*).
- Optionally click **Browse** to change where the project is saved, then click **Create**.
diff --git a/docs/content/reference/configuration.mdx b/docs/content/reference/configuration.mdx
index ea43c193e..f916d07d4 100644
--- a/docs/content/reference/configuration.mdx
+++ b/docs/content/reference/configuration.mdx
@@ -20,7 +20,7 @@ You can inspect and edit config three ways:
Edits made anywhere reflect everywhere; an open Settings pane refreshes live.
-In the desktop app, Settings follows the focused window. An editor opens the full Settings pane. From the project navigator, Settings opens a customization dialog for your theme and, when available, terminal access and connections to your AI tools; on macOS it also opens that dialog when all windows are closed and the app is still running. This customization shortcut requires a supported packaged installation (macOS, Windows, or Linux deb/rpm). Dev and AppImage builds direct you to use Settings from a project window instead. Open a project for Git, Sync, Plugins, and Skills Studio settings. See the [quickstart](/docs/get-started/quickstart) for first-launch setup.
+In the desktop app, Settings follows the focused window. An editor opens the full Settings pane. From the project navigator, Settings opens the same pane with your user-level **Preferences** and **Hotkeys**; on macOS it also opens there when all windows are closed and the app is still running. Changes save to your user config and apply to every project. Panes that need a project, such as Agent connections, Git, Plugins, Skills Studio, and everything under **This project**, are shown but disabled until you open one. To connect your AI tools from the navigator, use **File → Set up OpenKnowledge integrations…**. See the [quickstart](/docs/get-started/quickstart) for first-launch setup.
## Schema
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/NavigatorApp.settings.dom.test.tsx b/packages/app/src/components/NavigatorApp.settings.dom.test.tsx
new file mode 100644
index 000000000..93d6a88b9
--- /dev/null
+++ b/packages/app/src/components/NavigatorApp.settings.dom.test.tsx
@@ -0,0 +1,342 @@
+import type { ConfigPatch } from '@inkeep/open-knowledge-core/config/schema';
+import type {
+ OkMenuRendererSnapshot,
+ OkUserConfigPatchResult,
+ OkUserConfigSnapshot,
+} from '@inkeep/open-knowledge-core/desktop-bridge';
+import { I18nProvider } from '@lingui/react';
+import { act, cleanup, render, screen, waitFor, within } from '@testing-library/react';
+import userEvent from '@testing-library/user-event';
+import { ThemeProvider } from 'next-themes';
+import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+import { TooltipProvider } from '@/components/ui/tooltip';
+import { dynamicActivate } from '@/lib/activate-locale';
+import type { OkDesktopBridge } from '@/lib/desktop-bridge-types';
+import { i18n } from '@/lib/i18n';
+
+const { NavigatorApp } = await import('./NavigatorApp');
+
+type WindowGlobals = { NodeFilter?: typeof NodeFilter; MutationObserver?: typeof MutationObserver };
+type GlobalWithDomShims = typeof globalThis &
+ WindowGlobals & { window?: WindowGlobals; ResizeObserver?: unknown };
+const globalWithDomShims = globalThis as GlobalWithDomShims;
+if (
+ globalWithDomShims.NodeFilter === undefined &&
+ globalWithDomShims.window?.NodeFilter !== undefined
+) {
+ globalWithDomShims.NodeFilter = globalWithDomShims.window.NodeFilter;
+}
+if (
+ globalWithDomShims.MutationObserver === undefined &&
+ globalWithDomShims.window?.MutationObserver !== undefined
+) {
+ globalWithDomShims.MutationObserver = globalWithDomShims.window.MutationObserver;
+}
+if (globalWithDomShims.ResizeObserver === undefined) {
+ class NoopResizeObserver {
+ observe() {}
+ unobserve() {}
+ disconnect() {}
+ }
+ globalWithDomShims.ResizeObserver = NoopResizeObserver;
+}
+
+const ASYNC_TIMEOUT_MS = 4000;
+
+function mergePatch(target: Record<string, unknown>, patch: Record<string, unknown>) {
+ for (const [key, value] of Object.entries(patch)) {
+ const existing = target[key];
+ if (
+ value !== null &&
+ typeof value === 'object' &&
+ !Array.isArray(value) &&
+ existing !== null &&
+ typeof existing === 'object' &&
+ !Array.isArray(existing)
+ ) {
+ mergePatch(existing as Record<string, unknown>, value as Record<string, unknown>);
+ } else {
+ target[key] = value;
+ }
+ }
+ return target;
+}
+
+function applyPatchToText(text: string, patch: ConfigPatch): string {
+ const doc = (parseYaml(text) as Record<string, unknown> | null) ?? {};
+ return stringifyYaml(mergePatch(doc, patch as Record<string, unknown>));
+}
+
+function makeNavigatorBridge(
+ initialText: string,
+ options: { readError?: Error; integrationsMenuItem?: boolean } = {},
+) {
+ const changeListeners = new Set<(snapshot: OkUserConfigSnapshot) => void>();
+ const patches: ConfigPatch[] = [];
+ let diskText = initialText;
+ const setThemeSource = vi.fn(async () => ({ ok: true as const }));
+ const setLanguagePreference = vi.fn(async () => ({ ok: true as const }));
+ const menuDispatch = vi.fn(async (request: { kind: string }) =>
+ request.kind === 'query'
+ ? ({
+ recentProjects: [],
+ spellCheckEnabled: true,
+ showDevToolsMenu: false,
+ canCheckForUpdates: false,
+ canReconfigureMcpWiring: options.integrationsMenuItem === true,
+ } as unknown as OkMenuRendererSnapshot)
+ : undefined,
+ );
+ const bridge = {
+ config: {
+ collabUrl: '',
+ apiOrigin: '',
+ projectPath: '',
+ projectName: 'Project Navigator',
+ mode: 'navigator',
+ themePreference: 'system',
+ },
+ appVersion: '1.2.3',
+ platform: 'darwin',
+ ...(options.integrationsMenuItem === undefined ? {} : { menu: { dispatch: menuDispatch } }),
+ onMenuAction: () => () => {},
+ state: { query: async () => ({ channel: 'latest' }) },
+ onRecentRemovedMissing: () => () => {},
+ setThemeSource,
+ setLanguagePreference,
+ signalThemeApplied: () => {},
+ shell: { openExternal: async () => undefined },
+ project: {
+ listRecent: async () => [],
+ removeRecent: async () => undefined,
+ readHeadBranch: async () => ({ currentBranch: null, headSha: null, detached: false }),
+ },
+ dialog: { openFolder: async (): Promise<string | null> => null },
+ userConfig: {
+ read: async (): Promise<OkUserConfigSnapshot> => {
+ if (options.readError) throw options.readError;
+ return { text: diskText };
+ },
+ patch: async (patch: ConfigPatch): Promise<OkUserConfigPatchResult> => {
+ patches.push(patch);
+ diskText = applyPatchToText(diskText, patch);
+ return { ok: true, text: diskText };
+ },
+ onChanged: (cb: (snapshot: OkUserConfigSnapshot) => void) => {
+ changeListeners.add(cb);
+ return () => changeListeners.delete(cb);
+ },
+ },
+ } as unknown as OkDesktopBridge;
+ return {
+ bridge,
+ patches,
+ menuDispatch,
+ setThemeSource,
+ setLanguagePreference,
+ emitChange: (text: string) => {
+ diskText = text;
+ act(() => {
+ for (const cb of changeListeners) cb({ text });
+ });
+ },
+ };
+}
+
+function renderNavigator(bridge: OkDesktopBridge, options: { asWindowBridge?: boolean } = {}) {
+ if (options.asWindowBridge) {
+ (window as unknown as { okDesktop?: OkDesktopBridge }).okDesktop = bridge;
+ }
+ return render(
+ <I18nProvider i18n={i18n}>
+ <ThemeProvider attribute="class" defaultTheme="system" enableSystem storageKey="ok-theme-v1">
+ <TooltipProvider>
+ <NavigatorApp bridge={bridge} />
+ </TooltipProvider>
+ </ThemeProvider>
+ </I18nProvider>,
+ );
+}
+
+function sidebarItem(id: string): HTMLButtonElement {
+ return screen.getByTestId(`settings-sidebar-item-${id}`) as HTMLButtonElement;
+}
+
+function describedBy(el: HTMLElement): string {
+ const ids = el.getAttribute('aria-describedby')?.split(' ') ?? [];
+ return ids.map((id) => document.getElementById(id)?.textContent ?? '').join(' ');
+}
+
+describe('NavigatorApp settings', () => {
+ let consoleWarnSpy: ReturnType<typeof vi.spyOn>;
+ let consoleErrorSpy: ReturnType<typeof vi.spyOn>;
+
+ beforeEach(async () => {
+ localStorage.clear();
+ document.documentElement.className = '';
+ await act(async () => {
+ await dynamicActivate('en');
+ });
+ consoleWarnSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => {});
+ window.history.replaceState(null, '', '#settings');
+ });
+
+ afterEach(() => {
+ cleanup();
+ delete (window as unknown as { okDesktop?: OkDesktopBridge }).okDesktop;
+ window.history.replaceState(null, '', '#');
+ consoleWarnSpy.mockRestore();
+ consoleErrorSpy.mockRestore();
+ });
+
+ test('the settings route opens Settings with only the user-level panes enabled', async () => {
+ const stub = makeNavigatorBridge('', { integrationsMenuItem: true });
+ renderNavigator(stub.bridge, { asWindowBridge: true });
+
+ const dialog = await screen.findByTestId('settings-dialog', {}, { timeout: ASYNC_TIMEOUT_MS });
+ expect(within(dialog).queryByText('Customize your OpenKnowledge experience.')).toBeNull();
+
+ for (const id of ['preferences', 'hotkeys']) {
+ expect(sidebarItem(id).disabled).toBe(false);
+ }
+ await waitFor(
+ () =>
+ expect(describedBy(sidebarItem('agent-connections'))).toBe(
+ 'Open a project to edit. To connect AI tools without a project, use File > Set up OpenKnowledge integrations…',
+ ),
+ { timeout: ASYNC_TIMEOUT_MS },
+ );
+ for (const id of [
+ 'account',
+ 'user-plugins-manage',
+ 'user-skills',
+ 'project-preferences',
+ 'sync',
+ ]) {
+ expect(sidebarItem(id).disabled).toBe(true);
+ expect(sidebarItem(id).getAttribute('aria-disabled')).toBe('true');
+ expect(describedBy(sidebarItem(id))).toBe('Open a project to edit.');
+ }
+ expect(screen.queryByTestId('settings-sidebar-item-plugin:theme')).toBeNull();
+ expect(screen.queryByTestId('settings-sidebar-item-claude-desktop')).toBeNull();
+ expect(sidebarItem('preferences').getAttribute('aria-current')).toBe('page');
+ });
+
+ test('an install without the integrations menu item does not point Agent connections at it', async () => {
+ const stub = makeNavigatorBridge('', { integrationsMenuItem: false });
+ renderNavigator(stub.bridge, { asWindowBridge: true });
+
+ await screen.findByTestId('settings-dialog', {}, { timeout: ASYNC_TIMEOUT_MS });
+ await waitFor(() => expect(stub.menuDispatch).toHaveBeenCalledWith({ kind: 'query' }), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ await act(async () => {
+ await new Promise((resolve) => setTimeout(resolve, 0));
+ });
+
+ expect(sidebarItem('agent-connections').disabled).toBe(true);
+ expect(describedBy(sidebarItem('agent-connections'))).toBe('Open a project to edit.');
+ expect(screen.queryByText(/Set up OpenKnowledge integrations/)).toBeNull();
+ });
+
+ test('an unreadable user config shows a notice instead of loading forever, then recovers', async () => {
+ const stub = makeNavigatorBridge('', { readError: new Error('EACCES: permission denied') });
+ renderNavigator(stub.bridge);
+
+ const notice = await screen.findByTestId(
+ 'settings-user-config-unavailable',
+ {},
+ { timeout: ASYNC_TIMEOUT_MS },
+ );
+ expect(notice.textContent).toContain('Your user settings could not be read');
+
+ stub.emitChange('editor:\n wordWrap: false\n');
+
+ const wordWrap = await screen.findByRole(
+ 'switch',
+ { name: 'Word wrap' },
+ { timeout: ASYNC_TIMEOUT_MS },
+ );
+ expect(wordWrap.getAttribute('aria-checked')).toBe('false');
+ expect(screen.queryByTestId('settings-user-config-unavailable')).toBeNull();
+ });
+
+ test('settings search skips panes that need a project', async () => {
+ const stub = makeNavigatorBridge('');
+ renderNavigator(stub.bridge);
+ await screen.findByTestId('settings-dialog', {}, { timeout: ASYNC_TIMEOUT_MS });
+
+ await userEvent.type(screen.getByTestId('settings-search-input'), 'Agent connections');
+
+ expect(screen.queryByTestId('settings-search-result-section:agent-connections')).toBeNull();
+ });
+
+ test('changing a preference writes it to the user config', async () => {
+ const stub = makeNavigatorBridge('');
+ renderNavigator(stub.bridge);
+
+ const wordWrap = await screen.findByRole(
+ 'switch',
+ { name: 'Word wrap' },
+ { timeout: ASYNC_TIMEOUT_MS },
+ );
+ await userEvent.click(wordWrap);
+
+ await waitFor(() => expect(stub.patches).toContainEqual({ editor: { wordWrap: false } }), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ });
+
+ test('a theme and language picked in Settings apply live to the navigator', async () => {
+ const user = userEvent.setup();
+ const stub = makeNavigatorBridge('');
+ renderNavigator(stub.bridge);
+ await screen.findByTestId('settings-dialog', {}, { timeout: ASYNC_TIMEOUT_MS });
+
+ await user.click(await screen.findByTestId('theme-picker-dark'));
+
+ await waitFor(() => expect(stub.patches).toContainEqual({ appearance: { theme: 'dark' } }), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ await waitFor(() => expect(document.documentElement.classList.contains('dark')).toBe(true), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ await waitFor(() => expect(stub.setThemeSource).toHaveBeenLastCalledWith('dark'), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+
+ const languagePicker = screen.getByRole('combobox', { name: 'Language' });
+ languagePicker.focus();
+ await user.keyboard('{ArrowDown}');
+ await user.click(await screen.findByRole('option', { name: 'français' }));
+
+ await waitFor(() => expect(i18n.locale).toBe('fr'), { timeout: ASYNC_TIMEOUT_MS });
+ expect(document.documentElement.lang).toBe('fr');
+ await waitFor(() => expect(stub.setLanguagePreference).toHaveBeenLastCalledWith('fr'), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ expect(document.documentElement.classList.contains('dark')).toBe(true);
+ });
+
+ test('a theme and language edited outside the navigator apply to it', async () => {
+ const stub = makeNavigatorBridge('');
+ renderNavigator(stub.bridge);
+ await screen.findByTestId('settings-dialog', {}, { timeout: ASYNC_TIMEOUT_MS });
+
+ stub.emitChange('appearance:\n theme: dark\n language: fr\n');
+
+ await waitFor(() => expect(document.documentElement.classList.contains('dark')).toBe(true), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ await waitFor(() => expect(i18n.locale).toBe('fr'), { timeout: ASYNC_TIMEOUT_MS });
+ expect(document.documentElement.lang).toBe('fr');
+ await waitFor(() => expect(stub.setThemeSource).toHaveBeenLastCalledWith('dark'), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ await waitFor(() => expect(stub.setLanguagePreference).toHaveBeenLastCalledWith('fr'), {
+ timeout: ASYNC_TIMEOUT_MS,
+ });
+ });
+});
diff --git a/packages/app/src/components/NavigatorApp.tsx b/packages/app/src/components/NavigatorApp.tsx
index 6f1959805..7ae6443b0 100644
--- a/packages/app/src/components/NavigatorApp.tsx
+++ b/packages/app/src/components/NavigatorApp.tsx
@@ -6,7 +6,9 @@ import { type ComponentType, lazy, Suspense, useEffect, useState } from 'react';
import { shouldShowAppMenubar } from '@/components/app-menubar-gate';
import { Spinner } from '@/components/ui/spinner';
import { Tooltip, TooltipContent, TooltipTrigger } from '@/components/ui/tooltip';
+import { useLanguageBridge } from '@/hooks/use-language-bridge';
import { useThemeBridge } from '@/hooks/use-theme-bridge';
+import { ConfigContext } from '@/lib/config-context';
import type {
OkDesktopBridge,
OkLocalOpAuthStatusResponse,
@@ -32,6 +34,12 @@ import {
readCachedLanguagePreference,
useApplyConfigLanguage,
} from '@/lib/use-apply-config-language';
+import { narrowThemePreference, useApplyConfigTheme } from '@/lib/use-apply-config-theme';
+import {
+ navigatorConfigContextValue,
+ useNavigatorUserConfig,
+} from '@/lib/use-navigator-user-config';
+import { useSettingsRoute } from '@/lib/use-settings-route';
import { AuthModal } from './AuthModal';
import { BetaBadge } from './BetaBadge';
import { CloneDialog } from './CloneDialog';
@@ -45,6 +53,7 @@ import { iconForPack } from './PackCardGrid';
import { basenameOf } from './project-switcher-recents';
import { ReportBugDialog } from './ReportBugDialog';
import { RecentItemContextMenu } from './recent-remove-controls';
+import { SettingsDialogShell } from './settings/SettingsDialogShell';
import { Badge } from './ui/badge';
import { Button } from './ui/button';
@@ -63,6 +72,20 @@ export const runWithErrorStatePure = (
type RecentProject = RecentProjectEntry;
+function NavigatorSettings() {
+ const route = useSettingsRoute();
+ return (
+ <SettingsDialogShell
+ host="navigator"
+ open={route.open}
+ initialSection={route.section}
+ onOpenChange={(next) => {
+ if (!next) route.close();
+ }}
+ />
+ );
+}
+
export function removeRecentFromList(
recents: readonly RecentProjectEntry[],
path: string,
@@ -92,14 +115,26 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {
const [authInitialStep, setAuthInitialStep] = useState<'auth' | 'identity'>('auth');
const { t } = useLingui();
+ const userConfig = useNavigatorUserConfig(bridge);
+ const configuredTheme = userConfig.synced
+ ? narrowThemePreference(userConfig.config?.appearance?.theme)
+ : undefined;
+ const configuredLanguage = userConfig.synced
+ ? (narrowLanguagePreference(userConfig.config?.appearance?.language) ?? 'system')
+ : undefined;
+
useThemeColorTransitions(true);
- useThemeBridge(bridge, bridge.config.themePreference ?? 'system');
+ useApplyConfigTheme(configuredTheme);
+ useThemeBridge(bridge, configuredTheme ?? bridge.config.themePreference ?? 'system');
useApplyConfigLanguage({
preference:
- narrowLanguagePreference(bridge.config.languagePreference) ?? readCachedLanguagePreference(),
+ configuredLanguage ??
+ narrowLanguagePreference(bridge.config.languagePreference) ??
+ readCachedLanguagePreference(),
userConfigSynced: true,
});
+ useLanguageBridge(bridge, configuredLanguage, userConfig.synced);
useEffect(() => {
let cancelled = false;
@@ -345,6 +380,10 @@ export function NavigatorApp({ bridge }: { bridge: OkDesktopBridge }) {
</div>
</div>
+ <ConfigContext value={navigatorConfigContextValue(userConfig)}>
+ <NavigatorSettings />
+ </ConfigContext>
+
{}
<McpConsentDialog />
diff --git a/packages/app/src/components/settings/SettingsDialogBody.tsx b/packages/app/src/components/settings/SettingsDialogBody.tsx
index 0dc7af023..0724a875a 100644
--- a/packages/app/src/components/settings/SettingsDialogBody.tsx
+++ b/packages/app/src/components/settings/SettingsDialogBody.tsx
@@ -1,7 +1,9 @@
import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
import type { OkignoreBinding } from '@inkeep/open-knowledge-core/config/bind-okignore-doc';
import { Trans, useLingui } from '@lingui/react/macro';
+import { TriangleAlert } from 'lucide-react';
import { type ComponentType, lazy } from 'react';
+import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert';
import { lazyWithPreload } from '@/lib/lazy-with-preload';
import { SettingsSectionHeader } from './SettingsSectionHeader';
import { FIELDS_USER_PREFERENCES } from './settings-fields';
@@ -109,9 +111,25 @@ const PreferencesSection = lazyWithPreload(async () => {
export const preloadPreferencesSection = PreferencesSection.preload;
+function UserConfigPending({ loadFailed }: { loadFailed: boolean }) {
+ if (!loadFailed) return <SectionSkeleton />;
+ return (
+ <Alert data-testid="settings-user-config-unavailable">
+ <TriangleAlert aria-hidden="true" />
+ <AlertTitle>
+ <Trans>Your user settings could not be read</Trans>
+ </AlertTitle>
+ <AlertDescription>
+ <Trans>OpenKnowledge keeps retrying and shows them as soon as the file can be read.</Trans>
+ </AlertDescription>
+ </Alert>
+ );
+}
+
interface SettingsDialogBodyProps {
activeId: string;
userBinding: ConfigBinding | null;
+ userLoadFailed?: boolean;
okignoreBinding: OkignoreBinding | null;
okignoreSynced: boolean;
markdownlintRuleQuery?: { query: string; nonce: number } | null;
@@ -120,6 +138,7 @@ interface SettingsDialogBodyProps {
export function SettingsDialogBody({
activeId,
userBinding,
+ userLoadFailed = false,
okignoreBinding,
okignoreSynced,
markdownlintRuleQuery,
@@ -133,7 +152,7 @@ export function SettingsDialogBody({
binding={userBinding}
/>
) : (
- <SectionSkeleton />
+ <UserConfigPending loadFailed={userLoadFailed} />
);
}
if (activeId === 'project-preferences') {
@@ -166,7 +185,11 @@ export function SettingsDialogBody({
return <HotkeysSection />;
}
if (activeId === 'account') {
- return userBinding ? <AccountSection userBinding={userBinding} /> : <SectionSkeleton />;
+ return userBinding ? (
+ <AccountSection userBinding={userBinding} />
+ ) : (
+ <UserConfigPending loadFailed={userLoadFailed} />
+ );
}
if (activeId === 'sync') {
return (
@@ -202,7 +225,11 @@ export function SettingsDialogBody({
return <UserPluginsManageSection userBinding={userBinding} />;
}
if (activeId === 'plugin:theme') {
- return userBinding ? <ThemePluginSection userBinding={userBinding} /> : <SectionSkeleton />;
+ return userBinding ? (
+ <ThemePluginSection userBinding={userBinding} />
+ ) : (
+ <UserConfigPending loadFailed={userLoadFailed} />
+ );
}
if (activeId === 'plugin:slides') {
return <SlidesPluginSection />;
diff --git a/packages/app/src/components/settings/SettingsDialogShell.tsx b/packages/app/src/components/settings/SettingsDialogShell.tsx
index e1d0d7043..59257a1f4 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.tsx
@@ -22,6 +22,7 @@ import { Dialog, DialogContent, DialogDescription, DialogTitle } from '@/compone
import { electronDragBandClearance } from '@/components/ui/electron-drag-strip';
import { Skeleton } from '@/components/ui/skeleton';
import { useDocumentContext } from '@/editor/DocumentContext';
+import type { ConfigContextValue } from '@/lib/config-context';
import { useConfigContext } from '@/lib/config-provider';
import { isFileProtocolPage } from '@/lib/file-protocol-page';
import { useClaudeDesktopIntegration } from '@/lib/handoff/use-claude-desktop-integration';
@@ -34,6 +35,11 @@ import {
isSpellcheckLanguageSelectionAvailable,
isTerminalSettingsAvailable,
} from './settings-host-gates';
+import {
+ isSidebarItemSelectable,
+ type SettingsHost,
+ scopeSettingsGroupsForHost,
+} from './settings-host-scope';
import { buildSettingsSearchIndex, type SettingsSearchEntry } from './settings-search-index';
import { AGENT_CONNECTIONS_SECTION_LABEL } from './settings-section-labels';
import type { SidebarGroup, SidebarItem, SidebarSubsection } from './settings-sidebar-types';
@@ -64,18 +70,99 @@ interface SettingsDialogShellProps {
open: boolean;
initialSection?: string | null;
onOpenChange: (open: boolean) => void;
+ host?: SettingsHost;
+}
+
+export function SettingsDialogShell({ host = 'project', ...props }: SettingsDialogShellProps) {
+ return host === 'navigator' ? (
+ <NavigatorSettingsDialogShell {...props} />
+ ) : (
+ <ProjectSettingsDialogShell {...props} />
+ );
+}
+
+type SettingsDialogHostProps = Omit<SettingsDialogShellProps, 'host'>;
+
+function ProjectSettingsDialogShell(props: SettingsDialogHostProps) {
+ const { collabUrl } = useDocumentContext();
+ const config = useConfigContext();
+ const { desktopPresent } = useClaudeDesktopIntegration();
+ return (
+ <SettingsDialogFrame
+ {...props}
+ host="project"
+ hasProject={collabUrl !== null}
+ config={config}
+ desktopPresent={desktopPresent}
+ integrationsMenuAvailable={false}
+ />
+ );
+}
+
+function NavigatorSettingsDialogShell(props: SettingsDialogHostProps) {
+ const config = useConfigContext();
+ const integrationsMenuAvailable = useIntegrationsMenuAvailable();
+ return (
+ <SettingsDialogFrame
+ {...props}
+ host="navigator"
+ hasProject={false}
+ config={config}
+ desktopPresent={false}
+ integrationsMenuAvailable={integrationsMenuAvailable}
+ />
+ );
+}
+
+function useIntegrationsMenuAvailable(): boolean {
+ const [available, setAvailable] = useState(false);
+ useEffect(() => {
+ const menu = window.okDesktop?.menu;
+ if (!menu) return;
+ let cancelled = false;
+ menu
+ .dispatch({ kind: 'query' })
+ .then((snapshot) => {
+ if (!cancelled) setAvailable(snapshot?.canReconfigureMcpWiring === true);
+ })
+ .catch((error: unknown) => {
+ console.warn('[SettingsDialogShell] Could not read the desktop menu state', error);
+ });
+ return () => {
+ cancelled = true;
+ };
+ }, []);
+ return available;
+}
+
+interface SettingsDialogFrameProps extends SettingsDialogHostProps {
+ host: SettingsHost;
+ hasProject: boolean;
+ config: ConfigContextValue;
+ desktopPresent: boolean;
+ integrationsMenuAvailable: boolean;
}
-export function SettingsDialogShell({
+function SettingsDialogFrame({
open,
initialSection = null,
onOpenChange,
-}: SettingsDialogShellProps) {
+ host,
+ hasProject,
+ config,
+ desktopPresent,
+ integrationsMenuAvailable,
+}: SettingsDialogFrameProps) {
const { t } = useLingui();
- const { collabUrl } = useDocumentContext();
- const { userBinding, userSynced, okignoreBinding, okignoreSynced, projectConfig, merged } =
- useConfigContext();
- const { desktopPresent } = useClaudeDesktopIntegration();
+ const {
+ userBinding,
+ userSynced,
+ userLoadFailed,
+ okignoreBinding,
+ okignoreSynced,
+ projectConfig,
+ merged,
+ } = config;
const [activeId, setActiveId] = useState(resolveSectionId(initialSection ?? 'preferences'));
const [searchQuery, setSearchQuery] = useState('');
@@ -158,8 +245,6 @@ export function SettingsDialogShell({
};
}, [fieldFlash]);
- const hasProject = collabUrl !== null;
-
const isOkDesktopHost = isOkDesktopHostGate();
const terminalSettingsAvailable = isTerminalSettingsAvailable();
const spellcheckLanguagesAvailable = isSpellcheckLanguageSelectionAvailable();
@@ -174,11 +259,16 @@ export function SettingsDialogShell({
const isFileProtocolRenderer = isFileProtocolPage();
- const groups: SidebarGroup[] = [
+ const declaredGroups: SidebarGroup[] = [
{
id: 'agents',
label: t`Agents`,
enabled: true,
+ ...(integrationsMenuAvailable
+ ? {
+ disabledHint: t`To connect AI tools without a project, use File > Set up OpenKnowledge integrations…`,
+ }
+ : {}),
items: [
{
id: 'agent-connections',
@@ -195,6 +285,7 @@ export function SettingsDialogShell({
{
id: 'preferences',
label: t`Preferences`,
+ userScope: true,
subsections: [
...(isOkDesktopHost
? [
@@ -218,7 +309,7 @@ export function SettingsDialogShell({
: []),
] satisfies SidebarSubsection[],
},
- { id: 'hotkeys', label: t`Hotkeys` },
+ { id: 'hotkeys', label: t`Hotkeys`, userScope: true },
{
id: 'account',
label: t`Git`,
@@ -314,6 +405,7 @@ export function SettingsDialogShell({
id: 'plugins',
label: t`Plugins`,
enabled: true,
+ hideOutsideProject: true,
items: [
...(hasProject ? enabledPluginItems : []),
...(themeEnabled ? [{ id: 'plugin:theme', label: t`Themes` }] : []),
@@ -324,6 +416,7 @@ export function SettingsDialogShell({
id: 'integrations',
label: t`Integrations`,
enabled: true,
+ hideOutsideProject: true,
items:
desktopPresent && SHOW_INSTALL_SKILL
? [{ id: 'claude-desktop', label: t`Claude Desktop` }]
@@ -331,6 +424,15 @@ export function SettingsDialogShell({
},
];
+ const groups = scopeSettingsGroupsForHost(declaredGroups, host);
+ const shownId =
+ host === 'navigator' &&
+ !groups.some((group) =>
+ group.items.some((item) => item.id === activeId && isSidebarItemSelectable(group, item)),
+ )
+ ? 'preferences'
+ : activeId;
+
const searchEntries = buildSettingsSearchIndex({ groups, translate: t });
function handleNavigate(entry: SettingsSearchEntry) {
@@ -370,7 +472,7 @@ export function SettingsDialogShell({
</DialogDescription>
<SettingsSidebar
groups={groups}
- activeId={activeId}
+ activeId={shownId}
onSelect={setActiveId}
entries={searchEntries}
searchQuery={searchQuery}
@@ -384,11 +486,12 @@ export function SettingsDialogShell({
// biome-ignore lint/a11y/noNoninteractiveTabindex: this scrollable content section must be focusable so keyboard users can scroll long settings pages.
tabIndex={0}
>
- <SettingsDialogErrorBoundary key={activeId}>
+ <SettingsDialogErrorBoundary key={shownId}>
<Suspense fallback={<SettingsContentSkeleton />}>
<SettingsDialogBodyLazy
- activeId={activeId}
+ activeId={shownId}
userBinding={userSynced ? userBinding : null}
+ userLoadFailed={userLoadFailed === true}
okignoreBinding={okignoreBinding}
okignoreSynced={okignoreSynced}
markdownlintRuleQuery={ruleQuery}
@@ -607,11 +710,26 @@ function SettingsSidebarGroup({
if (group.items.length === 0) return null;
const headerId = `settings-group-${group.id}`;
const captionId = `${headerId}-caption`;
+ const hintId = `${headerId}-hint`;
+ const describedById = group.disabledHint ? `${captionId} ${hintId}` : captionId;
+ const someItemsDisabled = group.enabled && group.items.some((item) => item.disabled === true);
+ const caption = (
+ <>
+ <p id={captionId} className="px-2 text-xs italic text-muted-foreground sm:mb-1">
+ <Trans>Open a project to edit.</Trans>
+ </p>
+ {group.disabledHint ? (
+ <p id={hintId} className="px-2 text-xs text-muted-foreground sm:mb-1">
+ {group.disabledHint}
+ </p>
+ ) : null}
+ </>
+ );
return (
<div className="flex shrink-0 items-center gap-2 sm:mb-4 sm:block">
<h3
id={headerId}
- aria-describedby={group.enabled ? undefined : captionId}
+ aria-describedby={group.enabled ? undefined : describedById}
className={cn(
'shrink-0 whitespace-nowrap px-2 text-xs font-semibold uppercase tracking-wide font-mono sm:mb-1',
group.enabled ? 'text-muted-foreground/80' : 'text-muted-foreground/50',
@@ -619,37 +737,37 @@ function SettingsSidebarGroup({
>
{group.label}
</h3>
- {!group.enabled ? (
- <p id={captionId} className="px-2 text-xs italic text-muted-foreground/60 sm:mb-1">
- <Trans>Open a project to edit.</Trans>
- </p>
- ) : null}
+ {!group.enabled ? caption : null}
<ul aria-labelledby={headerId} className="flex gap-1 sm:block sm:space-y-0.5">
- {group.items.map((item) => (
- <li key={item.id}>
- <button
- type="button"
- aria-current={activeId === item.id ? 'page' : undefined}
- aria-disabled={group.enabled ? undefined : true}
- aria-describedby={group.enabled ? undefined : captionId}
- tabIndex={group.enabled ? 0 : -1}
- disabled={!group.enabled}
- onClick={() => group.enabled && onSelect(item.id)}
- data-testid={`settings-sidebar-item-${item.id}`}
- className={cn(
- 'w-auto whitespace-nowrap rounded px-2 py-1.5 text-left text-sm transition-colors sm:w-full',
- 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring',
- 'disabled:cursor-not-allowed disabled:opacity-50',
- activeId === item.id && group.enabled
- ? 'bg-accent text-accent-foreground'
- : 'hover:bg-accent/50',
- )}
- >
- {item.label}
- </button>
- </li>
- ))}
+ {group.items.map((item) => {
+ const selectable = isSidebarItemSelectable(group, item);
+ return (
+ <li key={item.id}>
+ <button
+ type="button"
+ aria-current={activeId === item.id ? 'page' : undefined}
+ aria-disabled={selectable ? undefined : true}
+ aria-describedby={selectable ? undefined : describedById}
+ tabIndex={selectable ? 0 : -1}
+ disabled={!selectable}
+ onClick={() => selectable && onSelect(item.id)}
+ data-testid={`settings-sidebar-item-${item.id}`}
+ className={cn(
+ 'w-auto whitespace-nowrap rounded px-2 py-1.5 text-left text-sm transition-colors sm:w-full',
+ 'focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring',
+ 'disabled:cursor-not-allowed disabled:opacity-50',
+ activeId === item.id && selectable
+ ? 'bg-accent text-accent-foreground'
+ : 'hover:bg-accent/50',
+ )}
+ >
+ {item.label}
+ </button>
+ </li>
+ );
+ })}
</ul>
+ {someItemsDisabled ? caption : null}
</div>
);
}
diff --git a/packages/app/src/components/settings/settings-host-scope.test.ts b/packages/app/src/components/settings/settings-host-scope.test.ts
new file mode 100644
index 000000000..f9a20bb1d
--- /dev/null
+++ b/packages/app/src/components/settings/settings-host-scope.test.ts
@@ -0,0 +1,73 @@
+import { describe, expect, test } from 'vitest';
+import { scopeSettingsGroupsForHost } from './settings-host-scope';
+import type { SidebarGroup } from './settings-sidebar-types';
+
+function groups(): SidebarGroup[] {
+ return [
+ {
+ id: 'agents',
+ label: 'Agents',
+ enabled: true,
+ items: [{ id: 'agent-connections', label: 'Agent connections' }],
+ },
+ {
+ id: 'user',
+ label: 'User',
+ enabled: true,
+ items: [
+ { id: 'preferences', label: 'Preferences', userScope: true },
+ { id: 'account', label: 'Git' },
+ ],
+ },
+ {
+ id: 'integrations',
+ label: 'Integrations',
+ enabled: true,
+ userScope: true,
+ items: [{ id: 'about', label: 'About' }],
+ },
+ {
+ id: 'plugins',
+ label: 'Plugins',
+ enabled: true,
+ hideOutsideProject: true,
+ items: [{ id: 'plugin:theme', label: 'Themes' }],
+ },
+ ];
+}
+
+function byId(scoped: SidebarGroup[], id: SidebarGroup['id']): SidebarGroup | undefined {
+ return scoped.find((group) => group.id === id);
+}
+
+describe('scopeSettingsGroupsForHost', () => {
+ test('the project host keeps every group as declared', () => {
+ expect(scopeSettingsGroupsForHost(groups(), 'project')).toEqual(groups());
+ });
+
+ test('the navigator host enables only user-scope panes and hides project-only groups', () => {
+ const scoped = scopeSettingsGroupsForHost(groups(), 'navigator');
+
+ expect(byId(scoped, 'plugins')).toBeUndefined();
+ expect(byId(scoped, 'agents')).toMatchObject({
+ enabled: false,
+ items: [{ id: 'agent-connections', disabled: true }],
+ });
+ expect(byId(scoped, 'user')).toMatchObject({
+ enabled: true,
+ items: [
+ { id: 'preferences', disabled: false },
+ { id: 'account', disabled: true },
+ ],
+ });
+ });
+
+ test('a group declared user-scope is enabled in the navigator with all of its items', () => {
+ const scoped = scopeSettingsGroupsForHost(groups(), 'navigator');
+
+ expect(byId(scoped, 'integrations')).toMatchObject({
+ enabled: true,
+ items: [{ id: 'about', disabled: false }],
+ });
+ });
+});
diff --git a/packages/app/src/components/settings/settings-host-scope.ts b/packages/app/src/components/settings/settings-host-scope.ts
new file mode 100644
index 000000000..6e3f57021
--- /dev/null
+++ b/packages/app/src/components/settings/settings-host-scope.ts
@@ -0,0 +1,27 @@
+import type { SidebarGroup, SidebarItem } from './settings-sidebar-types';
+
+export type SettingsHost = 'project' | 'navigator';
+
+export function scopeSettingsGroupsForHost(
+ groups: readonly SidebarGroup[],
+ host: SettingsHost,
+): SidebarGroup[] {
+ if (host === 'project') return [...groups];
+ return groups
+ .filter((group) => group.hideOutsideProject !== true)
+ .map((group) => {
+ const items = group.items.map((item) => ({
+ ...item,
+ disabled: item.disabled === true || !(group.userScope === true || item.userScope === true),
+ }));
+ return {
+ ...group,
+ enabled: group.enabled && items.some((item) => !item.disabled),
+ items,
+ };
+ });
+}
+
+export function isSidebarItemSelectable(group: SidebarGroup, item: SidebarItem): boolean {
+ return group.enabled && item.disabled !== true;
+}
diff --git a/packages/app/src/components/settings/settings-search-index.test.ts b/packages/app/src/components/settings/settings-search-index.test.ts
index c8c23b532..18fb2f3fc 100644
--- a/packages/app/src/components/settings/settings-search-index.test.ts
+++ b/packages/app/src/components/settings/settings-search-index.test.ts
@@ -50,6 +50,25 @@ function groupsFixture(opts: {
}
describe('buildSettingsSearchIndex', () => {
+ test('skips a disabled item inside an enabled group', () => {
+ const entries = buildSettingsSearchIndex({
+ groups: [
+ {
+ id: 'user',
+ label: 'User',
+ enabled: true,
+ items: [
+ { id: 'preferences', label: 'Preferences' },
+ { id: 'account', label: 'Git', disabled: true },
+ ],
+ },
+ ],
+ translate,
+ });
+ expect(entries.some((e) => e.sectionId === 'preferences')).toBe(true);
+ expect(entries.some((e) => e.sectionId === 'account')).toBe(false);
+ });
+
test('emits a section entry per item of an ENABLED group only', () => {
const enabled = buildSettingsSearchIndex({
groups: groupsFixture({ projectEnabled: true }),
diff --git a/packages/app/src/components/settings/settings-search-index.ts b/packages/app/src/components/settings/settings-search-index.ts
index 86062c47a..c53675296 100644
--- a/packages/app/src/components/settings/settings-search-index.ts
+++ b/packages/app/src/components/settings/settings-search-index.ts
@@ -27,6 +27,7 @@ export function buildSettingsSearchIndex(input: {
for (const group of groups) {
if (!group.enabled) continue;
for (const item of group.items) {
+ if (item.disabled === true) continue;
visibleSectionIds.add(item.id);
entries.push({
id: `section:${item.id}`,
diff --git a/packages/app/src/components/settings/settings-sidebar-types.ts b/packages/app/src/components/settings/settings-sidebar-types.ts
index edec42bb5..8ba644606 100644
--- a/packages/app/src/components/settings/settings-sidebar-types.ts
+++ b/packages/app/src/components/settings/settings-sidebar-types.ts
@@ -10,6 +10,8 @@ export interface SidebarItem {
label: string;
subsections?: SidebarSubsection[];
keywords?: string[];
+ userScope?: boolean;
+ disabled?: boolean;
}
export interface SidebarGroup {
@@ -17,4 +19,7 @@ export interface SidebarGroup {
label: string;
enabled: boolean;
items: SidebarItem[];
+ userScope?: boolean;
+ hideOutsideProject?: boolean;
+ disabledHint?: string;
}
diff --git a/packages/app/src/lib/config-context.ts b/packages/app/src/lib/config-context.ts
index 4a5218845..3647b8074 100644
--- a/packages/app/src/lib/config-context.ts
+++ b/packages/app/src/lib/config-context.ts
@@ -7,6 +7,7 @@ import { createContext, use } from 'react';
export interface ConfigContextValue {
userBinding: ConfigBinding | null;
userSynced: boolean;
+ userLoadFailed?: boolean;
projectBinding: ConfigBinding | null;
projectLocalBinding: ConfigBinding | null;
okignoreBinding: OkignoreBinding | null;
diff --git a/packages/app/src/lib/ipc-user-config-binding.test.ts b/packages/app/src/lib/ipc-user-config-binding.test.ts
new file mode 100644
index 000000000..000935cd0
--- /dev/null
+++ b/packages/app/src/lib/ipc-user-config-binding.test.ts
@@ -0,0 +1,412 @@
+import type { ConfigPatch } from '@inkeep/open-knowledge-core/config/schema';
+import type {
+ OkUserConfigBridge,
+ OkUserConfigPatchResult,
+ OkUserConfigSnapshot,
+} from '@inkeep/open-knowledge-core/desktop-bridge';
+import { describe, expect, test, vi } from 'vitest';
+import { createIpcUserConfigBinding } from './ipc-user-config-binding';
+
+interface Deferred<T> {
+ promise: Promise<T>;
+ resolve: (value: T) => void;
+ reject: (error: unknown) => void;
+}
+
+function deferred<T>(): Deferred<T> {
+ let resolve!: (value: T) => void;
+ let reject!: (error: unknown) => void;
+ const promise = new Promise<T>((res, rej) => {
+ resolve = res;
+ reject = rej;
+ });
+ return { promise, resolve, reject };
+}
+
+function fakeTransport(initialText: string) {
+ const read = deferred<OkUserConfigSnapshot>();
+ const changeListeners = new Set<(snapshot: OkUserConfigSnapshot) => void>();
+ const patchResponses: Array<Deferred<OkUserConfigPatchResult>> = [];
+ const patches: ConfigPatch[] = [];
+ let readCount = 0;
+ let diskText = initialText;
+ let readError: Error | null = null;
+ let heldRead: Deferred<OkUserConfigSnapshot> | null = null;
+ const transport: OkUserConfigBridge = {
+ read: () => {
+ readCount += 1;
+ if (readCount === 1) return read.promise;
+ if (heldRead) {
+ const held = heldRead;
+ heldRead = null;
+ return held.promise;
+ }
+ return readError ? Promise.reject(readError) : Promise.resolve({ text: diskText });
+ },
+ patch: (patch) => {
+ patches.push(patch);
+ const response = deferred<OkUserConfigPatchResult>();
+ patchResponses.push(response);
+ return response.promise;
+ },
+ onChanged: (cb) => {
+ changeListeners.add(cb);
+ return () => changeListeners.delete(cb);
+ },
+ };
+ return {
+ transport,
+ patches,
+ patchResponses,
+ finishInitialRead: async () => {
+ read.resolve({ text: initialText });
+ await flush();
+ },
+ failInitialRead: async (error: Error) => {
+ read.reject(error);
+ await flush();
+ },
+ setReadError: (error: Error | null) => {
+ readError = error;
+ },
+ readCount: () => readCount,
+ holdNextRead: () => {
+ const held = deferred<OkUserConfigSnapshot>();
+ heldRead = held;
+ return held;
+ },
+ setDisk: (text: string) => {
+ diskText = text;
+ },
+ emitChange: (text: string) => {
+ diskText = text;
+ for (const cb of changeListeners) cb({ text });
+ },
+ listenerCount: () => changeListeners.size,
+ };
+}
+
+async function flush(): Promise<void> {
+ for (let i = 0; i < 5; i++) await Promise.resolve();
+}
+
+async function elapse(ms: number): Promise<void> {
+ await new Promise((r) => setTimeout(r, ms));
+ await flush();
+}
+
+describe('createIpcUserConfigBinding', () => {
+ test('is unsynced until the first read lands, then reflects the user config', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ const onSynced = vi.fn();
+ binding.subscribeSynced(onSynced);
+
+ expect(binding.hasSynced()).toBe(false);
+ expect(binding.patch({ editor: { wordWrap: false } })).toMatchObject({
+ ok: false,
+ error: { code: 'NOT_SYNCED' },
+ });
+
+ await fake.finishInitialRead();
+
+ expect(binding.hasSynced()).toBe(true);
+ expect(onSynced).toHaveBeenCalledTimes(1);
+ expect(binding.current().appearance?.theme).toBe('dark');
+ });
+
+ test('a patch updates current() at once and sends only the patch, not the whole file', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ const result = binding.patch({ editor: { wordWrap: false } });
+
+ expect(result.ok).toBe(true);
+ expect(binding.current().editor?.wordWrap).toBe(false);
+ expect(fake.patches).toEqual([{ editor: { wordWrap: false } }]);
+ });
+
+ test('the written file text replaces the local copy, keeping keys another writer added', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ binding.patch({ editor: { wordWrap: false } });
+ fake.patchResponses[0]?.resolve({
+ ok: true,
+ text: 'appearance:\n theme: dark\n language: fr\neditor:\n wordWrap: false\n',
+ });
+ await flush();
+
+ expect(binding.current().appearance?.language).toBe('fr');
+ expect(binding.current().editor?.wordWrap).toBe(false);
+ });
+
+ test('a project-scope key is refused locally and never sent', async () => {
+ const fake = fakeTransport('');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ const result = binding.patch({ content: { dir: 'docs' } });
+
+ expect(result).toMatchObject({ ok: false, error: { code: 'SCOPE_VIOLATION' } });
+ expect(fake.patches).toEqual([]);
+ });
+
+ test('an external edit updates current() and notifies subscribers without writing back', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+ const listener = vi.fn();
+ binding.subscribe(listener);
+
+ fake.emitChange('appearance:\n theme: light\n');
+
+ expect(binding.current().appearance?.theme).toBe('light');
+ expect(listener).toHaveBeenCalled();
+ expect(fake.patches).toEqual([]);
+ });
+
+ test('a write the main process refuses reverts to the file and reports the error', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const onRemoteRejected = vi.fn();
+ const binding = createIpcUserConfigBinding(fake.transport, { onRemoteRejected });
+ await fake.finishInitialRead();
+
+ binding.patch({ appearance: { theme: 'light' } });
+ expect(binding.current().appearance?.theme).toBe('light');
+ fake.patchResponses[0]?.resolve({
+ ok: false,
+ error: { code: 'WRITE_ERROR', detail: 'disk full' },
+ });
+ await flush();
+
+ expect(onRemoteRejected).toHaveBeenCalledWith({ code: 'WRITE_ERROR', detail: 'disk full' });
+ expect(binding.current().appearance?.theme).toBe('dark');
+ });
+
+ test('a stale reply does not undo a newer optimistic patch', async () => {
+ const fake = fakeTransport('');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ binding.patch({ editor: { wordWrap: false } });
+ binding.patch({ appearance: { theme: 'light' } });
+ fake.patchResponses[0]?.resolve({ ok: true, text: 'editor:\n wordWrap: false\n' });
+ await flush();
+
+ expect(binding.current().appearance?.theme).toBe('light');
+ });
+
+ test('dispose stops listening for external edits', async () => {
+ const fake = fakeTransport('');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+ expect(fake.listenerCount()).toBe(1);
+
+ binding.dispose();
+
+ expect(fake.listenerCount()).toBe(0);
+ });
+
+ test('an external edit pushed while a patch is in flight is applied once the patch settles', async () => {
+ const fake = fakeTransport('');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ binding.patch({ editor: { wordWrap: false } });
+ fake.emitChange('editor:\n wordWrap: false\nappearance:\n theme: light\n');
+ expect(binding.current().appearance?.theme).toBeUndefined();
+ fake.patchResponses[0]?.resolve({ ok: true, text: 'editor:\n wordWrap: false\n' });
+ await flush();
+
+ expect(binding.current().appearance?.theme).toBe('light');
+ expect(binding.current().editor?.wordWrap).toBe(false);
+ });
+
+ test('a patch refused while another is in flight converges on the file once both settle', async () => {
+ const fake = fakeTransport('appearance:\n theme: dark\n');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ binding.patch({ appearance: { theme: 'light' } });
+ binding.patch({ editor: { wordWrap: false } });
+ fake.patchResponses[0]?.resolve({
+ ok: false,
+ error: { code: 'WRITE_ERROR', detail: 'disk full' },
+ });
+ await flush();
+ fake.setDisk('appearance:\n theme: dark\n language: fr\neditor:\n wordWrap: false\n');
+ fake.patchResponses[1]?.resolve({
+ ok: true,
+ text: 'appearance:\n theme: dark\neditor:\n wordWrap: false\n',
+ });
+ await flush();
+
+ expect(binding.current().appearance?.theme).toBe('dark');
+ expect(binding.current().appearance?.language).toBe('fr');
+ });
+
+ test('a resync read that a newer patch overtakes is discarded and read again', async () => {
+ const fake = fakeTransport('');
+ const binding = createIpcUserConfigBinding(fake.transport);
+ await fake.finishInitialRead();
+
+ binding.patch({ editor: { wordWrap: false } });
+ fake.emitChange('editor:\n wordWrap: false\nappearance:\n theme: light\n');
+ const resync = fake.holdNextRead();
+ fake.patchResponses[0]?.resolve({ ok: true, text: 'editor:\n wordWrap: false\n' });
+ await flush();
+ expect(fake.readCount()).toBe(2);
+
+ binding.patch({ appearance: { language: 'fr' } });
+ const newest = 'editor:\n wordWrap: false\nappearance:\n theme: light\n language: fr\n';
+ fake.setDisk(newest);
+ fake.patchResponses[1]?.resolve({ ok: true, text: newest });
+ await flush();
+ resync.resolve({ text: 'editor:\n wordWrap: false\nappearance:\n theme: light\n' });
+ await flush();
+
+ expect(fake.readCount()).toBe(3);
+ expect(binding.current().appearance?.language).toBe('fr');
+ expect(binding.current().appearance?.theme).toBe('light');
+ binding.dispose();
+ });
+
+ test('a resync read that fails is retried until the binding adopts the file', async () => {
+ const fake = fakeTransport('');
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const binding = createIpcUserConfigBinding(fake.transport, { readRetryMs: 5 });
+ await fake.finishInitialRead();
+
+ binding.patch({ editor: { wordWrap: false } });
+ fake.emitChange('editor:\n wordWrap: false\nappearance:\n theme: light\n');
+ fake.setReadError(new Error('EBUSY'));
+ fake.patchResponses[0]?.resolve({ ok: true, text: 'editor:\n wordWrap: false\n' });
+ await elapse(30);
+
+ expect(binding.current().appearance?.theme).toBeUndefined();
+ expect(warn).toHaveBeenCalledTimes(1);
+
+ fake.setReadError(null);
+ await elapse(30);
+
+ expect(binding.current().appearance?.theme).toBe('light');
+ expect(binding.current().editor?.wordWrap).toBe(false);
+ const reads = fake.readCount();
+ await elapse(30);
+ expect(fake.readCount()).toBe(reads);
+ binding.dispose();
+ } finally {
+ warn.mockRestore();
+ }
+ });
+
+ test('dispose stops retrying a failed resync read', async () => {
+ const fake = fakeTransport('');
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const binding = createIpcUserConfigBinding(fake.transport, { readRetryMs: 5 });
+ await fake.finishInitialRead();
+ binding.patch({ editor: { wordWrap: false } });
+ fake.emitChange('appearance:\n theme: light\n');
+ fake.setReadError(new Error('EBUSY'));
+ fake.patchResponses[0]?.resolve({ ok: true, text: 'editor:\n wordWrap: false\n' });
+ await flush();
+ binding.dispose();
+ const reads = fake.readCount();
+
+ await elapse(30);
+
+ expect(fake.readCount()).toBe(reads);
+ } finally {
+ warn.mockRestore();
+ }
+ });
+
+ test('a failed first read reports the failure, then loads once the file can be read', async () => {
+ vi.useFakeTimers();
+ const fake = fakeTransport('');
+ const onLoadFailedChange = vi.fn();
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const binding = createIpcUserConfigBinding(fake.transport, {
+ onLoadFailedChange,
+ readRetryMs: 1_000,
+ });
+ fake.setReadError(new Error('EACCES'));
+ fake.setDisk('appearance:\n theme: dark\n');
+ await fake.failInitialRead(new Error('EACCES'));
+
+ expect(binding.hasSynced()).toBe(false);
+ expect(onLoadFailedChange).toHaveBeenLastCalledWith(true);
+ expect(fake.readCount()).toBe(1);
+
+ await vi.advanceTimersByTimeAsync(999);
+ expect(fake.readCount()).toBe(1);
+ await vi.advanceTimersByTimeAsync(1);
+ expect(fake.readCount()).toBe(2);
+ await vi.advanceTimersByTimeAsync(1_000);
+ expect(fake.readCount()).toBe(3);
+ expect(binding.hasSynced()).toBe(false);
+ expect(warn).toHaveBeenCalledTimes(1);
+
+ fake.setReadError(null);
+ await vi.advanceTimersByTimeAsync(1_000);
+
+ expect(fake.readCount()).toBe(4);
+ expect(binding.hasSynced()).toBe(true);
+ expect(binding.current().appearance?.theme).toBe('dark');
+ expect(onLoadFailedChange).toHaveBeenLastCalledWith(false);
+ await vi.advanceTimersByTimeAsync(5_000);
+ expect(fake.readCount()).toBe(4);
+ binding.dispose();
+ } finally {
+ warn.mockRestore();
+ vi.useRealTimers();
+ }
+ });
+
+ test('after a failed first read, a pushed change loads the config', async () => {
+ const fake = fakeTransport('');
+ const onLoadFailedChange = vi.fn();
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const binding = createIpcUserConfigBinding(fake.transport, {
+ onLoadFailedChange,
+ readRetryMs: 60_000,
+ });
+ await fake.failInitialRead(new Error('EIO'));
+ expect(onLoadFailedChange).toHaveBeenLastCalledWith(true);
+
+ fake.emitChange('appearance:\n theme: light\n');
+
+ expect(binding.hasSynced()).toBe(true);
+ expect(binding.current().appearance?.theme).toBe('light');
+ expect(onLoadFailedChange).toHaveBeenLastCalledWith(false);
+ binding.dispose();
+ } finally {
+ warn.mockRestore();
+ }
+ });
+
+ test('dispose stops retrying a failed first read', async () => {
+ const fake = fakeTransport('');
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ try {
+ const binding = createIpcUserConfigBinding(fake.transport, { readRetryMs: 5 });
+ fake.setReadError(new Error('EIO'));
+ await fake.failInitialRead(new Error('EIO'));
+ binding.dispose();
+ const reads = fake.readCount();
+
+ await elapse(30);
+
+ expect(fake.readCount()).toBe(reads);
+ } finally {
+ warn.mockRestore();
+ }
+ });
+});
diff --git a/packages/app/src/lib/ipc-user-config-binding.ts b/packages/app/src/lib/ipc-user-config-binding.ts
new file mode 100644
index 000000000..c931354c9
--- /dev/null
+++ b/packages/app/src/lib/ipc-user-config-binding.ts
@@ -0,0 +1,187 @@
+import {
+ bindConfigDoc,
+ type ConfigBinding,
+ type ConfigDocProvider,
+} from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import type { ConfigValidationError } from '@inkeep/open-knowledge-core/config/errors';
+import type { OkUserConfigBridge } from '@inkeep/open-knowledge-core/desktop-bridge';
+import * as Y from 'yjs';
+
+const IPC_USER_CONFIG_FILE_ORIGIN = Symbol('ipc-user-config-file');
+const DEFAULT_READ_RETRY_MS = 2_000;
+
+interface IpcUserConfigBindingOptions {
+ onRemoteRejected?: (error: ConfigValidationError) => void;
+ onLoadFailedChange?: (failed: boolean) => void;
+ readRetryMs?: number;
+}
+
+function logTransportFailure(event: string, err: unknown): void {
+ console.warn(JSON.stringify({ event, error: err instanceof Error ? err.message : String(err) }));
+}
+
+export function createIpcUserConfigBinding(
+ transport: OkUserConfigBridge,
+ options: IpcUserConfigBindingOptions = {},
+): ConfigBinding {
+ const ydoc = new Y.Doc();
+ const ytext = ydoc.getText('source');
+ const syncedListeners = new Set<() => void>();
+ const provider: ConfigDocProvider = {
+ document: ydoc,
+ on: (_event, listener) => {
+ syncedListeners.add(listener);
+ },
+ off: (_event, listener) => {
+ syncedListeners.delete(listener);
+ },
+ };
+ const inner = bindConfigDoc(provider, 'user');
+ let disposed = false;
+ let synced = false;
+ let latestPatch = 0;
+ let inFlight = 0;
+ let missed = false;
+ let loadFailed = false;
+ let retryTimer: ReturnType<typeof setTimeout> | null = null;
+ let resyncTimer: ReturnType<typeof setTimeout> | null = null;
+ let resyncFailing = false;
+
+ function adoptFileText(text: string): void {
+ if (disposed || ytext.toString() === text) return;
+ ydoc.transact(() => {
+ if (ytext.length > 0) ytext.delete(0, ytext.length);
+ ytext.insert(0, text);
+ }, IPC_USER_CONFIG_FILE_ORIGIN);
+ }
+
+ function setLoadFailed(next: boolean): void {
+ if (loadFailed === next) return;
+ loadFailed = next;
+ options.onLoadFailedChange?.(next);
+ }
+
+ function markSynced(): void {
+ if (disposed || synced) return;
+ synced = true;
+ if (retryTimer !== null) {
+ clearTimeout(retryTimer);
+ retryTimer = null;
+ }
+ setLoadFailed(false);
+ for (const listener of syncedListeners) listener();
+ }
+
+ function settle(): void {
+ if (!disposed && inFlight === 0 && missed) resyncFromFile();
+ }
+
+ function scheduleResyncRetry(): void {
+ if (disposed || resyncTimer !== null) return;
+ resyncTimer = setTimeout(() => {
+ resyncTimer = null;
+ settle();
+ }, options.readRetryMs ?? DEFAULT_READ_RETRY_MS);
+ }
+
+ function resyncFromFile(): void {
+ missed = false;
+ const issuedAt = latestPatch;
+ transport.read().then(
+ ({ text }) => {
+ resyncFailing = false;
+ if (inFlight === 0 && issuedAt === latestPatch) {
+ adoptFileText(text);
+ return;
+ }
+ missed = true;
+ settle();
+ },
+ (err: unknown) => {
+ missed = true;
+ if (!resyncFailing) logTransportFailure('ok-user-config-resync-failed', err);
+ resyncFailing = true;
+ scheduleResyncRetry();
+ },
+ );
+ }
+
+ function loadInitial(): void {
+ transport.read().then(
+ ({ text }) => {
+ if (disposed || synced) return;
+ adoptFileText(text);
+ markSynced();
+ },
+ (err: unknown) => {
+ if (disposed || synced) return;
+ if (!loadFailed) logTransportFailure('ok-user-config-read-failed', err);
+ setLoadFailed(true);
+ retryTimer = setTimeout(() => {
+ retryTimer = null;
+ loadInitial();
+ }, options.readRetryMs ?? DEFAULT_READ_RETRY_MS);
+ },
+ );
+ }
+
+ const unsubscribeChanged = transport.onChanged(({ text }) => {
+ if (inFlight > 0) {
+ missed = true;
+ return;
+ }
+ adoptFileText(text);
+ markSynced();
+ });
+
+ loadInitial();
+
+ return {
+ current: () => inner.current(),
+ subscribe: (listener) => inner.subscribe(listener),
+ hasSynced: () => inner.hasSynced(),
+ subscribeSynced: (listener) => inner.subscribeSynced(listener),
+
+ patch(patch) {
+ const result = inner.patch(patch);
+ if (!result.ok) return result;
+ latestPatch += 1;
+ const token = latestPatch;
+ inFlight += 1;
+ transport.patch(patch).then(
+ (response) => {
+ inFlight -= 1;
+ if (response.ok) {
+ if (token === latestPatch) adoptFileText(response.text);
+ } else {
+ options.onRemoteRejected?.(response.error);
+ missed = true;
+ }
+ settle();
+ },
+ (err: unknown) => {
+ inFlight -= 1;
+ logTransportFailure('ok-user-config-patch-failed', err);
+ options.onRemoteRejected?.({
+ code: 'WRITE_ERROR',
+ detail: err instanceof Error ? err.message : String(err),
+ });
+ missed = true;
+ settle();
+ },
+ );
+ return result;
+ },
+
+ dispose() {
+ if (disposed) return;
+ disposed = true;
+ if (retryTimer !== null) clearTimeout(retryTimer);
+ if (resyncTimer !== null) clearTimeout(resyncTimer);
+ unsubscribeChanged();
+ inner.dispose();
+ syncedListeners.clear();
+ ydoc.destroy();
+ },
+ };
+}
diff --git a/packages/app/src/lib/use-navigator-user-config.ts b/packages/app/src/lib/use-navigator-user-config.ts
new file mode 100644
index 000000000..3274728d8
--- /dev/null
+++ b/packages/app/src/lib/use-navigator-user-config.ts
@@ -0,0 +1,96 @@
+import type { ConfigBinding } from '@inkeep/open-knowledge-core/config/bind-config-doc';
+import type { Config } from '@inkeep/open-knowledge-core/config/schema';
+import {
+ CC1_CONTRACT_VERSION,
+ CONFIG_DOC_NAME_USER,
+} from '@inkeep/open-knowledge-core/constants/cc1';
+import { CC1_CHANNEL_CONFIG_VALIDATION_REJECTED } from '@inkeep/open-knowledge-core/schemas/cc1';
+import { useEffect, useState } from 'react';
+import type { ConfigContextValue } from './config-context';
+import { emitConfigValidationRejected } from './config-validation-events';
+import type { OkDesktopBridge } from './desktop-bridge-types';
+import { createIpcUserConfigBinding } from './ipc-user-config-binding';
+
+interface NavigatorUserConfigState {
+ binding: ConfigBinding;
+ config: Config;
+ synced: boolean;
+ loadFailed: boolean;
+}
+
+export interface NavigatorUserConfig {
+ binding: ConfigBinding | null;
+ config: Config | null;
+ synced: boolean;
+ loadFailed: boolean;
+}
+
+export function useNavigatorUserConfig(bridge: OkDesktopBridge): NavigatorUserConfig {
+ const [state, setState] = useState<NavigatorUserConfigState | null>(null);
+
+ useEffect(() => {
+ const transport = bridge.userConfig;
+ if (!transport) return;
+ let rejectionSeq = 0;
+ const binding: ConfigBinding = createIpcUserConfigBinding(transport, {
+ onLoadFailedChange: (loadFailed) => {
+ setState((prev) => (prev?.binding === binding ? { ...prev, loadFailed } : prev));
+ },
+ onRemoteRejected: (error) => {
+ rejectionSeq += 1;
+ emitConfigValidationRejected({
+ v: CC1_CONTRACT_VERSION,
+ ch: CC1_CHANNEL_CONFIG_VALIDATION_REJECTED,
+ seq: rejectionSeq,
+ docName: CONFIG_DOC_NAME_USER,
+ error,
+ });
+ },
+ });
+ setState({
+ binding,
+ config: binding.current(),
+ synced: binding.hasSynced(),
+ loadFailed: false,
+ });
+ const unsubscribe = binding.subscribe((config) => {
+ setState((prev) => (prev?.binding === binding ? { ...prev, config } : prev));
+ });
+ const unsubscribeSynced = binding.subscribeSynced(() => {
+ setState((prev) =>
+ prev?.binding === binding ? { ...prev, config: binding.current(), synced: true } : prev,
+ );
+ });
+ return () => {
+ unsubscribe();
+ unsubscribeSynced();
+ binding.dispose();
+ setState((prev) => (prev?.binding === binding ? null : prev));
+ };
+ }, [bridge]);
+
+ return {
+ binding: state?.binding ?? null,
+ config: state?.config ?? null,
+ synced: state?.synced ?? false,
+ loadFailed: state?.loadFailed ?? false,
+ };
+}
+
+export function navigatorConfigContextValue(userConfig: NavigatorUserConfig): ConfigContextValue {
+ return {
+ userBinding: userConfig.binding,
+ userSynced: userConfig.synced,
+ userLoadFailed: userConfig.loadFailed,
+ projectBinding: null,
+ projectLocalBinding: null,
+ okignoreBinding: null,
+ okignoreSynced: false,
+ userConfig: userConfig.config,
+ projectConfig: null,
+ projectSynced: false,
+ projectLocalConfig: null,
+ projectLocalSynced: false,
+ merged: userConfig.synced ? userConfig.config : null,
+ };
+}
diff --git a/packages/app/src/lib/use-settings-route.dom.test.tsx b/packages/app/src/lib/use-settings-route.dom.test.tsx
index b2233519a..afa0fe830 100644
--- a/packages/app/src/lib/use-settings-route.dom.test.tsx
+++ b/packages/app/src/lib/use-settings-route.dom.test.tsx
@@ -41,4 +41,31 @@ describe('useSettingsRoute runtime routing', () => {
expect(startTransitionMock).toHaveBeenCalledTimes(1);
expect(screen.getByTestId('settings-open').textContent).toBe('open');
});
+
+ test('a hash set after the first render but before the route subscribes still opens settings', async () => {
+ window.history.replaceState(null, '', '/');
+ const { useSettingsRoute } = await import('./use-settings-route');
+ let hashSet = false;
+
+ function Probe() {
+ const route = useSettingsRoute();
+ return <output data-testid="settings-open">{route.open ? 'open' : 'closed'}</output>;
+ }
+ function SetHashDuringRender() {
+ if (!hashSet) {
+ hashSet = true;
+ window.history.replaceState(null, '', '#settings');
+ }
+ return null;
+ }
+
+ render(
+ <>
+ <Probe />
+ <SetHashDuringRender />
+ </>,
+ );
+
+ expect(await screen.findByText('open')).toBeTruthy();
+ });
});
diff --git a/packages/app/src/lib/use-settings-route.ts b/packages/app/src/lib/use-settings-route.ts
index fc7bfccc6..28f33428a 100644
--- a/packages/app/src/lib/use-settings-route.ts
+++ b/packages/app/src/lib/use-settings-route.ts
@@ -105,10 +105,9 @@ function readCurrentHash(): string {
}
export function useSettingsRoute(): SettingsRouteState {
- const [open, setOpen] = useState<boolean>(() => isSettingsHashOpen(readCurrentHash()));
- const [section, setSection] = useState<string | null>(() =>
- settingsHashSection(readCurrentHash()),
- );
+ const [mountHash] = useState(readCurrentHash);
+ const [open, setOpen] = useState<boolean>(() => isSettingsHashOpen(mountHash));
+ const [section, setSection] = useState<string | null>(() => settingsHashSection(mountHash));
useEffect(() => {
const onHashChange = () => {
@@ -119,8 +118,9 @@ export function useSettingsRoute(): SettingsRouteState {
});
};
window.addEventListener('hashchange', onHashChange);
+ if (readCurrentHash() !== mountHash) onHashChange();
return () => window.removeEventListener('hashchange', onHashChange);
- }, []);
+ }, [mountHash]);
const close = () => {
if (typeof window === 'undefined') return;
diff --git a/packages/app/src/locales/ar/messages.json b/packages/app/src/locales/ar/messages.json
index 88e94bd1c..faf527b8b 100644
--- a/packages/app/src/locales/ar/messages.json
+++ b/packages/app/src/locales/ar/messages.json
@@ -1270,6 +1270,9 @@
],
"BQKHuL": ["إعادة تشغيل الطرفية"],
"BQu9Pg": ["رابط رمزي"],
+ "BRtKwG": [
+ "لتوصيل أدوات الذكاء الاصطناعي بدون مشروع، استخدم ملف > إعداد تكاملات OpenKnowledge…"
+ ],
"BUyQnq": ["تعذّرت إعادة تشغيل الخادم. جرّب `ok start` في هذا المجلد."],
"BVkqD9": [
"تم إيقاف صيانة الفهرس مؤقتًا لأن سمة Git أخرى تتحكم في index.md. قم بتحديث .gitattributes بحيث تستخدم مسارات index.md المحددة النطاق merge=union، ثم حاول مرة أخرى."
@@ -2700,6 +2703,7 @@
"PWh9Ii": ["تطبيق التغييرات"],
"PWqtgd": ["جارٍ تحميل المحادثة"],
"PXaT32": ["أعاد الخادم استجابة وجهات المهارات غير مكتملة."],
+ "PXg8xK": ["تعذّرت قراءة إعدادات المستخدم الخاصة بك"],
"PYmp-0": ["استيراد كقالب"],
"PZKdTd": ["تقرير بلا عنوان"],
"PZn2LP": ["الاحتفاظ بالمصدر"],
@@ -5866,6 +5870,7 @@
"rENNI6": ["رابط المشاركة غير صالح."],
"rFL-yb": ["تحرير نسخة"],
"rFTdVq": ["الإظهار في المستعرض"],
+ "rFbQzX": ["يواصل OpenKnowledge إعادة المحاولة وسيعرضها بمجرد أن تصبح قراءة الملف ممكنة."],
"rFmBG3": ["سمة الألوان"],
"rFskYz": [
"ينطبق على كل المشاريع على هذا الجهاز، في محادثات Claude Code وCodex في لوحة الوكلاء التي تبدأ بعد تشغيله. يستطيع الوكيل فتح الصفحات والنقر والكتابة والتقاط لقطات الشاشة في نافذة Google Chrome خاصة به بملف تعريف جديد. يتطلب تثبيت Google Chrome وNode.js. يطلب كل إجراء في المتصفح موافقتك، دون خيار للسماح به دائمًا، ما لم يتخطَّ وضع الوكيل نفسه أو إعدادات الأذونات الخاصة به طلبات الموافقة."
diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.po
index 8285bd643..2be8ca58c 100644
--- a/packages/app/src/locales/ar/messages.po
+++ b/packages/app/src/locales/ar/messages.po
@@ -10657,6 +10657,10 @@ msgstr "تم إعداد OpenKnowledge في جذر المستودع هنا، لذ
msgid "OpenKnowledge is using this GitHub account."
msgstr "يستخدم OpenKnowledge حساب GitHub هذا."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "يواصل OpenKnowledge إعادة المحاولة وسيعرضها بمجرد أن تصبح قراءة الملف ممكنة."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "لم يغيّر OpenKnowledge هذا الملف لأنه لم يتمكن من تحليله بأمان. أصلح الملف يدويًا ثم أعد المحاولة."
@@ -15741,6 +15745,10 @@ msgstr "العنوان"
msgid "Title"
msgstr "العنوان"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "لتوصيل أدوات الذكاء الاصطناعي بدون مشروع، استخدم ملف > إعداد تكاملات OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "للقيام به"
@@ -17117,6 +17125,10 @@ msgstr "تُرسل استعلامات بحثك والنص الكامل للصف
msgid "Your share link is ready below."
msgstr "رابط المشاركة الخاص بك جاهز أدناه."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "تعذّرت قراءة إعدادات المستخدم الخاصة بك"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "ملف Zip"
diff --git a/packages/app/src/locales/bn/messages.json b/packages/app/src/locales/bn/messages.json
index e336f7924..702d7d21e 100644
--- a/packages/app/src/locales/bn/messages.json
+++ b/packages/app/src/locales/bn/messages.json
@@ -1062,6 +1062,7 @@
],
"BQKHuL": ["টার্মিনাল পুনরায় চালু করুন"],
"BQu9Pg": ["সিমলিংক"],
+ "BRtKwG": ["কোনো প্রকল্প ছাড়া AI টুল সংযুক্ত করতে, ফাইল > OpenKnowledge সংযুক্তি সেট আপ করুন… ব্যবহার করুন।"],
"BUyQnq": ["সার্ভার পুনরায় চালু করা যায়নি। এই ফোল্ডারে `ok start` চেষ্টা করুন।"],
"BVkqD9": [
"সূচী রক্ষণাবেক্ষণ বিরাম দেওয়া হয়েছে কারণ অন্য Git বৈশিষ্ট্য নিয়ন্ত্রণ করে index.md। .gitattributes আপডেট করুন যাতে স্কোপযুক্ত index.md পাথগুলি merge=union ব্যবহার করে, তারপর আবার চেষ্টা করুন।"
@@ -2294,6 +2295,7 @@
"PWh9Ii": ["পরিবর্তন প্রয়োগ করুন"],
"PWqtgd": ["চ্যাট লোড হচ্ছে"],
"PXaT32": ["সার্ভার একটি অসম্পূর্ণ স্কিল-টার্গেট প্রতিক্রিয়া ফেরত দিয়েছে।"],
+ "PXg8xK": ["আপনার ব্যবহারকারী সেটিং পড়া যায়নি"],
"PYmp-0": ["টেমপ্লেট হিসেবে আমদানি করুন"],
"PZKdTd": ["শিরোনামহীন রিপোর্ট"],
"PZn2LP": ["উৎস রাখুন"],
@@ -4942,6 +4944,7 @@
"rENNI6": ["শেয়ার URL সঠিক নয়।"],
"rFL-yb": ["একটি অনুলিপি সম্পাদনা করুন"],
"rFTdVq": ["Explorer-এ দেখান"],
+ "rFbQzX": ["OpenKnowledge বারবার চেষ্টা করতে থাকে এবং ফাইলটি পড়া গেলেই সেগুলো দেখাবে।"],
"rFmBG3": ["রঙের থিম"],
"rFskYz": [
"এই মেশিনের সব প্রজেক্টে প্রযোজ্য, চালু করার পরে শুরু হওয়া এজেন্ট প্যানেলের Claude Code ও Codex চ্যাটে। এজেন্ট নতুন প্রোফাইলসহ নিজের Google Chrome উইন্ডোতে পেজ খুলতে, ক্লিক করতে, টাইপ করতে ও স্ক্রিনশট নিতে পারে। Google Chrome ও Node.js ইনস্টল থাকা দরকার। ব্রাউজারের প্রতিটি কাজ আপনার অনুমোদন চায়, সবসময় অনুমতি দেওয়ার কোনো বিকল্প ছাড়াই, যদি না এজেন্টের নিজের মোড বা অনুমতি সেটিংস অনুমোদন এড়িয়ে যায়।"
diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.po
index cbbf58ba2..e50db8b2f 100644
--- a/packages/app/src/locales/bn/messages.po
+++ b/packages/app/src/locales/bn/messages.po
@@ -10653,6 +10653,10 @@ msgstr "এখানে OpenKnowledge সংগ্রহস্থলের ম
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge এই GitHub অ্যাকাউন্টটি ব্যবহার করছে।"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge বারবার চেষ্টা করতে থাকে এবং ফাইলটি পড়া গেলেই সেগুলো দেখাবে।"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge এই ফাইলটি পরিবর্তন করেনি কারণ এটি নিরাপদে পার্স করা যায়নি। ফাইলটি হাতে ঠিক করুন, তারপর আবার চেষ্টা করুন।"
@@ -15737,6 +15741,10 @@ msgstr "শিরোনাম"
msgid "Title"
msgstr "শিরোনাম"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "কোনো প্রকল্প ছাড়া AI টুল সংযুক্ত করতে, ফাইল > OpenKnowledge সংযুক্তি সেট আপ করুন… ব্যবহার করুন।"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "করণীয়"
@@ -17113,6 +17121,10 @@ msgstr "আপনার অনুসন্ধানের প্রশ্ন ও
msgid "Your share link is ready below."
msgstr "আপনার শেয়ার লিংক নিচে প্রস্তুত।"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "আপনার ব্যবহারকারী সেটিং পড়া যায়নি"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Zip ফাইল"
diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.json
index e7c7daff8..d7202080d 100644
--- a/packages/app/src/locales/en/messages.json
+++ b/packages/app/src/locales/en/messages.json
@@ -1103,6 +1103,9 @@
],
"BQKHuL": ["Restart terminal"],
"BQu9Pg": ["Symlink"],
+ "BRtKwG": [
+ "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+ ],
"BUyQnq": ["Couldn't restart the server. Try `ok start` in this folder."],
"BVkqD9": [
"Index maintenance is paused because another Git attribute controls index.md. Update .gitattributes so the scoped index.md paths use merge=union, then try again."
@@ -2369,6 +2372,7 @@
"PWh9Ii": ["Apply changes"],
"PWqtgd": ["Loading the chat"],
"PXaT32": ["Server returned an incomplete skill-targets response."],
+ "PXg8xK": ["Your user settings could not be read"],
"PYmp-0": ["Import as template"],
"PZKdTd": ["Untitled report"],
"PZn2LP": ["Keep source"],
@@ -5117,6 +5121,7 @@
"rENNI6": ["Invalid share URL."],
"rFL-yb": ["Edit a copy"],
"rFTdVq": ["Show in Explorer"],
+ "rFbQzX": ["OpenKnowledge keeps retrying and shows them as soon as the file can be read."],
"rFmBG3": ["Color theme"],
"rFskYz": [
"Applies to all projects on this machine, in Claude Code and Codex chats in the Agents panel started after you turn it on. The agent can open pages, click, type, and take screenshots in its own Google Chrome window with a fresh profile. Needs Google Chrome and Node.js installed. Every browser action asks for your approval, with no option to always allow it, unless the agent's own mode or permission settings skip approvals."
diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.po
index d8171b85b..83b2ee75b 100644
--- a/packages/app/src/locales/en/messages.po
+++ b/packages/app/src/locales/en/messages.po
@@ -10657,6 +10657,10 @@ msgstr "OpenKnowledge is set up at the repository root here, so the pack goes in
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge is using this GitHub account."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
@@ -15741,6 +15745,10 @@ msgstr "title"
msgid "Title"
msgstr "Title"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "To do"
@@ -17117,6 +17125,10 @@ msgstr "Your search queries and the full text of matching pages are sent to your
msgid "Your share link is ready below."
msgstr "Your share link is ready below."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "Your user settings could not be read"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Zip file"
diff --git a/packages/app/src/locales/es/messages.json b/packages/app/src/locales/es/messages.json
index 206cd44c2..31b07edca 100644
--- a/packages/app/src/locales/es/messages.json
+++ b/packages/app/src/locales/es/messages.json
@@ -1282,6 +1282,9 @@
],
"BQKHuL": ["Reiniciar la terminal"],
"BQu9Pg": ["Enlace simbólico"],
+ "BRtKwG": [
+ "Para conectar herramientas de IA sin un proyecto, usa Archivo > Configurar las integraciones de OpenKnowledge…"
+ ],
"BUyQnq": ["No se pudo reiniciar el servidor. Prueba `ok start` en esta carpeta."],
"BVkqD9": [
"El mantenimiento del índice está en pausa porque otro atributo de Git controla index.md. Actualiza .gitattributes para que las rutas index.md de ese ámbito usen merge=union y vuelve a intentarlo."
@@ -2722,6 +2725,7 @@
"PWh9Ii": ["Aplicar cambios"],
"PWqtgd": ["Cargando el chat"],
"PXaT32": ["El servidor devolvió una respuesta de destinos de habilidades incompleta."],
+ "PXg8xK": ["No se pudieron leer tus ajustes de usuario"],
"PYmp-0": ["Importar como plantilla"],
"PZKdTd": ["Informe sin título"],
"PZn2LP": ["Conservar el origen"],
@@ -5899,6 +5903,9 @@
"rENNI6": ["URL para compartir no válida."],
"rFL-yb": ["Editar una copia"],
"rFTdVq": ["Mostrar en el Explorador"],
+ "rFbQzX": [
+ "OpenKnowledge sigue reintentándolo y los mostrará en cuanto se pueda leer el archivo."
+ ],
"rFmBG3": ["Tema de color"],
"rFskYz": [
"Se aplica a todos los proyectos de esta máquina, en los chats de Claude Code y Codex del panel de agentes que se inicien después de activarlo. El agente puede abrir páginas, hacer clic, escribir y tomar capturas de pantalla en su propia ventana de Google Chrome con un perfil nuevo. Requiere tener Google Chrome y Node.js instalados. Cada acción del navegador pide tu aprobación, sin opción de permitirla siempre, salvo que el propio modo del agente o su configuración de permisos omitan las aprobaciones."
diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.po
index 8710345a3..bd2f2471f 100644
--- a/packages/app/src/locales/es/messages.po
+++ b/packages/app/src/locales/es/messages.po
@@ -10657,6 +10657,10 @@ msgstr "Aquí OpenKnowledge se configura en la raíz del repositorio, así que e
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge está usando esta cuenta de GitHub."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge sigue reintentándolo y los mostrará en cuanto se pueda leer el archivo."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge no modificó este archivo porque no pudo analizarlo de forma segura. Corrige el archivo a mano y vuelve a intentarlo."
@@ -15741,6 +15745,10 @@ msgstr "título"
msgid "Title"
msgstr "Título"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "Para conectar herramientas de IA sin un proyecto, usa Archivo > Configurar las integraciones de OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "Por hacer"
@@ -17117,6 +17125,10 @@ msgstr "Tus consultas de búsqueda y el texto completo de las páginas que coinc
msgid "Your share link is ready below."
msgstr "Tu enlace para compartir está listo abajo."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "No se pudieron leer tus ajustes de usuario"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Archivo zip"
diff --git a/packages/app/src/locales/fr/messages.json b/packages/app/src/locales/fr/messages.json
index dd9421ca0..a63b6fe13 100644
--- a/packages/app/src/locales/fr/messages.json
+++ b/packages/app/src/locales/fr/messages.json
@@ -1311,6 +1311,9 @@
],
"BQKHuL": ["Redémarrer le terminal"],
"BQu9Pg": ["Lien symbolique"],
+ "BRtKwG": [
+ "Pour connecter des outils IA sans projet, utilisez Fichier > Configurer les intégrations OpenKnowledge…"
+ ],
"BUyQnq": ["Impossible de redémarrer le serveur. Essayez `ok start` dans ce dossier."],
"BVkqD9": [
"La maintenance de l'index est suspendue car un autre attribut Git contrôle index.md. Mettez à jour .gitattributes pour que les chemins index.md définis utilisent merge=union, puis réessayez."
@@ -2766,6 +2769,7 @@
"PWh9Ii": ["Appliquer les modifications"],
"PWqtgd": ["Chargement du chat"],
"PXaT32": ["Le serveur a renvoyé une réponse de cibles de compétences incomplète."],
+ "PXg8xK": ["Impossible de lire vos paramètres utilisateur"],
"PYmp-0": ["Importer comme modèle"],
"PZKdTd": ["Rapport sans titre"],
"PZn2LP": ["Conserver la source"],
@@ -5966,6 +5970,9 @@
"rENNI6": ["URL de partage non valide."],
"rFL-yb": ["Modifier une copie"],
"rFTdVq": ["Afficher dans l'Explorateur"],
+ "rFbQzX": [
+ "OpenKnowledge continue de réessayer et les affichera dès que le fichier pourra être lu."
+ ],
"rFmBG3": ["Thème de couleurs"],
"rFskYz": [
"S'applique à tous les projets de cette machine, dans les chats Claude Code et Codex du panneau Agents démarrés après l'activation. L'agent peut ouvrir des pages, cliquer, saisir du texte et prendre des captures d'écran dans sa propre fenêtre Google Chrome avec un profil vierge. Nécessite que Google Chrome et Node.js soient installés. Chaque action du navigateur demande votre approbation, sans option pour toujours l'autoriser, sauf si le mode de l'agent lui-même ou ses paramètres d'autorisation ignorent les approbations."
diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.po
index 3fb3c1e16..4f2eb62a7 100644
--- a/packages/app/src/locales/fr/messages.po
+++ b/packages/app/src/locales/fr/messages.po
@@ -10657,6 +10657,10 @@ msgstr "Ici, OpenKnowledge est configuré à la racine du dépôt, donc le pack
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge utilise ce compte GitHub."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge continue de réessayer et les affichera dès que le fichier pourra être lu."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge n'a pas touché à ce fichier, car il n'a pas pu l'analyser en toute sécurité. Corrigez le fichier à la main, puis réessayez."
@@ -15741,6 +15745,10 @@ msgstr "titre"
msgid "Title"
msgstr "Titre"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "Pour connecter des outils IA sans projet, utilisez Fichier > Configurer les intégrations OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "À faire"
@@ -17117,6 +17125,10 @@ msgstr "Vos requêtes de recherche et le texte intégral des pages correspondant
msgid "Your share link is ready below."
msgstr "Votre lien de partage est prêt ci-dessous."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "Impossible de lire vos paramètres utilisateur"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Fichier zip"
diff --git a/packages/app/src/locales/hi/messages.json b/packages/app/src/locales/hi/messages.json
index 202c72b00..4f00cf9da 100644
--- a/packages/app/src/locales/hi/messages.json
+++ b/packages/app/src/locales/hi/messages.json
@@ -1069,6 +1069,9 @@
],
"BQKHuL": ["टर्मिनल पुनः आरंभ करें"],
"BQu9Pg": ["सिमलिंक"],
+ "BRtKwG": [
+ "किसी प्रोजेक्ट के बिना AI टूल कनेक्ट करने के लिए, फ़ाइल > OpenKnowledge एकीकरण सेट अप करें… का उपयोग करें।"
+ ],
"BUyQnq": ["सर्वर पुनः आरंभ नहीं किया जा सका। इस फ़ोल्डर में `ok start` आज़माएँ।"],
"BVkqD9": [
"सूचकांक रखरखाव रोक दिया गया है क्योंकि एक अन्य Git विशेषता index.md को नियंत्रित करती है। .gitattributes को अपडेट करें ताकि दायरे वाले index.md पथ merge=union का उपयोग करें, फिर पुनः प्रयास करें।"
@@ -2299,6 +2302,7 @@
"PWh9Ii": ["परिवर्तन लागू करें"],
"PWqtgd": ["चैट लोड हो रही है"],
"PXaT32": ["सर्वर ने अधूरी स्किल-टारगेट प्रतिक्रिया लौटाई।"],
+ "PXg8xK": ["आपकी उपयोगकर्ता सेटिंग पढ़ी नहीं जा सकीं"],
"PYmp-0": ["टेम्पलेट के रूप में आयात करें"],
"PZKdTd": ["बिना शीर्षक रिपोर्ट"],
"PZn2LP": ["स्रोत रखें"],
@@ -4923,6 +4927,7 @@
"rENNI6": ["साझा करने का URL अमान्य है।"],
"rFL-yb": ["एक प्रति संपादित करें"],
"rFTdVq": ["Explorer में दिखाएँ"],
+ "rFbQzX": ["OpenKnowledge फिर से कोशिश करता रहता है और फ़ाइल पढ़ी जा सकते ही उन्हें दिखा देगा।"],
"rFmBG3": ["रंग थीम"],
"rFskYz": [
"इस मशीन के सभी प्रोजेक्ट पर लागू होता है, एजेंट पैनल की उन Claude Code और Codex चैट में जो इसे चालू करने के बाद शुरू हों। एजेंट नई प्रोफ़ाइल वाली अपनी Google Chrome विंडो में पेज खोल सकता है, क्लिक कर सकता है, टाइप कर सकता है और स्क्रीनशॉट ले सकता है। Google Chrome और Node.js इंस्टॉल होना ज़रूरी है। ब्राउज़र की हर कार्रवाई आपकी स्वीकृति माँगती है, हमेशा अनुमति देने के किसी विकल्प के बिना, जब तक कि एजेंट का अपना मोड या उसकी अनुमति सेटिंग स्वीकृति को छोड़ न दें।"
diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.po
index d3b2674db..9204ea7e7 100644
--- a/packages/app/src/locales/hi/messages.po
+++ b/packages/app/src/locales/hi/messages.po
@@ -10653,6 +10653,10 @@ msgstr "यहाँ OpenKnowledge रिपॉज़िटरी रूट प
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge यही GitHub खाता उपयोग कर रहा है।"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge फिर से कोशिश करता रहता है और फ़ाइल पढ़ी जा सकते ही उन्हें दिखा देगा।"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge ने इस फ़ाइल को नहीं बदला क्योंकि वह इसे सुरक्षित रूप से पार्स नहीं कर सका। फ़ाइल को हाथ से ठीक करें, फिर दोबारा कोशिश करें।"
@@ -15737,6 +15741,10 @@ msgstr "शीर्षक"
msgid "Title"
msgstr "शीर्षक"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "किसी प्रोजेक्ट के बिना AI टूल कनेक्ट करने के लिए, फ़ाइल > OpenKnowledge एकीकरण सेट अप करें… का उपयोग करें।"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "करना है"
@@ -17113,6 +17121,10 @@ msgstr "आपकी खोज क्वेरी और मेल खाते
msgid "Your share link is ready below."
msgstr "आपका साझा लिंक नीचे तैयार है।"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "आपकी उपयोगकर्ता सेटिंग पढ़ी नहीं जा सकीं"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Zip फ़ाइल"
diff --git a/packages/app/src/locales/id/messages.json b/packages/app/src/locales/id/messages.json
index ddb46c254..47ad7c9d6 100644
--- a/packages/app/src/locales/id/messages.json
+++ b/packages/app/src/locales/id/messages.json
@@ -1095,6 +1095,9 @@
],
"BQKHuL": ["Mulai ulang terminal"],
"BQu9Pg": ["Symlink"],
+ "BRtKwG": [
+ "Untuk menghubungkan alat AI tanpa proyek, gunakan Berkas > Siapkan integrasi OpenKnowledge…"
+ ],
"BUyQnq": ["Server tidak bisa dimulai ulang. Coba `ok start` di folder ini."],
"BVkqD9": [
"Pemeliharaan indeks dihentikan sementara karena atribut Git lainnya mengontrol index.md. Perbarui .gitattributes sehingga jalur index.md yang dicakup menggunakan merge=union, lalu coba lagi."
@@ -2379,6 +2382,7 @@
"PWh9Ii": ["Terapkan perubahan"],
"PWqtgd": ["Memuat obrolan"],
"PXaT32": ["Server mengembalikan respons target skill yang tidak lengkap."],
+ "PXg8xK": ["Pengaturan pengguna Anda tidak dapat dibaca"],
"PYmp-0": ["Impor sebagai templat"],
"PZKdTd": ["Laporan tanpa judul"],
"PZn2LP": ["Simpan sumbernya"],
@@ -5108,6 +5112,9 @@
"rENNI6": ["URL berbagi tidak valid."],
"rFL-yb": ["Sunting salinan"],
"rFTdVq": ["Tampilkan di Explorer"],
+ "rFbQzX": [
+ "OpenKnowledge terus mencoba lagi dan akan menampilkannya segera setelah berkas dapat dibaca."
+ ],
"rFmBG3": ["Tema warna"],
"rFskYz": [
"Berlaku untuk semua proyek di mesin ini, pada obrolan Claude Code dan Codex di panel Agen yang dimulai setelah Anda mengaktifkannya. Agen dapat membuka halaman, mengeklik, mengetik, dan mengambil tangkapan layar di jendela Google Chrome miliknya dengan profil baru. Memerlukan Google Chrome dan Node.js yang terpasang. Setiap tindakan browser meminta persetujuan Anda, tanpa opsi untuk selalu mengizinkannya, kecuali mode agen itu sendiri atau pengaturan izinnya melewati persetujuan."
diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.po
index aaa53157a..a517fee0e 100644
--- a/packages/app/src/locales/id/messages.po
+++ b/packages/app/src/locales/id/messages.po
@@ -10653,6 +10653,10 @@ msgstr "Di sini OpenKnowledge disiapkan di root repositori, jadi paket ditempatk
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge memakai akun GitHub ini."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge terus mencoba lagi dan akan menampilkannya segera setelah berkas dapat dibaca."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge tidak mengubah file ini karena tidak dapat mengurainya dengan aman. Perbaiki file secara manual, lalu coba lagi."
@@ -15737,6 +15741,10 @@ msgstr "judul"
msgid "Title"
msgstr "Judul"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "Untuk menghubungkan alat AI tanpa proyek, gunakan Berkas > Siapkan integrasi OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "Akan dikerjakan"
@@ -17113,6 +17121,10 @@ msgstr "Kueri pencarian Anda dan teks lengkap halaman yang cocok dikirim ke peny
msgid "Your share link is ready below."
msgstr "Tautan berbagi Anda sudah siap di bawah."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "Pengaturan pengguna Anda tidak dapat dibaca"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Berkas zip"
diff --git a/packages/app/src/locales/ko/messages.json b/packages/app/src/locales/ko/messages.json
index d0faefb8e..42478ab5c 100644
--- a/packages/app/src/locales/ko/messages.json
+++ b/packages/app/src/locales/ko/messages.json
@@ -1062,6 +1062,7 @@
],
"BQKHuL": ["터미널 재시작"],
"BQu9Pg": ["심볼릭 링크"],
+ "BRtKwG": ["프로젝트 없이 AI 도구를 연결하려면 파일 > OpenKnowledge 통합 설정…을 사용하세요."],
"BUyQnq": ["서버를 다시 시작할 수 없습니다. 이 폴더에서 `ok start`를 실행해 보세요."],
"BVkqD9": [
"다른 Git 속성이 index.md를 제어하므로 인덱스 유지 관리가 일시 중지되었습니다. 범위가 지정된 index.md 경로가 merge=union을 사용하도록 .gitattributes를 업데이트한 후 다시 시도합니다."
@@ -2288,6 +2289,7 @@
"PWh9Ii": ["변경 사항 적용"],
"PWqtgd": ["채팅 불러오는 중"],
"PXaT32": ["서버에서 불완전한 스킬 대상 응답을 반환했습니다."],
+ "PXg8xK": ["사용자 설정을 읽을 수 없습니다"],
"PYmp-0": ["템플릿으로 가져오기"],
"PZKdTd": ["제목 없는 보고서"],
"PZn2LP": ["소스 유지"],
@@ -4883,6 +4885,7 @@
"rENNI6": ["잘못된 공유 URL입니다."],
"rFL-yb": ["복사본 편집"],
"rFTdVq": ["탐색기에서 보기"],
+ "rFbQzX": ["OpenKnowledge가 계속 다시 시도하며, 파일을 읽을 수 있게 되면 바로 표시합니다."],
"rFmBG3": ["색상 테마"],
"rFskYz": [
"이 컴퓨터의 모든 프로젝트에 적용되며, 켠 뒤에 시작한 에이전트 패널의 Claude Code 및 Codex 채팅에 적용됩니다. 에이전트는 새 프로필을 쓰는 자체 Google Chrome 창에서 페이지를 열고, 클릭하고, 입력하고, 스크린샷을 찍을 수 있습니다. Google Chrome과 Node.js가 설치되어 있어야 합니다. 에이전트 자체 모드나 권한 설정이 승인을 건너뛰지 않는 한, 모든 브라우저 작업은 승인을 요청하며 항상 허용하는 선택지는 없습니다."
diff --git a/packages/app/src/locales/ko/messages.po b/packages/app/src/locales/ko/messages.po
index 0adfcaaed..507936f03 100644
--- a/packages/app/src/locales/ko/messages.po
+++ b/packages/app/src/locales/ko/messages.po
@@ -10657,6 +10657,10 @@ msgstr "OpenKnowledge는 여기 리포지토리 루트에 설정되어 있으므
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge가 이 GitHub 계정을 사용 중입니다."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge가 계속 다시 시도하며, 파일을 읽을 수 있게 되면 바로 표시합니다."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge가 이 파일을 안전하게 파싱할 수 없어 파일을 변경하지 않았습니다. 파일을 직접 수정한 뒤 다시 시도하세요."
@@ -15741,6 +15745,10 @@ msgstr "제목"
msgid "Title"
msgstr "제목"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "프로젝트 없이 AI 도구를 연결하려면 파일 > OpenKnowledge 통합 설정…을 사용하세요."
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "할 일"
@@ -17117,6 +17125,10 @@ msgstr "검색어와 일치하는 페이지의 전체 텍스트가 임베딩 제
msgid "Your share link is ready below."
msgstr "공유 링크가 아래에 준비되어 있습니다."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "사용자 설정을 읽을 수 없습니다"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Zip 파일"
diff --git a/packages/app/src/locales/pl/messages.json b/packages/app/src/locales/pl/messages.json
index 292beabc6..02aefdea2 100644
--- a/packages/app/src/locales/pl/messages.json
+++ b/packages/app/src/locales/pl/messages.json
@@ -1317,6 +1317,9 @@
],
"BQKHuL": ["Uruchom ponownie terminal"],
"BQu9Pg": ["Symlink"],
+ "BRtKwG": [
+ "Aby połączyć narzędzia AI bez projektu, użyj Plik > Konfiguruj integracje OpenKnowledge…"
+ ],
"BUyQnq": ["Nie udało się zrestartować serwera. Spróbuj `ok start` w tym folderze."],
"BVkqD9": [
"Konserwacja indeksu jest wstrzymana, ponieważ inny atrybut Git kontroluje index.md. Zaktualizuj .gitattributes, aby ścieżki index.md objęte zakresem używały merge=union, a następnie spróbuj ponownie."
@@ -2774,6 +2777,7 @@
"PWh9Ii": ["Zastosuj zmiany"],
"PWqtgd": ["Ładowanie czatu"],
"PXaT32": ["Serwer zwrócił niepełną odpowiedź dla celów umiejętności."],
+ "PXg8xK": ["Nie udało się odczytać Twoich ustawień użytkownika"],
"PYmp-0": ["Importuj jako szablon"],
"PZKdTd": ["Raport bez tytułu"],
"PZn2LP": ["Zachowaj źródło"],
@@ -6039,6 +6043,7 @@
"rENNI6": ["Nieprawidłowy adres URL udostępniania."],
"rFL-yb": ["Edytuj kopię"],
"rFTdVq": ["Pokaż w Eksploratorze"],
+ "rFbQzX": ["OpenKnowledge ponawia próby i wyświetli je, gdy tylko plik będzie można odczytać."],
"rFmBG3": ["Motyw kolorystyczny"],
"rFskYz": [
"Dotyczy wszystkich projektów na tym komputerze, w czatach Claude Code i Codex w panelu Agentów uruchomionych po włączeniu tej opcji. Agent może otwierać strony, klikać, pisać i robić zrzuty ekranu w własnym oknie Google Chrome z świeżym profilem. Wymaga zainstalowanych Google Chrome i Node.js. Każde działanie w przeglądarce pyta o Twoją zgodę, bez opcji „zawsze zezwalaj”, chyba że tryb agenta lub ustawienia uprawnień pomijają pytania."
diff --git a/packages/app/src/locales/pl/messages.po b/packages/app/src/locales/pl/messages.po
index e8ece20dc..4ca5f6f24 100644
--- a/packages/app/src/locales/pl/messages.po
+++ b/packages/app/src/locales/pl/messages.po
@@ -10657,6 +10657,10 @@ msgstr "OpenKnowledge jest tutaj skonfigurowane w katalogu głównym repozytoriu
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge korzysta z tego konta GitHub."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge ponawia próby i wyświetli je, gdy tylko plik będzie można odczytać."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge zostawiło ten plik w spokoju, ponieważ nie udało się go bezpiecznie przeanalizować. Napraw plik ręcznie, a następnie spróbuj ponownie."
@@ -15741,6 +15745,10 @@ msgstr "tytuł"
msgid "Title"
msgstr "Tytuł"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "Aby połączyć narzędzia AI bez projektu, użyj Plik > Konfiguruj integracje OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "Do zrobienia"
@@ -17117,6 +17125,10 @@ msgstr "Twoje zapytania wyszukiwania i pełny tekst pasujących stron są wysył
msgid "Your share link is ready below."
msgstr "Twój link do udostępnienia jest gotowy poniżej."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "Nie udało się odczytać Twoich ustawień użytkownika"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Plik ZIP"
diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.json
index b4440505f..0f819d4a2 100644
--- a/packages/app/src/locales/pseudo/messages.json
+++ b/packages/app/src/locales/pseudo/messages.json
@@ -1103,6 +1103,9 @@
],
"BQKHuL": ["Ŕēśţàŕţ ţēŕḿĩńàĺ"],
"BQu9Pg": ["Śŷḿĺĩńķ"],
+ "BRtKwG": [
+ "Ţō ćōńńēćţ ÀĨ ţōōĺś ŵĩţĥōũţ à ƥŕōĴēćţ, ũśē Ƒĩĺē > Śēţ ũƥ ŌƥēńĶńōŵĺēďĝē ĩńţēĝŕàţĩōńś…"
+ ],
"BUyQnq": ["Ćōũĺďń'ţ ŕēśţàŕţ ţĥē śēŕvēŕ. Ţŕŷ `ōķ śţàŕţ` ĩń ţĥĩś ƒōĺďēŕ."],
"BVkqD9": [
"Ĩńďēx ḿàĩńţēńàńćē ĩś ƥàũśēď ƀēćàũśē àńōţĥēŕ Ĝĩţ àţţŕĩƀũţē ćōńţŕōĺś ĩńďēx.ḿď. Ũƥďàţē .ĝĩţàţţŕĩƀũţēś śō ţĥē śćōƥēď ĩńďēx.ḿď ƥàţĥś ũśē ḿēŕĝē=ũńĩōń, ţĥēń ţŕŷ àĝàĩń."
@@ -2369,6 +2372,7 @@
"PWh9Ii": ["Àƥƥĺŷ ćĥàńĝēś"],
"PWqtgd": ["Ĺōàďĩńĝ ţĥē ćĥàţ"],
"PXaT32": ["Śēŕvēŕ ŕēţũŕńēď àń ĩńćōḿƥĺēţē śķĩĺĺ-ţàŕĝēţś ŕēśƥōńśē."],
+ "PXg8xK": ["Ŷōũŕ ũśēŕ śēţţĩńĝś ćōũĺď ńōţ ƀē ŕēàď"],
"PYmp-0": ["Ĩḿƥōŕţ àś ţēḿƥĺàţē"],
"PZKdTd": ["Ũńţĩţĺēď ŕēƥōŕţ"],
"PZn2LP": ["Ķēēƥ śōũŕćē"],
@@ -5117,6 +5121,7 @@
"rENNI6": ["Ĩńvàĺĩď śĥàŕē ŨŔĹ."],
"rFL-yb": ["Ēďĩţ à ćōƥŷ"],
"rFTdVq": ["Śĥōŵ ĩń Ēxƥĺōŕēŕ"],
+ "rFbQzX": ["ŌƥēńĶńōŵĺēďĝē ķēēƥś ŕēţŕŷĩńĝ àńď śĥōŵś ţĥēḿ àś śōōń àś ţĥē ƒĩĺē ćàń ƀē ŕēàď."],
"rFmBG3": ["Ćōĺōŕ ţĥēḿē"],
"rFskYz": [
"Àƥƥĺĩēś ţō àĺĺ ƥŕōĴēćţś ōń ţĥĩś ḿàćĥĩńē, ĩń Ćĺàũďē Ćōďē àńď Ćōďēx ćĥàţś ĩń ţĥē Àĝēńţś ƥàńēĺ śţàŕţēď àƒţēŕ ŷōũ ţũŕń ĩţ ōń. Ţĥē àĝēńţ ćàń ōƥēń ƥàĝēś, ćĺĩćķ, ţŷƥē, àńď ţàķē śćŕēēńśĥōţś ĩń ĩţś ōŵń Ĝōōĝĺē Ćĥŕōḿē ŵĩńďōŵ ŵĩţĥ à ƒŕēśĥ ƥŕōƒĩĺē. Ńēēďś Ĝōōĝĺē Ćĥŕōḿē àńď Ńōďē.Ĵś ĩńśţàĺĺēď. Ēvēŕŷ ƀŕōŵśēŕ àćţĩōń àśķś ƒōŕ ŷōũŕ àƥƥŕōvàĺ, ŵĩţĥ ńō ōƥţĩōń ţō àĺŵàŷś àĺĺōŵ ĩţ, ũńĺēśś ţĥē àĝēńţ'ś ōŵń ḿōďē ōŕ ƥēŕḿĩśśĩōń śēţţĩńĝś śķĩƥ àƥƥŕōvàĺś."
diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.po
index c071c9db8..fc8254476 100644
--- a/packages/app/src/locales/pseudo/messages.po
+++ b/packages/app/src/locales/pseudo/messages.po
@@ -10653,6 +10653,10 @@ msgstr ""
msgid "OpenKnowledge is using this GitHub account."
msgstr ""
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr ""
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr ""
@@ -15737,6 +15741,10 @@ msgstr ""
msgid "Title"
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr ""
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr ""
@@ -17113,6 +17121,10 @@ msgstr ""
msgid "Your share link is ready below."
msgstr ""
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr ""
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr ""
diff --git a/packages/app/src/locales/pt-BR/messages.json b/packages/app/src/locales/pt-BR/messages.json
index 138fef9c3..f7232b6a2 100644
--- a/packages/app/src/locales/pt-BR/messages.json
+++ b/packages/app/src/locales/pt-BR/messages.json
@@ -1266,6 +1266,9 @@
],
"BQKHuL": ["Reiniciar o terminal"],
"BQu9Pg": ["Link simbólico"],
+ "BRtKwG": [
+ "Para conectar ferramentas de IA sem um projeto, use Arquivo > Configurar as integrações do OpenKnowledge…"
+ ],
"BUyQnq": ["Não deu para reiniciar o servidor. Tente `ok start` nesta pasta."],
"BVkqD9": [
"A manutenção do índice está pausada porque outro atributo Git controla index.md. Atualize .gitattributes para que os caminhos index.md com escopo usem merge=union e tente novamente."
@@ -2687,6 +2690,7 @@
"PWh9Ii": ["Aplicar alterações"],
"PWqtgd": ["Carregando o chat"],
"PXaT32": ["O servidor retornou uma resposta de destinos de habilidades incompleta."],
+ "PXg8xK": ["Não foi possível ler suas configurações de usuário"],
"PYmp-0": ["Importar como modelo"],
"PZKdTd": ["Relatório sem título"],
"PZn2LP": ["Manter a fonte"],
@@ -5782,6 +5786,9 @@
"rENNI6": ["URL de compartilhamento inválida."],
"rFL-yb": ["Editar uma cópia"],
"rFTdVq": ["Mostrar no Explorador"],
+ "rFbQzX": [
+ "O OpenKnowledge continua tentando e vai mostrá-las assim que o arquivo puder ser lido."
+ ],
"rFmBG3": ["Tema de cores"],
"rFskYz": [
"Vale para todos os projetos desta máquina, nos chats do Claude Code e do Codex no painel de agentes iniciados depois que você ativar. O agente pode abrir páginas, clicar, digitar e fazer capturas de tela na própria janela do Google Chrome, com um perfil novo. Requer o Google Chrome e o Node.js instalados. Cada ação do navegador pede sua aprovação, sem opção de permitir sempre, a menos que o próprio modo do agente ou as configurações de permissão dele pulem as aprovações."
diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.po
index 6e4562811..db9b9f685 100644
--- a/packages/app/src/locales/pt-BR/messages.po
+++ b/packages/app/src/locales/pt-BR/messages.po
@@ -10653,6 +10653,10 @@ msgstr "Aqui o OpenKnowledge é configurado na raiz do repositório, então o pa
msgid "OpenKnowledge is using this GitHub account."
msgstr "O OpenKnowledge está usando esta conta do GitHub."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "O OpenKnowledge continua tentando e vai mostrá-las assim que o arquivo puder ser lido."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "O OpenKnowledge não alterou este arquivo porque não conseguiu analisá-lo com segurança. Corrija o arquivo manualmente e tente novamente."
@@ -15737,6 +15741,10 @@ msgstr "título"
msgid "Title"
msgstr "Título"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "Para conectar ferramentas de IA sem um projeto, use Arquivo > Configurar as integrações do OpenKnowledge…"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "A fazer"
@@ -17113,6 +17121,10 @@ msgstr "Suas consultas de busca e o texto completo das páginas correspondentes
msgid "Your share link is ready below."
msgstr "Seu link de compartilhamento está pronto abaixo."
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "Não foi possível ler suas configurações de usuário"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Arquivo zip"
diff --git a/packages/app/src/locales/ur/messages.json b/packages/app/src/locales/ur/messages.json
index 80f84bd76..5bed1b6b8 100644
--- a/packages/app/src/locales/ur/messages.json
+++ b/packages/app/src/locales/ur/messages.json
@@ -1110,6 +1110,9 @@
],
"BQKHuL": ["ٹرمینل دوبارہ چلائیں"],
"BQu9Pg": ["سِم لنک"],
+ "BRtKwG": [
+ "کسی پروجیکٹ کے بغیر AI ٹولز جوڑنے کے لیے، فائل > OpenKnowledge کے انضمامات ترتیب دیں… استعمال کریں۔"
+ ],
"BUyQnq": ["سرور دوبارہ نہیں چل سکا۔ اس فولڈر میں `ok start` آزمائیں۔"],
"BVkqD9": [
"انڈیکس کی دیکھ بھال موقوف ہے کیونکہ ایک اور Git وصف کنٹرول کرتا ہے index.md۔ .gitattributes کو اپ ڈیٹ کریں تاکہ دائرہ کار والے index.md راستے merge=union استعمال کریں، پھر دوبارہ کوشش کریں۔"
@@ -2409,6 +2412,7 @@
"PWh9Ii": ["تبدیلیاں لاگو کریں"],
"PWqtgd": ["چیٹ لوڈ ہو رہی ہے"],
"PXaT32": ["سرور نے نامکمل اسکل ٹارگٹس جواب لوٹایا۔"],
+ "PXg8xK": ["آپ کی صارف ترتیبات پڑھی نہیں جا سکیں"],
"PYmp-0": ["ٹیمپلیٹ کے طور پر درآمد کریں"],
"PZKdTd": ["بلا عنوان رپورٹ"],
"PZn2LP": ["ماخذ رکھیں"],
@@ -5192,6 +5196,9 @@
"rENNI6": ["شیئر URL درست نہیں۔"],
"rFL-yb": ["ایک نقل میں ترمیم کریں"],
"rFTdVq": ["ایکسپلورر میں دکھائیں"],
+ "rFbQzX": [
+ "OpenKnowledge دوبارہ کوشش کرتا رہتا ہے اور فائل پڑھنے کے قابل ہوتے ہی انہیں دکھا دے گا۔"
+ ],
"rFmBG3": ["رنگ تھیم"],
"rFskYz": [
"اس مشین کے تمام پروجیکٹس پر لاگو ہوتا ہے، ایجنٹ پینل کی ان Claude Code اور Codex چیٹس میں جو اسے آن کرنے کے بعد شروع ہوں۔ ایجنٹ نئی پروفائل والی اپنی Google Chrome ونڈو میں صفحات کھول، کلک کر، ٹائپ کر اور اسکرین شاٹ لے سکتا ہے۔ Google Chrome اور Node.js انسٹال ہونا ضروری ہے۔ براؤزر کی ہر کارروائی آپ کی منظوری مانگتی ہے، ہمیشہ اجازت دینے کے کسی اختیار کے بغیر، جب تک ایجنٹ کا اپنا موڈ یا اس کی اجازت کی ترتیبات منظوری کو نظرانداز نہ کریں۔"
diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.po
index 0ec3e8341..fbf578cbe 100644
--- a/packages/app/src/locales/ur/messages.po
+++ b/packages/app/src/locales/ur/messages.po
@@ -10657,6 +10657,10 @@ msgstr "یہاں OpenKnowledge ریپوزٹری کی جڑ میں سیٹ ہوتا
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge یہی GitHub اکاؤنٹ استعمال کر رہا ہے۔"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge دوبارہ کوشش کرتا رہتا ہے اور فائل پڑھنے کے قابل ہوتے ہی انہیں دکھا دے گا۔"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge نے اس فائل کو تبدیل نہیں کیا کیونکہ وہ اسے محفوظ طریقے سے پارس نہیں کر سکا۔ فائل کو خود درست کریں، پھر دوبارہ کوشش کریں۔"
@@ -15741,6 +15745,10 @@ msgstr "عنوان"
msgid "Title"
msgstr "عنوان"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "کسی پروجیکٹ کے بغیر AI ٹولز جوڑنے کے لیے، فائل > OpenKnowledge کے انضمامات ترتیب دیں… استعمال کریں۔"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "کرنا ہے"
@@ -17117,6 +17125,10 @@ msgstr "آپ کے تلاش استفسارات اور مماثل صفحات کا
msgid "Your share link is ready below."
msgstr "آپ کا شیئر لنک نیچے تیار ہے۔"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "آپ کی صارف ترتیبات پڑھی نہیں جا سکیں"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "Zip فائل"
diff --git a/packages/app/src/locales/zh-Hans/messages.json b/packages/app/src/locales/zh-Hans/messages.json
index 136789e65..2f1d3babe 100644
--- a/packages/app/src/locales/zh-Hans/messages.json
+++ b/packages/app/src/locales/zh-Hans/messages.json
@@ -960,6 +960,7 @@
],
"BQKHuL": ["重启终端"],
"BQu9Pg": ["符号链接"],
+ "BRtKwG": ["若要在没有项目的情况下连接 AI 工具,请使用“文件 > 设置 OpenKnowledge 集成…”。"],
"BUyQnq": ["无法重启服务器。请在这个文件夹中尝试 `ok start`。"],
"BVkqD9": [
"索引维护已暂停,因为另一个 Git 属性控制 index.md。更新 .gitattributes 以便作用域 index.md 路径使用 merge=union,然后重试。"
@@ -2065,6 +2066,7 @@
"PWh9Ii": ["应用更改"],
"PWqtgd": ["正在加载对话"],
"PXaT32": ["服务器返回的技能目标响应不完整。"],
+ "PXg8xK": ["无法读取你的用户设置"],
"PYmp-0": ["作为模板导入"],
"PZKdTd": ["未命名报告"],
"PZn2LP": ["保留来源"],
@@ -4445,6 +4447,7 @@
"rENNI6": ["共享链接无效。"],
"rFL-yb": ["编辑一份副本"],
"rFTdVq": ["在资源管理器中显示"],
+ "rFbQzX": ["OpenKnowledge 会持续重试,并在文件可以读取后立即显示这些设置。"],
"rFmBG3": ["配色主题"],
"rFskYz": [
"适用于本机上的所有项目,作用于开启后新建的智能体面板中的 Claude Code 和 Codex 对话。智能体可以在它自己的 Google Chrome 窗口中(使用全新的配置文件)打开页面、点击、输入和截图。需要已安装 Google Chrome 和 Node.js。除非智能体自身的模式或权限设置跳过了批准,否则每个浏览器操作都会请求你的批准,且没有“始终允许”的选项。"
diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.po
index 2f2b09206..56c656082 100644
--- a/packages/app/src/locales/zh-Hans/messages.po
+++ b/packages/app/src/locales/zh-Hans/messages.po
@@ -10657,6 +10657,10 @@ msgstr "这里的 OpenKnowledge 设置在仓库根目录,因此入门包会放
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge 正在使用这个 GitHub 账户。"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge 会持续重试,并在文件可以读取后立即显示这些设置。"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge 未修改此文件,因为无法安全地解析它。请手动修复该文件,然后重试。"
@@ -15741,6 +15745,10 @@ msgstr "标题"
msgid "Title"
msgstr "标题"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "若要在没有项目的情况下连接 AI 工具,请使用“文件 > 设置 OpenKnowledge 集成…”。"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "待办"
@@ -17117,6 +17125,10 @@ msgstr "你的搜索查询和匹配页面的全文会发送到你的嵌入服务
msgid "Your share link is ready below."
msgstr "你的共享链接已在下方生成。"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "无法读取你的用户设置"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "zip 文件"
diff --git a/packages/app/src/locales/zh-Hant/messages.json b/packages/app/src/locales/zh-Hant/messages.json
index 8ec216e76..662f8e33d 100644
--- a/packages/app/src/locales/zh-Hant/messages.json
+++ b/packages/app/src/locales/zh-Hant/messages.json
@@ -962,6 +962,7 @@
],
"BQKHuL": ["重新啟動終端機"],
"BQu9Pg": ["符號連結"],
+ "BRtKwG": ["若要在沒有專案的情況下連接 AI 工具,請使用「檔案 > 設定 OpenKnowledge 整合…」。"],
"BUyQnq": ["無法重新啟動伺服器。請在這個資料夾中試試 `ok start`。"],
"BVkqD9": [
"索引維護已暫停,因為另一個 Git 屬性控制 index.md。更新 .gitattributes 以便作用域 index.md 路徑使用 merge=union,然後重試。"
@@ -2087,6 +2088,7 @@
"PWh9Ii": ["套用變更"],
"PWqtgd": ["正在載入對話"],
"PXaT32": ["伺服器回傳的技能目標回應不完整。"],
+ "PXg8xK": ["無法讀取你的使用者設定"],
"PYmp-0": ["當成範本匯入"],
"PZKdTd": ["未命名回報"],
"PZn2LP": ["保留來源"],
@@ -4467,6 +4469,7 @@
"rENNI6": ["分享網址無效。"],
"rFL-yb": ["編輯一份副本"],
"rFTdVq": ["在檔案總管中顯示"],
+ "rFbQzX": ["OpenKnowledge 會持續重試,並在檔案可以讀取後立即顯示這些設定。"],
"rFmBG3": ["配色主題"],
"rFskYz": [
"適用於本機上的所有專案,作用於開啟後新建的代理面板中的 Claude Code 和 Codex 對話。代理可以在它自己的 Google Chrome 視窗中(使用全新的設定檔)開啟頁面、點按、輸入和擷取螢幕畫面。需要已安裝 Google Chrome 和 Node.js。除非代理本身的模式或權限設定略過了核准,否則每個瀏覽器操作都會請求你的核准,且沒有「一律允許」的選項。"
diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.po
index e9a8925ae..5a2251960 100644
--- a/packages/app/src/locales/zh-Hant/messages.po
+++ b/packages/app/src/locales/zh-Hant/messages.po
@@ -10657,6 +10657,10 @@ msgstr "這裡的 OpenKnowledge 設定在存放庫根目錄,因此入門套件
msgid "OpenKnowledge is using this GitHub account."
msgstr "OpenKnowledge 正在使用這個 GitHub 帳戶。"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "OpenKnowledge keeps retrying and shows them as soon as the file can be read."
+msgstr "OpenKnowledge 會持續重試,並在檔案可以讀取後立即顯示這些設定。"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge left this file alone because it could not parse it safely. Fix the file by hand, then try again."
msgstr "OpenKnowledge 未修改此檔案,因為無法安全地解析它。請手動修正該檔案,然後再試一次。"
@@ -15741,6 +15745,10 @@ msgstr "標題"
msgid "Title"
msgstr "標題"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "To connect AI tools without a project, use File > Set up OpenKnowledge integrations…"
+msgstr "若要在沒有專案的情況下連接 AI 工具,請使用「檔案 > 設定 OpenKnowledge 整合…」。"
+
#: src/editor/slash-command/items.tsx
msgid "To do"
msgstr "待辦"
@@ -17117,6 +17125,10 @@ msgstr "你的搜尋查詢和相符頁面的全文會送到你的嵌入服務供
msgid "Your share link is ready below."
msgstr "你的分享連結已經在下面產生好了。"
+#: src/components/settings/SettingsDialogBody.tsx
+msgid "Your user settings could not be read"
+msgstr "無法讀取你的使用者設定"
+
#: src/components/ImportSkillForm.tsx
msgid "Zip file"
msgstr "zip 檔案"
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/origin-undoability-sweep.uncached.test.ts b/packages/app/tests/integration/origin-undoability-sweep.uncached.test.ts
index 11de8d964..ad308a515 100644
--- a/packages/app/tests/integration/origin-undoability-sweep.uncached.test.ts
+++ b/packages/app/tests/integration/origin-undoability-sweep.uncached.test.ts
@@ -122,6 +122,8 @@ const NON_CONTENT_ORIGINS: Record<string, string> = {
'Config-doc plane revert to last-known-good; markdown bridge bypassed, not content.',
CONFIG_FILE_WATCHER_ORIGIN:
'Config-doc plane file-watcher intake; markdown bridge bypassed, not content.',
+ IPC_USER_CONFIG_FILE_ORIGIN:
+ 'Navigator user-config plane adopting file text returned by desktop main; config doc only, markdown bridge bypassed, not content.',
PARK_SNAPSHOT_ORIGIN:
'Read-only serializeDoc wrapper; paired only so observers self-short-circuit, performs no content mutation.',
ORIGIN_TREE_TO_TEXT:
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/desktop-bridge.ts b/packages/core/src/desktop-bridge.ts
index 1790003b5..419888cae 100644
--- a/packages/core/src/desktop-bridge.ts
+++ b/packages/core/src/desktop-bridge.ts
@@ -1,6 +1,8 @@
import type { ApplyReport } from './agent-registry/apply.ts';
import type { HandoffHostPlatform } from './agent-registry/schema.ts';
import type { HostSnapshot } from './agent-registry/snapshot.ts';
+import type { ConfigValidationError } from './config/errors.ts';
+import type { ConfigPatch } from './config/schema.ts';
import type { CreateNewBannerKind } from './constants/create-new-banner.ts';
import type { EditorId } from './constants/editors.ts';
import type { OkFolderState } from './constants/folder-state.ts';
@@ -325,6 +327,20 @@ export type OkUpdateChannel = 'latest' | 'beta';
export type OkThemeSource = 'system' | 'light' | 'dark';
+export interface OkUserConfigSnapshot {
+ readonly text: string;
+}
+
+export type OkUserConfigPatchResult =
+ | { readonly ok: true; readonly text: string }
+ | { readonly ok: false; readonly error: ConfigValidationError };
+
+export interface OkUserConfigBridge {
+ read(): Promise<OkUserConfigSnapshot>;
+ patch(patch: ConfigPatch): Promise<OkUserConfigPatchResult>;
+ onChanged(cb: (snapshot: OkUserConfigSnapshot) => void): OkUnsubscribe;
+}
+
export interface OkChromeColors {
bg: string;
symbol: string;
@@ -1099,6 +1115,8 @@ export interface OkDesktopBridge {
setLanguagePreference(preference: LanguagePreference): Promise<{ ok: true }>;
+ userConfig?: OkUserConfigBridge;
+
signalThemeApplied(opts?: { reducedTransparency?: boolean; chrome?: OkChromeColors }): void;
dialog: {
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/desktop/src/main/index.ts b/packages/desktop/src/main/index.ts
index 9667bb4ff..153eaad1d 100644
--- a/packages/desktop/src/main/index.ts
+++ b/packages/desktop/src/main/index.ts
@@ -443,6 +443,7 @@ import { attachServerExitObserver } from './server-exit-observer.ts';
import { createServerExitRecorder, type ServerExitRecorder } from './server-exit-record.ts';
import { breakServerLockHeldBy } from './server-lock-break.ts';
import {
+ deliverNavigatorSettings,
openSettingsSurface,
resolveSettingsWindowKind,
type SettingsSurfaceOptions,
@@ -556,6 +557,7 @@ import {
type ShareDeepLinkBranchSwitchPayload,
type ShareNavigatorPayload,
} from './url-scheme.ts';
+import { createUserConfigDispatch, createUserConfigStore } from './user-config-ipc.ts';
import { migrateLegacyUserDataDir } from './userdata-migration.ts';
import { buildUtilityForkEnv } from './utility-fork-env.ts';
import { computeFirstLaunchAfterUpgrade } from './version-drift.ts';
@@ -2499,12 +2501,11 @@ async function runApplicationMenuRefresh(): Promise<void> {
openExternalUrl: (url: string) => {
void shell.openExternal(url);
},
- reconfigureMcpWiring:
- app.isPackaged && supportedPackagedInstall()
- ? () => {
- reconfigureMcpWiringNow(pickLoadedRendererForMcpDialog());
- }
- : undefined,
+ reconfigureMcpWiring: canReconfigureMcpWiring()
+ ? () => {
+ reconfigureMcpWiringNow(pickLoadedRendererForMcpDialog());
+ }
+ : undefined,
openInstallSkillDialog: () => {
const target = BrowserWindow.getFocusedWindow() ?? BrowserWindow.getAllWindows()[0];
if (!target) return;
@@ -2573,6 +2574,10 @@ function supportedPackagedInstall(): boolean {
return isSupportedInstallShape(process.platform, app.getPath('exe'), process.env);
}
+function canReconfigureMcpWiring(): boolean {
+ return app.isPackaged && supportedPackagedInstall();
+}
+
function desktopSelfUninstallAvailable(): boolean {
if (process.platform !== 'darwin' || !app.isPackaged) return false;
const appBundlePath = resolveAppBundleFromExecPath(process.execPath, process.platform);
@@ -3602,29 +3607,16 @@ function openSettings(
getLogger('settings').warn({ err }, 'failed to open editor settings');
});
},
- showNavigator: (win) => {
- if (win?.isMinimized()) win.restore();
- win?.focus();
- if (!(app.isPackaged && supportedPackagedInstall())) {
- getLogger('settings').warn(
- { packaged: app.isPackaged, supported: supportedPackagedInstall() },
- 'navigator settings unavailable on this install',
- );
- const options: MessageBoxOptions = {
- type: 'info',
- buttons: ['OK'],
- defaultId: 0,
- cancelId: 0,
- title: 'Settings unavailable',
- message:
- 'Settings from the navigator is unavailable in this build. Open Settings from a project window instead.',
- };
- void (win ? dialog.showMessageBox(win, options) : dialog.showMessageBox(options));
- return false;
- }
- return reconfigureMcpWiringNow(
- win && !win.webContents.isLoading() ? win.webContents : undefined,
- );
+ showNavigatorSettings: (win) => {
+ const created = win === null && navigatorWindow === null;
+ if (win === null) openNavigator();
+ const target = win ?? (navigatorWindow as unknown as BrowserWindow | null);
+ if (!target || target.isDestroyed()) return;
+ deliverNavigatorSettings(target, {
+ awaitLoad: created,
+ onError: (err) =>
+ getLogger('settings').warn({ err }, 'failed to open navigator settings'),
+ });
},
openNavigator,
onEditorRequired: (win) => {
@@ -3647,7 +3639,7 @@ function openSettings(
}
function reconfigureMcpWiringNow(target: McpWiringDispatchTarget | undefined): boolean {
- if (!(app.isPackaged && supportedPackagedInstall())) return false;
+ if (!canReconfigureMcpWiring()) return false;
mcpWiringHandle?.destroy();
mcpWiringHandle = null;
try {
@@ -4501,13 +4493,16 @@ function registerIpcHandlers() {
return result;
});
- handle('ok:locale:set-preference', async (_event, { preference }) => {
- pushedLanguagePreference = preference;
- menuTranslator = null;
- getLogger('menu-locale').info({ preference }, 'language preference pushed; rebuilding menu');
- refreshApplicationMenu();
- return { ok: true };
+ const userConfigDispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: osHomedir() }),
+ setLanguagePreference: (preference) => {
+ pushedLanguagePreference = preference;
+ menuTranslator = null;
+ getLogger('menu-locale').info({ preference }, 'language preference pushed; rebuilding menu');
+ refreshApplicationMenu();
+ },
});
+ handle('ok:user-config:dispatch', (event, request) => userConfigDispatch(event.sender, request));
handle('ok:theme:set-source', async (event, { source }) => {
return applyThemeSource(
@@ -4551,7 +4546,7 @@ function registerIpcHandlers() {
spellCheckEnabled: appState.spellCheckEnabled,
showDevToolsMenu: !app.isPackaged || DESKTOP_VARIANT.name !== 'stable',
canCheckForUpdates: autoUpdaterHandle != null,
- canReconfigureMcpWiring: app.isPackaged && supportedPackagedInstall(),
+ canReconfigureMcpWiring: canReconfigureMcpWiring(),
activeTarget: currentActiveTarget(),
viewMenuState: (() => {
const win = BrowserWindow.fromWebContents(event.sender);
diff --git a/packages/desktop/src/main/settings-surface.test.ts b/packages/desktop/src/main/settings-surface.test.ts
index d37b2eeda..536a530fd 100644
--- a/packages/desktop/src/main/settings-surface.test.ts
+++ b/packages/desktop/src/main/settings-surface.test.ts
@@ -1,6 +1,7 @@
import { describe, expect, test, vi } from 'vitest';
import {
+ deliverNavigatorSettings,
openSettingsSurface,
resolveSettingsSurface,
resolveSettingsWindowKind,
@@ -176,19 +177,19 @@ describe('openSettingsSurface', () => {
return {
...depsFor(focused, all),
showEditor: vi.fn(),
- showNavigator: vi.fn(() => true),
+ showNavigatorSettings: vi.fn(),
openNavigator: vi.fn(),
onEditorRequired: vi.fn(),
};
}
- test('opens customization in the focused navigator while a project is open', () => {
+ test('opens navigator settings in the focused navigator while a project is open', () => {
const navigator = win(1, 'navigator');
const deps = harness(navigator, [win(2, 'editor'), navigator]);
openSettingsSurface(null, deps);
- expect(deps.showNavigator).toHaveBeenCalledExactlyOnceWith(navigator);
+ expect(deps.showNavigatorSettings).toHaveBeenCalledExactlyOnceWith(navigator);
expect(deps.showEditor).not.toHaveBeenCalled();
expect(deps.openNavigator).not.toHaveBeenCalled();
});
@@ -201,29 +202,25 @@ describe('openSettingsSurface', () => {
openSettingsSurface(editor, deps);
expect(deps.showEditor).toHaveBeenCalledExactlyOnceWith(editor, undefined);
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
});
- test('arms customization before creating the first navigator', () => {
+ test('with no window open, asks for navigator settings in a new navigator', () => {
const deps = harness(null, []);
- deps.openNavigator.mockImplementation(() => {
- expect(deps.showNavigator).toHaveBeenCalledExactlyOnceWith(null);
- });
openSettingsSurface(null, deps);
- expect(deps.openNavigator).toHaveBeenCalledOnce();
+ expect(deps.showNavigatorSettings).toHaveBeenCalledExactlyOnceWith(null);
expect(deps.showEditor).not.toHaveBeenCalled();
});
- test('a terminal-only session creates a navigator to host customization', () => {
+ test('a terminal-only session opens navigator settings in a new navigator', () => {
const terminal = win(1, 'terminal');
const deps = harness(terminal, [terminal]);
openSettingsSurface(terminal, deps);
- expect(deps.showNavigator).toHaveBeenCalledExactlyOnceWith(null);
- expect(deps.openNavigator).toHaveBeenCalledOnce();
+ expect(deps.showNavigatorSettings).toHaveBeenCalledExactlyOnceWith(null);
});
test('account settings target an editor even when the navigator is focused', () => {
@@ -234,7 +231,7 @@ describe('openSettingsSurface', () => {
openSettingsSurface(navigator, deps, { editorOnly: true, section: 'account' });
expect(deps.showEditor).toHaveBeenCalledExactlyOnceWith(editor, 'account');
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
});
test('account settings without an editor open the project picker', () => {
@@ -244,7 +241,7 @@ describe('openSettingsSurface', () => {
expect(deps.openNavigator).toHaveBeenCalledOnce();
expect(deps.showEditor).not.toHaveBeenCalled();
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
expect(deps.onEditorRequired).toHaveBeenCalledExactlyOnceWith(null);
});
@@ -258,21 +255,11 @@ describe('openSettingsSurface', () => {
expect(deps.openNavigator).toHaveBeenCalledOnce();
expect(deps.onEditorRequired).toHaveBeenCalledExactlyOnceWith(focused);
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
expect(deps.showEditor).not.toHaveBeenCalled();
},
);
- test('does not create an empty navigator when customization cannot be armed', () => {
- const deps = harness(null, []);
- deps.showNavigator.mockReturnValue(false);
-
- openSettingsSurface(null, deps);
-
- expect(deps.showNavigator).toHaveBeenCalledExactlyOnceWith(null);
- expect(deps.openNavigator).not.toHaveBeenCalled();
- });
-
test.each([null, win(1, 'navigator'), win(2, 'terminal')] as const)(
'a deep link with %j focused opens the navigator without forcing consent',
(focused) => {
@@ -281,7 +268,7 @@ describe('openSettingsSurface', () => {
openSettingsSurface(focused, deps, { origin: 'deep-link' });
expect(deps.openNavigator).toHaveBeenCalledOnce();
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
expect(deps.onEditorRequired).not.toHaveBeenCalled();
},
);
@@ -293,11 +280,79 @@ describe('openSettingsSurface', () => {
openSettingsSurface(editor, deps, { origin: 'deep-link' });
expect(deps.showEditor).toHaveBeenCalledExactlyOnceWith(editor, undefined);
- expect(deps.showNavigator).not.toHaveBeenCalled();
+ expect(deps.showNavigatorSettings).not.toHaveBeenCalled();
expect(deps.openNavigator).not.toHaveBeenCalled();
});
});
+function navigatorWindow(opts: { loading?: boolean; minimized?: boolean } = {}) {
+ let loadListener: (() => void) | null = null;
+ const executeJavaScript = vi.fn(async (_code: string) => undefined);
+ const target = {
+ isMinimized: vi.fn(() => opts.minimized === true),
+ restore: vi.fn(),
+ focus: vi.fn(),
+ webContents: {
+ isLoading: () => opts.loading === true,
+ once: vi.fn((_event: 'did-finish-load', listener: () => void) => {
+ loadListener = listener;
+ }),
+ executeJavaScript,
+ },
+ };
+ return { target, executeJavaScript, finishLoad: () => loadListener?.() };
+}
+
+describe('deliverNavigatorSettings', () => {
+ test('a loaded navigator is focused and routed to settings at once', () => {
+ const nav = navigatorWindow();
+
+ deliverNavigatorSettings(nav.target, { onError: () => {} });
+
+ expect(nav.target.focus).toHaveBeenCalledOnce();
+ expect(nav.executeJavaScript).toHaveBeenCalledExactlyOnceWith(settingsHashScript());
+ });
+
+ test('a minimized navigator is restored first', () => {
+ const nav = navigatorWindow({ minimized: true });
+
+ deliverNavigatorSettings(nav.target, { onError: () => {} });
+
+ expect(nav.target.restore).toHaveBeenCalledOnce();
+ });
+
+ test('a navigator that is still loading is routed once it finishes loading', () => {
+ const nav = navigatorWindow({ loading: true });
+
+ deliverNavigatorSettings(nav.target, { onError: () => {} });
+ expect(nav.executeJavaScript).not.toHaveBeenCalled();
+
+ nav.finishLoad();
+ expect(nav.executeJavaScript).toHaveBeenCalledExactlyOnceWith(settingsHashScript());
+ });
+
+ test('a freshly created navigator waits for its first load even before it reports loading', () => {
+ const nav = navigatorWindow({ loading: false });
+
+ deliverNavigatorSettings(nav.target, { onError: () => {}, awaitLoad: true });
+ expect(nav.executeJavaScript).not.toHaveBeenCalled();
+
+ nav.finishLoad();
+ expect(nav.executeJavaScript).toHaveBeenCalledOnce();
+ });
+
+ test('a failed route is reported', async () => {
+ const nav = navigatorWindow();
+ const err = new Error('renderer gone');
+ nav.executeJavaScript.mockRejectedValueOnce(err);
+ const onError = vi.fn();
+
+ deliverNavigatorSettings(nav.target, { onError });
+
+ await vi.waitFor(() => expect(onError).toHaveBeenCalledWith(err));
+ });
+});
+
describe('settingsHash', () => {
test('defaults to the bare settings hash', () => {
expect(settingsHash()).toBe('#settings');
diff --git a/packages/desktop/src/main/settings-surface.ts b/packages/desktop/src/main/settings-surface.ts
index ef2cf2e23..f3f29a840 100644
--- a/packages/desktop/src/main/settings-surface.ts
+++ b/packages/desktop/src/main/settings-surface.ts
@@ -31,7 +31,7 @@ export type SettingsSurfaceOptions =
export interface OpenSettingsSurfaceDeps<TWindow> extends SettingsSurfaceDeps<TWindow> {
showEditor: (win: TWindow, section?: SettingsSection) => void;
- showNavigator: (win: TWindow | null) => boolean;
+ showNavigatorSettings: (win: TWindow | null) => void;
openNavigator: () => void;
onEditorRequired: (win: TWindow | null) => void;
}
@@ -79,12 +79,39 @@ export function openSettingsSurface<TWindow>(
} else if (options.origin === 'deep-link') {
deps.openNavigator();
} else if (target.kind === 'navigator') {
- deps.showNavigator(target.window);
+ deps.showNavigatorSettings(target.window);
} else if (options.editorOnly) {
deps.openNavigator();
deps.onEditorRequired(explicit ?? deps.getFocusedWindow());
- } else if (deps.showNavigator(null)) {
- deps.openNavigator();
+ } else {
+ deps.showNavigatorSettings(null);
+ }
+}
+
+export interface NavigatorSettingsWindow {
+ isMinimized(): boolean;
+ restore(): void;
+ focus(): void;
+ webContents: {
+ isLoading(): boolean;
+ once(event: 'did-finish-load', listener: () => void): void;
+ executeJavaScript(code: string): Promise<unknown>;
+ };
+}
+
+export function deliverNavigatorSettings(
+ win: NavigatorSettingsWindow,
+ opts: { onError: (err: unknown) => void; awaitLoad?: boolean },
+): void {
+ if (win.isMinimized()) win.restore();
+ win.focus();
+ const route = () => {
+ win.webContents.executeJavaScript(settingsHashScript()).catch(opts.onError);
+ };
+ if (opts.awaitLoad === true || win.webContents.isLoading()) {
+ win.webContents.once('did-finish-load', route);
+ } else {
+ route();
}
}
diff --git a/packages/desktop/src/main/user-config-ipc.test.ts b/packages/desktop/src/main/user-config-ipc.test.ts
new file mode 100644
index 000000000..0873b47bb
--- /dev/null
+++ b/packages/desktop/src/main/user-config-ipc.test.ts
@@ -0,0 +1,305 @@
+import {
+ existsSync,
+ mkdirSync,
+ mkdtempSync,
+ readFileSync,
+ realpathSync,
+ rmSync,
+ writeFileSync,
+} from 'node:fs';
+import { tmpdir } from 'node:os';
+import { dirname, join } from 'node:path';
+import { resolveConfigPath } from '@inkeep/open-knowledge-core/server';
+import { afterEach, describe, expect, test, vi } from 'vitest';
+import { parse as parseYaml } from 'yaml';
+import { createUserConfigDispatch, createUserConfigStore } from './user-config-ipc.ts';
+
+const dirs: string[] = [];
+function tmpHome(): string {
+ const d = realpathSync(mkdtempSync(join(tmpdir(), 'ok-user-config-ipc-')));
+ dirs.push(d);
+ return d;
+}
+afterEach(() => {
+ for (const d of dirs) rmSync(d, { recursive: true, force: true });
+ dirs.length = 0;
+});
+
+function userConfigPath(home: string): string {
+ return resolveConfigPath('user', home, home);
+}
+
+function writeUserConfig(home: string, text: string): void {
+ const path = userConfigPath(home);
+ mkdirSync(dirname(path), { recursive: true });
+ writeFileSync(path, text, 'utf-8');
+}
+
+function readUserConfig(home: string): Record<string, unknown> {
+ return parseYaml(readFileSync(userConfigPath(home), 'utf-8')) as Record<string, unknown>;
+}
+
+function fakeLog() {
+ return { info: vi.fn(), warn: vi.fn() };
+}
+
+async function waitFor(predicate: () => boolean, timeoutMs = 4_000): Promise<void> {
+ const start = Date.now();
+ while (!predicate()) {
+ if (Date.now() - start > timeoutMs) throw new Error('waitFor timed out');
+ await new Promise((r) => setTimeout(r, 20));
+ }
+}
+
+describe('createUserConfigStore', () => {
+ test('reads an absent user config as empty text', async () => {
+ const store = createUserConfigStore({ homedir: tmpHome() });
+ await expect(store.read()).resolves.toEqual({ text: '' });
+ });
+
+ test('reads the current user config text', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const store = createUserConfigStore({ homedir: home });
+ await expect(store.read()).resolves.toEqual({ text: 'appearance:\n theme: dark\n' });
+ });
+
+ test('a patch lands in the user config and returns the new file text', async () => {
+ const home = tmpHome();
+ const store = createUserConfigStore({ homedir: home });
+ const result = await store.patch({ editor: { wordWrap: false } });
+ expect(result.ok).toBe(true);
+ expect(readUserConfig(home)).toMatchObject({ editor: { wordWrap: false } });
+ if (result.ok) expect(result.text).toBe(readFileSync(userConfigPath(home), 'utf-8'));
+ });
+
+ test('a patch keeps a key another writer landed after the renderer last read the file', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const store = createUserConfigStore({ homedir: home });
+ await store.read();
+ writeUserConfig(home, 'appearance:\n theme: dark\n language: fr\n');
+
+ const result = await store.patch({ editor: { wordWrap: false } });
+
+ expect(result.ok).toBe(true);
+ expect(readUserConfig(home)).toMatchObject({
+ appearance: { theme: 'dark', language: 'fr' },
+ editor: { wordWrap: false },
+ });
+ });
+
+ test('concurrent patches from two writers both land', async () => {
+ const home = tmpHome();
+ const store = createUserConfigStore({ homedir: home });
+ const other = createUserConfigStore({ homedir: home });
+ const [a, b] = await Promise.all([
+ store.patch({ editor: { wordWrap: false } }),
+ other.patch({ appearance: { theme: 'light' } }),
+ ]);
+ expect(a.ok && b.ok).toBe(true);
+ expect(readUserConfig(home)).toMatchObject({
+ editor: { wordWrap: false },
+ appearance: { theme: 'light' },
+ });
+ });
+
+ test('a project-scope key is refused and the file is untouched', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const store = createUserConfigStore({ homedir: home });
+ const result = await store.patch({ content: { dir: 'docs' } });
+ expect(result.ok).toBe(false);
+ if (!result.ok) expect(result.error.code).toBe('SCOPE_VIOLATION');
+ expect(readFileSync(userConfigPath(home), 'utf-8')).toBe('appearance:\n theme: dark\n');
+ });
+
+ test('a schema-invalid value is refused and the file is untouched', async () => {
+ const home = tmpHome();
+ const store = createUserConfigStore({ homedir: home });
+ const result = await store.patch({ editor: { wordWrap: 'sometimes' as unknown as boolean } });
+ expect(result.ok).toBe(false);
+ expect(existsSync(userConfigPath(home))).toBe(false);
+ });
+
+ test('watch reports an external edit and stops after unsubscribe', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const store = createUserConfigStore({ homedir: home, pollIntervalMs: 20 });
+ const seen: string[] = [];
+ const stop = store.watch(({ text }) => seen.push(text));
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => seen.includes('appearance:\n theme: light\n'));
+ stop();
+ writeUserConfig(home, 'appearance:\n theme: system\n');
+ await new Promise((r) => setTimeout(r, 150));
+ expect(seen).not.toContain('appearance:\n theme: system\n');
+ });
+
+ test('watch reports an edit only once the file reads the same on two consecutive polls', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const store = createUserConfigStore({ homedir: home, pollIntervalMs: 400 });
+ const seen: string[] = [];
+ const stop = store.watch(({ text }) => seen.push(text));
+ writeUserConfig(home, 'appearance:\n theme: li');
+ await new Promise((r) => setTimeout(r, 600));
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => seen.length > 0);
+ stop();
+
+ expect(seen).toEqual(['appearance:\n theme: light\n']);
+ });
+
+ test('an unreadable user config is logged once, polling continues, and recovery is logged', async () => {
+ const home = tmpHome();
+ const path = userConfigPath(home);
+ mkdirSync(path, { recursive: true });
+ const log = fakeLog();
+ const store = createUserConfigStore({ homedir: home, pollIntervalMs: 20, log });
+ const seen: string[] = [];
+ const stop = store.watch(({ text }) => seen.push(text));
+ await expect(store.read()).rejects.toThrow();
+ await new Promise((r) => setTimeout(r, 150));
+
+ expect(log.warn).toHaveBeenCalledTimes(1);
+ expect(log.warn.mock.calls[0]?.[0]).toMatchObject({ err: expect.any(Error) });
+ expect(seen).toEqual([]);
+
+ rmSync(path, { recursive: true, force: true });
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => seen.includes('appearance:\n theme: light\n'));
+ stop();
+
+ expect(log.warn).toHaveBeenCalledTimes(1);
+ expect(log.info).toHaveBeenCalledTimes(1);
+ expect(log.info.mock.calls[0]?.[1]).toContain('recovered');
+ });
+
+ test('a delivery that throws is logged once and retried on the next poll', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const log = fakeLog();
+ const store = createUserConfigStore({ homedir: home, pollIntervalMs: 20, log });
+ let failures = 3;
+ const seen: string[] = [];
+ const stop = store.watch(({ text }) => {
+ if (failures > 0) {
+ failures -= 1;
+ throw new Error('render frame disposed');
+ }
+ seen.push(text);
+ });
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => seen.length > 0);
+ stop();
+
+ expect(seen).toEqual(['appearance:\n theme: light\n']);
+ expect(log.warn).toHaveBeenCalledTimes(1);
+ expect(log.info).toHaveBeenCalledTimes(1);
+ });
+});
+
+function fakeSender() {
+ const sent: Array<{ channel: string; payload: unknown }> = [];
+ let onDestroyed: (() => void) | null = null;
+ return {
+ sent,
+ destroy: () => onDestroyed?.(),
+ webContents: {
+ send: (channel: string, payload: unknown) => {
+ sent.push({ channel, payload });
+ },
+ isDestroyed: () => false,
+ once: (_event: 'destroyed', listener: () => void) => {
+ onDestroyed = listener;
+ },
+ },
+ };
+}
+
+describe('createUserConfigDispatch', () => {
+ test('forwards a language preference push', async () => {
+ const setLanguagePreference = vi.fn();
+ const dispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: tmpHome() }),
+ setLanguagePreference,
+ });
+ await expect(
+ dispatch(fakeSender().webContents, { kind: 'set-language-preference', preference: 'fr' }),
+ ).resolves.toEqual({ ok: true });
+ expect(setLanguagePreference).toHaveBeenCalledWith('fr');
+ });
+
+ test('read and patch reach the user config', async () => {
+ const home = tmpHome();
+ const dispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: home }),
+ setLanguagePreference: () => {},
+ });
+ const sender = fakeSender().webContents;
+ await expect(dispatch(sender, { kind: 'read' })).resolves.toEqual({ text: '' });
+ const patched = await dispatch(sender, {
+ kind: 'patch',
+ patch: { appearance: { theme: 'dark' } },
+ });
+ expect(patched).toMatchObject({ ok: true });
+ expect(readUserConfig(home)).toMatchObject({ appearance: { theme: 'dark' } });
+ });
+
+ test('a subscribed window is told about external edits until it is destroyed', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const dispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: home, pollIntervalMs: 20 }),
+ setLanguagePreference: () => {},
+ });
+ const sender = fakeSender();
+ await expect(dispatch(sender.webContents, { kind: 'subscribe' })).resolves.toEqual({
+ ok: true,
+ });
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => sender.sent.length > 0);
+ expect(sender.sent[0]).toEqual({
+ channel: 'ok:user-config:changed',
+ payload: { text: 'appearance:\n theme: light\n' },
+ });
+ sender.destroy();
+ const count = sender.sent.length;
+ writeUserConfig(home, 'appearance:\n theme: system\n');
+ await new Promise((r) => setTimeout(r, 150));
+ expect(sender.sent.length).toBe(count);
+ });
+
+ test('a window stops being told about edits once its last subscription is released', async () => {
+ const home = tmpHome();
+ writeUserConfig(home, 'appearance:\n theme: dark\n');
+ const dispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: home, pollIntervalMs: 20 }),
+ setLanguagePreference: () => {},
+ });
+ const sender = fakeSender();
+ await dispatch(sender.webContents, { kind: 'subscribe' });
+ await dispatch(sender.webContents, { kind: 'subscribe' });
+ await expect(dispatch(sender.webContents, { kind: 'unsubscribe' })).resolves.toEqual({
+ ok: true,
+ });
+ writeUserConfig(home, 'appearance:\n theme: light\n');
+ await waitFor(() => sender.sent.length > 0);
+ await dispatch(sender.webContents, { kind: 'unsubscribe' });
+ const count = sender.sent.length;
+ writeUserConfig(home, 'appearance:\n theme: system\n');
+ await new Promise((r) => setTimeout(r, 150));
+ expect(sender.sent.length).toBe(count);
+ });
+
+ test('a malformed request is rejected', async () => {
+ const dispatch = createUserConfigDispatch({
+ store: createUserConfigStore({ homedir: tmpHome() }),
+ setLanguagePreference: () => {},
+ });
+ await expect(
+ dispatch(fakeSender().webContents, { kind: 'bogus' } as unknown as { kind: 'read' }),
+ ).rejects.toThrow();
+ });
+});
diff --git a/packages/desktop/src/main/user-config-ipc.ts b/packages/desktop/src/main/user-config-ipc.ts
new file mode 100644
index 000000000..111c65f2b
--- /dev/null
+++ b/packages/desktop/src/main/user-config-ipc.ts
@@ -0,0 +1,214 @@
+import { readFileSync } from 'node:fs';
+import { readFile } from 'node:fs/promises';
+import type { ConfigPatch, LanguagePreference } from '@inkeep/open-knowledge-core';
+import type {
+ OkUserConfigPatchResult,
+ OkUserConfigSnapshot,
+} from '@inkeep/open-knowledge-core/desktop-bridge';
+import { resolveConfigPath, writeConfigPatch } from '@inkeep/open-knowledge-core/server';
+import type { UserConfigDispatchRequest } from '../shared/ipc-channels.ts';
+import { type SendableWebContents, sendToRenderer } from '../shared/ipc-send.ts';
+import { type DesktopLogger, getLogger } from './desktop-logger.ts';
+
+const DEFAULT_POLL_INTERVAL_MS = 1_000;
+
+export interface UserConfigStore {
+ read(): Promise<OkUserConfigSnapshot>;
+ patch(patch: ConfigPatch): Promise<OkUserConfigPatchResult>;
+ watch(onChange: (snapshot: OkUserConfigSnapshot) => void): () => void;
+}
+
+async function readTextOrEmpty(path: string): Promise<string> {
+ try {
+ return await readFile(path, 'utf-8');
+ } catch (err) {
+ if ((err as NodeJS.ErrnoException).code === 'ENOENT') return '';
+ throw err;
+ }
+}
+
+function readTextOrEmptySync(path: string): string {
+ try {
+ return readFileSync(path, 'utf-8');
+ } catch (err) {
+ if ((err as NodeJS.ErrnoException).code === 'ENOENT') return '';
+ throw err;
+ }
+}
+
+type UserConfigLog = Pick<DesktopLogger, 'info' | 'warn'>;
+
+function createFailureEpisode(log: UserConfigLog, event: string) {
+ let failing = false;
+ return {
+ failed(err: unknown, context: Record<string, unknown> = {}): void {
+ if (failing) return;
+ failing = true;
+ log.warn({ err, ...context }, `${event} failed`);
+ },
+ succeeded(context: Record<string, unknown> = {}): void {
+ if (!failing) return;
+ failing = false;
+ log.info(context, `${event} recovered`);
+ },
+ };
+}
+
+function isPatchObject(value: unknown): value is ConfigPatch {
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+
+export function createUserConfigStore(opts: {
+ homedir: string;
+ pollIntervalMs?: number;
+ log?: UserConfigLog;
+}): UserConfigStore {
+ const path = resolveConfigPath('user', opts.homedir, opts.homedir);
+ const interval = opts.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
+ const log = opts.log ?? getLogger('user-config');
+ const readEpisode = createFailureEpisode(log, 'user config read');
+
+ async function readTracked(source: string): Promise<string> {
+ try {
+ const text = await readTextOrEmpty(path);
+ readEpisode.succeeded({ source });
+ return text;
+ } catch (err) {
+ readEpisode.failed(err, { source });
+ throw err;
+ }
+ }
+
+ return {
+ async read() {
+ return { text: await readTracked('read') };
+ },
+
+ async patch(patch) {
+ if (!isPatchObject(patch)) {
+ return { ok: false, error: { code: 'WRITE_ERROR', detail: 'Patch must be an object.' } };
+ }
+ const result = await writeConfigPatch({
+ cwd: opts.homedir,
+ scope: 'user',
+ patch,
+ homedirOverride: opts.homedir,
+ });
+ if (!result.ok) return { ok: false, error: result.error };
+ return { ok: true, text: await readTracked('patch') };
+ },
+
+ watch(onChange) {
+ const deliveryEpisode = createFailureEpisode(log, 'user config change delivery');
+ let last: string | null = null;
+ try {
+ last = readTextOrEmptySync(path);
+ readEpisode.succeeded({ source: 'watch' });
+ } catch (err) {
+ readEpisode.failed(err, { source: 'watch' });
+ }
+ let stopped = false;
+ let reading = false;
+ let settling: string | null = null;
+ const deliver = (text: string) => {
+ if (stopped) return;
+ if (text === last) {
+ settling = null;
+ return;
+ }
+ if (text !== settling) {
+ settling = text;
+ return;
+ }
+ settling = null;
+ try {
+ onChange({ text });
+ } catch (err) {
+ deliveryEpisode.failed(err);
+ return;
+ }
+ deliveryEpisode.succeeded();
+ last = text;
+ };
+ const poll = () => {
+ if (reading) return;
+ reading = true;
+ readTracked('poll')
+ .then(deliver, () => {})
+ .finally(() => {
+ reading = false;
+ });
+ };
+ const timer = setInterval(poll, interval);
+ timer.unref?.();
+ return () => {
+ stopped = true;
+ clearInterval(timer);
+ };
+ },
+ };
+}
+
+export interface UserConfigSubscriber extends SendableWebContents {
+ once(event: 'destroyed', listener: () => void): void;
+}
+
+export function createUserConfigDispatch(deps: {
+ store: UserConfigStore;
+ setLanguagePreference: (preference: LanguagePreference) => void;
+}) {
+ const subscriptions = new Map<UserConfigSubscriber, { stop: () => void; count: number }>();
+
+ function release(sender: UserConfigSubscriber): void {
+ subscriptions.get(sender)?.stop();
+ subscriptions.delete(sender);
+ }
+
+ function subscribe(sender: UserConfigSubscriber): void {
+ const existing = subscriptions.get(sender);
+ if (existing) {
+ existing.count += 1;
+ return;
+ }
+ const stop = deps.store.watch((snapshot) => {
+ if (sender.isDestroyed?.() === true) return;
+ sendToRenderer(sender, 'ok:user-config:changed', snapshot);
+ });
+ subscriptions.set(sender, { stop, count: 1 });
+ sender.once('destroyed', () => release(sender));
+ }
+
+ function unsubscribe(sender: UserConfigSubscriber): void {
+ const existing = subscriptions.get(sender);
+ if (!existing) return;
+ existing.count -= 1;
+ if (existing.count <= 0) release(sender);
+ }
+
+ return async function dispatch(
+ sender: UserConfigSubscriber,
+ request: UserConfigDispatchRequest,
+ ): Promise<{ ok: true } | OkUserConfigSnapshot | OkUserConfigPatchResult> {
+ switch (request?.kind) {
+ case 'set-language-preference':
+ deps.setLanguagePreference(request.preference);
+ return { ok: true };
+ case 'read':
+ return deps.store.read();
+ case 'subscribe':
+ subscribe(sender);
+ return { ok: true };
+ case 'unsubscribe':
+ unsubscribe(sender);
+ return { ok: true };
+ case 'patch':
+ return deps.store.patch(request.patch);
+ default:
+ return rejectUnknownRequest(request);
+ }
+ };
+}
+
+function rejectUnknownRequest(_request: never): never {
+ throw new Error('Unknown user-config request.');
+}
diff --git a/packages/desktop/src/preload/bridge-forwarding.test.ts b/packages/desktop/src/preload/bridge-forwarding.test.ts
index 5ddfa9bbd..eeb4469a0 100644
--- a/packages/desktop/src/preload/bridge-forwarding.test.ts
+++ b/packages/desktop/src/preload/bridge-forwarding.test.ts
@@ -48,6 +48,9 @@ type BridgeProbe = {
terminalSnapshot: { tabs: []; activeOrdinal: null };
}): Promise<{ ok: true } | { ok: false; reason: string }>;
};
+ userConfig: {
+ onChanged(cb: (snapshot: { text: string }) => void): () => void;
+ };
editor: {
notifyViewMenuStateChanged(state: {
terminalVisible?: boolean;
@@ -292,3 +295,33 @@ describe('preload terminal dock-state marshalling', () => {
).resolves.toEqual({ ok: false, reason: 'ipc-unavailable' });
});
});
+
+describe('preload userConfig subscription', () => {
+ function userConfigRequests(): unknown[] {
+ return invokeMock.mock.calls
+ .filter((c) => c[0] === 'ok:user-config:dispatch')
+ .map((c) => c[1] as unknown);
+ }
+
+ it('subscribes on listen and unsubscribes when the listener is disposed', async () => {
+ const bridge = await loadBridge();
+
+ const dispose = bridge.userConfig.onChanged(() => {});
+ expect(userConfigRequests()).toEqual([{ kind: 'subscribe' }]);
+
+ dispose();
+ expect(userConfigRequests()).toEqual([{ kind: 'subscribe' }, { kind: 'unsubscribe' }]);
+ });
+
+ it('does not hand the subscribe reply to the listener as a change', async () => {
+ invokeMock.mockResolvedValueOnce({ text: 'appearance:\n theme: dark\n' } as never);
+ const bridge = await loadBridge();
+ const cb = vi.fn();
+
+ bridge.userConfig.onChanged(cb);
+ await Promise.resolve();
+ await Promise.resolve();
+
+ expect(cb).not.toHaveBeenCalled();
+ });
+});
diff --git a/packages/desktop/src/preload/index.ts b/packages/desktop/src/preload/index.ts
index e640eb137..f67c56285 100644
--- a/packages/desktop/src/preload/index.ts
+++ b/packages/desktop/src/preload/index.ts
@@ -1,4 +1,5 @@
import type {
+ ConfigPatch,
HandoffHostPlatform,
LanguagePreference,
OkBugReportCrashAckResult,
@@ -55,6 +56,8 @@ import type {
OkUpdateRelaunchFailedInfo,
OkUpdateRelaunchingInfo,
OkUpdateStuckHintInfo,
+ OkUserConfigPatchResult,
+ OkUserConfigSnapshot,
OkWhatsNewInfo,
} from '../shared/bridge-contract.ts';
import {
@@ -463,7 +466,43 @@ const bridge: OkDesktopBridge = {
setThemeSource: (source: OkThemeSource) => invoke('ok:theme:set-source', { source }),
setLanguagePreference: (preference: LanguagePreference) =>
- invoke('ok:locale:set-preference', { preference }),
+ invoke('ok:user-config:dispatch', { kind: 'set-language-preference', preference }) as Promise<{
+ ok: true;
+ }>,
+
+ userConfig: {
+ read: () =>
+ invoke('ok:user-config:dispatch', { kind: 'read' }) as Promise<OkUserConfigSnapshot>,
+ patch: (patch: ConfigPatch) =>
+ invoke('ok:user-config:dispatch', {
+ kind: 'patch',
+ patch,
+ }) as Promise<OkUserConfigPatchResult>,
+ onChanged(cb: (snapshot: OkUserConfigSnapshot) => void) {
+ const listener = (_event: IpcRendererEvent, snapshot: OkUserConfigSnapshot) => cb(snapshot);
+ // oxlint-disable-next-line ok/no-loosely-typed-webcontents-ipc -- preload-side subscription wrapper (precedent #14)
+ ipcRenderer.on('ok:user-config:changed', listener);
+ invoke('ok:user-config:dispatch', { kind: 'subscribe' }).catch((err: unknown) => {
+ console.warn(
+ JSON.stringify({
+ event: 'user-config-subscribe-failed',
+ error: err instanceof Error ? err.message : String(err),
+ }),
+ );
+ });
+ return () => {
+ ipcRenderer.removeListener('ok:user-config:changed', listener);
+ invoke('ok:user-config:dispatch', { kind: 'unsubscribe' }).catch((err: unknown) => {
+ console.warn(
+ JSON.stringify({
+ event: 'user-config-unsubscribe-failed',
+ error: err instanceof Error ? err.message : String(err),
+ }),
+ );
+ });
+ };
+ },
+ },
signalThemeApplied: (opts?: { reducedTransparency?: boolean; chrome?: OkChromeColors }) => {
invoke('ok:theme:applied', opts).catch((err: unknown) => {
diff --git a/packages/desktop/src/shared/ipc-channels.ts b/packages/desktop/src/shared/ipc-channels.ts
index b05e15d65..7af171793 100644
--- a/packages/desktop/src/shared/ipc-channels.ts
+++ b/packages/desktop/src/shared/ipc-channels.ts
@@ -2,6 +2,7 @@ import type {
ApplyReport,
BranchInfoResponse,
CheckoutResponse,
+ ConfigPatch,
CreateNewBannerKind,
EditorId,
HandoffFailureReason,
@@ -66,6 +67,8 @@ import type {
OkTerminalDockStateWriteResult,
OkThemeSource,
OkUpdateChannel,
+ OkUserConfigPatchResult,
+ OkUserConfigSnapshot,
OkSeedApplyOptions as SeedApplyOptions,
OkSeedPlanOptions as SeedPlanOptions,
SlidevOpenFailureReason,
@@ -366,6 +369,13 @@ interface DialogOpenFolderOpts {
readonly defaultPath?: string;
}
+export type UserConfigDispatchRequest =
+ | { kind: 'set-language-preference'; preference: LanguagePreference }
+ | { kind: 'read' }
+ | { kind: 'subscribe' }
+ | { kind: 'unsubscribe' }
+ | { kind: 'patch'; patch: ConfigPatch };
+
export const TYPED_IPC_MIGRATION_CHANNEL_CAP = 95;
export interface RequestChannels {
@@ -559,9 +569,9 @@ export interface RequestChannels {
};
'ok:state:reset-incompatible': { args: []; result: undefined };
'ok:theme:set-source': { args: [params: { source: OkThemeSource }]; result: { ok: true } };
- 'ok:locale:set-preference': {
- args: [params: { preference: LanguagePreference }];
- result: { ok: true };
+ 'ok:user-config:dispatch': {
+ args: [request: UserConfigDispatchRequest];
+ result: { ok: true } | OkUserConfigSnapshot | OkUserConfigPatchResult;
};
'ok:theme:applied': {
args: [opts?: { reducedTransparency?: boolean; chrome?: OkChromeColors }];
diff --git a/packages/desktop/src/shared/ipc-events.ts b/packages/desktop/src/shared/ipc-events.ts
index 3d6ce4216..a4f8ba1ad 100644
--- a/packages/desktop/src/shared/ipc-events.ts
+++ b/packages/desktop/src/shared/ipc-events.ts
@@ -3,6 +3,7 @@ import type {
OkDeepLinkPayload,
OkNoteWindowMainAction,
OkOnboardingToastPayload,
+ OkUserConfigSnapshot,
} from '@inkeep/open-knowledge-core/desktop-bridge';
import type {
OkDesktopConfig,
@@ -74,4 +75,5 @@ export interface EventChannels {
'ok:pty:notice': { payload: OkPtyNotice };
'ok:accessibility:changed': { payload: { screenReaderActive: boolean } };
'ok:bug-report:crash-detected': { payload: OkBugReportCrashDetectedEvent };
+ 'ok:user-config:changed': { payload: OkUserConfigSnapshot };
}
diff --git a/packages/server/src/server-factory.test.ts b/packages/server/src/server-factory.test.ts
index 221ba4e39..a9527b415 100644
--- a/packages/server/src/server-factory.test.ts
+++ b/packages/server/src/server-factory.test.ts
@@ -24,7 +24,11 @@ import {
lintDocument,
REMOVED_KEYS,
} from '@inkeep/open-knowledge-core';
-import { readConfigSafely, resolveConfigPath } from '@inkeep/open-knowledge-core/server';
+import {
+ readConfigSafely,
+ resolveConfigPath,
+ writeConfigPatch,
+} from '@inkeep/open-knowledge-core/server';
import { parseCheckpoint } from '@inkeep/open-knowledge-core/shadow-repo-layout';
import simpleGit from 'simple-git';
import { afterEach, beforeEach, describe, expect, test, vi } from 'vitest';
@@ -1888,6 +1892,38 @@ describe('createServer() — config file watcher (US-007)', () => {
await srv.destroy();
});
+ test('a key-level patch to the user config from outside the server reaches __user__/config.yml', async () => {
+ const contentDir = mkdtempSync(resolve(testProjectDir, 'content-'));
+ const srv = createServer({
+ contentDir,
+ projectDir: testProjectDir,
+ quiet: true,
+ configHomedirOverride: testHomedir,
+ });
+ await srv.ready;
+
+ const userDoc = srv.hocuspocus.documents.get('__user__/config.yml');
+ expect(userDoc).toBeDefined();
+ if (!userDoc) {
+ await srv.destroy();
+ return;
+ }
+ const ytext = userDoc.getText('source');
+
+ const written = await writeConfigPatch({
+ cwd: testHomedir,
+ scope: 'user',
+ patch: { editor: { wordWrap: false } },
+ homedirOverride: testHomedir,
+ });
+ expect(written.ok).toBe(true);
+
+ const fired = await waitFor(() => ytext.toString().includes('wordWrap: false'));
+ expect(fired).toBe(true);
+
+ await srv.destroy();
+ });
+
test('external broken-YAML write keeps Y.Text at LKG and does not crash the server', async () => {
const logs = captureAllLoggers();
const contentDir = mkdtempSync(resolve(testProjectDir, 'content-'));