Skip to content

Beautiful, AI-native markdown IDE and LLM wiki

Fix launch-week download routing (PRD-8105) (#3635)

mike-inkeepd0240ad7ef89
diff --git a/docs/content/reference/what-open-knowledge-writes.mdx b/docs/content/reference/what-open-knowledge-writes.mdx
index 5a82cb60b..6e9131ee3 100644
--- a/docs/content/reference/what-open-knowledge-writes.mdx
+++ b/docs/content/reference/what-open-knowledge-writes.mdx
@@ -48,7 +48,7 @@ On every platform the app writes app-level state and logs on launch. The table b
| `~/Library/Application Support/OpenKnowledge/bug-report-dirty-shutdown.json` | Dirty-shutdown sentinel — written on **every** launch, refreshed as it runs, and removed on a clean quit. The next launch reads it to tell an app crash (prompts you) from the machine ending the session — a reboot, an OS shutdown, or dying asleep (suppressed and logged instead) | Outside-project (home dir) |
| `~/Library/Application Support/OpenKnowledge/bug-report-crash-acks.json` | Records which crash-report invitations you already answered or dismissed, so the same crash never re-prompts | Outside-project (home dir) |
-The app registers the `openknowledge://` URL scheme (for deep links) and checks for updates — on launch and periodically while it runs — against the OpenKnowledge update service at `openknowledge.ai/updates`, which redirects to the GitHub release asset and counts the update per version and channel (falling back to GitHub directly if it's 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. The channel (stable or beta) is fixed by the build you installed — switch by reinstalling the other from `openknowledge.ai/download/stable` or `/download/beta`. Override the feed with `OK_UPDATER_FEED_URL`.
+The app registers the `openknowledge://` URL scheme (for deep links) and checks for updates — on launch and periodically while it runs — against the OpenKnowledge update service at `openknowledge.ai/updates`, which redirects to the GitHub release asset and counts the update per version and channel (falling back to GitHub directly if it's 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. The channel (stable or beta) is fixed by the build you installed. Reinstall a stable build for any supported platform from `openknowledge.ai/download`. The `/download/beta` shortcut serves the latest Apple Silicon macOS beta; Windows and Linux beta 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/docs/src/app/download/beta/route.test.ts b/docs/src/app/download/beta/route.test.ts
index a7f4a00b8..0d547b4d0 100644
--- a/docs/src/app/download/beta/route.test.ts
+++ b/docs/src/app/download/beta/route.test.ts
@@ -50,7 +50,7 @@ function call(): Promise<Response> {
}
describe('GET /download/beta', () => {
- test('302 to the fresh beta URL and fires dmg_downloaded (beta)', async () => {
+ test('serves the Apple Silicon macOS beta and reports that fixed target', async () => {
_redirect = { kind: 'fresh', url: TEST_DMG_URL };
_lastCapture = null;
const res = await call();
diff --git a/docs/src/app/download/beta/route.ts b/docs/src/app/download/beta/route.ts
index 9efbdddc2..8160f9d9b 100644
--- a/docs/src/app/download/beta/route.ts
+++ b/docs/src/app/download/beta/route.ts
@@ -2,9 +2,12 @@ import { createBetaResolver, toRedirectResponse } from '@/lib/download-links';
import { attribution, captureServerEvent, isPrefetchRequest, resolveDistinctId } from '@/lib/track';
/**
- * Perennial beta-channel download URL: openknowledge.ai/download/beta
- * 302s to the newest published `-beta.N` DMG on inkeep/open-knowledge,
- * degrading to the releases page when resolution fails (never an error
+ * Perennial Apple Silicon macOS beta URL: openknowledge.ai/download/beta
+ * 302s to the newest published `-beta.N` DMG on inkeep/open-knowledge.
+ * Windows and Linux beta users must choose an asset on the releases page;
+ * this route intentionally does not infer or accept another platform target.
+ *
+ * Resolution degrades to the releases page when it fails (never an error
* page — shared links must land somewhere actionable).
*
* force-dynamic keeps `next build` from prerendering this route, which
diff --git a/docs/src/app/download/stable/route.test.ts b/docs/src/app/download/stable/route.test.ts
index 1a25f1e43..b68cb780d 100644
--- a/docs/src/app/download/stable/route.test.ts
+++ b/docs/src/app/download/stable/route.test.ts
@@ -23,7 +23,7 @@ vi.doMock('../../../lib/track.ts', () => ({
const { GET } = await import('./route.ts');
describe('GET /download/stable', () => {
- test('302 to the stable DMG URL, uncached, and fires dmg_downloaded', () => {
+ test('keeps the bare legacy URL on the stable Apple Silicon DMG', () => {
_lastCapture = null;
const res = GET(new Request('https://openknowledge.ai/download/stable'));
expect(res.status).toBe(302);