feat: local HTTP API, quick capture, mermaid/math plugins + ASAR fix (#231)

## Summary

### New Features
- **Local HTTP API** (port 29168): REST API with bearer auth for
Alfred/Raycast/curl integration
- **Quick Capture** (Cmd+Shift+N): frameless floating window,
always-on-top, auto-focus
- **Mermaid diagrams**: code block renderer with "Open in Mermaid Live"
button
- **Math/LaTeX**: styled code block renderer with copy button
- **Vim mode**: plugin stub with toggle command (ready for
@codemirror/vim)

### Bug Fix
- **ASAR crash fix**: `ERR_PACKAGE_PATH_NOT_EXPORTED` — workspace
packages now bundled by electron-vite instead of externalized to
node_modules

### Verified
- Note window already shows only editor (no sidebar) — confirmed correct

## Test plan
- [x] `pnpm typecheck` — 17/17 pass
- [x] `pnpm build` (desktop) — builds successfully

🤖 Generated with [Claude Code](https://claude.com/claude-code)

<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* Quick Capture window with Cmd/Ctrl+Shift+N for rapid note entry
(floating, frameless).
* Local HTTP server controls (start/stop/status/get token) accessible
from the app.
  * Math & LaTeX plugin: render math blocks and copy LaTeX.
  * Mermaid plugin: render Mermaid blocks and copy source.
  * Vim Mode plugin: toggleable Vim Mode command and status indicator.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: tomymaritano

.claude/settings.local.json

@@ -81,7 +81,11 @@
       "Bash(ls /Users/tomasmaritano/Documents/Github/readied/readide/apps/desktop/src/renderer/components/NoteListFilterBar*)",
       "Bash(ls /Users/tomasmaritano/Documents/Github/readied/readide/apps/desktop/src/renderer/components/*.module.css)",
       "Bash(npm view:*)",
-      "Bash(git log:*)"
+      "Bash(git log:*)",
+      "Bash(git branch:*)",
+      "Bash(npx vercel:*)",
+      "Bash(gh workflow:*)",
+      "Bash(ls:*)"
     ]
   }
 }

apps/desktop/electron-vite.config.ts

