feat: deliver P2 v0.2.0 with unified editor, search, and snapshots

Implement schema v2 migration, outline/setting/inspiration CRUD, unified TipTap editing, reference panel with mentions, FTS global search, chapter version history, writing landmarks, word frequency analysis, light theme contrast fixes, and full unit/E2E test coverage.

Co-authored-by: Cursor <cursoragent@cursor.com>

src/renderer/stores/useAppStore.ts

@@ -6,10 +6,14 @@ interface AppState {
   view: AppView
   sidebarPanel: 'chapters' | 'outline' | 'setting' | 'inspiration'
   rightPanel: 'ai' | 'knowledge' | 'wordfreq' | 'book-settings'
+  versionModalOpen: boolean
+  landmarksModalOpen: boolean
   toast: string | null
   setView: (view: AppView) => void
   setSidebarPanel: (panel: AppState['sidebarPanel']) => void
   setRightPanel: (panel: AppState['rightPanel']) => void
+  setVersionModalOpen: (open: boolean) => void
+  setLandmarksModalOpen: (open: boolean) => void
   showToast: (message: string) => void
   clearToast: () => void
 }
@@ -18,10 +22,14 @@ export const useAppStore = create<AppState>((set) => ({
   view: 'home',
   sidebarPanel: 'chapters',
   rightPanel: 'ai',
+  versionModalOpen: false,
+  landmarksModalOpen: false,
   toast: null,
   setView: (view) => set({ view }),
   setSidebarPanel: (sidebarPanel) => set({ sidebarPanel }),
   setRightPanel: (rightPanel) => set({ rightPanel }),
+  setVersionModalOpen: (versionModalOpen) => set({ versionModalOpen }),
+  setLandmarksModalOpen: (landmarksModalOpen) => set({ landmarksModalOpen }),
   showToast: (toast) => {
     set({ toast })
     setTimeout(() => set({ toast: null }), 2500)

src/renderer/stores/useBookStore.ts

@@ -1,5 +1,5 @@
 import { create } from 'zustand'
-import type { BookMeta, Volume, Chapter } from '@shared/types'
+import type { BookMeta, Volume, Chapter, OutlineItem, SettingEntry, InspirationEntry } from '@shared/types'
 import { ipcCall } from '@renderer/lib/ipc-client'
 
 interface BookState {
@@ -7,6 +7,9 @@ interface BookState {
   currentBookId: string | null
   volumes: Volume[]
   chapters: Chapter[]
+  outlines: OutlineItem[]
+  settings: SettingEntry[]
+  inspirations: InspirationEntry[]
   selectedChapterId: string | null
   activeVolumeId: string | null
   loadBooks: () => Promise<void>
@@ -14,7 +17,17 @@ interface BookState {
   setSelectedChapter: (chapterId: string) => void
   setActiveVolume: (volumeId: string) => void
   refreshChapters: () => Promise<void>
+  refreshBookData: () => Promise<void>
   updateChapterLocal: (chapter: Chapter) => void
+  updateOutlineLocal: (item: OutlineItem) => void
+  addOutlineLocal: (item: OutlineItem) => void
+  removeOutlineLocal: (id: string) => void
+  updateSettingLocal: (item: SettingEntry) => void
+  addSettingLocal: (item: SettingEntry) => void
+  removeSettingLocal: (id: string) => void
+  updateInspirationLocal: (item: InspirationEntry) => void
+  addInspirationLocal: (item: InspirationEntry) => void
+  removeInspirationLocal: (id: string) => void
 }
 
 export const useBookStore = create<BookState>((set, get) => ({
@@ -22,6 +35,9 @@ export const useBookStore = create<BookState>((set, get) => ({
   currentBookId: null,
   volumes: [],
   chapters: [],
+  outlines: [],
+  settings: [],
+  inspirations: [],
   selectedChapterId: null,
   activeVolumeId: null,
   loadBooks: async () => {
@@ -40,6 +56,9 @@ export const useBookStore = create<BookState>((set, get) => ({
       currentBookId: bookId,
       volumes: result.volumes,
       chapters: result.chapters,
+      outlines: result.outlines,
+      settings: result.settings,
+      inspirations: result.inspirations,
       activeVolumeId: result.chapters.find((c) => c.id === lastChapter)?.volumeId ?? firstVolume,
       selectedChapterId: lastChapter
     })
@@ -53,14 +72,56 @@ export const useBookStore = create<BookState>((set, get) => ({
   },
   setActiveVolume: (volumeId) => set({ activeVolumeId: volumeId }),
   refreshChapters: async () => {
+    await get().refreshBookData()
+  },
+  refreshBookData: async () => {
     const bookId = get().currentBookId
     if (!bookId) return
     const result = await ipcCall(() => window.electronAPI.book.open(bookId))
-    set({ volumes: result.volumes, chapters: result.chapters })
+    set({
+      volumes: result.volumes,
+      chapters: result.chapters,
+      outlines: result.outlines,
+      settings: result.settings,
+      inspirations: result.inspirations
+    })
   },
   updateChapterLocal: (chapter) => {
     set((s) => ({
       chapters: s.chapters.map((c) => (c.id === chapter.id ? chapter : c))
     }))
+  },
+  updateOutlineLocal: (item) => {
+    set((s) => ({
+      outlines: s.outlines.map((o) => (o.id === item.id ? item : o))
+    }))
+  },
+  addOutlineLocal: (item) => {
+    set((s) => ({ outlines: [...s.outlines, item] }))
+  },
+  removeOutlineLocal: (id) => {
+    set((s) => ({ outlines: s.outlines.filter((o) => o.id !== id) }))
+  },
+  updateSettingLocal: (item) => {
+    set((s) => ({
+      settings: s.settings.map((x) => (x.id === item.id ? item : x))
+    }))
+  },
+  addSettingLocal: (item) => {
+    set((s) => ({ settings: [...s.settings, item] }))
+  },
+  removeSettingLocal: (id) => {
+    set((s) => ({ settings: s.settings.filter((x) => x.id !== id) }))
+  },
+  updateInspirationLocal: (item) => {
+    set((s) => ({
+      inspirations: s.inspirations.map((x) => (x.id === item.id ? item : x))
+    }))
+  },
+  addInspirationLocal: (item) => {
+    set((s) => ({ inspirations: [...s.inspirations, item] }))
+  },
+  removeInspirationLocal: (id) => {
+    set((s) => ({ inspirations: s.inspirations.filter((x) => x.id !== id) }))
   }
 }))

src/renderer/stores/useEditStore.ts

@@ -0,0 +1,27 @@
+import { create } from 'zustand'
+import type { EditTarget } from '@shared/types'
+
+interface EditState {
+  target: EditTarget | null
+  switchTarget: (next: EditTarget) => Promise<void>
+  setTarget: (next: EditTarget | null) => void
+}
+
+let flushFn: (() => Promise<void>) | null = null
+
+export function registerEditorFlush(fn: () => Promise<void>): void {
+  flushFn = fn
+}
+
+export async function flushEditSession(): Promise<void> {
+  if (flushFn) await flushFn()
+}
+
+export const useEditStore = create<EditState>((set) => ({
+  target: null,
+  switchTarget: async (next) => {
+    await flushEditSession()
+    set({ target: next })
+  },
+  setTarget: (next) => set({ target: next })
+}))

src/renderer/stores/useOutlineStore.ts

@@ -0,0 +1,28 @@
+import { create } from 'zustand'
+import type { OutlineItem } from '@shared/types'
+
+export type OutlineFilter = 'all' | 'uncovered' | 'covered'
+
+interface OutlineState {
+  compareMode: boolean
+  filter: OutlineFilter
+  compareSelectedId: string | null
+  setCompareMode: (open: boolean) => void
+  setFilter: (filter: OutlineFilter) => void
+  setCompareSelectedId: (id: string | null) => void
+}
+
+export function filterOutlines(items: OutlineItem[], filter: OutlineFilter): OutlineItem[] {
+  if (filter === 'all') return items
+  if (filter === 'uncovered') return items.filter((o) => !o.chapterId)
+  return items.filter((o) => Boolean(o.chapterId))
+}
+
+export const useOutlineStore = create<OutlineState>((set) => ({
+  compareMode: false,
+  filter: 'all',
+  compareSelectedId: null,
+  setCompareMode: (compareMode) => set({ compareMode }),
+  setFilter: (filter) => set({ filter }),
+  setCompareSelectedId: (compareSelectedId) => set({ compareSelectedId })
+}))

src/renderer/stores/useReferenceStore.ts

@@ -0,0 +1,30 @@
+import { create } from 'zustand'
+
+type ReferenceTab = 'setting' | 'outline' | 'inspiration'
+
+interface ReferenceState {
+  open: boolean
+  tab: ReferenceTab
+  query: string
+  pinnedIds: string[]
+  setOpen: (open: boolean) => void
+  setTab: (tab: ReferenceTab) => void
+  setQuery: (query: string) => void
+  togglePin: (id: string) => void
+}
+
+export const useReferenceStore = create<ReferenceState>((set, get) => ({
+  open: false,
+  tab: 'setting',
+  query: '',
+  pinnedIds: [],
+  setOpen: (open) => set({ open }),
+  setTab: (tab) => set({ tab }),
+  setQuery: (query) => set({ query }),
+  togglePin: (id) => {
+    const pinned = get().pinnedIds
+    set({
+      pinnedIds: pinned.includes(id) ? pinned.filter((x) => x !== id) : [...pinned, id]
+    })
+  }
+}))

src/renderer/stores/useSearchStore.ts

@@ -0,0 +1,23 @@
+import { create } from 'zustand'
+
+interface SearchState {
+  open: boolean
+  query: string
+  regex: boolean
+  caseSensitive: boolean
+  setOpen: (open: boolean) => void
+  setQuery: (query: string) => void
+  setRegex: (regex: boolean) => void
+  setCaseSensitive: (caseSensitive: boolean) => void
+}
+
+export const useSearchStore = create<SearchState>((set) => ({
+  open: false,
+  query: '',
+  regex: false,
+  caseSensitive: false,
+  setOpen: (open) => set({ open }),
+  setQuery: (query) => set({ query }),
+  setRegex: (regex) => set({ regex }),
+  setCaseSensitive: (caseSensitive) => set({ caseSensitive })
+}))