Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Let users turn off desktop auto-updates (PRD-7875) (#6016)

Andrew Mikofalvyc522e35f25b9
diff --git a/.changeset/prd-7875-desktop-update-off-switch.md b/.changeset/prd-7875-desktop-update-off-switch.md
new file mode 100644
index 000000000..52d895cbf
--- /dev/null
+++ b/.changeset/prd-7875-desktop-update-off-switch.md
@@ -0,0 +1,5 @@
+---
+"@inkeep/open-knowledge": minor
+---
+
+The desktop app can now stop updating itself: turn off **Download and install updates automatically** in Settings → About & updates. Check for updates still works. Dismissing the "ready to install" card now sticks, and a failing install stops asking after a few tries.
diff --git a/docs/content/reference/configuration.mdx b/docs/content/reference/configuration.mdx
index f916d07d4..f14eaaecf 100644
--- a/docs/content/reference/configuration.mdx
+++ b/docs/content/reference/configuration.mdx
@@ -109,6 +109,19 @@ Path exclusions live in a project-root `.okignore` file using gitignore syntax.
CLI flags (when running the bundled `ok` CLI) > environment variables > project-local config > project config > user config > defaults. Leaf values at higher levels override the same leaf below; arrays replace, they don't concatenate.
+## Desktop updates
+
+Automatic updates have no `config.yml` key, because they describe the machine rather than the person: `config.yml` can follow you between machines, and this preference does not. Set it in **Settings → About & updates**.
+
+| **Download and install updates automatically** | What happens |
+| --- | --- |
+| On (default) | OpenKnowledge checks at launch and every hour and downloads new versions in the background. On macOS and Windows it installs them when you quit; on Linux it asks you to authorize each install. |
+| Off | OpenKnowledge never contacts the update server on its own: no check at launch or on the hourly schedule, no new downloads, nothing installed when you quit, and no update notices. |
+
+Turn it off on a machine whose software you don't control, such as a work laptop under IT policy. **Check for updates** still works while it is off; if it finds a newer version, it offers to open the releases page instead of downloading. Turning it back on checks right away.
+
+A download already in progress when you turn it off still finishes, but it is not installed when you quit. On macOS, an update whose download had already finished before you turned it off may still be applied at the next launch, because macOS takes over a completed download.
+
## Environment variables
Most users never set these — the schema settings above cover the common cases. These have no `config.yml` key or Settings toggle; they are environment-only.
diff --git a/docs/content/reference/what-open-knowledge-writes.mdx b/docs/content/reference/what-open-knowledge-writes.mdx
index dfc9955d1..f7588b55f 100644
--- a/docs/content/reference/what-open-knowledge-writes.mdx
+++ b/docs/content/reference/what-open-knowledge-writes.mdx
@@ -50,9 +50,9 @@ On every platform the app writes app-level state and logs on launch. The table b
| Path | What it is | Scope |
| --- | --- | --- |
-| `~/Library/Application Support/OpenKnowledge/state.json` | Recent projects, window/view state, update channel | Outside-project (home dir) |
+| `~/Library/Application Support/OpenKnowledge/state.json` | Recent projects, window/view state, update channel, and your automatic-updates preference | Outside-project (home dir) |
| `~/Library/Application Support/OpenKnowledge/path-install.json` | Records the `PATH`/shell changes it made and your `PATH`-consent choice, so they can be reverted | Outside-project (home dir) |
-| `~/Library/Application Support/OpenKnowledge Beta/state.json` | Beta's separate recent projects, window/view state, and update channel | Outside-project (home dir) |
+| `~/Library/Application Support/OpenKnowledge Beta/state.json` | Beta's separate recent projects, window/view state, update channel, and automatic-updates preference | Outside-project (home dir) |
| `~/.ok-beta/path-install.json` | Records Beta's separate `PATH`/shell changes and consent choice | Outside-project (home dir) |
| `~/.ok/logs/desktop.<date>.log` | Desktop app + renderer log | Outside-project (home dir) |
| `~/.ok/mcp-status.json` | Records your first-launch MCP-setup consent choice | Outside-project (home dir) |
@@ -67,7 +67,7 @@ On every platform the app writes app-level state and logs on launch. The table b
| `~/Library/Application Support/OpenKnowledge/bug-report-main-thread-stall.json` | Main-thread stall snapshot. When the liveness witness first sees the main thread blocked for at least 15 seconds, the same background worker writes this file at once, then briefly pauses the main thread to read where it is and resumes it straight away. It holds function names and script locations from the app's own code, and the Node.js runtime beneath it, at the moment of a freeze: at most 24 frames, never document content. A freeze inside native code only lets the pause land once the main thread returns to the app's code, so the file records how long that took, and a session that ended before then keeps the record written when the freeze was first seen. One snapshot per freeze; a later freeze in the same session overwrites it, through a `.tmp-` sibling during each write. A freeze the app recovers from is also noted in the desktop log as it recovers. Read at the next launch; left in place on a clean quit and overwritten by the next freeze. It does not change whether the app prompts you | Outside-project (home dir) |
| `~/Library/Application Support/OpenKnowledge/bug-report-main-exit.json` | Main-process exit record. Written only when the main process exits without the app having marked a clean quit, for example when code ends the process directly instead of going through the normal quit path. It holds the session's identifier, the time, and the exit code. A crash or a forced kill never gets to write it, which is how the next launch tells those endings apart from an exit the app ran itself. Read only at the next launch, where the result lands in the desktop log a bug report carries; left in place and overwritten by the next such exit. It does not change whether the app prompts you | Outside-project (home dir) |
-Stable registers `openknowledge://`; Beta registers `openknowledge-beta://`. Both check for updates — on launch and periodically while running — against separate Stable/Beta paths on the OpenKnowledge update service at `openknowledge.ai/updates`, which redirects to the matching GitHub release asset and counts the update per version and channel (Stable alone can fall back to GitHub directly if the proxy is unreachable). On macOS and Windows an update on your channel downloads in the background and installs on the next quit; on Linux — where there is no apt/rpm repository — the app downloads the new deb/rpm from the release feed and asks you to authorize the install (a `pkexec` password prompt) each time. You can also check on demand from **Check for updates…** in the app and Help menus, from **Check for updates** in the Help (**?**) popover once the updater has started, or from **Settings → About & updates**, which also shows the installed version and opens its release notes. If the check finds a new version but its download fails, the app tells you so you can try again. The channel is fixed by the product you installed. Older Beta installations named `OpenKnowledge` continue receiving Beta updates in place, preserving their existing settings and CLI commands; they do not silently become the separately installed `OpenKnowledge Beta` app. Reinstall Stable from `openknowledge.ai/download` or Beta from `openknowledge.ai/download/beta`; Windows and Linux installers are available from [GitHub Releases](https://github.com/inkeep/open-knowledge/releases). Override the feed with `OK_UPDATER_FEED_URL`.
+Stable registers `openknowledge://`; Beta registers `openknowledge-beta://`. Unless you turn off **Download and install updates automatically** in **Settings → About & updates** (see [Desktop updates](/docs/reference/configuration#desktop-updates)), both check for updates — on launch and periodically while running — against separate Stable/Beta paths on the OpenKnowledge update service at `openknowledge.ai/updates`, which redirects to the matching GitHub release asset and counts the update per version and channel (Stable alone can fall back to GitHub directly if the proxy is unreachable). On macOS and Windows an update on your channel downloads in the background and installs on the next quit; on Linux — where there is no apt/rpm repository — the app downloads the new deb/rpm from the release feed and asks you to authorize the install (a `pkexec` password prompt) each time. You can also check on demand from **Check for updates…** in the app and Help menus, from **Check for updates** in the Help (**?**) popover once the updater has started, or from **Settings → About & updates**, which also shows the installed version and opens its release notes. If the check finds a new version but its download fails, the app tells you so you can try again. The channel is fixed by the product you installed. Older Beta installations named `OpenKnowledge` continue receiving Beta updates in place, preserving their existing settings and CLI commands; they do not silently become the separately installed `OpenKnowledge Beta` app. Reinstall Stable from `openknowledge.ai/download` or Beta from `openknowledge.ai/download/beta`; Windows and Linux installers are available from [GitHub Releases](https://github.com/inkeep/open-knowledge/releases). Override the feed with `OK_UPDATER_FEED_URL`.
On its first launch the app also opens your default browser once to `openknowledge.ai/continue`, to check whether you installed from a share link and redeem it if so; the exchange completes over a short-lived local loopback listener.
diff --git a/packages/app/src/components/UpdateNotices.shared.ts b/packages/app/src/components/UpdateNotices.shared.ts
index 1e31fa4d8..e1922b898 100644
--- a/packages/app/src/components/UpdateNotices.shared.ts
+++ b/packages/app/src/components/UpdateNotices.shared.ts
@@ -91,6 +91,10 @@ export function attachUpdateSubscribers(
unsubscribers.push(
bridge.onUpdateDownloaded(({ version }) => {
const noticeId = downloadedNoticeId;
+ if (version === null) {
+ dismissNotice(noticeId);
+ return;
+ }
dismissNotice(noLongerPendingNoticeId);
const armReadyNotice = () => {
@@ -98,6 +102,11 @@ export function attachUpdateSubscribers(
id: noticeId,
body: toastABody(version),
priority: PRIORITY_UPDATE_DOWNLOADED,
+ onDismiss: () => {
+ bridge.update.dismissDownloaded(version).catch((err: unknown) => {
+ console.warn('[update-notice] dismissing the ready-to-install card failed', err);
+ });
+ },
action: {
label: TOAST_A_ACTION,
onClick: () => {
diff --git a/packages/app/src/components/UpdateNotices.test.ts b/packages/app/src/components/UpdateNotices.test.ts
index 527df4c45..2c34761a2 100644
--- a/packages/app/src/components/UpdateNotices.test.ts
+++ b/packages/app/src/components/UpdateNotices.test.ts
@@ -24,7 +24,7 @@ import {
WHATS_NEW_AUTO_DISMISS_MS,
} from './UpdateNotices';
-type UpdateDownloadedCb = (info: { version: string }) => void;
+type UpdateDownloadedCb = (info: { version: string | null }) => void;
type RelaunchingCb = (info: { version: string }) => void;
type FetchingLatestCb = (info: { version: string }) => void;
type RelaunchFailedCb = (info: {
@@ -52,6 +52,8 @@ interface FakeBridge {
relaunchNow: ReturnType<typeof vi.fn>;
checkNow: ReturnType<typeof vi.fn>;
dismissWhatsNew: ReturnType<typeof vi.fn>;
+ dismissDownloaded: ReturnType<typeof vi.fn>;
+ setMode: ReturnType<typeof vi.fn>;
};
state: {
query: ReturnType<typeof vi.fn>;
@@ -98,6 +100,8 @@ function makeFakeBridge(): FakeBridge {
relaunchNow: vi.fn(() => Promise.resolve(undefined)),
checkNow: vi.fn(() => Promise.resolve(undefined)),
dismissWhatsNew: vi.fn(() => Promise.resolve(undefined)),
+ dismissDownloaded: vi.fn(() => Promise.resolve(undefined)),
+ setMode: vi.fn(() => Promise.resolve(undefined)),
},
state: {
query: vi.fn(() => Promise.resolve({ channel: 'latest', schemaIncompatibility: null })),
@@ -1169,3 +1173,27 @@ describe('unsubscribe semantics', () => {
expect(bridge._manualCheckUnsub).toHaveBeenCalledTimes(1);
});
});
+
+describe('Notice A dismissal and stand-down', () => {
+ test('dismissing the ready-to-install card records the dismissal in main', () => {
+ const bridge = makeFakeBridge();
+ const addNotice = vi.fn<(notice: UpdateNotice) => void>(() => {});
+ attachUpdateSubscribers(castBridge(bridge), addNotice);
+
+ bridge._downloaded?.({ version: '0.1.1' });
+ const card = addNotice.mock.calls[0]?.[0] as UpdateNotice;
+ card.onDismiss?.();
+ expect(bridge.update.dismissDownloaded).toHaveBeenCalledWith('0.1.1');
+ });
+
+ test('a null-version downloaded event retracts the card without arming a new one', () => {
+ const bridge = makeFakeBridge();
+ const addNotice = vi.fn<(notice: UpdateNotice) => void>(() => {});
+ const dismissNotice = vi.fn<(id: string) => void>(() => {});
+ attachUpdateSubscribers(castBridge(bridge), addNotice, dismissNotice);
+
+ bridge._downloaded?.({ version: null });
+ expect(addNotice).not.toHaveBeenCalled();
+ expect(dismissNotice).toHaveBeenCalledWith('update-downloaded');
+ });
+});
diff --git a/packages/app/src/components/settings/AboutSection.dom.test.tsx b/packages/app/src/components/settings/AboutSection.dom.test.tsx
index bee82d26d..e3bf1cf55 100644
--- a/packages/app/src/components/settings/AboutSection.dom.test.tsx
+++ b/packages/app/src/components/settings/AboutSection.dom.test.tsx
@@ -358,3 +358,116 @@ describe('AboutSection', () => {
expect(checkNow).not.toHaveBeenCalled();
});
});
+
+function installModeBridge(
+ updateMode: 'auto' | 'off',
+ setMode: (mode: 'auto' | 'off') => Promise<void> = async () => {},
+ about: OkAboutInfo = CLOUD_ABOUT,
+) {
+ const setModeSpy = vi.fn(setMode);
+ Object.defineProperty(window, 'okDesktop', {
+ value: {
+ appVersion: about.version,
+ shell: { openExternal: vi.fn(async () => {}) },
+ update: { checkNow: vi.fn(async () => {}), setMode: setModeSpy },
+ state: {
+ query: vi.fn(async () => ({
+ channel: 'latest' as const,
+ schemaIncompatibility: null,
+ about,
+ updateMode,
+ })),
+ },
+ onUpdateManualCheck: () => () => {},
+ },
+ configurable: true,
+ writable: true,
+ });
+ return { setMode: setModeSpy };
+}
+
+describe('AboutSection automatic updates switch', () => {
+ test('reflects the persisted mode and turns automatic updates off', async () => {
+ const { setMode } = installModeBridge('auto');
+ render(<AboutSection />);
+
+ const toggle = await screen.findByRole('switch', {
+ name: 'Download and install updates automatically',
+ });
+ expect(toggle.getAttribute('aria-checked')).toBe('true');
+
+ await userEvent.click(toggle);
+
+ expect(setMode).toHaveBeenCalledWith('off');
+ await waitFor(() => expect(toggle.getAttribute('aria-checked')).toBe('false'));
+ expect(screen.getByText(/check for or download updates on its own/)).not.toBeNull();
+ });
+
+ test('turns automatic updates back on from off', async () => {
+ const { setMode } = installModeBridge('off');
+ render(<AboutSection />);
+
+ const toggle = await screen.findByRole('switch', {
+ name: 'Download and install updates automatically',
+ });
+ expect(toggle.getAttribute('aria-checked')).toBe('false');
+ await userEvent.click(toggle);
+ expect(setMode).toHaveBeenCalledWith('auto');
+ });
+
+ test('a refused write reverts the switch and reports the failure', async () => {
+ const warn = vi.spyOn(console, 'warn').mockImplementation(() => {});
+ installModeBridge('auto', async () => {
+ throw new Error('ok:update:dispatch: set-mode refused (persist-failed)');
+ });
+ render(<AboutSection />);
+
+ const toggle = await screen.findByRole('switch', {
+ name: 'Download and install updates automatically',
+ });
+ await userEvent.click(toggle);
+
+ expect(await screen.findByRole('alert')).not.toBeNull();
+ expect(toggle.getAttribute('aria-checked')).toBe('true');
+ warn.mockRestore();
+ });
+
+ test('a state read started before the click does not undo the new setting', async () => {
+ installModeBridge('auto');
+ const bridge = window.okDesktop as unknown as {
+ state: { query: ReturnType<typeof vi.fn> };
+ };
+ render(<AboutSection />);
+ const toggle = await screen.findByRole('switch', {
+ name: 'Download and install updates automatically',
+ });
+
+ let resolveStaleRead: (value: unknown) => void = () => {};
+ bridge.state.query.mockImplementationOnce(
+ () =>
+ new Promise((resolve) => {
+ resolveStaleRead = resolve;
+ }),
+ );
+ window.dispatchEvent(new Event('focus'));
+ await userEvent.click(toggle);
+ await waitFor(() => expect(toggle.getAttribute('aria-checked')).toBe('false'));
+
+ resolveStaleRead({
+ channel: 'latest',
+ schemaIncompatibility: null,
+ about: CLOUD_ABOUT,
+ updateMode: 'auto',
+ });
+ await new Promise((resolve) => setTimeout(resolve, 0));
+ expect(toggle.getAttribute('aria-checked')).toBe('false');
+ });
+
+ test('is hidden when this build cannot update itself', async () => {
+ installModeBridge('auto', async () => {}, { ...CLOUD_ABOUT, updateChecks: 'unavailable' });
+ render(<AboutSection />);
+
+ expect(await screen.findByText('OpenKnowledge Cloud')).not.toBeNull();
+ expect(screen.queryByRole('switch')).toBeNull();
+ });
+});
diff --git a/packages/app/src/components/settings/AboutSection.tsx b/packages/app/src/components/settings/AboutSection.tsx
index ac2f89221..ed3112211 100644
--- a/packages/app/src/components/settings/AboutSection.tsx
+++ b/packages/app/src/components/settings/AboutSection.tsx
@@ -1,9 +1,11 @@
import { Trans } from '@lingui/react/macro';
import { ArrowUpRight } from 'lucide-react';
-import { useEffect, useState } from 'react';
+import { useEffect, useRef, useState } from 'react';
import { Button } from '@/components/ui/button';
+import { Label } from '@/components/ui/label';
import { Spinner } from '@/components/ui/spinner';
-import type { OkAboutInfo } from '@/lib/desktop-bridge-types';
+import { Switch } from '@/components/ui/switch';
+import type { OkAboutInfo, OkUpdateMode } from '@/lib/desktop-bridge-types';
import { SettingsSectionHeader } from './SettingsSectionHeader';
const UNAVAILABLE_REREAD_INTERVAL_MS = 3000;
@@ -12,7 +14,11 @@ const UNAVAILABLE_REREAD_LIMIT = 20;
export function AboutSection() {
const bridge = typeof window !== 'undefined' ? (window.okDesktop ?? null) : null;
const [about, setAbout] = useState<OkAboutInfo | null>(null);
+ const [updateMode, setUpdateMode] = useState<OkUpdateMode | null>(null);
+ const [savingMode, setSavingMode] = useState(false);
+ const [modeError, setModeError] = useState(false);
const [checking, setChecking] = useState(false);
+ const modeWrites = useRef(0);
useEffect(() => {
if (!bridge) return;
@@ -32,11 +38,13 @@ export function AboutSection() {
reads.timer = undefined;
const read = reads.latest + 1;
reads.latest = read;
+ const modeWritesAtRead = modeWrites.current;
bridge.state
.query()
.then((snapshot) => {
if (cancelled || read !== reads.latest || !snapshot.about) return;
setAbout(snapshot.about);
+ if (modeWrites.current === modeWritesAtRead) setUpdateMode(snapshot.updateMode ?? null);
if (snapshot.about.updateChecks === 'unavailable') scheduleReread();
})
.catch((err: unknown) => {
@@ -67,6 +75,24 @@ export function AboutSection() {
if (!bridge) return null;
const version = about?.version ?? bridge.appVersion;
const updatesUnavailable = about?.updateChecks === 'unavailable';
+ const changeUpdateMode = (next: OkUpdateMode) => {
+ if (savingMode) return;
+ const previous = updateMode;
+ modeWrites.current += 1;
+ setSavingMode(true);
+ setModeError(false);
+ setUpdateMode(next);
+ bridge.update
+ .setMode(next)
+ .catch((err: unknown) => {
+ console.warn('[about-section] bridge.update.setMode() failed', err);
+ setUpdateMode(previous);
+ setModeError(true);
+ })
+ .finally(() => {
+ setSavingMode(false);
+ });
+ };
return (
<section
@@ -131,6 +157,41 @@ export function AboutSection() {
<Trans>Automatic updates are not available right now.</Trans>
</p>
) : null}
+ {about && updateMode && !updatesUnavailable ? (
+ <div className="flex items-start justify-between gap-3 border-t pt-3">
+ <div className="space-y-1">
+ <Label htmlFor="settings-about-auto-update">
+ <Trans>Download and install updates automatically</Trans>
+ </Label>
+ <p
+ id="settings-about-auto-update-description"
+ className="text-1sm text-muted-foreground"
+ >
+ {updateMode === 'off' ? (
+ <Trans>
+ OpenKnowledge doesn't check for or download updates on its own. Check for
+ updates still works when you want a newer version.
+ </Trans>
+ ) : (
+ <Trans>OpenKnowledge checks for and downloads updates in the background.</Trans>
+ )}
+ </p>
+ {modeError ? (
+ <p role="alert" className="text-1sm text-destructive">
+ <Trans>Couldn't save this setting. Try again.</Trans>
+ </p>
+ ) : null}
+ </div>
+ <Switch
+ id="settings-about-auto-update"
+ aria-describedby="settings-about-auto-update-description"
+ checked={updateMode === 'auto'}
+ disabled={savingMode}
+ onCheckedChange={(checked) => changeUpdateMode(checked ? 'auto' : 'off')}
+ data-testid="settings-about-auto-update"
+ />
+ </div>
+ ) : null}
</div>
</section>
);
diff --git a/packages/app/src/components/settings/SettingsDialogShell.tsx b/packages/app/src/components/settings/SettingsDialogShell.tsx
index 2f0abd1bd..2b771f7a9 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.tsx
@@ -436,6 +436,7 @@ function SettingsDialogFrame({
t({ message: 'about', context: 'settings search keyword' }),
t`Release notes`,
t`Check for updates`,
+ t`Automatic updates`,
],
},
],
diff --git a/packages/app/src/components/settings/SettingsDialogShell.update-checking.dom.test.tsx b/packages/app/src/components/settings/SettingsDialogShell.update-checking.dom.test.tsx
index 4cb1963f8..331f9239b 100644
--- a/packages/app/src/components/settings/SettingsDialogShell.update-checking.dom.test.tsx
+++ b/packages/app/src/components/settings/SettingsDialogShell.update-checking.dom.test.tsx
@@ -86,6 +86,8 @@ const unsubscribe = () => () => {};
relaunchNow: () => Promise.resolve(),
checkNow: () => Promise.resolve(),
dismissWhatsNew: () => Promise.resolve(),
+ dismissDownloaded: () => Promise.resolve(),
+ setMode: () => Promise.resolve(),
},
state: {
query: () => Promise.resolve({ channel: 'latest', schemaIncompatibility: null }),
diff --git a/packages/app/src/locales/ar/messages.json b/packages/app/src/locales/ar/messages.json
index ba54fbc90..43c1608f6 100644
--- a/packages/app/src/locales/ar/messages.json
+++ b/packages/app/src/locales/ar/messages.json
@@ -862,6 +862,9 @@
"7C9JcA": [
"يخرج مسار مشروع OpenKnowledge في هذا الفرع من شجرة العمل. تم إنشاء شجرة العمل ولكن لم يتم فتحها."
],
+ "7Crqsa": [
+ "لا يتحقق OpenKnowledge من وجود تحديثات ولا ينزّلها من تلقاء نفسه. يظل زر «التحقق من التحديثات» متاحًا عندما تريد إصدارًا أحدث."
+ ],
"7FA2iI": ["تعذّرت قراءة التعليقات المنتظرة للإرسال — لم يُرسل شيء."],
"7FamGZ": ["الانتقال إلى سطر"],
"7Fkcej": ["+ إضافة ", ["addChildName"]],
@@ -921,6 +924,7 @@
"7l15X4": ["فشل"],
"7lFX_h": ["إعادة التوجيه الآن"],
"7m3Ade": ["التثبيتات:"],
+ "7mxVbK": ["تنزيل التحديثات وتثبيتها تلقائيًا"],
"7qRHf0": ["التثبيت لـ Claude Chat وCowork"],
"7sNhEz": ["اسم المستخدم"],
"7uBlRT": ["انسخ عنصر شجرة الملفات المركَّز عليه ليتمكن «لصق» من تكراره."],
@@ -3475,6 +3479,7 @@
"X7ShnN": ["فتح لوحة الوكلاء"],
"X8kjQX": ["أعد المصادقة مع GitHub"],
"X9VpsP": ["يجري تحميل محتويات المجلد"],
+ "XA9uvc": ["يتحقق OpenKnowledge من وجود تحديثات وينزّلها في الخلفية."],
"XAnapw": ["Git قاعدة الدمج"],
"XAyxsa": ["سحب فرع بعيد"],
"XBBZnv": ["هدف الرابط \"", ["shown"], "\" لا يشير إلى مستند موجود."],
@@ -3487,6 +3492,7 @@
"XJOV1Y": ["النشاط"],
"XK5cbh": ["تنقّل في سجل تنقّل OpenKnowledge إلى الأمام."],
"XNBGZw": ["لم تُرسل الرسالة: ", ["0"]],
+ "XN_sSd": ["التحديثات التلقائية"],
"XNdXMR": [
["dependent"],
" يحتاج إلى ",
@@ -4094,6 +4100,7 @@
" كل إضافة فيه، لا إضافة Open Knowledge وحدها، ويبقى كلاهما إلى أن تزيل Open Knowledge من هذا المشروع."
],
"c9-Pi9": [["source"], " · مصدر skills.sh"],
+ "c9C7DQ": ["تعذّر حفظ هذا الإعداد. حاول مرة أخرى."],
"cCd8Bs": ["قص"],
"cD3aew": [
"تحدث إعادة التضمين أثناء تشغيل عمليات البحث، لذا تبدأ التغطية من الصفر وتمتلئ من جديد."
diff --git a/packages/app/src/locales/ar/messages.po b/packages/app/src/locales/ar/messages.po
index d8968643b..1e17912d8 100644
--- a/packages/app/src/locales/ar/messages.po
+++ b/packages/app/src/locales/ar/messages.po
@@ -2508,6 +2508,10 @@ msgstr "تلقائي"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "يختار الوضع التلقائي منفذًا متاحًا في كل بدء تشغيل. اختر منفذًا ثابتًا للاحتفاظ بالعنوان نفسه عبر عمليات إعادة التشغيل."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "التحديثات التلقائية"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "التحديثات التلقائية غير متاحة حاليًا."
@@ -4657,6 +4661,10 @@ msgstr "تعذّر حفظ المفتاح — يرجى المحاولة مرة أ
msgid "Couldn't save the resolution for {filePath}."
msgstr "تعذّر حفظ الحل لـ {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "تعذّر حفظ هذا الإعداد. حاول مرة أخرى."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "تعذّر حفظ تفضيل السمة لديك."
@@ -5480,6 +5488,10 @@ msgstr "انقر نقرًا مزدوجًا للتحرير"
msgid "Download {0}"
msgstr "تنزيل {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "تنزيل التحديثات وتثبيتها تلقائيًا"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "تنزيل التطبيق"
@@ -10590,6 +10602,10 @@ msgstr "تحقق OpenKnowledge من {subject}"
msgid "OpenKnowledge checked the project"
msgstr "تحقق OpenKnowledge من المشروع"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "يتحقق OpenKnowledge من وجود تحديثات وينزّلها في الخلفية."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "لم يتمكن OpenKnowledge من العثور على هذا الوكيل على هذا الجهاز."
@@ -10638,6 +10654,10 @@ msgstr "لا يتعرّف OpenKnowledge على هذا الإدخال، ولا ي
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "لا يتعرّف OpenKnowledge على هذا الإدخال. تشغيله سيستبدله."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "لا يتحقق OpenKnowledge من وجود تحديثات ولا ينزّلها من تلقاء نفسه. يظل زر «التحقق من التحديثات» متاحًا عندما تريد إصدارًا أحدث."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "عدّل OpenKnowledge {subject}"
diff --git a/packages/app/src/locales/bn/messages.json b/packages/app/src/locales/bn/messages.json
index c7014373c..bdd6c917a 100644
--- a/packages/app/src/locales/bn/messages.json
+++ b/packages/app/src/locales/bn/messages.json
@@ -700,6 +700,9 @@
"7C9JcA": [
"এই ব্রাঞ্চের OpenKnowledge প্রজেক্ট পাথ ওয়ার্কট্রির বাইরে চলে যায়। ওয়ার্কট্রি তৈরি হয়েছে, কিন্তু খোলা হয়নি।"
],
+ "7Crqsa": [
+ "OpenKnowledge নিজে থেকে হালনাগাদ খোঁজে না বা ডাউনলোড করে না। নতুন সংস্করণ চাইলে \"হালনাগাদ দেখুন\" এখনও কাজ করে।"
+ ],
"7FA2iI": ["পাঠানোর অপেক্ষায় থাকা মন্তব্যগুলো পড়া যায়নি — কিছুই পাঠানো হয়নি।"],
"7FamGZ": ["লাইনে যান"],
"7Fkcej": ["+ ", ["addChildName"], " যোগ করুন"],
@@ -759,6 +762,7 @@
"7l15X4": ["ব্যর্থ"],
"7lFX_h": ["এখনই দিক পরিবর্তন করুন"],
"7m3Ade": ["ইনস্টল:"],
+ "7mxVbK": ["হালনাগাদ স্বয়ংক্রিয়ভাবে ডাউনলোড ও ইনস্টল করুন"],
"7qRHf0": ["Claude Chat ও Cowork-এর জন্য ইনস্টল করুন"],
"7sNhEz": ["ব্যবহারকারীর নাম"],
"7uBlRT": ["ফোকাস করা ফাইল-ট্রি আইটেমটি কপি করুন যাতে Paste সেটির প্রতিলিপি বানাতে পারে।"],
@@ -2918,6 +2922,7 @@
"X7ShnN": ["এজেন্ট প্যানেল খুলুন"],
"X8kjQX": ["GitHub-এর সঙ্গে আবার প্রমাণীকরণ করুন"],
"X9VpsP": ["ফোল্ডারের বিষয়বস্তু লোড হচ্ছে"],
+ "XA9uvc": ["OpenKnowledge পটভূমিতে হালনাগাদ খোঁজে এবং ডাউনলোড করে।"],
"XAnapw": ["Git মার্জ নিয়ম"],
"XAyxsa": ["রিমোট ব্রাঞ্চ চেক আউট করুন"],
"XBBZnv": ["লিংকের লক্ষ্য \"", ["shown"], "\" কোনো বিদ্যমান নথিকে নির্দেশ করে না।"],
@@ -2930,6 +2935,7 @@
"XJOV1Y": ["কার্যকলাপ"],
"XK5cbh": ["OpenKnowledge-এর নেভিগেশন ইতিহাসে সামনে যান।"],
"XNBGZw": ["বার্তা পাঠানো হয়নি: ", ["0"]],
+ "XN_sSd": ["স্বয়ংক্রিয় হালনাগাদ"],
"XNdXMR": [
["dependent"],
"-এর জন্য ",
@@ -3469,6 +3475,7 @@
" সেখানকার প্রতিটি এক্সটেনশন লোড করবে, শুধু Open Knowledge-এর নয়, এবং আপনি এই প্রকল্প থেকে Open Knowledge না সরানো পর্যন্ত দুটিই থেকে যাবে।"
],
"c9-Pi9": [["source"], " · skills.sh উৎস"],
+ "c9C7DQ": ["এই সেটিংটি সংরক্ষণ করা যায়নি। আবার চেষ্টা করুন।"],
"cCd8Bs": ["কাটুন"],
"cD3aew": ["অনুসন্ধান চলার সঙ্গে সঙ্গেই পুনরায় এমবেড হয়, তাই আওতা শূন্য থেকে আবার শুরু হয়ে ভরে ওঠে।"],
"cEoyWz": [["keyName"], "-এ আইটেম যোগ করুন"],
diff --git a/packages/app/src/locales/bn/messages.po b/packages/app/src/locales/bn/messages.po
index 92bc4d300..cb77c1f9e 100644
--- a/packages/app/src/locales/bn/messages.po
+++ b/packages/app/src/locales/bn/messages.po
@@ -2504,6 +2504,10 @@ msgstr "স্বয়ংক্রিয়"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "স্বয়ংক্রিয় প্রতিবার চালু হওয়ার সময় একটি ফাঁকা পোর্ট বেছে নেয়। পুনরায় চালু হওয়ার পরেও একই ঠিকানা রাখতে একটি নির্দিষ্ট পোর্ট বেছে নিন।"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "স্বয়ংক্রিয় হালনাগাদ"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "স্বয়ংক্রিয় হালনাগাদ এখন উপলব্ধ নেই।"
@@ -4653,6 +4657,10 @@ msgstr "কী সংরক্ষণ করা যায়নি — অনু
msgid "Couldn't save the resolution for {filePath}."
msgstr "{filePath}-এর মীমাংসা সংরক্ষণ করা যায়নি।"
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "এই সেটিংটি সংরক্ষণ করা যায়নি। আবার চেষ্টা করুন।"
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "আপনার থিম পছন্দ সংরক্ষণ করা যায়নি।"
@@ -5476,6 +5484,10 @@ msgstr "সম্পাদনা করতে ডাবল-ক্লিক ক
msgid "Download {0}"
msgstr "{0} ডাউনলোড করুন"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "হালনাগাদ স্বয়ংক্রিয়ভাবে ডাউনলোড ও ইনস্টল করুন"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "অ্যাপ ডাউনলোড করুন"
@@ -10586,6 +10598,10 @@ msgstr "OpenKnowledge {subject} পরীক্ষা করেছে"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge প্রকল্প পরীক্ষা করেছে"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge পটভূমিতে হালনাগাদ খোঁজে এবং ডাউনলোড করে।"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge এই মেশিনে এই এজেন্টটি খুঁজে পায়নি।"
@@ -10634,6 +10650,10 @@ msgstr "OpenKnowledge এই এন্ট্রিটি চিনতে পা
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge এই এন্ট্রিটি চিনতে পারছে না। এটি চালু করলে এটি প্রতিস্থাপিত হবে।"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge নিজে থেকে হালনাগাদ খোঁজে না বা ডাউনলোড করে না। নতুন সংস্করণ চাইলে \"হালনাগাদ দেখুন\" এখনও কাজ করে।"
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge {subject} সম্পাদনা করেছে"
diff --git a/packages/app/src/locales/en/messages.json b/packages/app/src/locales/en/messages.json
index 4ccda6288..effc19a2a 100644
--- a/packages/app/src/locales/en/messages.json
+++ b/packages/app/src/locales/en/messages.json
@@ -719,6 +719,9 @@
"7C9JcA": [
"The OpenKnowledge project path on this branch leaves the worktree. The worktree was created but not opened."
],
+ "7Crqsa": [
+ "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+ ],
"7FA2iI": ["Couldn't read the comments waiting to send — nothing was sent."],
"7FamGZ": ["Go to line"],
"7Fkcej": ["+ Add ", ["addChildName"]],
@@ -784,6 +787,7 @@
"7l15X4": ["failed"],
"7lFX_h": ["Steer now"],
"7m3Ade": ["installs:"],
+ "7mxVbK": ["Download and install updates automatically"],
"7qRHf0": ["Install for Claude Chat & Cowork"],
"7sNhEz": ["Username"],
"7uBlRT": ["Copy the focused file-tree item so Paste can duplicate it."],
@@ -3007,6 +3011,7 @@
"X7ShnN": ["Open agents panel"],
"X8kjQX": ["Re-authenticate with GitHub"],
"X9VpsP": ["Loading folder contents"],
+ "XA9uvc": ["OpenKnowledge checks for and downloads updates in the background."],
"XAnapw": ["Git merge rule"],
"XAyxsa": ["Check out remote branch"],
"XBBZnv": ["Link target \"", ["shown"], "\" does not resolve to an existing document."],
@@ -3019,6 +3024,7 @@
"XJOV1Y": ["Activity"],
"XK5cbh": ["Traverse OpenKnowledge navigation history forward."],
"XNBGZw": ["Message not sent: ", ["0"]],
+ "XN_sSd": ["Automatic updates"],
"XNdXMR": [
["dependent"],
" needs ",
@@ -3567,6 +3573,7 @@
" will load every extension in it, not only Open Knowledge's — and both stay until you remove Open Knowledge from this project."
],
"c9-Pi9": [["source"], " · skills.sh source"],
+ "c9C7DQ": ["Couldn't save this setting. Try again."],
"cCd8Bs": ["Cut"],
"cD3aew": ["Re-embedding happens as searches run, so coverage restarts at zero and refills."],
"cEoyWz": ["Add item to ", ["keyName"]],
diff --git a/packages/app/src/locales/en/messages.po b/packages/app/src/locales/en/messages.po
index fe2bc1061..1c2a14a3c 100644
--- a/packages/app/src/locales/en/messages.po
+++ b/packages/app/src/locales/en/messages.po
@@ -2508,6 +2508,10 @@ msgstr "Automatic"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Automatic updates"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "Automatic updates are not available right now."
@@ -4657,6 +4661,10 @@ msgstr "Couldn't save the key — please try again."
msgid "Couldn't save the resolution for {filePath}."
msgstr "Couldn't save the resolution for {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "Couldn't save this setting. Try again."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "Couldn't save your theme preference."
@@ -5480,6 +5488,10 @@ msgstr "Double-click to edit"
msgid "Download {0}"
msgstr "Download {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Download and install updates automatically"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Download app"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge checked {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge checked the project"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge checks for and downloads updates in the background."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge could not find this agent on this machine."
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge does not recognize this entry, and cannot safely replace i
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge does not recognize this entry. Turning it on replaces it."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge edited {subject}"
diff --git a/packages/app/src/locales/es/messages.json b/packages/app/src/locales/es/messages.json
index e1ad29f47..23cf90f66 100644
--- a/packages/app/src/locales/es/messages.json
+++ b/packages/app/src/locales/es/messages.json
@@ -849,6 +849,9 @@
"7C9JcA": [
"La ruta del proyecto de OpenKnowledge en esta rama sale del worktree. El worktree se creó, pero no se abrió."
],
+ "7Crqsa": [
+ "OpenKnowledge no busca ni descarga actualizaciones por sí solo. Buscar actualizaciones sigue funcionando cuando quieras una versión más reciente."
+ ],
"7FA2iI": ["No se pudieron leer los comentarios pendientes de envío; no se envió nada."],
"7FamGZ": ["Ir a la línea"],
"7Fkcej": ["+ Añadir ", ["addChildName"]],
@@ -914,6 +917,7 @@
"7l15X4": ["falló"],
"7lFX_h": ["Redirigir ahora"],
"7m3Ade": ["instalaciones:"],
+ "7mxVbK": ["Descargar e instalar actualizaciones automáticamente"],
"7qRHf0": ["Instalar para Claude Chat y Cowork"],
"7sNhEz": ["Nombre de usuario"],
"7uBlRT": ["Copia el elemento enfocado del árbol de archivos para que Pegar pueda duplicarlo."],
@@ -3482,6 +3486,7 @@
"X7ShnN": ["Abrir el panel de agentes"],
"X8kjQX": ["Volver a autenticarse con GitHub"],
"X9VpsP": ["Cargando el contenido de la carpeta"],
+ "XA9uvc": ["OpenKnowledge busca y descarga actualizaciones en segundo plano."],
"XAnapw": ["Regla de combinación de Git"],
"XAyxsa": ["Extraer rama remota"],
"XBBZnv": ["El destino del enlace «", ["shown"], "» no corresponde a un documento existente."],
@@ -3494,6 +3499,7 @@
"XJOV1Y": ["Actividad"],
"XK5cbh": ["Avanza por el historial de navegación de OpenKnowledge."],
"XNBGZw": ["No se envió el mensaje: ", ["0"]],
+ "XN_sSd": ["Actualizaciones automáticas"],
"XNdXMR": [
["dependent"],
" necesita ",
@@ -4117,6 +4123,7 @@
" cargará todas las extensiones que haya en ella, no solo la de Open Knowledge, y ambas permanecen hasta que quites Open Knowledge de este proyecto."
],
"c9-Pi9": [["source"], " · fuente de skills.sh"],
+ "c9C7DQ": ["No se pudo guardar este ajuste. Inténtalo de nuevo."],
"cCd8Bs": ["Cortar"],
"cD3aew": [
"Los embeddings se recalculan a medida que se hacen búsquedas, así que la cobertura empieza de cero y se vuelve a llenar."
diff --git a/packages/app/src/locales/es/messages.po b/packages/app/src/locales/es/messages.po
index 525201379..27d26f969 100644
--- a/packages/app/src/locales/es/messages.po
+++ b/packages/app/src/locales/es/messages.po
@@ -2508,6 +2508,10 @@ msgstr "Automático"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "El modo automático elige un puerto libre en cada inicio. Elige un puerto fijo para mantener la misma dirección entre reinicios."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Actualizaciones automáticas"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "Las actualizaciones automáticas no están disponibles en este momento."
@@ -4657,6 +4661,10 @@ msgstr "No se pudo guardar la clave; inténtalo de nuevo."
msgid "Couldn't save the resolution for {filePath}."
msgstr "No se pudo guardar la resolución de {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "No se pudo guardar este ajuste. Inténtalo de nuevo."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "No se pudo guardar tu preferencia de tema."
@@ -5480,6 +5488,10 @@ msgstr "Haz doble clic para editar"
msgid "Download {0}"
msgstr "Descargar {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Descargar e instalar actualizaciones automáticamente"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Descargar la aplicación"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge revisó {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge revisó el proyecto"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge busca y descarga actualizaciones en segundo plano."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge no encontró este agente en este equipo."
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge no reconoce esta entrada y no puede sustituirla de forma s
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge no reconoce esta entrada. Al activarla, se sustituirá."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge no busca ni descarga actualizaciones por sí solo. Buscar actualizaciones sigue funcionando cuando quieras una versión más reciente."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge editó {subject}"
diff --git a/packages/app/src/locales/fr/messages.json b/packages/app/src/locales/fr/messages.json
index 786d8b6be..3d4f00293 100644
--- a/packages/app/src/locales/fr/messages.json
+++ b/packages/app/src/locales/fr/messages.json
@@ -878,6 +878,9 @@
"7C9JcA": [
"Le chemin du projet OpenKnowledge de cette branche sort du worktree. Le worktree a été créé, mais pas ouvert."
],
+ "7Crqsa": [
+ "OpenKnowledge ne recherche ni ne télécharge les mises à jour de lui-même. Rechercher les mises à jour reste disponible lorsque vous voulez une version plus récente."
+ ],
"7FA2iI": ["Impossible de lire les commentaires en attente d'envoi — rien n'a été envoyé."],
"7FamGZ": ["Aller à la ligne"],
"7Fkcej": ["+ Ajouter ", ["addChildName"]],
@@ -945,6 +948,7 @@
"7l15X4": ["échec"],
"7lFX_h": ["Réorienter maintenant"],
"7m3Ade": ["installations :"],
+ "7mxVbK": ["Télécharger et installer les mises à jour automatiquement"],
"7qRHf0": ["Installer pour Claude Chat et Cowork"],
"7sNhEz": ["Nom d'utilisateur"],
"7uBlRT": [
@@ -3534,6 +3538,7 @@
"X7ShnN": ["Ouvrir le panneau des agents"],
"X8kjQX": ["Se réauthentifier auprès de GitHub"],
"X9VpsP": ["Chargement du contenu du dossier"],
+ "XA9uvc": ["OpenKnowledge recherche et télécharge les mises à jour en arrière-plan."],
"XAnapw": ["Règle de fusion Git"],
"XAyxsa": ["Extraire une branche distante"],
"XBBZnv": ["La cible du lien « ", ["shown"], " » ne correspond à aucun document existant."],
@@ -3546,6 +3551,7 @@
"XJOV1Y": ["Activité"],
"XK5cbh": ["Avance dans l'historique de navigation d'OpenKnowledge."],
"XNBGZw": ["Message non envoyé : ", ["0"]],
+ "XN_sSd": ["Mises à jour automatiques"],
"XNdXMR": [
["dependent"],
" a besoin de ",
@@ -4174,6 +4180,7 @@
" chargera chaque extension qui s'y trouve, pas seulement celle d'Open Knowledge, et les deux subsistent jusqu'à ce que vous retiriez Open Knowledge de ce projet."
],
"c9-Pi9": [["source"], " · source skills.sh"],
+ "c9C7DQ": ["Impossible d'enregistrer ce paramètre. Réessayez."],
"cCd8Bs": ["Couper"],
"cD3aew": [
"Le recalcul des embeddings se fait au fil des recherches, donc la couverture repart de zéro et se remplit peu à peu."
diff --git a/packages/app/src/locales/fr/messages.po b/packages/app/src/locales/fr/messages.po
index 9375850b6..935f0eaf7 100644
--- a/packages/app/src/locales/fr/messages.po
+++ b/packages/app/src/locales/fr/messages.po
@@ -2508,6 +2508,10 @@ msgstr "Automatique"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "Le mode automatique choisit un port libre à chaque démarrage. Choisissez un port fixe pour conserver la même adresse d'un redémarrage à l'autre."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Mises à jour automatiques"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "Les mises à jour automatiques ne sont pas disponibles pour le moment."
@@ -4657,6 +4661,10 @@ msgstr "Impossible d'enregistrer la clé — veuillez réessayer."
msgid "Couldn't save the resolution for {filePath}."
msgstr "Impossible d'enregistrer la résolution pour {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "Impossible d'enregistrer ce paramètre. Réessayez."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "Impossible d'enregistrer votre préférence de thème."
@@ -5480,6 +5488,10 @@ msgstr "Double-cliquez pour modifier"
msgid "Download {0}"
msgstr "Télécharger {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Télécharger et installer les mises à jour automatiquement"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Télécharger l’application"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge a vérifié {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge a vérifié le projet"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge recherche et télécharge les mises à jour en arrière-plan."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge n'a pas trouvé cet agent sur cette machine."
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge ne reconnaît pas cette entrée et ne peut pas la remplace
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge ne reconnaît pas cette entrée. L'activer la remplacera."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge ne recherche ni ne télécharge les mises à jour de lui-même. Rechercher les mises à jour reste disponible lorsque vous voulez une version plus récente."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge a modifié {subject}"
diff --git a/packages/app/src/locales/hi/messages.json b/packages/app/src/locales/hi/messages.json
index 0181c11d3..dd763d58f 100644
--- a/packages/app/src/locales/hi/messages.json
+++ b/packages/app/src/locales/hi/messages.json
@@ -705,6 +705,9 @@
"7C9JcA": [
"इस ब्रांच पर OpenKnowledge प्रोजेक्ट का पथ वर्कट्री से बाहर जाता है। वर्कट्री बनाई गई, लेकिन खोली नहीं गई।"
],
+ "7Crqsa": [
+ "OpenKnowledge अपने आप अपडेट नहीं देखता या डाउनलोड नहीं करता। नया संस्करण चाहिए तो \"अपडेट देखें\" अब भी काम करता है।"
+ ],
"7FA2iI": ["भेजे जाने की प्रतीक्षा में मौजूद टिप्पणियाँ नहीं पढ़ी जा सकीं — कुछ भी नहीं भेजा गया।"],
"7FamGZ": ["पंक्ति पर जाएँ"],
"7Fkcej": ["+ ", ["addChildName"], " जोड़ें"],
@@ -764,6 +767,7 @@
"7l15X4": ["विफल"],
"7lFX_h": ["अभी दिशा बदलें"],
"7m3Ade": ["इंस्टॉल:"],
+ "7mxVbK": ["अपडेट अपने-आप डाउनलोड और इंस्टॉल करें"],
"7qRHf0": ["Claude Chat और Cowork के लिए इंस्टॉल करें"],
"7sNhEz": ["उपयोगकर्ता नाम"],
"7uBlRT": ["फ़ाइल-ट्री के फ़ोकस किए गए आइटम को कॉपी करें ताकि Paste उसकी नकल बना सके।"],
@@ -2917,6 +2921,7 @@
"X7ShnN": ["एजेंट पैनल खोलें"],
"X8kjQX": ["GitHub के साथ फिर से प्रमाणित करें"],
"X9VpsP": ["फ़ोल्डर की सामग्री लोड हो रही है"],
+ "XA9uvc": ["OpenKnowledge पृष्ठभूमि में अपडेट देखता और डाउनलोड करता है।"],
"XAnapw": ["Git मर्ज नियम"],
"XAyxsa": ["रिमोट ब्रांच चेक आउट करें"],
"XBBZnv": ["लिंक लक्ष्य \"", ["shown"], "\" किसी मौजूदा दस्तावेज़ पर हल नहीं होता।"],
@@ -2929,6 +2934,7 @@
"XJOV1Y": ["गतिविधि"],
"XK5cbh": ["OpenKnowledge के नेविगेशन इतिहास में आगे जाएँ।"],
"XNBGZw": ["संदेश नहीं भेजा गया: ", ["0"]],
+ "XN_sSd": ["स्वचालित अपडेट"],
"XNdXMR": [
["dependent"],
" को ",
@@ -3470,6 +3476,7 @@
" उसमें मौजूद हर एक्सटेंशन लोड करेगा, केवल Open Knowledge का नहीं, और जब तक आप इस प्रोजेक्ट से Open Knowledge नहीं हटाते, दोनों बने रहते हैं।"
],
"c9-Pi9": [["source"], " · skills.sh स्रोत"],
+ "c9C7DQ": ["यह सेटिंग सहेजी नहीं जा सकी। फिर से कोशिश करें।"],
"cCd8Bs": ["काटें"],
"cD3aew": ["फिर से एम्बेड करना खोज चलने के साथ होता है, इसलिए कवरेज शून्य से फिर शुरू होकर भरता है।"],
"cEoyWz": [["keyName"], " में आइटम जोड़ें"],
diff --git a/packages/app/src/locales/hi/messages.po b/packages/app/src/locales/hi/messages.po
index f2e418859..b46618c96 100644
--- a/packages/app/src/locales/hi/messages.po
+++ b/packages/app/src/locales/hi/messages.po
@@ -2504,6 +2504,10 @@ msgstr "स्वचालित"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "स्वचालित हर बार प्रारंभ पर एक मुक्त port चुनता है। पुनः प्रारंभ के बीच समान पता बनाए रखने के लिए एक निश्चित port चुनें।"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "स्वचालित अपडेट"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "स्वचालित अपडेट अभी उपलब्ध नहीं हैं।"
@@ -4653,6 +4657,10 @@ msgstr "कुंजी नहीं सहेजी जा सकी — कृ
msgid "Couldn't save the resolution for {filePath}."
msgstr "{filePath} का समाधान नहीं सहेजा जा सका।"
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "यह सेटिंग सहेजी नहीं जा सकी। फिर से कोशिश करें।"
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "आपकी थीम प्राथमिकता सहेजी नहीं जा सकी।"
@@ -5476,6 +5484,10 @@ msgstr "संपादित करने के लिए डबल-क्ल
msgid "Download {0}"
msgstr "{0} डाउनलोड करें"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "अपडेट अपने-आप डाउनलोड और इंस्टॉल करें"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "ऐप डाउनलोड करें"
@@ -10586,6 +10598,10 @@ msgstr "OpenKnowledge ने {subject} की जाँच की"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge ने प्रोजेक्ट की जाँच की"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge पृष्ठभूमि में अपडेट देखता और डाउनलोड करता है।"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge को इस मशीन पर यह एजेंट नहीं मिला।"
@@ -10634,6 +10650,10 @@ msgstr "OpenKnowledge इस प्रविष्टि को नहीं प
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge इस प्रविष्टि को नहीं पहचानता। इसे चालू करने पर यह बदल दी जाएगी।"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge अपने आप अपडेट नहीं देखता या डाउनलोड नहीं करता। नया संस्करण चाहिए तो \"अपडेट देखें\" अब भी काम करता है।"
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge ने {subject} को संपादित किया"
diff --git a/packages/app/src/locales/id/messages.json b/packages/app/src/locales/id/messages.json
index 23069bc3b..526d71816 100644
--- a/packages/app/src/locales/id/messages.json
+++ b/packages/app/src/locales/id/messages.json
@@ -730,6 +730,9 @@
"7C9JcA": [
"Jalur proyek OpenKnowledge pada branch ini keluar dari worktree. Worktree dibuat, tetapi tidak dibuka."
],
+ "7Crqsa": [
+ "OpenKnowledge tidak memeriksa atau mengunduh pembaruan dengan sendirinya. Periksa pembaruan tetap berfungsi saat Anda menginginkan versi yang lebih baru."
+ ],
"7FA2iI": ["Komentar yang menunggu dikirim tidak bisa dibaca — tidak ada yang dikirim."],
"7FamGZ": ["Ke baris"],
"7Fkcej": ["+ Tambah ", ["addChildName"]],
@@ -793,6 +796,7 @@
"7l15X4": ["gagal"],
"7lFX_h": ["Alihkan sekarang"],
"7m3Ade": ["pemasangan:"],
+ "7mxVbK": ["Unduh dan pasang pembaruan secara otomatis"],
"7qRHf0": ["Pasang untuk Claude Chat & Cowork"],
"7sNhEz": ["Nama pengguna"],
"7uBlRT": ["Menyalin item pohon berkas yang sedang difokus agar Tempel bisa menggandakannya."],
@@ -3031,6 +3035,7 @@
"X7ShnN": ["Buka panel agen"],
"X8kjQX": ["Autentikasi ulang dengan GitHub"],
"X9VpsP": ["Memuat isi folder"],
+ "XA9uvc": ["OpenKnowledge memeriksa dan mengunduh pembaruan di latar belakang."],
"XAnapw": ["Git aturan penggabungan"],
"XAyxsa": ["Ambil cabang remote"],
"XBBZnv": ["Target tautan \"", ["shown"], "\" tidak merujuk ke dokumen yang ada."],
@@ -3043,6 +3048,7 @@
"XJOV1Y": ["Aktivitas"],
"XK5cbh": ["Menyusuri riwayat navigasi OpenKnowledge ke depan."],
"XNBGZw": ["Pesan tidak terkirim: ", ["0"]],
+ "XN_sSd": ["Pembaruan otomatis"],
"XNdXMR": [
["dependent"],
" memerlukan ",
@@ -3596,6 +3602,7 @@
" akan memuat setiap ekstensi di dalamnya, bukan hanya milik Open Knowledge, dan keduanya tetap ada sampai Anda menghapus Open Knowledge dari proyek ini."
],
"c9-Pi9": [["source"], " · sumber skills.sh"],
+ "c9C7DQ": ["Pengaturan ini tidak dapat disimpan. Coba lagi."],
"cCd8Bs": ["Potong"],
"cD3aew": [
"Embedding dihitung ulang seiring pencarian berjalan, jadi cakupannya dimulai lagi dari nol lalu terisi kembali."
diff --git a/packages/app/src/locales/id/messages.po b/packages/app/src/locales/id/messages.po
index 02f04b607..83a01f8ba 100644
--- a/packages/app/src/locales/id/messages.po
+++ b/packages/app/src/locales/id/messages.po
@@ -2504,6 +2504,10 @@ msgstr "Otomatis"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "Otomatis memilih port bebas setiap kali dimulai. Pilih port tetap untuk mempertahankan alamat yang sama di seluruh mulai ulang."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Pembaruan otomatis"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "Pembaruan otomatis saat ini tidak tersedia."
@@ -4653,6 +4657,10 @@ msgstr "Kuncinya tidak bisa disimpan — silakan coba lagi."
msgid "Couldn't save the resolution for {filePath}."
msgstr "Penyelesaian untuk {filePath} tidak bisa disimpan."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "Pengaturan ini tidak dapat disimpan. Coba lagi."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "Tidak dapat menyimpan preferensi tema Anda."
@@ -5476,6 +5484,10 @@ msgstr "Klik dua kali untuk menyunting"
msgid "Download {0}"
msgstr "Unduh {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Unduh dan pasang pembaruan secara otomatis"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Unduh aplikasi"
@@ -10586,6 +10598,10 @@ msgstr "OpenKnowledge memeriksa {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge memeriksa proyek"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge memeriksa dan mengunduh pembaruan di latar belakang."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge tidak menemukan agen ini di mesin ini."
@@ -10634,6 +10650,10 @@ msgstr "OpenKnowledge tidak mengenali entri ini, dan tidak dapat menggantinya de
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge tidak mengenali entri ini. Mengaktifkannya akan menggantinya."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge tidak memeriksa atau mengunduh pembaruan dengan sendirinya. Periksa pembaruan tetap berfungsi saat Anda menginginkan versi yang lebih baru."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge menyunting {subject}"
diff --git a/packages/app/src/locales/ko/messages.json b/packages/app/src/locales/ko/messages.json
index 9fe8d6742..890e45119 100644
--- a/packages/app/src/locales/ko/messages.json
+++ b/packages/app/src/locales/ko/messages.json
@@ -701,6 +701,9 @@
"7C9JcA": [
"이 브랜치의 OpenKnowledge 프로젝트 경로가 워크트리 밖으로 나갑니다. 워크트리는 생성되었지만 열리지 않았습니다."
],
+ "7Crqsa": [
+ "OpenKnowledge가 스스로 업데이트를 확인하거나 다운로드하지 않습니다. 새 버전이 필요하면 업데이트 확인을 계속 사용할 수 있습니다."
+ ],
"7FA2iI": ["전송 대기 댓글을 읽지 못했습니다. 전송된 댓글 없음."],
"7FamGZ": ["줄로 이동"],
"7Fkcej": ["+ ", ["addChildName"], " 추가"],
@@ -764,6 +767,7 @@
"7l15X4": ["실패"],
"7lFX_h": ["지금 조정"],
"7m3Ade": ["설치 항목:"],
+ "7mxVbK": ["업데이트를 자동으로 다운로드하고 설치"],
"7qRHf0": ["Claude Chat 및 Cowork용 설치"],
"7sNhEz": ["사용자 이름"],
"7uBlRT": ["붙여넣기로 복제할 수 있도록 파일 트리에서 포커스된 항목을 복사합니다."],
@@ -2893,6 +2897,7 @@
"X7ShnN": ["에이전트 패널 열기"],
"X8kjQX": ["GitHub 재인증"],
"X9VpsP": ["폴더 내용 불러오는 중"],
+ "XA9uvc": ["OpenKnowledge가 백그라운드에서 업데이트를 확인하고 다운로드합니다."],
"XAnapw": ["Git 병합 규칙"],
"XAyxsa": ["원격 브랜치 체크아웃"],
"XBBZnv": ["링크 대상 \"", ["shown"], "\"이 존재하는 문서로 확인되지 않습니다."],
@@ -2905,6 +2910,7 @@
"XJOV1Y": ["활동"],
"XK5cbh": ["OpenKnowledge 탐색 기록을 앞으로 이동합니다."],
"XNBGZw": ["메시지 전송 실패: ", ["0"]],
+ "XN_sSd": ["자동 업데이트"],
"XNdXMR": [
["dependent"],
"에는 ",
@@ -3432,6 +3438,7 @@
"은(는) Open Knowledge의 것뿐 아니라 그 폴더의 모든 확장을 로드하며, 이 프로젝트에서 Open Knowledge를 제거할 때까지 둘 다 유지됩니다."
],
"c9-Pi9": [["source"], " · skills.sh 소스"],
+ "c9C7DQ": ["이 설정을 저장하지 못했습니다. 다시 시도하세요."],
"cCd8Bs": ["잘라내기"],
"cD3aew": ["검색을 실행하면 다시 임베딩되므로, 적용 범위가 0부터 다시 채워집니다."],
"cEoyWz": [["keyName"], "에 항목 추가"],
diff --git a/packages/app/src/locales/ko/messages.po b/packages/app/src/locales/ko/messages.po
index b581874ab..5a0510722 100644
--- a/packages/app/src/locales/ko/messages.po
+++ b/packages/app/src/locales/ko/messages.po
@@ -2508,6 +2508,10 @@ msgstr "자동"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "자동을 선택하면 시작할 때마다 사용 가능한 포트를 고릅니다. 재시작해도 같은 주소를 유지하려면 고정 포트를 선택하세요."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "자동 업데이트"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "지금은 자동 업데이트를 사용할 수 없습니다."
@@ -4657,6 +4661,10 @@ msgstr "키를 저장하지 못했습니다. 다시 시도합니다."
msgid "Couldn't save the resolution for {filePath}."
msgstr "{filePath}의 해결 결과를 저장하지 못했습니다."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "이 설정을 저장하지 못했습니다. 다시 시도하세요."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "테마 설정을 저장하지 못했습니다."
@@ -5480,6 +5488,10 @@ msgstr "편집하려면 두 번 클릭"
msgid "Download {0}"
msgstr "{0} 다운로드"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "업데이트를 자동으로 다운로드하고 설치"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "앱 다운로드"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge에서 {subject} 확인"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge에서 프로젝트 확인"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge가 백그라운드에서 업데이트를 확인하고 다운로드합니다."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge가 이 컴퓨터에서 이 에이전트를 찾지 못했습니다."
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge가 이 항목을 인식하지 못하며, 이 파일 형식
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge가 이 항목을 인식하지 못합니다. 켜면 이 항목을 대체합니다."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge가 스스로 업데이트를 확인하거나 다운로드하지 않습니다. 새 버전이 필요하면 업데이트 확인을 계속 사용할 수 있습니다."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge에서 {subject} 편집"
diff --git a/packages/app/src/locales/pl/messages.json b/packages/app/src/locales/pl/messages.json
index 95d92f968..fdd4c9b5f 100644
--- a/packages/app/src/locales/pl/messages.json
+++ b/packages/app/src/locales/pl/messages.json
@@ -886,6 +886,9 @@
"7C9JcA": [
"Ścieżka projektu OpenKnowledge na tej gałęzi prowadzi poza worktree. Worktree został utworzony, ale nie otwarty."
],
+ "7Crqsa": [
+ "OpenKnowledge nie sprawdza ani nie pobiera aktualizacji samodzielnie. Przycisk Sprawdź aktualizacje nadal działa, gdy chcesz nowszą wersję."
+ ],
"7FA2iI": [
"Nie udało się odczytać komentarzy oczekujących na wysłanie — nic nie zostało wysłane."
],
@@ -953,6 +956,7 @@
"7l15X4": ["nieudane"],
"7lFX_h": ["Skieruj teraz"],
"7m3Ade": ["instalacje:"],
+ "7mxVbK": ["Pobieraj i instaluj aktualizacje automatycznie"],
"7qRHf0": ["Zainstaluj dla Claude Chat i Cowork"],
"7sNhEz": ["Nazwa użytkownika"],
"7uBlRT": ["Skopiuj zaznaczony element drzewa plików, aby dało się go potem wkleić."],
@@ -3563,6 +3567,7 @@
"X7ShnN": ["Otwórz panel agentów"],
"X8kjQX": ["Uwierzytelnij się ponownie z GitHub"],
"X9VpsP": ["Ładowanie zawartości folderu"],
+ "XA9uvc": ["OpenKnowledge sprawdza i pobiera aktualizacje w tle."],
"XAnapw": ["Reguła scalania Gita"],
"XAyxsa": ["Przełącz zdalną gałąź"],
"XBBZnv": ["Cel linku „", ["shown"], "” nie wskazuje na istniejący dokument."],
@@ -3575,6 +3580,7 @@
"XJOV1Y": ["Aktywność"],
"XK5cbh": ["Przechodź do przodu po historii nawigacji OpenKnowledge."],
"XNBGZw": ["Wiadomość nie wysłana: ", ["0"]],
+ "XN_sSd": ["Automatyczne aktualizacje"],
"XNdXMR": [
["dependent"],
" wymaga ",
@@ -4190,6 +4196,7 @@
" wczyta wszystkie rozszerzenia w nim, nie tylko rozszerzenia Open Knowledge — i oba pozostają, dopóki nie usuniesz Open Knowledge z tego projektu."
],
"c9-Pi9": [["source"], " · źródło skills.sh"],
+ "c9C7DQ": ["Nie udało się zapisać tego ustawienia. Spróbuj ponownie."],
"cCd8Bs": ["Wytnij"],
"cD3aew": [
"Ponowne osadzanie odbywa się podczas wyszukiwania, więc pokrycie zaczyna się od zera i stopniowo się uzupełnia."
diff --git a/packages/app/src/locales/pl/messages.po b/packages/app/src/locales/pl/messages.po
index 8ce311453..46a1e5fcb 100644
--- a/packages/app/src/locales/pl/messages.po
+++ b/packages/app/src/locales/pl/messages.po
@@ -2508,6 +2508,10 @@ msgstr "Automatycznie"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "Tryb automatyczny przy każdym uruchomieniu wybiera wolny port. Wybierz stały port, żeby adres był taki sam po restartach."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Automatyczne aktualizacje"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "Automatyczne aktualizacje są teraz niedostępne."
@@ -4657,6 +4661,10 @@ msgstr "Nie udało się zapisać klucza — spróbuj ponownie."
msgid "Couldn't save the resolution for {filePath}."
msgstr "Nie udało się zapisać rozwiązania dla {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "Nie udało się zapisać tego ustawienia. Spróbuj ponownie."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "Nie udało się zapisać preferencji motywu."
@@ -5480,6 +5488,10 @@ msgstr "Kliknij dwukrotnie, aby edytować"
msgid "Download {0}"
msgstr "Pobierz {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Pobieraj i instaluj aktualizacje automatycznie"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Pobierz aplikację"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge sprawdziło {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge sprawdziło projekt"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge sprawdza i pobiera aktualizacje w tle."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge nie znalazło tego agenta na tym komputerze."
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge nie rozpoznaje tego wpisu i nie może go bezpiecznie zast
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge nie rozpoznaje tego wpisu. Włączenie go spowoduje jego zastąpienie."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge nie sprawdza ani nie pobiera aktualizacji samodzielnie. Przycisk Sprawdź aktualizacje nadal działa, gdy chcesz nowszą wersję."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge edytowało {subject}"
diff --git a/packages/app/src/locales/pseudo/messages.json b/packages/app/src/locales/pseudo/messages.json
index 8b34e6bfd..714a19a1c 100644
--- a/packages/app/src/locales/pseudo/messages.json
+++ b/packages/app/src/locales/pseudo/messages.json
@@ -719,6 +719,9 @@
"7C9JcA": [
"Ţĥē ŌƥēńĶńōŵĺēďĝē ƥŕōĴēćţ ƥàţĥ ōń ţĥĩś ƀŕàńćĥ ĺēàvēś ţĥē ŵōŕķţŕēē. Ţĥē ŵōŕķţŕēē ŵàś ćŕēàţēď ƀũţ ńōţ ōƥēńēď."
],
+ "7Crqsa": [
+ "ŌƥēńĶńōŵĺēďĝē ďōēśń'ţ ćĥēćķ ƒōŕ ōŕ ďōŵńĺōàď ũƥďàţēś ōń ĩţś ōŵń. Ćĥēćķ ƒōŕ ũƥďàţēś śţĩĺĺ ŵōŕķś ŵĥēń ŷōũ ŵàńţ à ńēŵēŕ vēŕśĩōń."
+ ],
"7FA2iI": ["Ćōũĺďń'ţ ŕēàď ţĥē ćōḿḿēńţś ŵàĩţĩńĝ ţō śēńď — ńōţĥĩńĝ ŵàś śēńţ."],
"7FamGZ": ["Ĝō ţō ĺĩńē"],
"7Fkcej": ["+ Àďď ", ["addChildName"]],
@@ -784,6 +787,7 @@
"7l15X4": ["ƒàĩĺēď"],
"7lFX_h": ["Śţēēŕ ńōŵ"],
"7m3Ade": ["ĩńśţàĺĺś:"],
+ "7mxVbK": ["Ďōŵńĺōàď àńď ĩńśţàĺĺ ũƥďàţēś àũţōḿàţĩćàĺĺŷ"],
"7qRHf0": ["Ĩńśţàĺĺ ƒōŕ Ćĺàũďē Ćĥàţ & Ćōŵōŕķ"],
"7sNhEz": ["Ũśēŕńàḿē"],
"7uBlRT": ["Ćōƥŷ ţĥē ƒōćũśēď ƒĩĺē-ţŕēē ĩţēḿ śō Ƥàśţē ćàń ďũƥĺĩćàţē ĩţ."],
@@ -3007,6 +3011,7 @@
"X7ShnN": ["Ōƥēń àĝēńţś ƥàńēĺ"],
"X8kjQX": ["Ŕē-àũţĥēńţĩćàţē ŵĩţĥ ĜĩţĤũƀ"],
"X9VpsP": ["Ĺōàďĩńĝ ƒōĺďēŕ ćōńţēńţś"],
+ "XA9uvc": ["ŌƥēńĶńōŵĺēďĝē ćĥēćķś ƒōŕ àńď ďōŵńĺōàďś ũƥďàţēś ĩń ţĥē ƀàćķĝŕōũńď."],
"XAnapw": ["Ĝĩţ ḿēŕĝē ŕũĺē"],
"XAyxsa": ["Ćĥēćķ ōũţ ŕēḿōţē ƀŕàńćĥ"],
"XBBZnv": ["Ĺĩńķ ţàŕĝēţ \"", ["shown"], "\" ďōēś ńōţ ŕēśōĺvē ţō àń ēxĩśţĩńĝ ďōćũḿēńţ."],
@@ -3019,6 +3024,7 @@
"XJOV1Y": ["Àćţĩvĩţŷ"],
"XK5cbh": ["Ţŕàvēŕśē ŌƥēńĶńōŵĺēďĝē ńàvĩĝàţĩōń ĥĩśţōŕŷ ƒōŕŵàŕď."],
"XNBGZw": ["Ḿēśśàĝē ńōţ śēńţ: ", ["0"]],
+ "XN_sSd": ["Àũţōḿàţĩć ũƥďàţēś"],
"XNdXMR": [
["dependent"],
" ńēēďś ",
@@ -3567,6 +3573,7 @@
" ŵĩĺĺ ĺōàď ēvēŕŷ ēxţēńśĩōń ĩń ĩţ, ńōţ ōńĺŷ Ōƥēń Ķńōŵĺēďĝē'ś — àńď ƀōţĥ śţàŷ ũńţĩĺ ŷōũ ŕēḿōvē Ōƥēń Ķńōŵĺēďĝē ƒŕōḿ ţĥĩś ƥŕōĴēćţ."
],
"c9-Pi9": [["source"], " · śķĩĺĺś.śĥ śōũŕćē"],
+ "c9C7DQ": ["Ćōũĺďń'ţ śàvē ţĥĩś śēţţĩńĝ. Ţŕŷ àĝàĩń."],
"cCd8Bs": ["Ćũţ"],
"cD3aew": ["Ŕē-ēḿƀēďďĩńĝ ĥàƥƥēńś àś śēàŕćĥēś ŕũń, śō ćōvēŕàĝē ŕēśţàŕţś àţ źēŕō àńď ŕēƒĩĺĺś."],
"cEoyWz": ["Àďď ĩţēḿ ţō ", ["keyName"]],
diff --git a/packages/app/src/locales/pseudo/messages.po b/packages/app/src/locales/pseudo/messages.po
index 77c4f3452..2b2f100f3 100644
--- a/packages/app/src/locales/pseudo/messages.po
+++ b/packages/app/src/locales/pseudo/messages.po
@@ -2504,6 +2504,10 @@ msgstr ""
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr ""
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr ""
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr ""
@@ -4653,6 +4657,10 @@ msgstr ""
msgid "Couldn't save the resolution for {filePath}."
msgstr ""
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr ""
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr ""
@@ -5476,6 +5484,10 @@ msgstr ""
msgid "Download {0}"
msgstr ""
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr ""
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr ""
@@ -10586,6 +10598,10 @@ msgstr ""
msgid "OpenKnowledge checked the project"
msgstr ""
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr ""
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr ""
@@ -10634,6 +10650,10 @@ msgstr ""
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr ""
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr ""
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr ""
diff --git a/packages/app/src/locales/pt-BR/messages.json b/packages/app/src/locales/pt-BR/messages.json
index 29e0a4152..b59d1bec5 100644
--- a/packages/app/src/locales/pt-BR/messages.json
+++ b/packages/app/src/locales/pt-BR/messages.json
@@ -845,6 +845,9 @@
"7C9JcA": [
"O caminho do projeto do OpenKnowledge neste branch sai do worktree. O worktree foi criado, mas não foi aberto."
],
+ "7Crqsa": [
+ "O OpenKnowledge não busca nem baixa atualizações por conta própria. Buscar atualizações continua funcionando quando você quiser uma versão mais recente."
+ ],
"7FA2iI": ["Não deu para ler os comentários que aguardam envio — nada foi enviado."],
"7FamGZ": ["Ir para a linha"],
"7Fkcej": ["+ Adicionar ", ["addChildName"]],
@@ -910,6 +913,7 @@
"7l15X4": ["falhou"],
"7lFX_h": ["Redirecionar agora"],
"7m3Ade": ["instalações:"],
+ "7mxVbK": ["Baixar e instalar atualizações automaticamente"],
"7qRHf0": ["Instalar para o Claude Chat e Cowork"],
"7sNhEz": ["Nome de usuário"],
"7uBlRT": ["Copia o item em foco na árvore de arquivos para que Colar possa duplicá-lo."],
@@ -3435,6 +3439,7 @@
"X7ShnN": ["Abrir o painel de agentes"],
"X8kjQX": ["Autenticar de novo no GitHub"],
"X9VpsP": ["Carregando o conteúdo da pasta"],
+ "XA9uvc": ["O OpenKnowledge busca e baixa atualizações em segundo plano."],
"XAnapw": ["Git regra de mesclagem"],
"XAyxsa": ["Extrair ramo remoto"],
"XBBZnv": ["O destino do link \"", ["shown"], "\" não corresponde a um documento existente."],
@@ -3447,6 +3452,7 @@
"XJOV1Y": ["Atividade"],
"XK5cbh": ["Avança pelo histórico de navegação do OpenKnowledge."],
"XNBGZw": ["Mensagem não enviada: ", ["0"]],
+ "XN_sSd": ["Atualizações automáticas"],
"XNdXMR": [
["dependent"],
" precisa de ",
@@ -4038,6 +4044,7 @@
" carregará todas as extensões que houver nela, não apenas a do Open Knowledge, e ambas permanecem até você remover o Open Knowledge deste projeto."
],
"c9-Pi9": [["source"], " · fonte do skills.sh"],
+ "c9C7DQ": ["Não foi possível salvar esta configuração. Tente novamente."],
"cCd8Bs": ["Recortar"],
"cD3aew": [
"Os embeddings são recalculados à medida que as buscas rodam, então a cobertura recomeça do zero e vai enchendo."
diff --git a/packages/app/src/locales/pt-BR/messages.po b/packages/app/src/locales/pt-BR/messages.po
index d9c58aabb..4ebaad263 100644
--- a/packages/app/src/locales/pt-BR/messages.po
+++ b/packages/app/src/locales/pt-BR/messages.po
@@ -2504,6 +2504,10 @@ msgstr "Automático"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "O modo automático escolhe uma porta livre a cada inicialização. Escolha uma porta fixa para manter o mesmo endereço entre reinicializações."
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "Atualizações automáticas"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "As atualizações automáticas não estão disponíveis no momento."
@@ -4653,6 +4657,10 @@ msgstr "Não deu para salvar a chave — tente de novo."
msgid "Couldn't save the resolution for {filePath}."
msgstr "Não deu para salvar a resolução de {filePath}."
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "Não foi possível salvar esta configuração. Tente novamente."
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "Não foi possível salvar sua preferência de tema."
@@ -5476,6 +5484,10 @@ msgstr "Clique duas vezes para editar"
msgid "Download {0}"
msgstr "Baixar {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "Baixar e instalar atualizações automaticamente"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "Baixar aplicativo"
@@ -10586,6 +10598,10 @@ msgstr "OpenKnowledge verificou {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge verificou o projeto"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "O OpenKnowledge busca e baixa atualizações em segundo plano."
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "O OpenKnowledge não encontrou este agente nesta máquina."
@@ -10634,6 +10650,10 @@ msgstr "O OpenKnowledge não reconhece esta entrada e não pode substituí-la co
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "O OpenKnowledge não reconhece esta entrada. Ativá-la a substituirá."
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "O OpenKnowledge não busca nem baixa atualizações por conta própria. Buscar atualizações continua funcionando quando você quiser uma versão mais recente."
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge editou {subject}"
diff --git a/packages/app/src/locales/ur/messages.json b/packages/app/src/locales/ur/messages.json
index b609caec9..b6a747d96 100644
--- a/packages/app/src/locales/ur/messages.json
+++ b/packages/app/src/locales/ur/messages.json
@@ -732,6 +732,9 @@
"7C9JcA": [
"اس برانچ پر OpenKnowledge پروجیکٹ کا پاتھ ورک ٹری سے باہر جاتا ہے۔ ورک ٹری بن گئی، لیکن کھولی نہیں گئی۔"
],
+ "7Crqsa": [
+ "OpenKnowledge خود سے اپ ڈیٹس نہیں دیکھتا یا ڈاؤن لوڈ نہیں کرتا۔ نیا ورژن چاہیں تو \"اپ ڈیٹس دیکھیں\" اب بھی کام کرتا ہے۔"
+ ],
"7FA2iI": ["بھیجنے کے منتظر تبصرے پڑھے نہیں جا سکے — کچھ نہیں بھیجا گیا۔"],
"7FamGZ": ["سطر پر جائیں"],
"7Fkcej": ["+ ", ["addChildName"], " شامل کریں"],
@@ -795,6 +798,7 @@
"7l15X4": ["ناکام"],
"7lFX_h": ["ابھی رخ بدلیں"],
"7m3Ade": ["تنصیبات:"],
+ "7mxVbK": ["اپ ڈیٹس خودکار طور پر ڈاؤن لوڈ اور انسٹال کریں"],
"7qRHf0": ["Claude Chat اور Cowork کے لیے نصب کریں"],
"7sNhEz": ["صارف نام"],
"7uBlRT": ["فوکس شدہ فائل ٹری آئٹم نقل کریں تاکہ «چسپاں» اس کی نقل بنا سکے۔"],
@@ -3069,6 +3073,7 @@
"X7ShnN": ["ایجنٹس کا پینل کھولیں"],
"X8kjQX": ["GitHub سے دوبارہ توثیق کریں"],
"X9VpsP": ["فولڈر کا مواد لوڈ ہو رہا ہے"],
+ "XA9uvc": ["OpenKnowledge پس منظر میں اپ ڈیٹس دیکھتا اور ڈاؤن لوڈ کرتا ہے۔"],
"XAnapw": ["Git ضم کرنے کا اصول"],
"XAyxsa": ["ریموٹ برانچ چیک آؤٹ کریں"],
"XBBZnv": ["لنک کا ہدف \"", ["shown"], "\" کسی موجودہ دستاویز کی طرف اشارہ نہیں کرتا۔"],
@@ -3081,6 +3086,7 @@
"XJOV1Y": ["سرگرمی"],
"XK5cbh": ["OpenKnowledge کی نیویگیشن تاریخ میں آگے جائیں۔"],
"XNBGZw": ["پیغام نہیں بھیجا گیا: ", ["0"]],
+ "XN_sSd": ["خودکار اپ ڈیٹس"],
"XNdXMR": [
["dependent"],
" کو ",
@@ -3648,6 +3654,7 @@
" اس میں موجود ہر ایکسٹینشن لوڈ کرے گا، صرف Open Knowledge کی نہیں، اور جب تک آپ اس پروجیکٹ سے Open Knowledge نہ ہٹائیں، دونوں برقرار رہیں گے۔"
],
"c9-Pi9": [["source"], " · skills.sh ماخذ"],
+ "c9C7DQ": ["یہ ترتیب محفوظ نہیں ہو سکی۔ دوبارہ کوشش کریں۔"],
"cCd8Bs": ["کاٹیں"],
"cD3aew": [
"دوبارہ ایمبیڈنگ تلاش چلنے کے دوران ہوتی ہے، اس لیے احاطہ صفر سے شروع ہو کر دوبارہ بھرتا ہے۔"
diff --git a/packages/app/src/locales/ur/messages.po b/packages/app/src/locales/ur/messages.po
index e9e333001..11077d844 100644
--- a/packages/app/src/locales/ur/messages.po
+++ b/packages/app/src/locales/ur/messages.po
@@ -2508,6 +2508,10 @@ msgstr "خودکار"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "خودکار ہر بار شروع ہونے پر ایک خالی پورٹ منتخب کرتا ہے۔ دوبارہ شروع ہونے پر ایک ہی ایڈریس برقرار رکھنے کے لیے ایک مقررہ پورٹ منتخب کریں۔"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "خودکار اپ ڈیٹس"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "خودکار اپ ڈیٹس ابھی دستیاب نہیں ہیں۔"
@@ -4657,6 +4661,10 @@ msgstr "کلید محفوظ نہیں ہو سکی — براہِ کرم دوبا
msgid "Couldn't save the resolution for {filePath}."
msgstr "{filePath} کا حل محفوظ نہیں ہو سکا۔"
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "یہ ترتیب محفوظ نہیں ہو سکی۔ دوبارہ کوشش کریں۔"
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "آپ کی تھیم ترجیح محفوظ نہیں ہو سکی۔"
@@ -5480,6 +5488,10 @@ msgstr "ترمیم کے لیے ڈبل کلک کریں"
msgid "Download {0}"
msgstr "{0} ڈاؤن لوڈ کریں"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "اپ ڈیٹس خودکار طور پر ڈاؤن لوڈ اور انسٹال کریں"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "ایپ ڈاؤن لوڈ کریں"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge نے {subject} کی جانچ کی"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge نے پروجیکٹ کی جانچ کی"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge پس منظر میں اپ ڈیٹس دیکھتا اور ڈاؤن لوڈ کرتا ہے۔"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge کو اس مشین پر یہ ایجنٹ نہیں ملا۔"
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge اس اندراج کو نہیں پہچانتا، اور ا
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge اس اندراج کو نہیں پہچانتا۔ اسے آن کرنے پر یہ تبدیل ہو جائے گا۔"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge خود سے اپ ڈیٹس نہیں دیکھتا یا ڈاؤن لوڈ نہیں کرتا۔ نیا ورژن چاہیں تو \"اپ ڈیٹس دیکھیں\" اب بھی کام کرتا ہے۔"
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge نے {subject} میں ترمیم کی"
diff --git a/packages/app/src/locales/zh-Hans/messages.json b/packages/app/src/locales/zh-Hans/messages.json
index 7a6c8fdd6..8eae332e7 100644
--- a/packages/app/src/locales/zh-Hans/messages.json
+++ b/packages/app/src/locales/zh-Hans/messages.json
@@ -629,6 +629,7 @@
"7Ag-Xu": ["询问 ", ["agentName"], ",", ["hint"]],
"7Bj3x9": ["失败"],
"7C9JcA": ["此分支中的 OpenKnowledge 项目路径位于工作树之外。工作树已创建,但未打开。"],
+ "7Crqsa": ["OpenKnowledge 不会自行检查或下载更新。需要新版本时,仍可使用“检查更新”。"],
"7FA2iI": ["无法读取等待发送的评论——什么都没有发送。"],
"7FamGZ": ["跳转到行"],
"7Fkcej": ["+ 添加 ", ["addChildName"]],
@@ -688,6 +689,7 @@
"7l15X4": ["失败"],
"7lFX_h": ["立即改向"],
"7m3Ade": ["安装量:"],
+ "7mxVbK": ["自动下载并安装更新"],
"7qRHf0": ["为 Claude Chat 和 Cowork 安装"],
"7sNhEz": ["用户名"],
"7uBlRT": ["复制文件树中当前聚焦的项目,以便用「粘贴」创建副本。"],
@@ -2633,6 +2635,7 @@
"X7ShnN": ["打开智能体面板"],
"X8kjQX": ["重新通过 GitHub 认证"],
"X9VpsP": ["正在加载文件夹内容"],
+ "XA9uvc": ["OpenKnowledge 会在后台检查并下载更新。"],
"XAnapw": ["Git 合并规则"],
"XAyxsa": ["检出远程分支"],
"XBBZnv": ["链接目标“", ["shown"], "”未指向现有文档。"],
@@ -2645,6 +2648,7 @@
"XJOV1Y": ["动态"],
"XK5cbh": ["在 OpenKnowledge 的导航历史中前进。"],
"XNBGZw": ["消息未发送:", ["0"]],
+ "XN_sSd": ["自动更新"],
"XNdXMR": [
["dependent"],
" 需要 ",
@@ -3130,6 +3134,7 @@
" 会加载其中的每一个扩展,而不仅是 Open Knowledge 的;在你将 Open Knowledge 从此项目中移除之前,两者都会一直保留。"
],
"c9-Pi9": [["source"], " · skills.sh 来源"],
+ "c9C7DQ": ["无法保存此设置。请重试。"],
"cCd8Bs": ["剪切"],
"cD3aew": ["重新生成嵌入向量会随着搜索进行,因此覆盖率会从零重新累积。"],
"cEoyWz": ["向 ", ["keyName"], " 添加项目"],
diff --git a/packages/app/src/locales/zh-Hans/messages.po b/packages/app/src/locales/zh-Hans/messages.po
index 2dd829195..5ef7f7490 100644
--- a/packages/app/src/locales/zh-Hans/messages.po
+++ b/packages/app/src/locales/zh-Hans/messages.po
@@ -2508,6 +2508,10 @@ msgstr "自动"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "自动模式会在每次启动时选择一个空闲端口。选择固定端口可在重启后保持相同地址。"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "自动更新"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "目前无法自动更新。"
@@ -4657,6 +4661,10 @@ msgstr "无法保存密钥——请重试。"
msgid "Couldn't save the resolution for {filePath}."
msgstr "无法保存 {filePath} 的解决结果。"
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "无法保存此设置。请重试。"
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "无法保存你的主题偏好。"
@@ -5480,6 +5488,10 @@ msgstr "双击进行编辑"
msgid "Download {0}"
msgstr "下载 {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "自动下载并安装更新"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "下载应用"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge 检查了 {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge 检查了项目"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge 会在后台检查并下载更新。"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge 未在此设备上找到该智能体。"
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge 无法识别此条目,且无法在此文件格式中安
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge 无法识别此条目。启用后将替换它。"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge 不会自行检查或下载更新。需要新版本时,仍可使用“检查更新”。"
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge 编辑了 {subject}"
diff --git a/packages/app/src/locales/zh-Hant/messages.json b/packages/app/src/locales/zh-Hant/messages.json
index 2438aa087..3600e1c82 100644
--- a/packages/app/src/locales/zh-Hant/messages.json
+++ b/packages/app/src/locales/zh-Hant/messages.json
@@ -629,6 +629,7 @@
"7Ag-Xu": ["詢問 ", ["agentName"], ",", ["hint"]],
"7Bj3x9": ["失敗"],
"7C9JcA": ["此分支中的 OpenKnowledge 專案路徑位於工作樹之外。工作樹已建立,但未開啟。"],
+ "7Crqsa": ["OpenKnowledge 不會自行檢查或下載更新。需要新版本時,仍可使用「檢查更新」。"],
"7FA2iI": ["無法讀取等著傳送的註解——什麼都沒有送出。"],
"7FamGZ": ["移至行"],
"7Fkcej": ["+ 新增 ", ["addChildName"]],
@@ -688,6 +689,7 @@
"7l15X4": ["失敗"],
"7lFX_h": ["立即改向"],
"7m3Ade": ["安裝次數:"],
+ "7mxVbK": ["自動下載並安裝更新"],
"7qRHf0": ["為 Claude Chat 和 Cowork 安裝"],
"7sNhEz": ["使用者名稱"],
"7uBlRT": ["複製檔案樹中目前聚焦的項目,這樣「貼上」就能做出一份副本。"],
@@ -2657,6 +2659,7 @@
"X7ShnN": ["開啟代理面板"],
"X8kjQX": ["重新用 GitHub 驗證"],
"X9VpsP": ["正在載入資料夾內容"],
+ "XA9uvc": ["OpenKnowledge 會在背景檢查並下載更新。"],
"XAnapw": ["Git 合併規則"],
"XAyxsa": ["簽出遠端分支"],
"XBBZnv": ["連結目標「", ["shown"], "」未指向現有文件。"],
@@ -2669,6 +2672,7 @@
"XJOV1Y": ["動態"],
"XK5cbh": ["在 OpenKnowledge 的導覽記錄中往前走。"],
"XNBGZw": ["訊息未送出:", ["0"]],
+ "XN_sSd": ["自動更新"],
"XNdXMR": [
["dependent"],
" 需要 ",
@@ -3150,6 +3154,7 @@
" 會載入其中的每一個擴充功能,而不僅是 Open Knowledge 的;在你將 Open Knowledge 從此專案移除之前,兩者都會一直保留。"
],
"c9-Pi9": [["source"], " · skills.sh 來源"],
+ "c9C7DQ": ["無法儲存此設定。請再試一次。"],
"cCd8Bs": ["剪下"],
"cD3aew": ["重新產生嵌入向量會隨著搜尋進行,所以涵蓋率會從零重新累積。"],
"cEoyWz": ["為 ", ["keyName"], " 新增項目"],
diff --git a/packages/app/src/locales/zh-Hant/messages.po b/packages/app/src/locales/zh-Hant/messages.po
index 0af78d2d5..58515d58d 100644
--- a/packages/app/src/locales/zh-Hant/messages.po
+++ b/packages/app/src/locales/zh-Hant/messages.po
@@ -2508,6 +2508,10 @@ msgstr "自動"
msgid "Automatic picks a free port each start. Choose a fixed port to keep the same address across restarts."
msgstr "自動模式會在每次啟動時挑選一個空閒的連接埠。選擇固定連接埠可在重新啟動後維持相同位址。"
+#: src/components/settings/SettingsDialogShell.tsx
+msgid "Automatic updates"
+msgstr "自動更新"
+
#: src/components/settings/AboutSection.tsx
msgid "Automatic updates are not available right now."
msgstr "目前無法自動更新。"
@@ -4657,6 +4661,10 @@ msgstr "無法儲存金鑰——請再試一次。"
msgid "Couldn't save the resolution for {filePath}."
msgstr "無法儲存 {filePath} 的解決結果。"
+#: src/components/settings/AboutSection.tsx
+msgid "Couldn't save this setting. Try again."
+msgstr "無法儲存此設定。請再試一次。"
+
#: src/components/McpConsentDialogBody.tsx
msgid "Couldn't save your theme preference."
msgstr "無法儲存你的主題偏好。"
@@ -5480,6 +5488,10 @@ msgstr "按兩下即可編輯"
msgid "Download {0}"
msgstr "下載 {0}"
+#: src/components/settings/AboutSection.tsx
+msgid "Download and install updates automatically"
+msgstr "自動下載並安裝更新"
+
#: src/components/HelpPopover.tsx
msgid "Download app"
msgstr "下載應用程式"
@@ -10590,6 +10602,10 @@ msgstr "OpenKnowledge 檢查了 {subject}"
msgid "OpenKnowledge checked the project"
msgstr "OpenKnowledge 檢查了專案"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge checks for and downloads updates in the background."
+msgstr "OpenKnowledge 會在背景檢查並下載更新。"
+
#: src/components/settings/AgentConnectionDialogs.tsx
msgid "OpenKnowledge could not find this agent on this machine."
msgstr "OpenKnowledge 未在此裝置上找到該代理程式。"
@@ -10638,6 +10654,10 @@ msgstr "OpenKnowledge 無法辨識此項目,且無法在此檔案格式中安
msgid "OpenKnowledge does not recognize this entry. Turning it on replaces it."
msgstr "OpenKnowledge 無法辨識此項目。啟用後將取代它。"
+#: src/components/settings/AboutSection.tsx
+msgid "OpenKnowledge doesn't check for or download updates on its own. Check for updates still works when you want a newer version."
+msgstr "OpenKnowledge 不會自行檢查或下載更新。需要新版本時,仍可使用「檢查更新」。"
+
#: src/lib/acp/tool-call-display.ts
msgid "OpenKnowledge edited {subject}"
msgstr "OpenKnowledge 編輯了 {subject}"
diff --git a/packages/app/tests/stress/file-tree-create.e2e.ts b/packages/app/tests/stress/file-tree-create.e2e.ts
index 668ff31e9..80dd65f8b 100644
--- a/packages/app/tests/stress/file-tree-create.e2e.ts
+++ b/packages/app/tests/stress/file-tree-create.e2e.ts
@@ -270,6 +270,8 @@ async function installDelayedDesktopSessionBridge(
relaunchNow: async () => {},
checkNow: async () => {},
dismissWhatsNew: async () => {},
+ dismissDownloaded: async () => {},
+ setMode: async () => {},
},
state: {
query: async () => ({ channel: 'latest', schemaIncompatibility: null }),
diff --git a/packages/app/tests/stress/fixtures/handoff-mocks.ts b/packages/app/tests/stress/fixtures/handoff-mocks.ts
index e45c33db9..312abcf09 100644
--- a/packages/app/tests/stress/fixtures/handoff-mocks.ts
+++ b/packages/app/tests/stress/fixtures/handoff-mocks.ts
@@ -395,6 +395,8 @@ export async function installHandoffMocks(page: Page, cfg: HandoffMockConfig): P
relaunchNow: async () => {},
checkNow: async () => {},
dismissWhatsNew: async () => {},
+ dismissDownloaded: async () => {},
+ setMode: async () => {},
},
state: {
query: async () => ({
diff --git a/packages/core/src/desktop-bridge.ts b/packages/core/src/desktop-bridge.ts
index 8f9176d47..64367fc93 100644
--- a/packages/core/src/desktop-bridge.ts
+++ b/packages/core/src/desktop-bridge.ts
@@ -247,7 +247,7 @@ export interface OkHeadBranchInfo {
}
export interface OkUpdateDownloadedInfo {
- readonly version: string;
+ readonly version: string | null;
}
export interface OkUpdateRelaunchingInfo {
@@ -333,6 +333,8 @@ export type ShareFolderValidationResult =
export type OkUpdateChannel = 'latest' | 'beta';
+export type OkUpdateMode = 'auto' | 'off';
+
export type OkThemeSource = 'system' | 'light' | 'dark';
export interface OkUserConfigSnapshot {
@@ -362,6 +364,7 @@ export interface OkStateSnapshot {
readonly maxSupported: number;
} | null;
readonly about?: OkAboutInfo;
+ readonly updateMode?: OkUpdateMode;
}
export type OkMcpWiringEditorId = EditorId;
@@ -1354,6 +1357,8 @@ export interface OkDesktopBridge {
relaunchNow(): Promise<void>;
checkNow(): Promise<void>;
dismissWhatsNew(version: string): Promise<void>;
+ dismissDownloaded(version: string): Promise<void>;
+ setMode(mode: OkUpdateMode): Promise<void>;
};
state: {
diff --git a/packages/desktop/src/main/auto-updater.ts b/packages/desktop/src/main/auto-updater.ts
index 8c171691d..d8b096bd8 100644
--- a/packages/desktop/src/main/auto-updater.ts
+++ b/packages/desktop/src/main/auto-updater.ts
@@ -1,6 +1,11 @@
import type { OutgoingHttpHeaders } from 'node:http';
import { MANUAL_CHECK_WATCHDOG_MS } from '@inkeep/open-knowledge-core';
import type { IpcMain, IpcMainInvokeEvent } from 'electron';
+import type {
+ OkUpdateDispatchRequest,
+ OkUpdateDispatchResult,
+ OkUpdateSetModeFailure,
+} from '../shared/ipc-channels.ts';
import type { EventChannels } from '../shared/ipc-events.ts';
import { createHandler } from '../shared/ipc-handler.ts';
import { type SendableWebContents, sendToRenderer } from '../shared/ipc-send.ts';
@@ -10,7 +15,12 @@ import {
type LinuxManualInstallContext,
manualInstallPlanFor,
} from './linux-install-fallback.ts';
-import type { AppState, UpdateChannel } from './state-store.ts';
+import {
+ type AppState,
+ type OkUpdateMode,
+ resolveUpdateMode,
+ type UpdateChannel,
+} from './state-store.ts';
import type { WindowsUpdateSurvivorSweepResult } from './windows-update-survivor-sweep.ts';
const GITHUB_OWNER = 'inkeep';
@@ -83,6 +93,8 @@ export type DispatchKind =
| 'linux-manual-fallback-no-auth'
| 'linux-manual-fallback-after-error'
| 'download-skipped-already-staged'
+ | 'update-downloaded-install-committed'
+ | 'staged-install-rebind'
| 'download-skipped-install-armed'
| 'relaunch-refresh-found-newer'
| 'relaunch-refresh-up-to-date'
@@ -95,7 +107,16 @@ export type DispatchKind =
| 'check-now-ready-reoffered'
| 'check-now-download-failed-shown'
| 'toast-a-deferred-post-update-quiet'
- | 'toast-a-quiet-window-elapsed';
+ | 'toast-a-quiet-window-elapsed'
+ | 'skipped-updates-off'
+ | 'download-skipped-updates-off'
+ | 'update-downloaded-quiet'
+ | 'install-giveup-reconciled'
+ | 'install-failed-after-giveup'
+ | 'install-failed-notice-skipped-updates-off'
+ | 'stuck-hint-skipped-updates-off'
+ | 'downloaded-dismiss-recorded'
+ | 'update-mode-changed';
interface StartAutoUpdaterOpts {
updater: UpdaterLike;
@@ -137,7 +158,12 @@ type CheckNowResultResponse = 'relaunch' | 'dismiss';
type StagedRelaunch = 'available' | 'installing' | 'not-pending';
type CheckNowResult =
- | { kind: 'available'; currentVersion: string; latestVersion: string }
+ | {
+ kind: 'available';
+ currentVersion: string;
+ latestVersion: string;
+ download: 'background' | 'manual';
+ }
| {
kind: 'ready-to-install';
currentVersion: string;
@@ -416,8 +442,15 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
logger = DEFAULT_LOGGER,
} = opts;
+ const readUpdateMode = (): OkUpdateMode => resolveUpdateMode(readState().updateMode).mode;
+ const updatesOff = (): boolean => readUpdateMode() === 'off';
+ let autoInstallSuppressed = false;
+ const applyAutoInstallOnQuit = (): void => {
+ updater.autoInstallOnAppQuit = !autoInstallSuppressed && platform !== 'linux' && !updatesOff();
+ };
+
updater.autoDownload = false;
- updater.autoInstallOnAppQuit = platform !== 'linux';
+ applyAutoInstallOnQuit();
const appVersion = getAppVersion();
const buildChannel = configuredBuildChannel ?? channelFromVersion(appVersion);
applyChannelSettings(updater, buildChannel);
@@ -649,6 +682,10 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
const maybeFireStuckHint = (): void => {
const state = readState();
if (state.stuckHintShown) return;
+ if (updatesOff()) {
+ onDispatch?.('stuck-hint-skipped-updates-off');
+ return;
+ }
if (!state.lastSuccessfulCheckAt) return;
const last = Date.parse(state.lastSuccessfulCheckAt);
if (Number.isNaN(last)) return;
@@ -670,6 +707,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
};
const markCheckSucceeded = (): void => {
+ if (updatesOff()) return;
const state = readState();
if (
!persistSafely(
@@ -732,18 +770,31 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
);
};
- const relaunchableVersion = (): string | null =>
- installRequested ? null : readState().versionPendingInstall;
+ const relaunchableVersion = (): string | null => {
+ if (installRequested) return null;
+ const pending = readState().versionPendingInstall;
+ if (pending !== null && pending === unboundStagedVersion && !updatesOff()) return null;
+ return pending;
+ };
const stagedRelaunchFor = (version: string): StagedRelaunch => {
if (relaunchableVersion() === version) return 'available';
return installRequested ? 'installing' : 'not-pending';
};
+ const toastASilencedFor = (version: string): 'updates-off' | 'dismissed' | 'gave-up' | null => {
+ if (updatesOff()) return 'updates-off';
+ const state = readState();
+ if (state.gaveUpOnVersion === version) return 'gave-up';
+ if (state.dismissedUpdateVersion === version) return 'dismissed';
+ return null;
+ };
+
const pendingToastA = (): { version: string } | null => {
if (withinPostUpdateQuietWindow()) return null;
const version = relaunchableVersion();
- return version === null ? null : { version };
+ if (version === null || toastASilencedFor(version) !== null) return null;
+ return { version };
};
const reofferStagedForMenuCheck = (version: string): void => {
@@ -775,6 +826,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
};
let stagedThisSession: string | null = null;
+ let unboundStagedVersion: string | null = null;
const declinedForStagedVersion = (offeredVersion: string | undefined): string | null => {
if (stagedThisSession === null) return null;
@@ -895,8 +947,19 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
let activeWhatsNew: { version: string; releaseUrl: string; firedAt: number } | null = null;
+ const clearDismissalOnManualCheck = (): void => {
+ const state = readState();
+ if (state.dismissedUpdateVersion === null) return;
+ const cleared = state.dismissedUpdateVersion;
+ if (!persistSafely({ ...state, dismissedUpdateVersion: null }, 'manual-check-dismissal')) {
+ return;
+ }
+ logger.info('manual check cleared the recorded card dismissal', { cleared });
+ };
+
const runMenuDrivenCheck = (): Promise<unknown> => {
if (destroyed) return Promise.resolve(undefined);
+ clearDismissalOnManualCheck();
broadcastToAllWindows('ok:update:manual-check', { phase: 'started' });
if (menuCheck !== null) {
logger.info('check-now already pending, re-acknowledged');
@@ -995,6 +1058,14 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
onDispatch?.(reOffer ? 'download-skipped-already-staged' : 'download-skipped-install-armed');
return;
}
+ if (updatesOff()) {
+ logger.info('update-available while updates are off — not downloading', {
+ version: offeredVersion,
+ });
+ settleCheckWaiters('settled');
+ onDispatch?.('download-skipped-updates-off');
+ return;
+ }
if (usingProxyFeed && offeredVersion) {
updater.requestHeaders = {
...updater.requestHeaders,
@@ -1068,6 +1139,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
kind: 'available',
currentVersion: getAppVersion(),
latestVersion: typeof info.version === 'string' ? info.version : 'unknown',
+ download: updatesOff() ? 'manual' : 'background',
});
};
@@ -1103,12 +1175,49 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
}
stagedThisSession = version;
const state = readState();
+ const installCommittedAtDownload = platform !== 'linux' && updater.autoInstallOnAppQuit;
+ const installCommitment = {
+ attemptedInstall: version,
+ attemptedInstallSurfacedCount:
+ state.attemptedInstall === version ? state.attemptedInstallSurfacedCount : 0,
+ attemptedInstallDeferredBoots:
+ state.attemptedInstall === version ? state.attemptedInstallDeferredBoots : 0,
+ };
+ const rebound = unboundStagedVersion === version && installCommittedAtDownload;
+ unboundStagedVersion = platform !== 'linux' && !installCommittedAtDownload ? version : null;
if (state.versionPendingInstall === version) {
+ if (
+ installCommittedAtDownload &&
+ state.attemptedInstall !== version &&
+ state.gaveUpOnVersion !== version &&
+ persistSafely(
+ {
+ ...state,
+ ...installCommitment,
+ attemptedInstallStagingAgeMs: null,
+ attemptedInstallHandoffAt: null,
+ },
+ 'update-downloaded-install-committed',
+ )
+ ) {
+ logger.info('staged build is now installable on quit — recording the install commitment', {
+ version,
+ });
+ onDispatch?.('update-downloaded-install-committed');
+ }
+ if (rebound) {
+ const staged = pendingToastA();
+ if (staged) broadcastToAllWindows('ok:update:downloaded', staged);
+ }
logger.info('update-downloaded re-fired for same pending version — deduped', { version });
onDispatch?.('update-downloaded-deduped');
return;
}
- const installCommittedAtDownload = platform !== 'linux';
+ if (state.gaveUpOnVersion === version) {
+ logger.info('update-downloaded for a given-up version — staying quiet', { version });
+ onDispatch?.('update-downloaded-quiet');
+ return;
+ }
if (
!persistSafely(
{
@@ -1118,21 +1227,21 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
versionPendingInstallStagedAt: now().getTime(),
attemptedInstallStagingAgeMs: null,
attemptedInstallHandoffAt: null,
- ...(installCommittedAtDownload
- ? {
- attemptedInstall: version,
- attemptedInstallSurfacedCount:
- state.attemptedInstall === version ? state.attemptedInstallSurfacedCount : 0,
- attemptedInstallDeferredBoots:
- state.attemptedInstall === version ? state.attemptedInstallDeferredBoots : 0,
- }
- : {}),
+ gaveUpOnVersion: null,
+ dismissedUpdateVersion: null,
+ ...(installCommittedAtDownload ? installCommitment : {}),
},
'update-downloaded',
)
)
return;
const fireToastA = () => {
+ const silenced = toastASilencedFor(version);
+ if (silenced !== null) {
+ logger.info('update-downloaded staged without Toast A', { version, reason: silenced });
+ onDispatch?.('update-downloaded-quiet');
+ return;
+ }
broadcastToAllWindows('ok:update:downloaded', { version });
logger.info('update-downloaded dispatched Toast A (all windows)', { version });
onDispatch?.('update-downloaded-toast-a');
@@ -1233,6 +1342,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
});
const refreshBeforeInstall = async (): Promise<void> => {
+ if (updatesOff()) return;
if (stagingInFlight) {
logger.info('relaunch-now waiting on in-flight staging before install', {
version: stagingInFlight.version,
@@ -1338,19 +1448,11 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
versionPendingInstall: null,
attemptedInstallStagingAgeMs: stagingAgeMs,
attemptedInstallHandoffAt: now().getTime(),
- ...(platform === 'linux'
- ? {
- attemptedInstall: pending,
- attemptedInstallSurfacedCount:
- snapshot.attemptedInstall === pending
- ? snapshot.attemptedInstallSurfacedCount
- : 0,
- attemptedInstallDeferredBoots:
- snapshot.attemptedInstall === pending
- ? snapshot.attemptedInstallDeferredBoots
- : 0,
- }
- : {}),
+ attemptedInstall: pending,
+ attemptedInstallSurfacedCount:
+ snapshot.attemptedInstall === pending ? snapshot.attemptedInstallSurfacedCount : 0,
+ attemptedInstallDeferredBoots:
+ snapshot.attemptedInstall === pending ? snapshot.attemptedInstallDeferredBoots : 0,
},
'relaunch-now',
)
@@ -1410,28 +1512,120 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
return undefined;
};
- const register = createHandler(ipcMain as IpcMain);
- register(
- 'ok:update:relaunch-now',
- (_event: IpcMainInvokeEvent): Promise<undefined> => relaunchNow(),
- );
+ const dismissWhatsNew = (version: string): void => {
+ if (activeWhatsNew && activeWhatsNew.version === version) {
+ activeWhatsNew = null;
+ }
+ broadcastToAllWindows('ok:update:whats-new-dismissed', { version });
+ onDispatch?.('whats-new-dismiss-broadcast');
+ };
- register('ok:update:check-now', (_event: IpcMainInvokeEvent): undefined => {
- void runMenuDrivenCheck();
- return undefined;
- });
+ const dismissDownloaded = (version: string): void => {
+ if (version === '') return;
+ const state = readState();
+ if (state.dismissedUpdateVersion === version) return;
+ if (!persistSafely({ ...state, dismissedUpdateVersion: version }, 'downloaded-dismiss')) return;
+ logger.info('recorded dismissal of the ready-to-install card', { version });
+ if (state.versionPendingInstall === version) {
+ broadcastToAllWindows('ok:update:downloaded', { version: null });
+ }
+ onDispatch?.('downloaded-dismiss-recorded');
+ };
- register(
- 'ok:update:whats-new-dismiss',
- (_event: IpcMainInvokeEvent, payload: { version: string }): undefined => {
- const version = typeof payload?.version === 'string' ? payload.version : '';
- if (activeWhatsNew && activeWhatsNew.version === version) {
- activeWhatsNew = null;
+ let timerHandle: ReturnType<typeof setTimeout> | null = null;
+
+ const cancelPeriodicChecks = (): void => {
+ if (timerHandle === null) return;
+ clock.clearTimeout(timerHandle);
+ timerHandle = null;
+ };
+
+ const runBackgroundCheck = (): void => {
+ void checkForUpdatesFromConfiguredFeed().catch((err: unknown) => {
+ revertToGithubFeed(err);
+ logger.debug('checkForUpdates rejected', {
+ err,
+ });
+ });
+ };
+
+ const setUpdateMode = (
+ requested: unknown,
+ ): { ok: true; mode: OkUpdateMode } | { ok: false; reason: OkUpdateSetModeFailure } => {
+ if (requested !== 'auto' && requested !== 'off') {
+ logger.warn('set-mode refused an unrecognized mode', { requested });
+ return { ok: false, reason: 'unrecognized-mode' };
+ }
+ const state = readState();
+ const previous = readUpdateMode();
+ const next: AppState =
+ requested === 'off'
+ ? { ...state, updateMode: requested, lastSuccessfulCheckAt: null, stuckHintShown: false }
+ : { ...state, updateMode: requested };
+ if (!persistSafely(next, 'set-update-mode')) {
+ return { ok: false, reason: 'persist-failed' };
+ }
+ applyAutoInstallOnQuit();
+ logger.info('update mode changed', { from: previous, to: requested });
+ onDispatch?.('update-mode-changed');
+ if (requested === 'off') {
+ cancelPeriodicChecks();
+ broadcastToAllWindows('ok:update:downloaded', { version: null });
+ return { ok: true, mode: requested };
+ }
+ if (previous === 'off' && updatesEnabled && !destroyed) {
+ const rebind =
+ unboundStagedVersion !== null && unboundStagedVersion === next.versionPendingInstall;
+ if (rebind) {
+ stagedThisSession = null;
+ logger.info('staged build has no install hook — re-staging it before offering it', {
+ version: unboundStagedVersion,
+ });
+ onDispatch?.('staged-install-rebind');
}
- broadcastToAllWindows('ok:update:whats-new-dismissed', { version });
- onDispatch?.('whats-new-dismiss-broadcast');
- return undefined;
- },
+ startPeriodicChecks();
+ runBackgroundCheck();
+ const staged = pendingToastA();
+ if (staged) broadcastToAllWindows('ok:update:downloaded', staged);
+ }
+ return { ok: true, mode: requested };
+ };
+
+ const dispatchUpdate = async (
+ request: OkUpdateDispatchRequest,
+ ): Promise<OkUpdateDispatchResult> => {
+ switch (request?.kind) {
+ case 'relaunch-now':
+ await relaunchNow();
+ return { kind: 'relaunch-now' };
+ case 'check-now':
+ void runMenuDrivenCheck();
+ return { kind: 'check-now' };
+ case 'whats-new-dismiss':
+ dismissWhatsNew(typeof request.version === 'string' ? request.version : '');
+ return { kind: 'whats-new-dismiss' };
+ case 'downloaded-dismiss':
+ dismissDownloaded(typeof request.version === 'string' ? request.version : '');
+ return { kind: 'downloaded-dismiss' };
+ case 'set-mode':
+ return { kind: 'set-mode', ...setUpdateMode(request.mode) };
+ default: {
+ const unhandled: never = request;
+ logger.warn('ok:update:dispatch received an unrecognized kind', {
+ kind: (unhandled as { kind?: unknown } | null)?.kind,
+ });
+ return { kind: 'unknown', ok: false, reason: 'unrecognized-kind' };
+ }
+ }
+ };
+
+ const register = createHandler(ipcMain as IpcMain);
+ register(
+ 'ok:update:dispatch',
+ (
+ _event: IpcMainInvokeEvent,
+ request: OkUpdateDispatchRequest,
+ ): Promise<OkUpdateDispatchResult> => dispatchUpdate(request),
);
const currentVersion = getAppVersion();
@@ -1457,6 +1651,19 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
}
}
+ if (state.gaveUpOnVersion && installReached(currentVersion, state.gaveUpOnVersion)) {
+ const cleared = state.gaveUpOnVersion;
+ const next = { ...state, gaveUpOnVersion: null };
+ if (persistSafely(next, 'install-giveup-reconciled')) {
+ state = next;
+ logger.info('cleared give-up tombstone — running reached the version', {
+ cleared,
+ running: currentVersion,
+ });
+ onDispatch?.('install-giveup-reconciled');
+ }
+ }
+
let installGaveUpThisBoot = false;
if (state.attemptedInstall) {
const attempted = state.attemptedInstall;
@@ -1498,6 +1705,25 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
});
onDispatch?.('attempted-install-cross-channel');
}
+ } else if (state.gaveUpOnVersion === attempted) {
+ const next = {
+ ...state,
+ versionPendingInstall: attempted,
+ attemptedInstall: null,
+ attemptedInstallSurfacedCount: 0,
+ attemptedInstallStagingAgeMs: null,
+ attemptedInstallHandoffAt: null,
+ attemptedInstallDeferredBoots: 0,
+ };
+ if (persistSafely(next, 'install-failed-after-giveup')) {
+ state = next;
+ installGaveUpThisBoot = true;
+ logger.warn('given-up version failed to install again — staying quiet', {
+ attempted,
+ running: currentVersion,
+ });
+ onDispatch?.('install-failed-after-giveup');
+ }
} else if (updatesEnabled) {
const reconciledAtMs = now().getTime();
const handoffStampedAt = state.attemptedInstallHandoffAt;
@@ -1540,6 +1766,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
stagedAgeMs: installHandoffAgeMs(attemptStagedAt, reconciledAtMs),
});
const fireReoffer = (): void => {
+ if (toastASilencedFor(attempted) !== null) return;
broadcastToAllWindows('ok:update:downloaded', { version: attempted });
};
if (whenRendererReady) whenRendererReady(fireReoffer);
@@ -1554,11 +1781,10 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
} else if (state.attemptedInstallSurfacedCount >= INSTALL_FAILURE_MAX_SURFACES) {
const next = {
...state,
+ gaveUpOnVersion: attempted,
+ versionPendingInstall: attempted,
attemptedInstall: null,
attemptedInstallSurfacedCount: 0,
- versionPendingInstall: null,
- stagedInstallerPath: null,
- versionPendingInstallStagedAt: null,
attemptedInstallStagingAgeMs: null,
attemptedInstallHandoffAt: null,
attemptedInstallDeferredBoots: 0,
@@ -1566,7 +1792,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
if (persistSafely(next, 'install-failed-giveup')) {
state = next;
installGaveUpThisBoot = true;
- logger.warn('attempted install exhausted its retry budget — clearing record', {
+ logger.warn('attempted install exhausted its retry budget — tombstoning version', {
attempted,
running: currentVersion,
surfaced: INSTALL_FAILURE_MAX_SURFACES,
@@ -1591,6 +1817,10 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
handoffAgeMs,
});
const fireInstallFailed = (): void => {
+ if (updatesOff()) {
+ onDispatch?.('install-failed-notice-skipped-updates-off');
+ return;
+ }
broadcastToAllWindows('ok:update:relaunch-failed', {
version: attempted,
downloadUrl: STUCK_HINT_DOWNLOAD_URL,
@@ -1663,8 +1893,6 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
}
}
- let timerHandle: ReturnType<typeof setTimeout> | null = null;
-
const nextCheckDelayMs = (): number =>
UPDATE_CHECK_INTERVAL_MS + Math.floor(random() * UPDATE_CHECK_JITTER_MS);
@@ -1672,23 +1900,24 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
const delayMs = nextCheckDelayMs();
timerHandle = clock.setTimeout(() => {
timerHandle = null;
- void checkForUpdatesFromConfiguredFeed().catch((err: unknown) => {
- revertToGithubFeed(err);
- logger.debug('checkForUpdates rejected', {
- err,
- });
- });
+ if (updatesOff()) return;
+ runBackgroundCheck();
scheduleNextCheck();
}, delayMs);
logger.debug('next update check scheduled', { delayMs });
};
const startPeriodicChecks = (): void => {
- if (destroyed || !updatesEnabled || timerHandle) return;
+ if (destroyed || !updatesEnabled || timerHandle || updatesOff()) return;
scheduleNextCheck();
};
const runLaunchCheck = (): void => {
+ if (updatesOff()) {
+ logger.info('skipping checkForUpdates — updates are turned off');
+ onDispatch?.('skipped-updates-off');
+ return;
+ }
void checkForUpdatesFromConfiguredFeed()
.then(() => {
startPeriodicChecks();
@@ -1702,6 +1931,9 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
});
};
+ const bootMode = resolveUpdateMode(state.updateMode);
+ logger.info('update mode resolved', { mode: bootMode.mode, source: bootMode.source });
+
if (updatesEnabled) {
if (reclaimSettled) {
void reclaimSettled.then(runLaunchCheck);
@@ -1731,7 +1963,8 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
return pendingToastA();
},
suppressAutoInstallOnQuit(): void {
- updater.autoInstallOnAppQuit = false;
+ autoInstallSuppressed = true;
+ applyAutoInstallOnQuit();
logger.info('autoInstallOnAppQuit suppressed for uninstall');
},
recordInstallHandoffOnQuit(): void {
@@ -1818,9 +2051,7 @@ export function startAutoUpdater(opts: StartAutoUpdaterOpts): StartAutoUpdaterHa
});
}
};
- removeHandlerSafely('ok:update:relaunch-now');
- removeHandlerSafely('ok:update:check-now');
- removeHandlerSafely('ok:update:whats-new-dismiss');
+ removeHandlerSafely('ok:update:dispatch');
logger.info('destroyed');
},
};
diff --git a/packages/desktop/src/main/index.ts b/packages/desktop/src/main/index.ts
index b647442fd..30d395b64 100644
--- a/packages/desktop/src/main/index.ts
+++ b/packages/desktop/src/main/index.ts
@@ -159,6 +159,7 @@ import type { EventChannels } from '../shared/ipc-events.ts';
import { createHandler } from '../shared/ipc-handler.ts';
import { registerPendingDelivery, sendToRenderer } from '../shared/ipc-send.ts';
import { createPtyPhaseTrace } from '../shared/pty-phase-trace.ts';
+import { releasesPageUrl } from '../shared/release-links.ts';
import { UNINSTALL_PRELOAD_ARG } from '../shared/uninstall-preload-arg.ts';
import { getWindowsEnvValue } from '../shared/windows-env.ts';
import { resolveShell } from '../utility/pty-host.ts';
@@ -496,6 +497,7 @@ import {
setProjectWindowBounds,
setSpellCheckEnabled as setSpellCheckEnabledState,
type UpdateChannel,
+ unrecognizedUpdateModeIn,
windowRestoreKey,
} from './state-store.ts';
import { quoteStopCommandPath } from './stop-command.ts';
@@ -927,6 +929,13 @@ function loadAppState(): AppState {
quarantineCorruptState(statePath, 'schema-invalid');
return emptyState();
}
+ const unrecognizedUpdateMode = unrecognizedUpdateModeIn(raw);
+ if (unrecognizedUpdateMode !== null) {
+ getRootDesktopLogger().warn(
+ { persisted: unrecognizedUpdateMode },
+ 'persisted update mode unrecognized, automatic updates stay on',
+ );
+ }
return parsed;
}
@@ -6907,6 +6916,24 @@ function bootPrimaryInstance(): void {
}
}
} else if (result.kind === 'available') {
+ if (result.download === 'manual') {
+ const releasesUrl = releasesPageUrl(DESKTOP_VARIANT);
+ return dialog
+ .showMessageBox(target, {
+ type: 'info',
+ buttons: ['Download Manually', 'OK'],
+ defaultId: 0,
+ cancelId: 1,
+ title: 'Update Available',
+ message: `OpenKnowledge ${result.latestVersion} is available.`,
+ detail:
+ 'Automatic updates are turned off, so OpenKnowledge will not download it. Download it from the releases page, or turn on "Download and install updates automatically" in Settings > About & updates.',
+ })
+ .then(async ({ response }) => {
+ if (response === 0) await shell.openExternal(releasesUrl);
+ return 'dismiss' as const;
+ });
+ }
void dialog.showMessageBox(target, {
type: 'info',
buttons: ['OK'],
diff --git a/packages/desktop/src/main/state-store.ts b/packages/desktop/src/main/state-store.ts
index 64047da75..4e97b0285 100644
--- a/packages/desktop/src/main/state-store.ts
+++ b/packages/desktop/src/main/state-store.ts
@@ -1,6 +1,9 @@
import { existsSync, mkdirSync, renameSync, unlinkSync, writeFileSync } from 'node:fs';
import { join } from 'node:path';
-import type { OkTerminalRestartSnapshot } from '@inkeep/open-knowledge-core/desktop-bridge';
+import type {
+ OkTerminalRestartSnapshot,
+ OkUpdateMode,
+} from '@inkeep/open-knowledge-core/desktop-bridge';
import { canonicalizeGitHubRemoteUrl } from './git-remote.ts';
interface RecentProject {
@@ -69,6 +72,29 @@ export interface PersistedTerminalDockState {
export type UpdateChannel = 'latest' | 'beta';
+export type { OkUpdateMode };
+
+const DEFAULT_UPDATE_MODE: OkUpdateMode = 'auto';
+
+export interface UpdateModeResolution {
+ mode: OkUpdateMode;
+ source: 'user' | 'default';
+}
+
+export function resolveUpdateMode(raw: unknown): UpdateModeResolution {
+ if (raw === 'auto' || raw === 'off') return { mode: raw, source: 'user' };
+ return { mode: DEFAULT_UPDATE_MODE, source: 'default' };
+}
+
+export function unrecognizedUpdateModeIn(rawState: unknown): string | null {
+ if (typeof rawState !== 'object' || rawState === null || !('updateMode' in rawState)) {
+ return null;
+ }
+ const persisted = rawState.updateMode;
+ if (persisted === null || resolveUpdateMode(persisted).source === 'user') return null;
+ return typeof persisted === 'string' ? persisted.slice(0, 64) : typeof persisted;
+}
+
export const CURRENT_SCHEMA_VERSION = 1;
export const MAX_SUPPORTED_SCHEMA_VERSION = 1;
@@ -97,6 +123,9 @@ export interface AppState {
lastUsedProjectParent: string | null;
pendingWindowRestore: RestoredWindow[] | null;
spellCheckEnabled: boolean;
+ updateMode: OkUpdateMode | null;
+ gaveUpOnVersion: string | null;
+ dismissedUpdateVersion: string | null;
}
const RECENT_CAP = 20;
@@ -135,6 +164,9 @@ export function emptyState(): AppState {
lastUsedProjectParent: null,
pendingWindowRestore: null,
spellCheckEnabled: true,
+ updateMode: null,
+ gaveUpOnVersion: null,
+ dismissedUpdateVersion: null,
};
}
@@ -672,6 +704,11 @@ export function parseAppState(raw: unknown): AppState | null {
const recentFiles = parseRecentFiles(obj.recentFiles);
const spellCheckEnabled =
typeof obj.spellCheckEnabled === 'boolean' ? obj.spellCheckEnabled : true;
+ const updateModeResolution = resolveUpdateMode(obj.updateMode);
+ const updateMode = updateModeResolution.source === 'user' ? updateModeResolution.mode : null;
+ const gaveUpOnVersion = typeof obj.gaveUpOnVersion === 'string' ? obj.gaveUpOnVersion : null;
+ const dismissedUpdateVersion =
+ typeof obj.dismissedUpdateVersion === 'string' ? obj.dismissedUpdateVersion : null;
return {
recentProjects,
recentFiles,
@@ -696,5 +733,8 @@ export function parseAppState(raw: unknown): AppState | null {
lastUsedProjectParent,
pendingWindowRestore,
spellCheckEnabled,
+ updateMode,
+ gaveUpOnVersion,
+ dismissedUpdateVersion,
};
}
diff --git a/packages/desktop/src/main/update-state-handlers.ts b/packages/desktop/src/main/update-state-handlers.ts
index 0f78a2e4a..c681dd046 100644
--- a/packages/desktop/src/main/update-state-handlers.ts
+++ b/packages/desktop/src/main/update-state-handlers.ts
@@ -3,6 +3,7 @@ import { buildAboutInfo } from './about-info.ts';
import {
type AppState,
emptyState,
+ resolveUpdateMode,
type SchemaIncompatibilityDiagnostic,
type UpdateChannel,
} from './state-store.ts';
@@ -43,5 +44,6 @@ export async function applyStateQuery(
variant: deps.variant,
updateChecksAvailable: deps.isUpdaterRunning(),
}),
+ updateMode: resolveUpdateMode(deps.getAppState().updateMode).mode,
};
}
diff --git a/packages/desktop/src/preload/bridge-forwarding.test.ts b/packages/desktop/src/preload/bridge-forwarding.test.ts
index 637ca4633..eb3296231 100644
--- a/packages/desktop/src/preload/bridge-forwarding.test.ts
+++ b/packages/desktop/src/preload/bridge-forwarding.test.ts
@@ -21,6 +21,13 @@ vi.mock('electron', () => ({
type BridgeProbe = {
mcpServerName: string | null;
state: { query(): Promise<unknown> };
+ update: {
+ relaunchNow(): Promise<void>;
+ checkNow(): Promise<void>;
+ dismissWhatsNew(version: string): Promise<void>;
+ dismissDownloaded(version: string): Promise<void>;
+ setMode(mode: 'auto' | 'off'): Promise<void>;
+ };
config: {
languagePreference?: string;
themePreference?: string;
@@ -346,3 +353,49 @@ describe('preload userConfig subscription', () => {
expect(cb).not.toHaveBeenCalled();
});
});
+
+describe('preload update dispatch marshalling', () => {
+ const echoKind = (_channel: unknown, request: unknown) =>
+ Promise.resolve({ kind: (request as { kind: string }).kind, ok: true, mode: 'off' });
+
+ it('sends each update method as its own dispatch kind', async () => {
+ const bridge = await loadBridge();
+ for (let i = 0; i < 5; i++) invokeMock.mockImplementationOnce(echoKind as never);
+
+ await bridge.update.relaunchNow();
+ await bridge.update.checkNow();
+ await bridge.update.dismissWhatsNew('0.3.1');
+ await bridge.update.dismissDownloaded('0.3.2');
+ await bridge.update.setMode('off');
+
+ expect(invokeMock.mock.calls).toEqual([
+ ['ok:update:dispatch', { kind: 'relaunch-now' }],
+ ['ok:update:dispatch', { kind: 'check-now' }],
+ ['ok:update:dispatch', { kind: 'whats-new-dismiss', version: '0.3.1' }],
+ ['ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' }],
+ ['ok:update:dispatch', { kind: 'set-mode', mode: 'off' }],
+ ]);
+ });
+
+ it('rejects a reply whose kind does not match the request', async () => {
+ const bridge = await loadBridge();
+ invokeMock.mockResolvedValueOnce({ kind: 'check-now' } as never);
+
+ await expect(bridge.update.relaunchNow()).rejects.toThrow(
+ 'ok:update:dispatch: expected relaunch-now, got check-now',
+ );
+ });
+
+ it('turns a refused set-mode into a rejection that names the reason', async () => {
+ const bridge = await loadBridge();
+ invokeMock.mockResolvedValueOnce({
+ kind: 'set-mode',
+ ok: false,
+ reason: 'persist-failed',
+ } as never);
+
+ await expect(bridge.update.setMode('off')).rejects.toThrow(
+ 'ok:update:dispatch: set-mode refused (persist-failed)',
+ );
+ });
+});
diff --git a/packages/desktop/src/preload/index.ts b/packages/desktop/src/preload/index.ts
index f67c56285..b7c1aa3ab 100644
--- a/packages/desktop/src/preload/index.ts
+++ b/packages/desktop/src/preload/index.ts
@@ -68,6 +68,8 @@ import type {
AgentIntegrationsApplyResult,
IntegrationsSetResult,
IntegrationsStatus,
+ OkUpdateDispatchRequest,
+ OkUpdateDispatchResult,
ProjectIntegrationsSetResult,
ProjectIntegrationsStatus,
} from '../shared/ipc-channels.ts';
@@ -91,6 +93,14 @@ import { createUninstallBridge } from './uninstall.ts';
const invoke = createInvoker(ipcRenderer);
+async function dispatchUpdate(request: OkUpdateDispatchRequest): Promise<OkUpdateDispatchResult> {
+ const result = await invoke('ok:update:dispatch', request);
+ if (result.kind !== request.kind) {
+ throw new Error(`ok:update:dispatch: expected ${request.kind}, got ${result.kind}`);
+ }
+ return result;
+}
+
function isDockStateIpcTeardown(error: unknown): boolean {
if (!(error instanceof Error)) return false;
return /destroyed|disposed|closed|no handler registered/i.test(error.message);
@@ -698,9 +708,24 @@ const bridge: OkDesktopBridge = {
},
update: {
- relaunchNow: () => invoke('ok:update:relaunch-now'),
- checkNow: () => invoke('ok:update:check-now'),
- dismissWhatsNew: (version: string) => invoke('ok:update:whats-new-dismiss', { version }),
+ relaunchNow: async () => {
+ await dispatchUpdate({ kind: 'relaunch-now' });
+ },
+ checkNow: async () => {
+ await dispatchUpdate({ kind: 'check-now' });
+ },
+ dismissWhatsNew: async (version: string) => {
+ await dispatchUpdate({ kind: 'whats-new-dismiss', version });
+ },
+ dismissDownloaded: async (version: string) => {
+ await dispatchUpdate({ kind: 'downloaded-dismiss', version });
+ },
+ setMode: async (mode) => {
+ const result = await dispatchUpdate({ kind: 'set-mode', mode });
+ if (result.kind === 'set-mode' && !result.ok) {
+ throw new Error(`ok:update:dispatch: set-mode refused (${result.reason})`);
+ }
+ },
},
state: {
diff --git a/packages/desktop/src/shared/ipc-channels.ts b/packages/desktop/src/shared/ipc-channels.ts
index 0c6bcc9e3..654d440ac 100644
--- a/packages/desktop/src/shared/ipc-channels.ts
+++ b/packages/desktop/src/shared/ipc-channels.ts
@@ -68,6 +68,7 @@ import type {
OkTerminalDockStateUpdate,
OkTerminalDockStateWriteResult,
OkThemeSource,
+ OkUpdateMode,
OkUserConfigPatchResult,
OkUserConfigSnapshot,
OkSeedApplyOptions as SeedApplyOptions,
@@ -370,6 +371,24 @@ interface DialogOpenFolderOpts {
readonly defaultPath?: string;
}
+export type OkUpdateDispatchRequest =
+ | { readonly kind: 'relaunch-now' }
+ | { readonly kind: 'check-now' }
+ | { readonly kind: 'whats-new-dismiss'; readonly version: string }
+ | { readonly kind: 'downloaded-dismiss'; readonly version: string }
+ | { readonly kind: 'set-mode'; readonly mode: OkUpdateMode };
+
+export type OkUpdateSetModeFailure = 'unrecognized-mode' | 'persist-failed';
+
+export type OkUpdateDispatchResult =
+ | { readonly kind: 'relaunch-now' }
+ | { readonly kind: 'check-now' }
+ | { readonly kind: 'whats-new-dismiss' }
+ | { readonly kind: 'downloaded-dismiss' }
+ | { readonly kind: 'set-mode'; readonly ok: true; readonly mode: OkUpdateMode }
+ | { readonly kind: 'set-mode'; readonly ok: false; readonly reason: OkUpdateSetModeFailure }
+ | { readonly kind: 'unknown'; readonly ok: false; readonly reason: 'unrecognized-kind' };
+
export type UserConfigDispatchRequest =
| { kind: 'set-language-preference'; preference: LanguagePreference }
| { kind: 'read' }
@@ -552,9 +571,10 @@ export interface RequestChannels {
| { ok: false; reason: 'no-project' | 'invalid-request' }
| OkNoteWindowMainActionResult;
};
- 'ok:update:relaunch-now': { args: []; result: undefined };
- 'ok:update:check-now': { args: []; result: undefined };
- 'ok:update:whats-new-dismiss': { args: [{ version: string }]; result: undefined };
+ 'ok:update:dispatch': {
+ args: [request: OkUpdateDispatchRequest];
+ result: OkUpdateDispatchResult;
+ };
'ok:state:query': { args: []; result: Required<OkStateSnapshot> };
'ok:state:reset-incompatible': { args: []; result: undefined };
'ok:theme:set-source': { args: [params: { source: OkThemeSource }]; result: { ok: true } };
diff --git a/packages/desktop/src/shared/ipc-events.ts b/packages/desktop/src/shared/ipc-events.ts
index a4f8ba1ad..d7b2f0aad 100644
--- a/packages/desktop/src/shared/ipc-events.ts
+++ b/packages/desktop/src/shared/ipc-events.ts
@@ -32,7 +32,7 @@ export interface EventChannels {
'ok:project:recent-removed-missing': { payload: OkRecentRemovedMissingInfo };
'ok:menu-action': { payload: OkMenuActionDispatch };
'ok:note-window:main-action': { payload: OkNoteWindowMainAction };
- 'ok:update:downloaded': { payload: { version: string } };
+ 'ok:update:downloaded': { payload: { version: string | null } };
'ok:update:relaunching': { payload: { version: string } };
'ok:update:fetching-latest': { payload: { version: string } };
'ok:update:relaunch-failed': { payload: OkUpdateRelaunchFailedInfo };
diff --git a/packages/desktop/tests/integration/auto-updater.test.ts b/packages/desktop/tests/integration/auto-updater.test.ts
index c6959db51..9892e87f5 100644
--- a/packages/desktop/tests/integration/auto-updater.test.ts
+++ b/packages/desktop/tests/integration/auto-updater.test.ts
@@ -355,7 +355,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
test('linux: relaunch-now is the install-commit point — it arms attemptedInstall', async () => {
const { rig } = makeRig({ platform: 'linux' });
rig.updater.emit('update-downloaded', { version: '0.3.2' });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.state.attemptedInstall).toBe('0.3.2');
expect(rig.state.attemptedInstallSurfacedCount).toBe(0);
@@ -786,6 +786,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
kind: 'available',
currentVersion: '0.68.0-beta.2',
latestVersion: '0.68.13-beta.5',
+ download: 'background',
});
});
@@ -842,7 +843,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
});
const headers = rig.updater.requestHeaders;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await expect(handle.checkForUpdatesNow()).resolves.toBeUndefined();
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
@@ -891,7 +892,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
updater.checkForUpdates = vi.fn(() => new Promise<undefined>(() => {}));
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.logger.info).toHaveBeenCalledWith(
'check already in flight, reusing the pending promise',
{
@@ -904,7 +905,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
},
);
rig.now = new Date(rig.now.getTime() + UPDATE_CHECK_DEADLINE_MS - 1);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started', 'started']);
expect(rig.dispatches).toContain('check-now-already-pending');
expect(showCheckNowResult).not.toHaveBeenCalled();
@@ -941,7 +942,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
{ ms: MANUAL_CHECK_WATCHDOG_MS },
);
expect(manualCheckPhases(rig)).toEqual(['started', 'started', 'settled']);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(showCheckNowResult).toHaveBeenCalledTimes(2);
expect(showCheckNowResult).toHaveBeenLastCalledWith({
kind: 'error',
@@ -990,7 +991,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
});
fireTimerFor(rig.clock, UPDATE_CHECK_INTERVAL_MS);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('error', error);
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(2);
expect(rig.updater.setFeedURL).toHaveBeenCalledTimes(2);
@@ -1068,7 +1069,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
});
await Promise.resolve();
rig.updater.checkForUpdates.mockImplementation(() => rejectAfterErrorEvent(rig.updater, error));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
const log = level === 'warn' ? rig.logger.warn : rig.logger.debug;
expect(
@@ -1082,7 +1083,7 @@ describe('startAutoUpdater — initial configuration (parent §8.10 LOCKED)', ()
],
]);
expect(rig.updater.setFeedURL).toHaveBeenCalledTimes(1);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
expect(
log.mock.calls.filter(
@@ -1105,7 +1106,7 @@ describe('staging age — how long the update sat before the install was request
rig.now = new Date('2026-04-21T12:00:00.000Z');
rig.updater.emit('update-downloaded', { version: '0.3.2' });
rig.now = new Date('2026-04-21T12:00:02.060Z');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.state.attemptedInstallStagingAgeMs).toBe(2060);
expect(rig.logger.info).toHaveBeenCalledWith(
@@ -1121,7 +1122,7 @@ describe('staging age — how long the update sat before the install was request
rig.now = new Date('2026-04-21T12:00:00.000Z');
rig.updater.emit('update-downloaded', { version: '0.3.2' });
rig.now = new Date('2026-04-21T11:59:57.000Z');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.state.attemptedInstallStagingAgeMs).toBeNull();
});
@@ -1156,7 +1157,7 @@ describe('staging age — how long the update sat before the install was request
session.now = new Date('2026-04-21T12:00:00.000Z');
session.updater.emit('update-downloaded', { version: '0.3.2' });
session.now = new Date('2026-04-21T12:00:02.060Z');
- await session.ipc.invoke('ok:update:relaunch-now');
+ await session.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(session.state.attemptedInstallStagingAgeMs).toBe(2060);
session.now = new Date('2026-04-21T13:00:00.000Z');
@@ -1246,7 +1247,7 @@ describe('cross-channel veto on update-available', () => {
test('menu-driven check: cross-channel offer remaps to not-available + does not download', () => {
const showCheckNowResult = vi.fn(() => {});
const { rig } = makeRig({ appVersion: '0.5.0-beta.5', showCheckNowResult });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
expect(showCheckNowResult).toHaveBeenCalledWith({
kind: 'not-available',
@@ -1856,8 +1857,8 @@ describe('boot-time failed-install detection', () => {
expect(rig.dispatches).toContain('install-failed-on-boot' as DispatchKind);
});
- test('retry budget exhausted → gives up, clears the record incl. pending marker', () => {
- const { rig } = makeRig({
+ test('retry budget exhausted → tombstones the version and keeps the staged build installable', () => {
+ const { rig, handle } = makeRig({
attemptedInstall: '0.17.0-beta.1',
attemptedInstallHandoffAt: COMMITTED_LONG_AGO,
versionPendingInstall: '0.17.0-beta.1',
@@ -1868,8 +1869,10 @@ describe('boot-time failed-install detection', () => {
expect(rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed')).toHaveLength(0);
expect(rig.state.attemptedInstall).toBeNull();
expect(rig.state.attemptedInstallSurfacedCount).toBe(0);
- expect(rig.state.versionPendingInstall).toBeNull();
- expect(rig.state.stagedInstallerPath).toBeNull();
+ expect(rig.state.gaveUpOnVersion).toBe('0.17.0-beta.1');
+ expect(rig.state.versionPendingInstall).toBe('0.17.0-beta.1');
+ expect(rig.state.stagedInstallerPath).toBe('/tmp/staged-giveup.deb');
+ expect(handle.getPendingUpdate()).toBeNull();
expect(rig.dispatches).toContain('install-failed-giveup' as DispatchKind);
expect(rig.dispatches).not.toContain('install-failed-on-boot' as DispatchKind);
});
@@ -2187,7 +2190,8 @@ describe('boot-time failed-install detection — install still in flight', () =>
rig.now = STAGED_AT;
rig.updater.emit('update-downloaded', { version: overrides.attempted ?? ATTEMPTED });
rig.now = overrides.committedAt ?? HANDED_OFF_AT;
- if (via === 'relaunch-click') await rig.ipc.invoke('ok:update:relaunch-now');
+ if (via === 'relaunch-click')
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
else if (via === 'plain-quit') handle.recordInstallHandoffOnQuit();
return rig.state;
}
@@ -2361,7 +2365,7 @@ describe('boot-time failed-install detection — install still in flight', () =>
expect(reoffered.dispatches).toContain('install-never-committed-reoffered' as DispatchKind);
reoffered.now = new Date(STAGED_AT.getTime() + 24 * HOUR + MINUTE);
- await reoffered.ipc.invoke('ok:update:relaunch-now');
+ await reoffered.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(reoffered.state.attemptedInstallHandoffAt).not.toBeNull();
const reclaim = vi.fn();
@@ -2819,7 +2823,7 @@ describe('multi-window delivery: relaunch banner and "updated to" notice both re
test('manual check started and settled phases reach every open window', async () => {
const { rig } = makeRig({ extraWindowCount: 2 });
expect(rig.windows).toHaveLength(3);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-not-available', { version: '0.3.1' });
await new Promise((resolve) => setTimeout(resolve, 0));
for (const win of rig.windows) {
@@ -2877,14 +2881,9 @@ describe('multi-window delivery: relaunch banner and "updated to" notice both re
});
describe('release-notes cross-window dismiss + late-window delivery', () => {
- test('registers the whats-new-dismiss IPC handler', () => {
- const { rig } = makeRig();
- expect(rig.ipc.handlers.has('ok:update:whats-new-dismiss')).toBe(true);
- });
-
test('whats-new-dismiss re-broadcasts ok:update:whats-new-dismissed to every window', () => {
const { rig } = makeRig({ extraWindowCount: 2 });
- rig.ipc.invoke('ok:update:whats-new-dismiss', { version: '0.3.1' });
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'whats-new-dismiss', version: '0.3.1' });
for (const win of rig.windows) {
const dismissed = win.filter((c) => c.channel === 'ok:update:whats-new-dismissed');
expect(dismissed).toHaveLength(1);
@@ -2908,13 +2907,13 @@ describe('release-notes cross-window dismiss + late-window delivery', () => {
test('getActiveWhatsNew returns null after the notice is dismissed', () => {
const { rig, handle } = makeRig({ lastSeenVersion: '0.3.0', appVersion: '0.3.1' });
expect(handle.getActiveWhatsNew()).not.toBeNull();
- rig.ipc.invoke('ok:update:whats-new-dismiss', { version: '0.3.1' });
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'whats-new-dismiss', version: '0.3.1' });
expect(handle.getActiveWhatsNew()).toBeNull();
});
test('a stale dismiss for an older version leaves a newer live notice intact', () => {
const { rig, handle } = makeRig({ lastSeenVersion: '0.3.0', appVersion: '0.3.1' });
- rig.ipc.invoke('ok:update:whats-new-dismiss', { version: '0.3.0' });
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'whats-new-dismiss', version: '0.3.0' });
expect(handle.getActiveWhatsNew()).toMatchObject({ version: '0.3.1' });
});
});
@@ -3062,22 +3061,22 @@ describe('periodic check singleton + jitter (AC10, D10)', () => {
});
});
-describe('ok:update:relaunch-now IPC handler (AC18)', () => {
- test('registers the handler on startup', () => {
+describe('relaunch-now dispatch (AC18)', () => {
+ test('registers the single ok:update:dispatch handler on startup', () => {
const { rig } = makeRig();
- expect(rig.ipc.handlers.has('ok:update:relaunch-now')).toBe(true);
+ expect(rig.ipc.handlers.has('ok:update:dispatch')).toBe(true);
});
test('handler invocation WITH versionPendingInstall calls autoUpdater.quitAndInstall', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.dispatches).toContain('relaunch-now' as DispatchKind);
});
test('handler invocation WITHOUT versionPendingInstall is ignored (Finding #5 guard)', () => {
const { rig } = makeRig({ versionPendingInstall: null });
- rig.ipc.invoke('ok:update:relaunch-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(rig.dispatches).not.toContain('relaunch-now' as DispatchKind);
expect(rig.logger.warn).toHaveBeenCalled();
@@ -3086,7 +3085,7 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
test('broadcasts ok:update:relaunching to EVERY open window so all swap in lockstep', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2', extraWindowCount: 2 });
expect(rig.windows).toHaveLength(3);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
for (const win of rig.windows) {
const relaunching = win.filter((c) => c.channel === 'ok:update:relaunching');
expect(relaunching).toHaveLength(1);
@@ -3100,9 +3099,9 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
rig.updater.quitAndInstall = vi.fn(() => {
throw new Error('SQRLInstallerErrorDomain Code=-9');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'SQRLInstallerErrorDomain Code=-9',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('SQRLInstallerErrorDomain Code=-9');
expect(rig.state.versionPendingInstall).toBe('0.3.2');
for (const win of rig.windows) {
expect(win.filter((c) => c.channel === 'ok:update:relaunching')).toHaveLength(1);
@@ -3118,13 +3117,13 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
}
expect(rig.dispatches).toContain('relaunch-failed-rearm' as DispatchKind);
rig.updater.quitAndInstall = vi.fn(() => {});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
});
test('does NOT broadcast ok:update:relaunching when nothing is pending (gated)', () => {
const { rig } = makeRig({ versionPendingInstall: null, extraWindowCount: 2 });
- rig.ipc.invoke('ok:update:relaunch-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
for (const win of rig.windows) {
expect(win.filter((c) => c.channel === 'ok:update:relaunching')).toHaveLength(0);
}
@@ -3162,14 +3161,14 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
debug: vi.fn(() => {}),
},
});
- await ipc.invoke('ok:update:relaunch-now');
+ await ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(relaunchingSeenAtTeardown).toBe(1);
});
- test('destroy() removes the IPC handler', () => {
+ test('destroy() removes the ok:update:dispatch handler', () => {
const { rig, handle } = makeRig();
handle.destroy();
- expect(rig.ipc.handlers.has('ok:update:relaunch-now')).toBe(false);
+ expect(rig.ipc.handlers.has('ok:update:dispatch')).toBe(false);
});
test('teardown and survivor sweep fire before quitAndInstall in that order', async () => {
@@ -3206,14 +3205,14 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
debug: vi.fn(() => {}),
},
});
- await ipc.invoke('ok:update:relaunch-now');
+ await ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(calls).toEqual(['prepareForRelaunch', 'sweepUpdateSurvivors', 'quitAndInstall']);
});
test('prepareForRelaunch does NOT fire when versionPendingInstall is null', () => {
const prepareForRelaunch = vi.fn(() => {});
const { rig } = makeRig({ versionPendingInstall: null, prepareForRelaunch });
- rig.ipc.invoke('ok:update:relaunch-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(prepareForRelaunch).not.toHaveBeenCalled();
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
});
@@ -3223,7 +3222,7 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
throw new Error('teardown bug');
});
const { rig } = makeRig({ versionPendingInstall: '0.3.2', prepareForRelaunch });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(prepareForRelaunch).toHaveBeenCalledTimes(1);
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.logger.warn).toHaveBeenCalled();
@@ -3234,7 +3233,7 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
throw new Error('process query failed');
});
const { rig } = makeRig({ versionPendingInstall: '0.3.2', sweepUpdateSurvivors });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(sweepUpdateSurvivors).toHaveBeenCalledTimes(1);
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.logger.warn).toHaveBeenCalled();
@@ -3250,7 +3249,7 @@ describe('ok:update:relaunch-now IPC handler (AC18)', () => {
}));
const { rig } = makeRig({ versionPendingInstall: '0.3.2', sweepUpdateSurvivors });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.logger.warn).toHaveBeenCalledWith(
@@ -3266,7 +3265,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
await Promise.resolve();
await Promise.resolve();
expect(rig.clock.lastMs).toBe(UPDATE_CHECK_INTERVAL_MS);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.clock.lastMs).toBe(RELAUNCH_WATCHDOG_MS);
expect(rig.clock.lastCallback).not.toBeNull();
});
@@ -3276,7 +3275,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
await Promise.resolve();
await Promise.resolve();
expect(rig.clock.lastMs).toBe(UPDATE_CHECK_INTERVAL_MS);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.state.versionPendingInstall).toBeNull();
fireTimerFor(rig.clock, RELAUNCH_WATCHDOG_MS);
expect(rig.state.versionPendingInstall).toBe('0.3.2');
@@ -3297,7 +3296,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
await Promise.resolve();
await Promise.resolve();
expect(rig.clock.lastMs).toBe(UPDATE_CHECK_INTERVAL_MS);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('ShipIt swap failed'));
expect(rig.state.versionPendingInstall).toBe('0.3.2');
for (const win of rig.windows) {
@@ -3323,7 +3322,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
rig.updater.quitAndInstall = vi.fn(() => {
rig.updater.emit('error', new Error('pkexec: authorization could not be obtained'));
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.state.versionPendingInstall).toBe('0.3.2');
for (const win of rig.windows) {
const failed = win.filter((c) => c.channel === 'ok:update:relaunch-failed');
@@ -3342,7 +3341,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
await Promise.resolve();
await Promise.resolve();
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', Object.assign(new Error('HTTP 500'), { code: 'HTTP_ERROR_500' }));
expect(rig.dispatches).toContain('error-classified' as DispatchKind);
expect(rig.dispatches.filter((d) => d === 'relaunch-error-event')).toHaveLength(1);
@@ -3353,7 +3352,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
await Promise.resolve();
await Promise.resolve();
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error(''));
const failed = rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed');
expect(failed).toHaveLength(1);
@@ -3368,7 +3367,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
await Promise.resolve();
await Promise.resolve();
expect(rig.clock.lastMs).toBe(UPDATE_CHECK_INTERVAL_MS);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
fireTimerFor(rig.clock, RELAUNCH_WATCHDOG_MS);
rig.updater.emit('error', new Error('ShipIt swap failed (late)'));
expect(rig.state.versionPendingInstall).toBe('0.3.2');
@@ -3415,7 +3414,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
});
await Promise.resolve();
await Promise.resolve();
- await ipc.invoke('ok:update:relaunch-now');
+ await ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
failWrites = true;
fireTimerFor(clock, RELAUNCH_WATCHDOG_MS);
expect(state.versionPendingInstall).toBeNull();
@@ -3438,7 +3437,7 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
test('watchdog NOT armed when isPackaged=false (dev quitAndInstall no-op is not a failure)', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2', isPackaged: false });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.clock.lastCallback).toBeNull();
rig.updater.emit('error', new Error('dev error'));
expect(rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed')).toHaveLength(0);
@@ -3449,24 +3448,19 @@ describe('async relaunch failure — error event + no-quit watchdog', () => {
await Promise.resolve();
await Promise.resolve();
expect(rig.clock.lastMs).toBe(UPDATE_CHECK_INTERVAL_MS);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.clock.lastCallback).not.toBeNull();
handle.destroy();
expect(rig.clock.lastCallback).toBeNull();
});
});
-describe('ok:update:check-now IPC handler', () => {
- test('registers the handler on startup', () => {
- const { rig } = makeRig();
- expect(rig.ipc.handlers.has('ok:update:check-now')).toBe(true);
- });
-
+describe('check-now dispatch', () => {
test('handler invocation calls updater.checkForUpdates', async () => {
const { rig } = makeRig();
await Promise.resolve();
rig.updater.checkForUpdates.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
});
@@ -3476,8 +3470,8 @@ describe('ok:update:check-now IPC handler', () => {
rig.updater.checkForUpdates = vi.fn(() => new Promise(() => {}));
rig.updater.checkForUpdates.mockClear();
- rig.ipc.invoke('ok:update:check-now');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
expect(manualCheckPhases(rig)).toEqual(['started', 'started']);
@@ -3491,7 +3485,7 @@ describe('ok:update:check-now IPC handler', () => {
const { rig } = makeRig({ versionPendingInstall: null });
await Promise.resolve();
rig.updater.checkForUpdates.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
});
@@ -3507,13 +3501,7 @@ describe('ok:update:check-now IPC handler', () => {
const { rig } = makeRig();
await Promise.resolve();
rig.updater.checkForUpdates = vi.fn(() => Promise.reject(new Error('network down')));
- expect(() => rig.ipc.invoke('ok:update:check-now')).not.toThrow();
- });
-
- test('destroy() removes the check-now IPC handler', () => {
- const { rig, handle } = makeRig();
- handle.destroy();
- expect(rig.ipc.handlers.has('ok:update:check-now')).toBe(false);
+ expect(() => rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' })).not.toThrow();
});
});
@@ -3531,7 +3519,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
updater.checkForUpdates = vi.fn(() => pending.promise);
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.now = new Date(rig.now.getTime() + UPDATE_CHECK_DEADLINE_MS);
fireTimerFor(rig.clock, UPDATE_CHECK_DEADLINE_MS);
expect(showCheckNowResult).not.toHaveBeenCalled();
@@ -3539,7 +3527,12 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
rig.updater.emit(event, { version: '0.5.0' });
expect(showCheckNowResult).toHaveBeenCalledExactlyOnceWith(
event === 'update-available'
- ? { kind: 'available', currentVersion: '0.4.0', latestVersion: '0.5.0' }
+ ? {
+ kind: 'available',
+ currentVersion: '0.4.0',
+ latestVersion: '0.5.0',
+ download: 'background',
+ }
: { kind: 'not-available', currentVersion: '0.4.0' },
);
expect(manualCheckPhases(rig)).toEqual(['started', 'settled']);
@@ -3568,7 +3561,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
updater.checkForUpdates = vi.fn(() => pending.promise);
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.now = new Date(rig.now.getTime() + UPDATE_CHECK_DEADLINE_MS);
fireTimerFor(rig.clock, UPDATE_CHECK_DEADLINE_MS);
expect(showCheckNowResult).not.toHaveBeenCalled();
@@ -3625,7 +3618,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
expect(rig.captured.filter((c) => c.channel === 'ok:update:stuck-hint')).toHaveLength(0);
expect(rig.state.stuckHintShown).toBe(false);
rig.now = new Date(rig.now.getTime() + 2);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
}
expect(rig.captured.filter((c) => c.channel === 'ok:update:stuck-hint')).toEqual([
{ channel: 'ok:update:stuck-hint', payload: { downloadUrl: STUCK_HINT_DOWNLOAD_URL } },
@@ -3672,7 +3665,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
proxyFallbackTried: false,
});
expect(showCheckNowResult).not.toHaveBeenCalled();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(showCheckNowResult).toHaveBeenCalledTimes(1);
expect(showCheckNowResult).toHaveBeenCalledWith({
kind: 'error',
@@ -3722,7 +3715,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
});
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(showCheckNowResult).not.toHaveBeenCalled();
rig.now = new Date(rig.now.getTime() + UPDATE_CHECK_DEADLINE_MS);
if (outcome === 'destroy') {
@@ -3792,7 +3785,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
rig.updater.checkForUpdates.mockImplementation(() =>
rejectAfterErrorEvent(rig.updater, error),
);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
expect(showCheckNowResult).toHaveBeenCalledTimes(1);
expect(showCheckNowResult).toHaveBeenCalledWith(
@@ -3840,7 +3833,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
}
throw new Error('unexpected updater feed');
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
if (outcome === 'dispatch-throw') {
expect(rig.logger.error).toHaveBeenCalledWith('proxy-feed fallback checkForUpdates threw', {
@@ -3887,7 +3880,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
const reuseLogsBeforeClick = rig.logger.info.mock.calls.filter(
([message]) => message === 'check already in flight, reusing the pending promise',
).length;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(showCheckNowResult).not.toHaveBeenCalled();
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(2);
expect(rig.dispatches).toContain('check-now-already-pending');
@@ -3951,7 +3944,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
);
expect(rig.clock.clearTimeout).not.toHaveBeenCalledWith(deadlineHandle);
const feedCalls = rig.updater.setFeedURL.mock.calls.length;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual([
'started',
'started',
@@ -4037,7 +4030,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
throw new Error('unexpected updater feed');
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
expect(showCheckNowResult).not.toHaveBeenCalled();
finishRetry.resolve(undefined);
@@ -4049,6 +4042,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
kind: 'available',
currentVersion: '0.4.0',
latestVersion: '0.4.1',
+ download: 'background',
});
expect(showCheckNowResult).not.toHaveBeenCalledWith(
expect.objectContaining({ kind: 'not-available' }),
@@ -4091,7 +4085,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
rejectAfterErrorEvent(rig.updater, proxyError),
);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((resolve) => setTimeout(resolve, 0));
expect(showCheckNowResult).toHaveBeenCalledTimes(1);
expect(showCheckNowResult).toHaveBeenCalledWith({ kind: 'error', message: proxyError.message });
@@ -4113,7 +4107,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
? Promise.reject(new Error('network unavailable'))
: Promise.resolve(null),
);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const [watchdogHandle, watchdog] = liveTimerFor(rig.clock, MANUAL_CHECK_WATCHDOG_MS);
expect(watchdog.state).toBe('live');
@@ -4139,7 +4133,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
const showCheckNowResult = vi.fn(() => {});
const { rig, handle } = makeRig({ showCheckNowResult, isPackaged: false });
rig.updater.checkForUpdates = vi.fn(() => new Promise(() => {}));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const [watchdogHandle, watchdog] = liveTimerFor(rig.clock, MANUAL_CHECK_WATCHDOG_MS);
handle.destroy();
expect(rig.clock.clearTimeout).toHaveBeenCalledWith(watchdogHandle);
@@ -4156,7 +4150,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
throw dialogError;
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const [watchdogHandle] = liveTimerFor(rig.clock, MANUAL_CHECK_WATCHDOG_MS);
expect(() => rig.updater.emit('update-not-available', { version: '0.3.1' })).not.toThrow();
@@ -4178,7 +4172,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
});
rig.updater.checkForUpdates = vi.fn(() => Promise.resolve(null));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const [watchdogHandle, watchdog] = liveTimerFor(rig.clock, MANUAL_CHECK_WATCHDOG_MS);
expect(manualCheckPhases(rig)).toEqual(['started']);
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4189,7 +4183,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
watchdog.cb();
expect(showCheckNowResult).toHaveBeenCalledTimes(1);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(2);
expect(manualCheckPhases(rig)).toEqual(['started', 'settled', 'started']);
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4204,13 +4198,13 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
await Promise.resolve();
rig.updater.checkForUpdates = vi.fn(() => Promise.resolve(undefined));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started']);
await new Promise((resolve) => setTimeout(resolve, 0));
expect(manualCheckPhases(rig)).toEqual(['started', 'settled']);
expect(showCheckNowResult).not.toHaveBeenCalled();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(2);
expect(manualCheckPhases(rig)).toEqual(['started', 'settled', 'started']);
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4226,7 +4220,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
showCheckNowResult.mockImplementation(() => {
phasesAtDialog = manualCheckPhases(rig);
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started']);
rig.updater.emit('update-not-available', { version: '0.4.0-beta.13' });
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4249,7 +4243,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
showCheckNowResult.mockImplementation(() => {
phasesAtDialog = manualCheckPhases(rig);
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started']);
rig.updater.emit('update-available', { version: '0.4.0-beta.14' });
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4259,6 +4253,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
kind: 'available',
currentVersion: '0.4.0-beta.13',
latestVersion: '0.4.0-beta.14',
+ download: 'background',
});
expect(manualCheckPhases(rig)).toEqual(['started', 'settled']);
});
@@ -4270,7 +4265,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
showCheckNowResult.mockImplementation(() => {
phasesAtDialog = manualCheckPhases(rig);
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started']);
rig.updater.emit('error', new Error('network timeout'));
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4286,7 +4281,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
test('ERR_UPDATER_CHANNEL_FILE_NOT_FOUND routes to not-available', () => {
const showCheckNowResult = vi.fn(() => {});
const { rig } = makeRig({ appVersion: '0.5.0-beta.21', showCheckNowResult });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const err = Object.assign(
new Error(
'Cannot find latest-mac.yml in the latest release artifacts (https://github.com/inkeep/open-knowledge/releases/download/v0.5.0-beta.22/latest-mac.yml): HttpError: 404',
@@ -4304,7 +4299,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
test('other classified updater errors still surface kind=error (channel-file-not-found is the only narrow case)', () => {
const showCheckNowResult = vi.fn(() => {});
const { rig } = makeRig({ showCheckNowResult });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
const err = Object.assign(new Error('zip missing'), {
code: 'ERR_UPDATER_ZIP_FILE_NOT_FOUND',
});
@@ -4326,7 +4321,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
test('subsequent events after dispatch do NOT re-fire (single-shot per check-now)', () => {
const showCheckNowResult = vi.fn(() => {});
const { rig } = makeRig({ showCheckNowResult });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-not-available', { version: '0.4.0-beta.13' });
rig.updater.emit('update-not-available', { version: '0.4.0-beta.13' });
rig.updater.emit('error', new Error('next-cycle network error'));
@@ -4342,7 +4337,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
showCheckNowResult.mockImplementation(() => {
phasesAtDialog = manualCheckPhases(rig);
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(manualCheckPhases(rig)).toEqual(['started']);
await new Promise((r) => setTimeout(r, 0));
expect(phasesAtDialog).toEqual(['started', 'settled']);
@@ -4361,7 +4356,7 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
code: 'ERR_UPDATER_CHANNEL_FILE_NOT_FOUND',
});
rig.updater.checkForUpdates = vi.fn(() => Promise.reject(err));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
await new Promise((r) => setTimeout(r, 0));
expect(showCheckNowResult).toHaveBeenCalledWith({
kind: 'not-available',
@@ -4371,7 +4366,12 @@ describe('check-now → showCheckNowResult feedback dispatch', () => {
});
describe('a download that fails after the menu check said "available"', () => {
- const offered = { kind: 'available', currentVersion: '0.4.0', latestVersion: '0.5.0' } as const;
+ const offered = {
+ kind: 'available',
+ currentVersion: '0.4.0',
+ latestVersion: '0.5.0',
+ download: 'background',
+ } as const;
const downloadFailed = {
kind: 'download-failed',
latestVersion: '0.5.0',
@@ -4400,7 +4400,7 @@ describe('a download that fails after the menu check said "available"', () => {
? rejectAfterErrorEvent(rig.updater, assetMissing())
: Promise.reject(assetMissing()),
);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
expect(showCheckNowResult).toHaveBeenCalledExactlyOnceWith(offered);
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4422,7 +4422,7 @@ describe('a download that fails after the menu check said "available"', () => {
rig.updater.downloadUpdate.mockImplementation(() => {
throw assetMissing();
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(() => rig.updater.emit('update-available', { version: '0.5.0' })).not.toThrow();
expect(showCheckNowResult).toHaveBeenCalledExactlyOnceWith(downloadFailed);
expect(manualCheckPhases(rig)).toEqual(['started', 'settled']);
@@ -4446,9 +4446,9 @@ describe('a download that fails after the menu check said "available"', () => {
},
});
await Promise.resolve();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
download.reject(assetMissing());
await new Promise((resolve) => setTimeout(resolve, 0));
@@ -4469,7 +4469,7 @@ describe('a download that fails after the menu check said "available"', () => {
});
await Promise.resolve();
rig.updater.emit('update-available', { version: '0.5.0' });
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
expect(rig.updater.downloadUpdate).toHaveBeenCalledTimes(2);
download.reject(assetMissing());
@@ -4507,10 +4507,10 @@ describe('a download that fails after the menu check said "available"', () => {
rig.updater.downloadUpdate.mockImplementation(() =>
rejectAfterErrorEvent(rig.updater, assetMissing()),
);
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
await new Promise((resolve) => setTimeout(resolve, 0));
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
await new Promise((resolve) => setTimeout(resolve, 0));
expect(rig.captured.filter((entry) => entry.channel === 'ok:update:downloaded')).toEqual([]);
@@ -4571,7 +4571,7 @@ describe('a download that fails after the menu check said "available"', () => {
rig.updater.emit('update-downloaded', { version: '0.5.0' });
return Promise.resolve([]);
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
for (let tick = 0; tick < 4; tick++) await new Promise((resolve) => setTimeout(resolve, 0));
expect(rig.updater.setFeedURL).toHaveBeenCalledWith(
@@ -4593,7 +4593,7 @@ describe('a download that fails after the menu check said "available"', () => {
updater.downloadUpdate = vi.fn(() => download.promise);
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.5.0' });
handle.destroy();
download.reject(assetMissing());
@@ -4668,7 +4668,7 @@ describe('dev-mode guard (isPackaged=false)', () => {
},
});
expect(rig.updater.checkForUpdates).not.toHaveBeenCalled();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
rig.now = new Date(rig.now.getTime() + UPDATE_CHECK_DEADLINE_MS);
fireTimerFor(rig.clock, UPDATE_CHECK_DEADLINE_MS);
@@ -4792,7 +4792,7 @@ describe('destroy() teardown', () => {
updater.checkForUpdates = vi.fn(() => new Promise(() => {}));
},
});
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
handle.destroy();
expect(manualCheckPhases(rig)).toEqual(['started', 'settled']);
const timerCount = rig.clock.setTimeout.mock.calls.length;
@@ -5042,8 +5042,8 @@ describe('Toast B persist-before-emit + whenRendererReady (Major #1)', () => {
describe('relaunch-now idempotency (Major #2)', () => {
test('second invocation sees the committed install → no second quitAndInstall', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
- const first = rig.ipc.invoke('ok:update:relaunch-now');
- const second = rig.ipc.invoke('ok:update:relaunch-now');
+ const first = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
+ const second = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.all([first, second]);
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(rig.dispatches).toContain('relaunch-double-invoke-blocked' as DispatchKind);
@@ -5076,7 +5076,9 @@ describe('relaunch-now idempotency (Major #2)', () => {
debug: vi.fn(() => {}),
},
});
- await expect(Promise.resolve(ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow();
+ await expect(
+ Promise.resolve(ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow();
expect(updater.quitAndInstall).not.toHaveBeenCalled();
expect(state.versionPendingInstall).toBe('0.3.2');
});
@@ -5287,7 +5289,7 @@ describe('staged-cache reclaim — fires only once every install commitment is s
expect(reclaim).not.toHaveBeenCalled();
});
- test('the giveup boot clears both gates but still skips the reclaim', () => {
+ test('the giveup boot keeps the staged build and skips the reclaim', () => {
const reclaim = vi.fn(() => Promise.resolve());
const { rig } = makeRig({
attemptedInstall: '0.9.9',
@@ -5297,7 +5299,7 @@ describe('staged-cache reclaim — fires only once every install commitment is s
});
expect(rig.dispatches).toContain('install-failed-giveup' as DispatchKind);
expect(rig.state.attemptedInstall).toBeNull();
- expect(rig.state.versionPendingInstall).toBeNull();
+ expect(rig.state.versionPendingInstall).toBe('0.9.9');
expect(reclaim).not.toHaveBeenCalled();
});
@@ -5375,7 +5377,7 @@ describe('linux manual-install fallback', () => {
test('no graphical auth → fallback dialog instead of quitAndInstall, staged state preserved', async () => {
const { rig, fallback } = makeLinuxRig({ hasGraphicalAuth: false, extraWindowCount: 1 });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(rig.state.versionPendingInstall).toBe('0.3.2');
expect(rig.state.attemptedInstall).toBeNull();
@@ -5396,7 +5398,7 @@ describe('linux manual-install fallback', () => {
test('graphical auth present → normal quitAndInstall path, no fallback', async () => {
const { rig, fallback, hasAuth } = makeLinuxRig({ hasGraphicalAuth: true });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(hasAuth).toHaveBeenCalled();
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(fallback).not.toHaveBeenCalled();
@@ -5407,7 +5409,7 @@ describe('linux manual-install fallback', () => {
hasGraphicalAuth: false,
downloadedFile: '/x/OpenKnowledge.AppImage',
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(fallback).not.toHaveBeenCalled();
});
@@ -5416,7 +5418,7 @@ describe('linux manual-install fallback', () => {
const { rig, fallback } = makeLinuxRig({ hasGraphicalAuth: true, extraWindowCount: 1 });
await Promise.resolve();
await Promise.resolve();
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('Command pkexec exited with code 126'));
expect(rig.state.versionPendingInstall).toBe('0.3.2');
for (const win of rig.windows) {
@@ -5433,10 +5435,10 @@ describe('linux manual-install fallback', () => {
test('retry after cancellation: the re-armed gate accepts a second relaunch-now', async () => {
const { rig } = makeLinuxRig({ hasGraphicalAuth: true });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('Command pkexec exited with code 126'));
expect(rig.state.versionPendingInstall).toBe('0.3.2');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(2);
});
@@ -5444,7 +5446,7 @@ describe('linux manual-install fallback', () => {
const { rig, fallback } = makeLinuxRig({ hasGraphicalAuth: true, extraWindowCount: 1 });
await Promise.resolve();
await Promise.resolve();
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('Command pkexec exited with code 127'));
expect(rig.state.versionPendingInstall).toBe('0.3.2');
for (const win of rig.windows) {
@@ -5467,7 +5469,7 @@ describe('linux manual-install fallback', () => {
test('sudo-without-tty failure (no graphical wrapper found mid-install) also offers the fallback', async () => {
const { rig, fallback } = makeLinuxRig({ hasGraphicalAuth: true });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('Command sudo exited with code 1'));
expect(fallback).toHaveBeenCalledTimes(1);
});
@@ -5477,7 +5479,7 @@ describe('linux manual-install fallback', () => {
hasGraphicalAuth: false,
downloadedFile: '/home/u/.cache/ok-updater/pending/ok-0.3.2.x86_64.rpm',
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(fallback).toHaveBeenCalledWith(
expect.objectContaining({
packageKind: 'rpm',
@@ -5492,7 +5494,7 @@ describe('linux manual-install fallback', () => {
emitDownloadEvent: false,
stateStagedInstallerPath: STAGED_DEB,
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(fallback).toHaveBeenCalledWith({
version: '0.3.2',
@@ -5509,7 +5511,7 @@ describe('linux manual-install fallback', () => {
stateStagedInstallerPath: STAGED_DEB,
stagedInstallerExists: () => false,
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(fallback).not.toHaveBeenCalled();
});
@@ -5542,7 +5544,7 @@ describe('linux manual-install fallback', () => {
},
});
rig.updater.emit('update-downloaded', { version: '0.3.2', downloadedFile: STAGED_DEB });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
rig.updater.emit('error', new Error('Command pkexec exited with code 127'));
expect(fallback).not.toHaveBeenCalled();
@@ -5609,7 +5611,7 @@ describe('same-version download guard', () => {
expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
expect(rig.dispatches).toContain('download-skipped-already-staged' as DispatchKind);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
});
@@ -5690,7 +5692,7 @@ describe('single-flight install handoff', () => {
return Promise.resolve(undefined);
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
@@ -5722,13 +5724,14 @@ describe('single-flight install handoff', () => {
stageInSession(rig, '0.3.2');
showCheckNowResult.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.3' });
expect(showCheckNowResult).toHaveBeenCalledWith({
kind: 'available',
currentVersion: '0.3.1',
latestVersion: '0.3.3',
+ download: 'background',
});
},
);
@@ -5756,7 +5759,7 @@ describe('single-flight install handoff', () => {
stageInSession(rig, '0.3.2');
showCheckNowResult.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.3' });
expect(showCheckNowResult).toHaveBeenCalledTimes(1);
@@ -5778,7 +5781,7 @@ describe('single-flight install handoff', () => {
stageInSession(rig, '0.3.2');
showCheckNowResult.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
@@ -5803,7 +5806,7 @@ describe('single-flight install handoff', () => {
stageInSession(rig, '0.3.2');
showCheckNowResult.mockClear();
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
@@ -5826,9 +5829,9 @@ describe('single-flight install handoff', () => {
throw new Error('installer refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'installer refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('installer refused the handoff');
expect(rig.state.versionPendingInstall).toBeNull();
rig.failNextPersist = false;
rig.updater.downloadUpdate.mockClear();
@@ -5842,7 +5845,7 @@ describe('single-flight install handoff', () => {
test('on macOS a watchdog fire that cannot restore KEEPS the arm', async () => {
const { rig } = makeRig({ versionPendingInstall: null });
stageInSession(rig, '0.3.2');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.failNextPersist = true;
fireTimerFor(rig.clock, RELAUNCH_WATCHDOG_MS);
rig.failNextPersist = false;
@@ -5864,9 +5867,9 @@ describe('single-flight install handoff', () => {
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
rig.failNextPersist = false;
expect(rig.state.versionPendingInstall).toBeNull();
rig.updater.downloadUpdate.mockClear();
@@ -5880,7 +5883,7 @@ describe('single-flight install handoff', () => {
test('on macOS an in-flight error that cannot restore KEEPS the arm', async () => {
const { rig } = makeRig({ versionPendingInstall: null });
stageInSession(rig, '0.3.2');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.failNextPersist = true;
rig.updater.emit('error', new Error('install failed'));
rig.failNextPersist = false;
@@ -5901,9 +5904,9 @@ describe('single-flight install handoff', () => {
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
expect(rig.state.versionPendingInstall).toBe('0.3.2');
rig.updater.downloadUpdate.mockClear();
@@ -5928,7 +5931,7 @@ describe('single-flight install handoff', () => {
describe('click-gated freshness check', () => {
test('nothing newer → installs the staged build', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.checkForUpdates).toHaveBeenCalled();
expect(rig.dispatches).toContain('relaunch-refresh-up-to-date' as DispatchKind);
@@ -5937,7 +5940,7 @@ describe('click-gated freshness check', () => {
test('every window is told the click is fetching before the wait begins', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2', extraWindowCount: 2 });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
for (const win of rig.windows) {
const fetching = win.filter((c) => c.channel === 'ok:update:fetching-latest');
@@ -5954,7 +5957,7 @@ describe('click-gated freshness check', () => {
return Promise.resolve(undefined);
});
- const pending = rig.ipc.invoke('ok:update:relaunch-now');
+ const pending = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.resolve();
expect(rig.dispatches).toContain('relaunch-refresh-found-newer' as DispatchKind);
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
@@ -5970,7 +5973,7 @@ describe('click-gated freshness check', () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
rig.updater.emit('update-available', { version: '0.3.3' });
- const pending = rig.ipc.invoke('ok:update:relaunch-now');
+ const pending = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.resolve();
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(rig.dispatches).toContain('relaunch-awaited-in-flight-staging' as DispatchKind);
@@ -5985,7 +5988,7 @@ describe('click-gated freshness check', () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
rig.updater.emit('update-available', { version: '0.3.3' });
- const pending = rig.ipc.invoke('ok:update:relaunch-now');
+ const pending = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.resolve();
rig.updater.emit('error', new Error('download died'));
await pending;
@@ -5997,7 +6000,7 @@ describe('click-gated freshness check', () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
rig.updater.emit('update-available', { version: '0.3.3' });
- const pending = rig.ipc.invoke('ok:update:relaunch-now');
+ const pending = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.resolve();
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
@@ -6019,7 +6022,7 @@ describe('click-gated freshness check', () => {
return Promise.resolve(undefined);
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
for (const win of rig.windows) {
@@ -6039,7 +6042,7 @@ describe('click-gated freshness check', () => {
await Promise.resolve();
rig.updater.checkForUpdates.mockImplementation(() => new Promise(() => {}));
- const pending = rig.ipc.invoke('ok:update:relaunch-now');
+ const pending = rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
await Promise.resolve();
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
@@ -6056,20 +6059,20 @@ describe('the commit flag releases on every path that re-offers the click', () =
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
rig.failNextPersist = true;
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'could not save the update state',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('could not save the update state');
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
rig.failNextPersist = false;
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
});
test('a relaunch failure that restores cleanly does NOT ask to clear the card', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
rig.updater.emit('error', new Error('ShipIt swap failed'));
const failed = rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed');
@@ -6084,14 +6087,18 @@ describe('the commit flag releases on every path that re-offers the click', () =
const { rig } = makeRig({ versionPendingInstall: '0.3.2' });
rig.failNextPersist = true;
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow();
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow();
});
test('a persist failure re-arms the banner in EVERY window, not just the clicked one', async () => {
const { rig } = makeRig({ versionPendingInstall: '0.3.2', extraWindowCount: 2 });
rig.failNextPersist = true;
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow();
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow();
for (const win of rig.windows) {
expect(win.filter((c) => c.channel === 'ok:update:fetching-latest')).toHaveLength(1);
@@ -6122,11 +6129,11 @@ describe('the commit flag releases on every path that re-offers the click', () =
downloadedFile: '/home/u/.cache/ok-updater/pending/ok_0.3.2_arm64.deb',
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
hasGraphicalAuth.mockReturnValue(true);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
});
@@ -6226,7 +6233,7 @@ describe('Update Ready dialog offers Quit and Restart', () => {
});
stageInSession(rig, '0.3.2');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
await settleAsyncWork();
@@ -6257,7 +6264,7 @@ describe('Update Ready dialog offers Quit and Restart', () => {
const { rig } = makeRig({ versionPendingInstall: null, showCheckNowResult });
stageInSession(rig, '0.3.2');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
await settleAsyncWork();
@@ -6278,7 +6285,7 @@ describe('Update Ready dialog offers Quit and Restart', () => {
const { rig } = makeRig({ versionPendingInstall: null, showCheckNowResult });
stageInSession(rig, '0.3.2');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-not-available', { version: '0.3.1' });
await settleAsyncWork();
@@ -6297,7 +6304,7 @@ describe('Update Ready dialog offers Quit and Restart', () => {
const { rig } = makeRig({ versionPendingInstall: null, showCheckNowResult });
stageInSession(rig, '0.3.2');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
await settleAsyncWork();
@@ -6323,7 +6330,7 @@ describe('Update Ready dialog offers Quit and Restart', () => {
});
rig.captured.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
await settleAsyncWork();
@@ -6348,7 +6355,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
stageInSession(rig, '0.3.2');
for (const win of rig.windows) win.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
for (const win of rig.windows) {
@@ -6362,7 +6369,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
stageInSession(rig, '0.3.2');
rig.captured.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.3' });
expect(downloadedBroadcasts(rig.captured)).toEqual([{ version: '0.3.2' }]);
@@ -6374,8 +6381,10 @@ describe('a manual check that finds the staged build re-offers the card', () =>
await Promise.resolve();
stageInSession(rig, '0.3.2');
rig.updater.checkForUpdates.mockImplementation(() => new Promise(() => {}));
- const relaunch = Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'));
- rig.ipc.invoke('ok:update:check-now');
+ const relaunch = Promise.resolve(
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' }),
+ );
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.captured.length = 0;
rig.updater.emit('update-available', { version: '0.3.2' });
@@ -6412,7 +6421,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
stageInSession(rig, '0.3.2');
rig.captured.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
expect(showCheckNowResult).toHaveBeenCalledWith({
@@ -6433,14 +6442,14 @@ describe('a manual check that finds the staged build re-offers the card', () =>
rig.failNextPersist = true;
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
rig.failNextPersist = false;
rig.updater.quitAndInstall = vi.fn();
rig.captured.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.3' });
await settleAsyncWork();
@@ -6474,7 +6483,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
extraWindowCount: 1,
});
stageInSession(rig, '0.3.2');
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
expect(showCheckNowResult).toHaveBeenCalledWith(
expect.objectContaining({ kind: 'ready-to-install', relaunch: 'available' }),
@@ -6483,9 +6492,9 @@ describe('a manual check that finds the staged build re-offers the card', () =>
rig.failNextPersist = true;
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
rig.failNextPersist = false;
expect(rig.state.versionPendingInstall).toBeNull();
rig.updater.quitAndInstall = vi.fn();
@@ -6517,7 +6526,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
test('an in-app Relaunch with no pending install tells the user instead of doing nothing', async () => {
const { rig } = makeRig({ versionPendingInstall: null });
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed')).toEqual([
@@ -6536,7 +6545,7 @@ describe('a manual check that finds the staged build re-offers the card', () =>
const { rig } = makeRig({ versionPendingInstall: null });
rig.captured.length = 0;
- rig.ipc.invoke('ok:update:check-now');
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
rig.updater.emit('update-available', { version: '0.3.2' });
expect(downloadedBroadcasts(rig.captured)).toEqual([]);
@@ -6587,7 +6596,7 @@ describe('getPendingUpdate decides whether the ready card is on offer', () => {
test('is null once the relaunch commits', async () => {
const { rig, handle } = makeRig({ versionPendingInstall: null });
stageInSession(rig, '0.3.2');
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
expect(handle.getPendingUpdate()).toBeNull();
});
@@ -6597,7 +6606,9 @@ describe('getPendingUpdate decides whether the ready card is on offer', () => {
await Promise.resolve();
stageInSession(rig, '0.3.2');
rig.updater.checkForUpdates.mockImplementation(() => new Promise(() => {}));
- const relaunch = Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'));
+ const relaunch = Promise.resolve(
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' }),
+ );
expect(rig.state.versionPendingInstall).toBe('0.3.2');
expect(handle.getPendingUpdate()).toBeNull();
@@ -6614,9 +6625,9 @@ describe('getPendingUpdate decides whether the ready card is on offer', () => {
rig.updater.quitAndInstall = vi.fn(() => {
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
expect(handle.getPendingUpdate()).toEqual({ version: '0.3.2' });
});
@@ -6627,9 +6638,9 @@ describe('getPendingUpdate decides whether the ready card is on offer', () => {
rig.failNextPersist = true;
throw new Error('squirrel refused the handoff');
});
- await expect(Promise.resolve(rig.ipc.invoke('ok:update:relaunch-now'))).rejects.toThrow(
- 'squirrel refused the handoff',
- );
+ await expect(
+ Promise.resolve(rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' })),
+ ).rejects.toThrow('squirrel refused the handoff');
rig.failNextPersist = false;
expect(
rig.captured.some(
@@ -6650,7 +6661,7 @@ describe('getPendingUpdate decides whether the ready card is on offer', () => {
return Promise.resolve(undefined);
});
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
expect(rig.updater.quitAndInstall).not.toHaveBeenCalled();
expect(handle.getPendingUpdate()).toBeNull();
@@ -6739,9 +6750,452 @@ describe('a reloaded window gets the ready card back on every offer route', () =
win.reload();
expect(downloadedBroadcasts(win.sent)).toEqual([{ version: '0.3.2' }]);
- await rig.ipc.invoke('ok:update:relaunch-now');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
win.reload();
expect(downloadedBroadcasts(win.sent)).toEqual([]);
});
});
+
+function liveTimersFor(clock: FakeClock, ms: number): number {
+ return [...clock.timers.values()].filter((t) => t.ms === ms && t.state === 'live').length;
+}
+
+async function settleLaunchCheck(): Promise<void> {
+ await new Promise((resolve) => setTimeout(resolve, 0));
+}
+
+function downloadedSends(captured: CapturedSend[]): unknown[] {
+ return captured.filter((c) => c.channel === 'ok:update:downloaded').map((c) => c.payload);
+}
+
+describe('update mode off switch', () => {
+ for (const platform of ['darwin', 'win32', 'linux'] as const) {
+ test(`${platform}: off at boot issues no check, schedules no timer, and disables install-on-quit`, async () => {
+ const { rig } = makeRig({ platform, updateMode: 'off' });
+ await settleLaunchCheck();
+ expect(rig.updater.checkForUpdates).not.toHaveBeenCalled();
+ expect(rig.clock.setTimeout).not.toHaveBeenCalled();
+ expect(rig.updater.autoInstallOnAppQuit).toBe(false);
+ expect(rig.dispatches).toContain('skipped-updates-off' as DispatchKind);
+ expect(rig.ipc.handlers.has('ok:update:dispatch')).toBe(true);
+ });
+ }
+
+ test('an unrecognized persisted mode resolves to auto and still checks', async () => {
+ const { rig } = makeRig({ updateMode: 'never' as unknown as 'off' });
+ await settleLaunchCheck();
+ expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
+ expect(rig.updater.autoInstallOnAppQuit).toBe(true);
+ });
+
+ test('turning updates off before the deferred launch check runs skips that check', async () => {
+ let settleReclaim: () => void = () => {};
+ const reclaim = vi.fn(
+ () =>
+ new Promise<void>((resolve) => {
+ settleReclaim = resolve;
+ }),
+ );
+ const { rig } = makeRig({ reclaimStagedUpdateCache: reclaim });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ settleReclaim();
+ await settleLaunchCheck();
+ expect(rig.updater.checkForUpdates).not.toHaveBeenCalled();
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(0);
+ expect(rig.state.lastSuccessfulCheckAt).toBeNull();
+ expect(rig.dispatches).toContain('skipped-updates-off' as DispatchKind);
+ });
+
+ test('a check that succeeds after the switch to off records no check time', async () => {
+ const { rig } = makeRig({ updateMode: 'off' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
+ rig.updater.emit('update-not-available', { version: '0.3.1' });
+ expect(rig.state.lastSuccessfulCheckAt).toBeNull();
+ });
+
+ for (const platform of ['darwin', 'win32'] as const) {
+ test(`${platform}: a build staged while off is re-staged, then committed and offered, when updates come back on`, async () => {
+ const { rig } = makeRig({ platform, updateMode: 'off' });
+ rig.updater.emit('update-available', { version: '0.3.2' });
+ expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ rig.captured.length = 0;
+
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+ expect(downloadedSends(rig.captured)).toEqual([]);
+ expect(rig.dispatches).toContain('staged-install-rebind' as DispatchKind);
+
+ rig.updater.emit('update-available', { version: '0.3.2' });
+ expect(rig.updater.downloadUpdate).toHaveBeenCalledTimes(1);
+ expect(rig.updater.autoInstallOnAppQuit).toBe(true);
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+
+ expect(rig.state.attemptedInstall).toBe('0.3.2');
+ expect(rig.state.attemptedInstallHandoffAt).toBeNull();
+ expect(downloadedSends(rig.captured)).toEqual([{ version: '0.3.2' }]);
+ });
+
+ test(`${platform}: a build staged while off is not committed before it is re-staged, so a quit records no handoff`, async () => {
+ const { rig, handle } = makeRig({ platform, updateMode: 'off' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+
+ expect(rig.state.attemptedInstall).toBeNull();
+ handle.recordInstallHandoffOnQuit();
+ expect(rig.state.attemptedInstallHandoffAt).toBeNull();
+ });
+ }
+
+ test('a build staged in an earlier session with install-on-quit off is committed when it is re-downloaded with it on', () => {
+ const { rig } = makeRig({ platform: 'win32', versionPendingInstall: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBeNull();
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBe('0.3.2');
+ expect(rig.dispatches).toContain('update-downloaded-install-committed' as DispatchKind);
+ });
+
+ test('a re-download of a build whose install was already attempted keeps its retry count', () => {
+ const { rig } = makeRig({
+ platform: 'win32',
+ versionPendingInstall: '0.3.2',
+ attemptedInstall: '0.3.2',
+ attemptedInstallSurfacedCount: 1,
+ attemptedInstallHandoffAt: COMMITTED_LONG_AGO,
+ });
+ const before = { ...rig.state };
+ expect(before.attemptedInstallSurfacedCount).toBeGreaterThan(0);
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBe('0.3.2');
+ expect(rig.state.attemptedInstallSurfacedCount).toBe(before.attemptedInstallSurfacedCount);
+ expect(rig.state.attemptedInstallHandoffAt).toBe(before.attemptedInstallHandoffAt);
+ });
+
+ test('a re-download while install-on-quit is off commits nothing', () => {
+ const { rig } = makeRig({
+ platform: 'win32',
+ updateMode: 'off',
+ versionPendingInstall: '0.3.2',
+ });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBeNull();
+ });
+
+ test('linux: a re-download of a pending build records no install commitment', () => {
+ const { rig } = makeRig({ platform: 'linux', versionPendingInstall: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBeNull();
+ });
+
+ test('a re-download of a given-up pending version does not restart its retry budget', () => {
+ const { rig } = makeRig({
+ platform: 'win32',
+ versionPendingInstall: '0.3.2',
+ gaveUpOnVersion: '0.3.2',
+ });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBeNull();
+ expect(rig.state.gaveUpOnVersion).toBe('0.3.2');
+ });
+
+ test('a build waiting to be re-staged is not offered to a window that loads', async () => {
+ const { rig, handle } = makeRig({ platform: 'darwin', updateMode: 'off' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+
+ expect(handle.getPendingUpdate()).toBeNull();
+ rig.updater.emit('update-not-available', { version: '0.3.1' });
+ expect(handle.getPendingUpdate()).toBeNull();
+
+ rig.updater.emit('update-available', { version: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(handle.getPendingUpdate()).toEqual({ version: '0.3.2' });
+ });
+
+ test('an explicit relaunch of a build staged while off records the install attempt', async () => {
+ const { rig } = makeRig({ updateMode: 'off' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
+ expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
+ expect(rig.state.attemptedInstall).toBe('0.3.2');
+ expect(rig.state.attemptedInstallHandoffAt).not.toBeNull();
+ });
+
+ test('set-mode off persists, cancels the periodic timer, and retracts the card in every window', async () => {
+ const { rig } = makeRig({ extraWindowCount: 2, stuckHintShown: true });
+ await settleLaunchCheck();
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(1);
+ const result = await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ expect(result).toEqual({ kind: 'set-mode', ok: true, mode: 'off' });
+ expect(rig.state.updateMode).toBe('off');
+ expect(rig.state.stuckHintShown).toBe(false);
+ expect(rig.state.lastSuccessfulCheckAt).toBeNull();
+ expect(rig.updater.autoInstallOnAppQuit).toBe(false);
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(0);
+ for (const win of rig.windows) {
+ expect(downloadedSends(win)).toEqual([{ version: null }]);
+ }
+ });
+
+ test('set-mode auto after off re-arms one timer and checks immediately', async () => {
+ const { rig } = makeRig({ updateMode: 'off' });
+ await settleLaunchCheck();
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+ expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(1);
+ expect(rig.updater.autoInstallOnAppQuit).toBe(true);
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(1);
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(0);
+ });
+
+ test('a periodic timer that fires after the switch to off does not check or reschedule', async () => {
+ const { rig } = makeRig();
+ await settleLaunchCheck();
+ const [timer] = [...rig.clock.timers.values()].filter(
+ (t) => t.ms === UPDATE_CHECK_INTERVAL_MS && t.state === 'live',
+ );
+ rig.state = { ...rig.state, updateMode: 'off' };
+ timer?.cb();
+ expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(1);
+ });
+
+ test('set-mode refuses an unrecognized mode and reports a failed write', async () => {
+ const { rig } = makeRig();
+ await expect(
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'never' }),
+ ).resolves.toEqual({ kind: 'set-mode', ok: false, reason: 'unrecognized-mode' });
+ rig.failNextPersist = true;
+ await expect(
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' }),
+ ).resolves.toEqual({ kind: 'set-mode', ok: false, reason: 'persist-failed' });
+ expect(rig.state.updateMode).toBeNull();
+ });
+
+ test('an unknown dispatch kind answers with a named refusal', async () => {
+ const { rig } = makeRig();
+ await expect(rig.ipc.invoke('ok:update:dispatch', { kind: 'reboot' })).resolves.toEqual({
+ kind: 'unknown',
+ ok: false,
+ reason: 'unrecognized-kind',
+ });
+ });
+
+ test('a manual check under off reports the update without downloading it', async () => {
+ const results: unknown[] = [];
+ const { rig } = makeRig({
+ updateMode: 'off',
+ showCheckNowResult: (result) => {
+ results.push(result);
+ return undefined;
+ },
+ });
+ rig.updater.checkForUpdates = vi.fn(async () => {
+ rig.updater.emit('update-available', { version: '0.3.2' });
+ return {};
+ });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
+ await settleLaunchCheck();
+ expect(rig.updater.checkForUpdates).toHaveBeenCalledTimes(1);
+ expect(rig.updater.downloadUpdate).not.toHaveBeenCalled();
+ expect(rig.dispatches).toContain('download-skipped-updates-off' as DispatchKind);
+ expect(results).toEqual([
+ { kind: 'available', currentVersion: '0.3.1', latestVersion: '0.3.2', download: 'manual' },
+ ]);
+ expect(liveTimersFor(rig.clock, UPDATE_CHECK_INTERVAL_MS)).toBe(0);
+ });
+
+ test('a manual check under auto reports a background download', async () => {
+ const results: unknown[] = [];
+ const { rig } = makeRig({
+ showCheckNowResult: (result) => {
+ results.push(result);
+ return undefined;
+ },
+ });
+ await settleLaunchCheck();
+ rig.updater.checkForUpdates = vi.fn(async () => {
+ rig.updater.emit('update-available', { version: '0.3.2' });
+ return {};
+ });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
+ await settleLaunchCheck();
+ expect(rig.updater.downloadUpdate).toHaveBeenCalledTimes(1);
+ expect(results).toEqual([
+ {
+ kind: 'available',
+ currentVersion: '0.3.1',
+ latestVersion: '0.3.2',
+ download: 'background',
+ },
+ ]);
+ });
+
+ test('the stuck hint never fires under off', () => {
+ const { rig } = makeRig({
+ updateMode: 'off',
+ lastSuccessfulCheckAt: '2020-01-01T00:00:00.000Z',
+ });
+ rig.updater.emit('error', Object.assign(new Error('offline'), { code: 'HTTP_ERROR_500' }));
+ expect(rig.captured.filter((c) => c.channel === 'ok:update:stuck-hint')).toHaveLength(0);
+ expect(rig.dispatches).toContain('stuck-hint-skipped-updates-off' as DispatchKind);
+ });
+
+ test('a download finishing after the switch to off stages quietly without arming an install', () => {
+ const { rig, handle } = makeRig({ updateMode: 'off' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.versionPendingInstall).toBe('0.3.2');
+ expect(rig.state.attemptedInstall).toBeNull();
+ expect(downloadedSends(rig.captured)).toHaveLength(0);
+ expect(handle.getPendingUpdate()).toBeNull();
+ expect(rig.dispatches).toContain('update-downloaded-quiet' as DispatchKind);
+ });
+
+ test('an explicit relaunch still installs a build staged before the switch to off', async () => {
+ const { rig } = makeRig();
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ const checksBeforeRelaunch = rig.updater.checkForUpdates.mock.calls.length;
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
+ expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
+ expect(rig.updater.checkForUpdates.mock.calls.length).toBe(checksBeforeRelaunch);
+ });
+
+ test('the boot install-failure notice is not surfaced under off', () => {
+ const { rig } = makeRig({
+ updateMode: 'off',
+ attemptedInstall: '0.3.2',
+ attemptedInstallHandoffAt: COMMITTED_LONG_AGO,
+ });
+ expect(rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed')).toHaveLength(0);
+ expect(rig.dispatches).toContain('install-failed-notice-skipped-updates-off' as DispatchKind);
+ });
+
+ test('switching back to auto re-offers a build staged while it was on to every window', async () => {
+ const { rig } = makeRig({ extraWindowCount: 1 });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'off' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'set-mode', mode: 'auto' });
+ for (const win of rig.windows) {
+ expect(downloadedSends(win)).toEqual([
+ { version: '0.3.2' },
+ { version: null },
+ { version: '0.3.2' },
+ ]);
+ }
+ expect(rig.dispatches).not.toContain('staged-install-rebind' as DispatchKind);
+ });
+});
+
+describe('ready-to-install card dismissal', () => {
+ test('dismissal persists per version and hides the card from later windows', async () => {
+ const { rig, handle } = makeRig();
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(handle.getPendingUpdate()).toEqual({ version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ expect(rig.state.dismissedUpdateVersion).toBe('0.3.2');
+ expect(rig.state.versionPendingInstall).toBe('0.3.2');
+ expect(handle.getPendingUpdate()).toBeNull();
+ });
+
+ test('dismissal in one window retracts the card in every open window', async () => {
+ const { rig } = makeRig({ extraWindowCount: 2 });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ for (const win of rig.windows) {
+ expect(downloadedSends(win)).toEqual([{ version: '0.3.2' }, { version: null }]);
+ }
+ });
+
+ test('a dismissal of a build that is no longer staged leaves the current card up', async () => {
+ const { rig } = makeRig({ extraWindowCount: 1 });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.3' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ for (const win of rig.windows) {
+ expect(downloadedSends(win)).toEqual([{ version: '0.3.2' }, { version: '0.3.3' }]);
+ }
+ });
+
+ test('a repeated dismissal of the same version broadcasts nothing further', async () => {
+ const { rig } = makeRig({ versionPendingInstall: '0.3.2', dismissedUpdateVersion: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ expect(downloadedSends(rig.captured)).toHaveLength(0);
+ });
+
+ test('dismissal survives a relaunch of the app', () => {
+ const { handle } = makeRig({
+ versionPendingInstall: '0.3.2',
+ dismissedUpdateVersion: '0.3.2',
+ });
+ expect(handle.getPendingUpdate()).toBeNull();
+ });
+
+ test('a newer staged version clears the dismissal and surfaces normally', async () => {
+ const { rig, handle } = makeRig();
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.3' });
+ expect(rig.state.dismissedUpdateVersion).toBeNull();
+ expect(handle.getPendingUpdate()).toEqual({ version: '0.3.3' });
+ });
+
+ test('a manual check clears the recorded dismissal and brings the card back', async () => {
+ const { rig } = makeRig({ versionPendingInstall: null });
+ stageInSession(rig, '0.3.2');
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'downloaded-dismiss', version: '0.3.2' });
+ rig.captured.length = 0;
+
+ rig.ipc.invoke('ok:update:dispatch', { kind: 'check-now' });
+ expect(rig.state.dismissedUpdateVersion).toBeNull();
+ rig.updater.emit('update-available', { version: '0.3.2' });
+
+ expect(downloadedSends(rig.captured)).toEqual([{ version: '0.3.2' }]);
+ });
+});
+
+describe('install-failure give-up tombstone', () => {
+ test('a re-downloaded given-up version stays quiet and does not restart the budget', () => {
+ const { rig, handle } = makeRig({ gaveUpOnVersion: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.2' });
+ expect(rig.state.attemptedInstall).toBeNull();
+ expect(rig.state.attemptedInstallSurfacedCount).toBe(0);
+ expect(downloadedSends(rig.captured)).toHaveLength(0);
+ expect(handle.getPendingUpdate()).toBeNull();
+ });
+
+ test('the given-up version stays bounded across boots after an explicit relaunch re-arms it', () => {
+ const { rig } = makeRig({
+ gaveUpOnVersion: '0.3.2',
+ attemptedInstall: '0.3.2',
+ attemptedInstallHandoffAt: COMMITTED_LONG_AGO,
+ });
+ expect(rig.captured.filter((c) => c.channel === 'ok:update:relaunch-failed')).toHaveLength(0);
+ expect(rig.state.attemptedInstall).toBeNull();
+ expect(rig.state.versionPendingInstall).toBe('0.3.2');
+ expect(rig.dispatches).toContain('install-failed-after-giveup' as DispatchKind);
+ });
+
+ test('a genuinely newer version clears the tombstone and arms normally', () => {
+ const { rig } = makeRig({ gaveUpOnVersion: '0.3.2' });
+ rig.updater.emit('update-downloaded', { version: '0.3.3' });
+ expect(rig.state.gaveUpOnVersion).toBeNull();
+ expect(rig.state.attemptedInstall).toBe('0.3.3');
+ expect(downloadedSends(rig.captured)).toEqual([{ version: '0.3.3' }]);
+ });
+
+ test('the tombstone clears once the running version reaches it', () => {
+ const { rig } = makeRig({ appVersion: '0.3.2', gaveUpOnVersion: '0.3.2' });
+ expect(rig.state.gaveUpOnVersion).toBeNull();
+ expect(rig.dispatches).toContain('install-giveup-reconciled' as DispatchKind);
+ });
+
+ test('an explicit relaunch still installs the given-up version', async () => {
+ const { rig } = makeRig({ gaveUpOnVersion: '0.3.2', versionPendingInstall: '0.3.2' });
+ await rig.ipc.invoke('ok:update:dispatch', { kind: 'relaunch-now' });
+ expect(rig.updater.quitAndInstall).toHaveBeenCalledTimes(1);
+ });
+});
diff --git a/packages/desktop/tests/main/state-store.test.ts b/packages/desktop/tests/main/state-store.test.ts
index 517e138c2..5122dc60d 100644
--- a/packages/desktop/tests/main/state-store.test.ts
+++ b/packages/desktop/tests/main/state-store.test.ts
@@ -12,6 +12,7 @@ import {
type PersistedWindowBounds,
parseAppState,
removeRecentProject,
+ resolveUpdateMode,
restoreSurvivorPath,
type SaveAppStateFs,
saveAppStateToDir,
@@ -21,6 +22,7 @@ import {
setProjectWindowBounds,
setSpellCheckEnabled,
setTerminalDockState,
+ unrecognizedUpdateModeIn,
windowRestoreKey,
} from '../../src/main/state-store.ts';
@@ -1012,3 +1014,43 @@ describe('state-store (doc restore entries — popped-out note windows)', () =>
expect(parsed?.pendingWindowRestore).toHaveLength(2);
});
});
+
+describe('state-store (update preference fields)', () => {
+ test('a state.json without the update fields loads with no choice, no tombstone, no dismissal', () => {
+ const parsed = parseAppState({ recentProjects: [], schemaVersion: 1 });
+ expect(parsed?.updateMode).toBeNull();
+ expect(parsed?.gaveUpOnVersion).toBeNull();
+ expect(parsed?.dismissedUpdateVersion).toBeNull();
+ expect(parsed?.schemaVersion).toBe(1);
+ });
+
+ test('the update fields round-trip', () => {
+ const parsed = parseAppState({
+ recentProjects: [],
+ updateMode: 'off',
+ gaveUpOnVersion: '0.3.2',
+ dismissedUpdateVersion: '0.3.3',
+ });
+ expect(parsed?.updateMode).toBe('off');
+ expect(parsed?.gaveUpOnVersion).toBe('0.3.2');
+ expect(parsed?.dismissedUpdateVersion).toBe('0.3.3');
+ });
+
+ test('an unrecognized persisted mode never resolves to off', () => {
+ const parsed = parseAppState({ recentProjects: [], updateMode: 'never' });
+ expect(parsed?.updateMode).toBeNull();
+ expect(resolveUpdateMode('never')).toEqual({ mode: 'auto', source: 'default' });
+ expect(resolveUpdateMode(undefined)).toEqual({ mode: 'auto', source: 'default' });
+ expect(resolveUpdateMode('off')).toEqual({ mode: 'off', source: 'user' });
+ });
+
+ test('names an unrecognized persisted mode so the load path can report it', () => {
+ expect(unrecognizedUpdateModeIn({ updateMode: 'never' })).toBe('never');
+ expect(unrecognizedUpdateModeIn({ updateMode: 7 })).toBe('number');
+ expect(unrecognizedUpdateModeIn({ updateMode: 'x'.repeat(100) })).toBe('x'.repeat(64));
+ expect(unrecognizedUpdateModeIn({ updateMode: 'off' })).toBeNull();
+ expect(unrecognizedUpdateModeIn({ updateMode: null })).toBeNull();
+ expect(unrecognizedUpdateModeIn({ recentProjects: [] })).toBeNull();
+ expect(unrecognizedUpdateModeIn(null)).toBeNull();
+ });
+});
diff --git a/packages/desktop/tests/main/update-state-handlers.test.ts b/packages/desktop/tests/main/update-state-handlers.test.ts
index cb9134195..ce604b090 100644
--- a/packages/desktop/tests/main/update-state-handlers.test.ts
+++ b/packages/desktop/tests/main/update-state-handlers.test.ts
@@ -143,3 +143,17 @@ describe('applyStateQuery about info', () => {
expect(after.about.updateChecks).toBe('available');
});
});
+
+describe('applyStateQuery update mode', () => {
+ test('reports auto when no preference was ever chosen', async () => {
+ const snapshot = await applyStateQuery(makeRig().deps);
+ expect(snapshot.updateMode).toBe('auto');
+ });
+
+ test('reports the persisted choice', async () => {
+ const snapshot = await applyStateQuery(
+ makeRig({ state: { ...emptyState(), updateMode: 'off' } }).deps,
+ );
+ expect(snapshot.updateMode).toBe('off');
+ });
+});