@@ -4,7 +4,18 @@ import react from '@vitejs/plugin-react';
 
 export default defineConfig({
   main: {
-    plugins: [externalizeDepsPlugin()],
+    plugins: [
+      externalizeDepsPlugin({
+        exclude: [
+          '@readied/core',
+          '@readied/storage-core',
+          '@readied/storage-sqlite',
+          '@readied/sync-core',
+          '@readied/licensing',
+          '@readied/ai-core',
+        ],
+      }),
+    ],
     build: {
       outDir: 'out/main',
       rollupOptions: {
@@ -18,7 +29,11 @@ export default defineConfig({
     },
   },
   preload: {
-    plugins: [externalizeDepsPlugin()],
+    plugins: [
+      externalizeDepsPlugin({
+        exclude: ['@readied/core', '@readied/storage-core', '@readied/licensing'],
+      }),
+    ],
     build: {
       outDir: 'out/preload',
       rollupOptions: {

apps/desktop/src/main/handlers/localServerHandlers.ts

@@ -0,0 +1,192 @@
+/**
+ * Local HTTP API Server IPC Handlers
+ *
+ * Manages the local API server lifecycle and exposes status/token info
+ * to the renderer (settings UI).
+ */
+
+import { ipcMain, app } from 'electron';
+import { createNoteId, createNoteOperation, updateNoteOperation } from '@readied/core';
+import {
+  LocalServer,
+  getOrCreateApiToken,
+  type LocalServerHandlers,
+} from '../services/localServer.js';
+import type { SQLiteNoteRepository, DataPaths } from './types.js';
+
+// ============================================================================
+// Types
+// ============================================================================
+
+export interface LocalServerHandlerDeps {
+  noteRepository: SQLiteNoteRepository;
+  dataPaths: DataPaths;
+  noteToSnapshot: (note: {
+    id: string;
+    notebookId: string;
+    content: string;
+    title: string;
+    isPinned: boolean;
+    isDeleted: boolean;
+    status: import('@readied/core').NoteStatus;
+    metadata: {
+      createdAt: string;
+      updatedAt: string;
+      tags: readonly string[];
+      wordCount: number;
+      archivedAt: string | null;
+    };
+  }) => {
+    id: string;
+    notebookId: string;
+    content: string;
+    title: string;
+    createdAt: string;
+    updatedAt: string;
+    tags: string[];
+    wordCount: number;
+    archivedAt: string | null;
+    isArchived: boolean;
+    isPinned: boolean;
+    isDeleted: boolean;
+    status: import('@readied/core').NoteStatus;
+  };
+}
+
+// ============================================================================
+// Module State
+// ============================================================================
+
+const server = new LocalServer();
+let apiToken: string | null = null;
+
+// ============================================================================
+// Registration
+// ============================================================================
+
+export function registerLocalServerHandlers(deps: LocalServerHandlerDeps): void {
+  const { noteRepository: repo, dataPaths, noteToSnapshot } = deps;
+
+  // Build handler callbacks that bridge HTTP requests to the note repository
+  const handlers: LocalServerHandlers = {
+    async listNotes() {
+      const notes = await repo.list();
+      return notes
+        .filter(n => !n.isDeleted)
+        .map(n => ({
+          id: n.id,
+          title: n.title,
+          excerpt: n.content.slice(0, 200).replace(/\n/g, ' '),
+          updatedAt: n.metadata.updatedAt,
+        }));
+    },
+
+    async getNote(id) {
+      const note = await repo.get(createNoteId(id));
+      if (!note) return null;
+      const snap = noteToSnapshot(note);
+      return {
+        id: snap.id,
+        title: snap.title,
+        content: snap.content,
+        notebookId: snap.notebookId,
+        createdAt: snap.createdAt,
+        updatedAt: snap.updatedAt,
+        tags: snap.tags,
+        wordCount: snap.wordCount,
+        isPinned: snap.isPinned,
+      };
+    },
+
+    async createNote(input) {
+      const result = await createNoteOperation(input, repo);
+      if (result.ok) {
+        return { ok: true, data: { id: result.data.id } };
+      }
+      return { ok: false, error: result.error };
+    },
+
+    async updateNote(id, content) {
+      const noteId = createNoteId(id);
+      const result = await updateNoteOperation({ id: noteId, content }, repo);
+      return { ok: result.ok, error: result.ok ? undefined : result.error };
+    },
+
+    async searchNotes(query) {
+      const notes = await repo.search(query, 50);
+      return notes.map(n => ({
+        id: n.id,
+        title: n.title,
+        excerpt: n.content.slice(0, 200).replace(/\n/g, ' '),
+        updatedAt: n.metadata.updatedAt,
+      }));
+    },
+
+    async getNoteCount() {
+      return repo.count();
+    },
+
+    getAppVersion() {
+      return app.getVersion();
+    },
+  };
+
+  // IPC: Start the local server
+  ipcMain.handle('localServer:start', async (_event, port?: number) => {
+    try {
+      if (port !== undefined && (typeof port !== 'number' || port < 1 || port > 65535)) {
+        return { ok: false, error: 'Invalid port' };
+      }
+      if (server.isRunning()) return { ok: true, port: server.getPort() };
+      apiToken = await getOrCreateApiToken(dataPaths.root);
+      await server.start(port, apiToken, handlers);
+      return { ok: true, port: server.getPort() };
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+  });
+
+  // IPC: Stop the local server
+  ipcMain.handle('localServer:stop', async () => {
+    try {
+      await server.stop();
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+  });
+
+  // IPC: Get server status
+  ipcMain.handle('localServer:status', () => {
+    return {
+      running: server.isRunning(),
+      port: server.getPort(),
+    };
+  });
+
+  // IPC: Get the bearer token (for displaying in settings)
+  ipcMain.handle('localServer:getToken', async () => {
+    try {
+      if (!apiToken) {
+        apiToken = await getOrCreateApiToken(dataPaths.root);
+      }
+      return { ok: true, value: apiToken };
+    } catch (err) {
+      return { ok: false, error: err instanceof Error ? err.message : String(err) };
+    }
+  });
+}
+
+/**
+ * Pre-initialise the API bearer token (called from main index).
+ * The actual server start is controlled by settings — the renderer
+ * will call localServer:start if the setting is enabled.
+ */
+export async function initApiToken(dataPaths: DataPaths): Promise<void> {
+  apiToken = await getOrCreateApiToken(dataPaths.root);
+}
+
+/** Stop the server on app quit */
+export async function stopLocalServer(): Promise<void> {
+  await server.stop();
+}