AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
fix: repair welcome note Markdown seed
tianma-ifdba620d8e500
diff --git a/apps/api/src/workspace-provisioning.ts b/apps/api/src/workspace-provisioning.tsindex ddb0c458..5a4878be 100644--- a/apps/api/src/workspace-provisioning.ts+++ b/apps/api/src/workspace-provisioning.ts@@ -5,6 +5,7 @@ import {import {DEFAULT_NOTEBOOK_SEEDS,WELCOME_MEMO_ID,+ WELCOME_MEMO_REPAIRED_CONTENT_HASH,WELCOME_MEMO_SEED_CONTENT_HASH,WELCOME_MEMO_SEED_TITLE,buildWelcomeMemoContent,@@ -148,7 +149,7 @@ export const createWorkspaceSeedLocalizationStatements = async (// The memo row must still carry the seeded title and the system actor, and// the content must still be the seeded revision. The content is replaced// before the memo row, so the memo row's guard looks for that replacement.- const welcomeGuard = (contentHash: string, revision: number) => ({+ const welcomeGuard = (states: [string, number][]) => ({sql: `${SEED_LOCALIZATION_PENDING}AND EXISTS (SELECT 1 FROM memos@@ -157,7 +158,7 @@ export const createWorkspaceSeedLocalizationStatements = async ()AND EXISTS (SELECT 1 FROM memo_contents- WHERE memo_id = ? AND content_hash = ? AND revision = ?+ WHERE memo_id = ? AND (${states.map(() => "(content_hash = ? AND revision = ?)").join(" OR ")}))`,bindings: [workspaceId,@@ -165,12 +166,14 @@ export const createWorkspaceSeedLocalizationStatements = async (workspaceId,WELCOME_MEMO_SEED_TITLE,WELCOME_MEMO_ID,- contentHash,- revision,+ ...states.flat(),],});- const welcomeIsUntouched = welcomeGuard(WELCOME_MEMO_SEED_CONTENT_HASH, 0);- const welcomeContentWasLocalized = welcomeGuard(welcomeContentHash, 1);+ const welcomeIsUntouched = welcomeGuard([+ [WELCOME_MEMO_SEED_CONTENT_HASH, 0],+ [WELCOME_MEMO_REPAIRED_CONTENT_HASH, 1],+ ]);+ const welcomeContentWasLocalized = welcomeGuard([[welcomeContentHash, 1], [welcomeContentHash, 2]]);return [...createWorkspaceDefaultSeedStatements(db, workspaceId, now, locale, {diff --git a/apps/api/src/workspace-seed-localization.test.mjs b/apps/api/src/workspace-seed-localization.test.mjsindex bc934e8c..3ff36464 100644--- a/apps/api/src/workspace-seed-localization.test.mjs+++ b/apps/api/src/workspace-seed-localization.test.mjs@@ -1,7 +1,7 @@import { afterEach, describe, expect, test } from "bun:test";import { Database } from "bun:sqlite";import { globSync, readFileSync } from "node:fs";-import { WELCOME_MEMO_SEED_CONTENT_HASH } from "@edgeever/shared/default-workspace-seeds";+import { WELCOME_MEMO_REPAIRED_CONTENT_HASH, WELCOME_MEMO_SEED_CONTENT_HASH } from "@edgeever/shared/default-workspace-seeds";import { createSelfHostedStorageAdapter } from "./self-hosted-storage-adapter.ts";import { updateMemoRecord } from "./memo-service.ts";import {@@ -35,9 +35,9 @@ const freshInstallation = () => {// An installation that ran every migration before this change, then upgraded.const upgradedInstallation = (prepare) => {const database = openDatabase();- migrate(database.sqlite, (file) => !file.endsWith(LOCALIZATION_MIGRATION));+ migrate(database.sqlite, (file) => file < `migrations/${LOCALIZATION_MIGRATION}`);prepare(database.sqlite);- database.sqlite.exec(readFileSync(`migrations/${LOCALIZATION_MIGRATION}`, "utf8"));+ migrate(database.sqlite, (file) => file >= `migrations/${LOCALIZATION_MIGRATION}`);return database;};@@ -119,7 +119,7 @@ describe("fresh installation", () => {content: [{ type: "text", text: "Witaj w EdgeEver" }],});expect(note.content_hash).not.toBe(WELCOME_MEMO_SEED_CONTENT_HASH);- expect(note.revision).toBe(1);+ expect(note.revision).toBe(2);expect(searchMatches(sqlite, "Witaj")).toEqual(["memo_welcome"]);expect(templateNames(sqlite, DEFAULT_WORKSPACE_ID)).not.toContain("灵感速记");expect(searchMatches(sqlite, "Skrzynka")).toEqual([]);@@ -240,7 +240,7 @@ describe("fresh installation", () => {);expect(edited.error).toBeUndefined();const before = welcome(sqlite);- expect(before.content_hash).toBe(WELCOME_MEMO_SEED_CONTENT_HASH);+ expect(before.content_hash).toBe(WELCOME_MEMO_REPAIRED_CONTENT_HASH);expect(pendingWorkspaces(sqlite)).toEqual([DEFAULT_WORKSPACE_ID]);await ensureUserWorkspace(db, "usr_owner", "admin", "en-US");diff --git a/migrations/0071_fix_welcome_memo_markdown.sql b/migrations/0071_fix_welcome_memo_markdown.sqlnew file mode 100644index 00000000..f46e4b1f--- /dev/null+++ b/migrations/0071_fix_welcome_memo_markdown.sql@@ -0,0 +1,38 @@+-- Repair only the exact, untouched installation seed. SQL does not interpret \n.+-- Update the memo first so existing sync triggers announce the content change.+-- Both statements re-check the old content; replaying this migration is a no-op.+UPDATE memos+SET updated_at = strftime('%Y-%m-%dT%H:%M:%fZ', 'now')+WHERE id = 'memo_welcome'+ AND id IN (SELECT memo_id FROM memo_contents WHERE memo_id = 'memo_welcome'+ AND revision = 0+ AND content_hash = '4edcf7092f86c561210d4eb788e96f28ec5c045f93952c82f5f57e1902f548bd'+ AND content_json = '{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"欢迎来到 EdgeEver"}]},{"type":"paragraph","content":[{"type":"text","text":"这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。"}]},{"type":"paragraph","content":[{"type":"text","text":"接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。"}]}]}'+ AND content_markdown = '## 欢迎来到 EdgeEver\n\n这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。\n\n接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。'+ AND content_text = '欢迎来到 EdgeEver 这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。 接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。'+ AND NOT EXISTS (SELECT 1 FROM memo_revisions WHERE memo_id = 'memo_welcome')+ AND EXISTS (+ SELECT 1 FROM memos+ WHERE id = 'memo_welcome' AND workspace_id = 'ws_default'+ AND title = '欢迎来到 EdgeEver'+ AND created_by = 'system' AND updated_by = 'system' AND is_deleted = 0+ ));++UPDATE memo_contents+SET content_markdown = replace(content_markdown, '\n', char(10)),+ content_hash = '30fae5a337f8b9709505c5ab00ee921410b78632c14f4b7577c88aea0f9fc390',+ revision = revision + 1,+ updated_at = (SELECT updated_at FROM memos WHERE id = 'memo_welcome')+WHERE memo_id = 'memo_welcome'+ AND revision = 0+ AND content_hash = '4edcf7092f86c561210d4eb788e96f28ec5c045f93952c82f5f57e1902f548bd'+ AND content_json = '{"type":"doc","content":[{"type":"heading","attrs":{"level":2},"content":[{"type":"text","text":"欢迎来到 EdgeEver"}]},{"type":"paragraph","content":[{"type":"text","text":"这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。"}]},{"type":"paragraph","content":[{"type":"text","text":"接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。"}]}]}'+ AND content_markdown = '## 欢迎来到 EdgeEver\n\n这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。\n\n接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。'+ AND content_text = '欢迎来到 EdgeEver 这是第一条 EdgeEver 笔记,三栏、边缘、Agent-ready。 接下来可以创建笔记本、写笔记、搜索内容,并把多条笔记合并成一条新的长期笔记。'+ AND NOT EXISTS (SELECT 1 FROM memo_revisions WHERE memo_id = 'memo_welcome')+ AND EXISTS (+ SELECT 1 FROM memos+ WHERE id = 'memo_welcome' AND workspace_id = 'ws_default'+ AND title = '欢迎来到 EdgeEver'+ AND created_by = 'system' AND updated_by = 'system' AND is_deleted = 0+ );diff --git a/packages/shared/src/default-workspace-seeds.ts b/packages/shared/src/default-workspace-seeds.tsindex 04e8a852..0e687600 100644--- a/packages/shared/src/default-workspace-seeds.ts+++ b/packages/shared/src/default-workspace-seeds.ts@@ -64,6 +64,8 @@ export const WELCOME_MEMO_ID = "memo_welcome";*/export const WELCOME_MEMO_SEED_TITLE = "欢迎来到 EdgeEver";export const WELCOME_MEMO_SEED_CONTENT_HASH = "4edcf7092f86c561210d4eb788e96f28ec5c045f93952c82f5f57e1902f548bd";+// Migration 0071 repairs the original seed's literal backslash-n and advances it to revision 1.+export const WELCOME_MEMO_REPAIRED_CONTENT_HASH = "30fae5a337f8b9709505c5ab00ee921410b78632c14f4b7577c88aea0f9fc390";export type WelcomeMemoTranslation = {title: string;diff --git a/tests/seed-memo-migration.test.ts b/tests/seed-memo-migration.test.tsindex 9c0ff5c3..f525bc1d 100644--- a/tests/seed-memo-migration.test.ts+++ b/tests/seed-memo-migration.test.ts@@ -9,7 +9,7 @@ describe("seed memo migrations", () => {const db = new Database(":memory:");const migrations = globSync("migrations/*.sql").sort();- for (const migration of migrations.filter((path) => !path.endsWith("0014_repair_seed_memo_content_hash.sql"))) {+ for (const migration of migrations.filter((path) => path < "migrations/0014_repair_seed_memo_content_hash.sql")) {db.exec(readFileSync(migration, "utf8"));}diff --git a/tests/welcome-memo-markdown-migration.test.ts b/tests/welcome-memo-markdown-migration.test.tsnew file mode 100644index 00000000..ea5961b7--- /dev/null+++ b/tests/welcome-memo-markdown-migration.test.ts@@ -0,0 +1,142 @@+import { createHash } from "node:crypto";+import { globSync, mkdtempSync, readFileSync, rmSync } from "node:fs";+import { tmpdir } from "node:os";+import { join } from "node:path";+import { Database } from "bun:sqlite";+import { afterEach, describe, expect, test } from "bun:test";+import { buildWelcomeMemoContent, WELCOME_MEMO_REPAIRED_CONTENT_HASH } from "../packages/shared/src/default-workspace-seeds";+import { createSelfHostedStorageAdapter } from "../apps/api/src/self-hosted-storage-adapter";+import { ensureUserWorkspace } from "../apps/api/src/workspace-provisioning";+import { createLocalDevelopmentSession } from "../scripts/local-dev-auth.mjs";++const repairPath = "migrations/0071_fix_welcome_memo_markdown.sql";+const repair = readFileSync(repairPath, "utf8");+const migrations = globSync("migrations/*.sql").sort();+const databases: Database[] = [];+const directories: string[] = [];+afterEach(() => {+ for (const db of databases.splice(0)) db.close();+ for (const directory of directories.splice(0)) rmSync(directory, { recursive: true, force: true });+});+const open = (path = ":memory:") => {+ const db = new Database(path);+ databases.push(db);+ return db;+};+const legacy = () => {+ const db = open();+ for (const path of migrations.filter((path) => path < repairPath)) db.exec(readFileSync(path, "utf8"));+ return db;+};+const content = (db: Database) => db.query("SELECT * FROM memo_contents WHERE memo_id = 'memo_welcome'").get() as {+ content_markdown: string; content_json: string; content_hash: string; revision: number; updated_at: string;+};+const memo = (db: Database) => db.query("SELECT * FROM memos WHERE id = 'memo_welcome'").get();+const changes = (db: Database) => db.query("SELECT * FROM mobile_sync_changes ORDER BY id").all();+const assertRepaired = (db: Database) => {+ const row = content(db);+ expect(row.content_markdown).toBe(buildWelcomeMemoContent("zh-CN").contentMarkdown);+ expect(row.content_markdown).not.toContain("\\n");+ expect(row.content_markdown.split("\n\n")).toHaveLength(3);+ expect(row.content_hash).toBe(createHash("sha256").update(row.content_markdown + row.content_json).digest("hex"));+ expect(row.content_hash).toBe(WELCOME_MEMO_REPAIRED_CONTENT_HASH);+ expect(row.revision).toBe(1);+};++describe("welcome Markdown repair", () => {+ test("initializes correctly through local development auto-login without normal sign-in", async () => {+ const db = open();+ for (const path of migrations) db.exec(readFileSync(path, "utf8"));+ await createLocalDevelopmentSession(db);+ assertRepaired(db);+ });++ test("upgrades a persisted old database and announces the change exactly once", () => {+ const directory = mkdtempSync(join(tmpdir(), "edgeever-welcome-upgrade-"));+ directories.push(directory);+ const path = join(directory, "old.sqlite");+ const old = new Database(path);+ try {+ for (const migration of migrations.filter((file) => file < repairPath)) old.exec(readFileSync(migration, "utf8"));+ old.exec("UPDATE memos SET updated_at = '2020-01-01T00:00:00.000Z' WHERE id = 'memo_welcome'");+ expect(content(old).content_markdown).toContain("\\n\\n");+ } finally {+ old.close();+ }+ const db = open(path);+ const before = changes(db);+ db.transaction(() => db.exec(repair))();+ assertRepaired(db);+ expect(changes(db)).toHaveLength(before.length + 1);+ expect(changes(db).at(-1)).toMatchObject({ workspace_id: "ws_default", entity_type: "memo", entity_id: "memo_welcome", operation: "upsert" });+ expect(db.query("SELECT updated_at FROM memos WHERE id = 'memo_welcome'").get()).toEqual({ updated_at: content(db).updated_at });+ expect(content(db).updated_at).not.toBe("2020-01-01T00:00:00.000Z");+ const repaired = { memo: memo(db), content: content(db), changes: changes(db) };+ db.exec(repair);+ expect({ memo: memo(db), content: content(db), changes: changes(db) }).toEqual(repaired);+ });++ test.each([+ ["title", "UPDATE memos SET title = 'Custom title'"],+ ["actor", "UPDATE memos SET updated_by = 'user'"],+ ["creator", "UPDATE memos SET created_by = 'user'"],+ ["deleted", "UPDATE memos SET is_deleted = 1"],+ ["revision", "UPDATE memo_contents SET revision = 4"],+ ["hash", "UPDATE memo_contents SET content_hash = 'custom'"],+ ["Markdown with literal escapes", "UPDATE memo_contents SET content_markdown = 'user\\ntext'"],+ ["JSON", "UPDATE memo_contents SET content_json = '{}'"],+ ["plain text", "UPDATE memo_contents SET content_text = 'Custom text'"],+ ])("preserves a seed with a changed %s", (_name, edit) => {+ const db = legacy();+ db.exec(edit);+ const before = { memo: memo(db), content: content(db), changes: changes(db) };+ db.exec(repair);+ expect({ memo: memo(db), content: content(db), changes: changes(db) }).toEqual(before);+ });++ test.each([false, true])("localizes at first sign-in with repair applied: %s", async (applyRepair) => {+ const sqlite = legacy();+ if (applyRepair) sqlite.exec(repair);+ sqlite.exec("INSERT INTO users (id, username, password_hash, display_name) VALUES ('owner', 'owner', 'unused', 'Owner')");+ const db = createSelfHostedStorageAdapter(sqlite, "/tmp/edgeever-welcome-unused").db;+ await ensureUserWorkspace(db, "owner", "owner", "en-US");+ expect(content(sqlite).content_markdown).toBe(buildWelcomeMemoContent("en-US").contentMarkdown);+ expect(content(sqlite).revision).toBe(applyRepair ? 2 : 1);+ expect(memo(sqlite)).toMatchObject({ title: "Welcome to EdgeEver" });+ const before = { memo: memo(sqlite), content: content(sqlite), changes: changes(sqlite) };+ sqlite.exec(repair);+ expect({ memo: memo(sqlite), content: content(sqlite), changes: changes(sqlite) }).toEqual(before);+ });++ test("preserves a note with revision history even if its current content matches the seed", () => {+ const db = legacy();+ db.exec(`INSERT INTO memo_revisions (id, memo_id, revision, title, content_json, content_markdown, content_hash, created_by)+ SELECT 'rev_old', memo_id, 0, 'Previous title', content_json, content_markdown, content_hash, 'user'+ FROM memo_contents WHERE memo_id = 'memo_welcome'`);+ const before = { memo: memo(db), content: content(db), changes: changes(db) };+ db.exec(repair);+ expect({ memo: memo(db), content: content(db), changes: changes(db) }).toEqual(before);+ });++ test("preserves other notes containing the exact same content", () => {+ const db = legacy();+ db.exec(`INSERT INTO memos (id, notebook_id, title, created_by, updated_by)+ VALUES ('memo_user', 'nb_inbox', '欢迎来到 EdgeEver', 'system', 'system');+ INSERT INTO memo_contents (memo_id, content_json, content_markdown, content_text, content_hash)+ SELECT 'memo_user', content_json, content_markdown, content_text, content_hash+ FROM memo_contents WHERE memo_id = 'memo_welcome'`);+ const before = db.query("SELECT * FROM memo_contents WHERE memo_id = 'memo_user'").get();+ db.exec(repair);+ expect(db.query("SELECT * FROM memo_contents WHERE memo_id = 'memo_user'").get()).toEqual(before);+ assertRepaired(db);+ });++ test("does not announce or recreate a missing welcome note", () => {+ const db = legacy();+ db.exec("DELETE FROM memo_contents WHERE memo_id = 'memo_welcome'; DELETE FROM memos WHERE id = 'memo_welcome'");+ const before = changes(db);+ db.exec(repair);+ expect(memo(db)).toBeNull();+ expect(changes(db)).toEqual(before);+ });+});