@hienlh/ppm 0.5.20 → 0.6.0

package/docs/design-guidelines.md

@@ -296,7 +296,7 @@ screens: {
 
 ```tsx
 // src/web/components/editor/code-editor.tsx
-// CodeMirror 6 integration with syntax highlighting
+// Monaco Editor integration (@monaco-editor/react)
 
 <CodeEditor
   language="javascript"
@@ -307,10 +307,13 @@ screens: {
 />
 
 // Features:
-// - 50+ language support
+// - 50+ language support with IntelliSense
 // - Real-time syntax highlighting
 // - Line numbers, code folding
 // - Find/replace (Ctrl+H)
+// - Word wrap toggle (Alt+Z)
+// - Monaco diff viewer for git diffs
+// - Theme sync with app dark/light mode
 ```
 
 ### Terminal Component

package/docs/project-overview-pdr.md

@@ -5,7 +5,7 @@
 **PPM** (Personal Project Manager) is a full-stack, mobile-first web IDE designed for developers to manage code projects with AI-powered assistance. It combines a responsive web interface, real-time terminal access, AI chat with tool support, and Git integration into a cohesive development environment.
 
 Built on the **Bun runtime** for performance, PPM enables developers to:
-- Browse and edit project files with CodeMirror syntax highlighting
+- Browse and edit project files with Monaco Editor syntax highlighting
 - Execute commands via xterm.js terminal with full PTY support
 - Chat with Claude AI with file attachments and slash commands
 - View Git status, diffs, and commit graphs in real-time
@@ -25,9 +25,9 @@ Built on the **Bun runtime** for performance, PPM enables developers to:
 ### Core Features (Implemented v2)
 - **Project Management** — Create, switch, and manage multiple projects via CLI and web UI
 - **File Explorer** — Browse directory trees, create/edit/delete files with path traversal protection
-- **Code Editor** — CodeMirror 6 with syntax highlighting, line numbers, theme support (dark/light)
+- **Code Editor** — Monaco Editor with syntax highlighting, IntelliSense, diff viewer, theme support (dark/light)
 - **Terminal** — Full xterm.js with Bun PTY, resize handling, multiple terminal sessions per project
-- **AI Chat** — Streaming Claude messages with tool use (file read/write, git commands), file attachments, slash command detection
+- **AI Chat** — Streaming Claude messages with tool use (file read/write, git commands), file attachments, slash commands, auto-generated session titles
 - **Git Integration** — Status, diffs, commit graphs, branch management, staging/committing
 - **PWA** — Installable web app with offline support
 - **Authentication** — Token-based auth with auto-generated tokens in config
@@ -62,10 +62,10 @@ Built on the **Bun runtime** for performance, PPM enables developers to:
 - **Trade-off:** Larger CSS bundle; mitigated by tree-shaking, critical CSS extraction
 - **Impact:** Consistent, accessible, maintainable UI with dark/light theme support
 
-### Editor: CodeMirror 6 + Diff2HTML
-- **Why:** Modular, extensible, supports syntax highlighting, merge views, live collaboration
-- **Trade-off:** More complex API than Monaco; justified by Bun compatibility and flexibility
-- **Impact:** Supports 50+ languages, diffing, real-time file changes
+### Editor: Monaco Editor (@monaco-editor/react)
+- **Why:** Superior IntelliSense, syntax highlighting, built-in diff viewer, industry-standard code editor
+- **Trade-off:** Larger bundle size; justified by feature richness and developer experience
+- **Impact:** 50+ languages, IntelliSense, word wrap toggle (Alt+Z), Monaco diff viewer
 
 ### Terminal: xterm.js + Bun PTY
 - **Why:** xterm.js is industry-standard terminal emulator; Bun PTY avoids node-pty complexity
@@ -77,10 +77,10 @@ Built on the **Bun runtime** for performance, PPM enables developers to:
 - **Trade-off:** Anthropic-specific; can swap via provider registry pattern
 - **Impact:** Rich conversation capabilities, reliable streaming, tool approval flow
 
-### Database: None (Filesystem-based)
-- **Why:** Single-machine design, YAML project registry, stateless server
-- **Trade-off:** No persistence across server restarts for chat; mitigated by session IDs in URL
-- **Impact:** Zero infrastructure, fast startup, git-friendly config
+### Database: SQLite (migrating from YAML)
+- **Why:** Richer persistence for sessions, usage tracking, audit logs; single-file DB suits single-machine design
+- **Trade-off:** Added dependency; mitigated by Bun's built-in SQLite support (bun:sqlite)
+- **Impact:** Session mapping, push subscriptions, usage history, config storage with YAML backward compat
 
 ### Build: Vite 8.0
 - **Why:** ESM-native, fast hot reload, TypeScript support, PWA plugin
@@ -190,13 +190,16 @@ ppm stop                       # Stop daemon
 | Version | Status | Focus | Date |
 |---------|--------|-------|------|
 | **v1** | Complete | Initial prototype (single project, basic chat, terminal) | Feb 2025 |
-| **v2** | In Progress | Multi-project, project-scoped APIs, improved UI/UX, daemon mode, --share flag | Mar 2025 |
-| **v3** | Planned | Collaborative editing, plugin architecture | Q2 2025 |
+| **v2** | Complete (v0.5.21) | Multi-project, Monaco Editor, auto-title sessions, daemon mode, --share flag, SQLite migration | Mar 2026 |
+| **v3** | Planned | Collaborative editing, plugin architecture | Q2 2026 |
 
-### v2 Changes (Mar 2025)
-- **Daemon Mode as Default:** `ppm start` now runs background daemon by default. `--foreground/-f` flag for debugging.
+### v2 Changes (Mar 2026)
+- **Daemon Mode as Default:** `ppm start` runs background daemon by default. `--foreground/-f` flag for debugging.
 - **Public URL Sharing:** `ppm start --share` creates Cloudflare Quick Tunnel public URL. Auto-downloads cloudflared binary.
+- **Monaco Editor:** Migrated from CodeMirror 6 to Monaco Editor with IntelliSense and diff viewer.
+- **Auto-Title Sessions:** Chat sessions auto-generate titles from SDK summary after first message.
+- **SQLite Persistence:** Migrating from YAML to SQLite for config, sessions, usage, push subscriptions.
+- **Web Push Notifications:** Push notification support via Service Worker.
+- **Session Logging:** Audit trail with sensitive data redaction.
 - **Status File:** `~/.ppm/status.json` (new format) replaces `ppm.pid` with backward compatibility.
-- **Auth Warning:** Warns if `--share` used without auth enabled.
-- **New Services:** `cloudflared.service.ts` (binary download), `tunnel.service.ts` (tunnel lifecycle).
 

package/docs/project-roadmap.md

@@ -1,12 +1,12 @@
 # PPM Project Roadmap & Status
 
-**Last Updated:** March 17, 2026
+**Last Updated:** March 19, 2026
 
-## Current Version: v2.0 (In Progress)
+## Current Version: v2.0 (Complete v0.5.21)
 
-### Overall Progress: 90%
+### Overall Progress: 95%
 
-Multi-project, project-scoped API refactor with improved UX.
+Multi-project, project-scoped API refactor with improved UX, Monaco Editor, auto-title chat sessions.
 
 ---
 
@@ -61,22 +61,21 @@ Multi-project, project-scoped API refactor with improved UX.
 
 ### Phase 4: File Explorer & Editor ✅ Complete
 - FileTree component with directory expansion
-- Monaco Editor integration with syntax highlighting
+- Monaco Editor integration with syntax highlighting and IntelliSense
 - File read/write operations
 - Monaco diff viewer for git diffs
 
-**Status:** Done
-
-**Latest Work (260315):**
-- Chat file attachments (drag-drop, paste)
-- File viewer for images/PDFs/markdown
-- Better error messages
+**Status:** Done, CodeMirror fully removed (v0.5.17+)
 
 **Latest Work (260317):**
 - Migrated CodeMirror → Monaco Editor (@monaco-editor/react) for better syntax highlighting and diff viewer
 - Alt+Z keyboard shortcut for word wrap toggle in editor and diff viewer
 - Improved code completion and IntelliSense
 
+**Latest Work (260319):**
+- CodeMirror fully removed from codebase
+- Monaco Editor polishing for large file performance
+
 ---
 
 ### Phase 5: Web Terminal ✅ Complete
@@ -122,6 +121,11 @@ Multi-project, project-scoped API refactor with improved UX.
 - Usage badge (token tracking)
 - Session management (save/load)
 
+**Latest Work (260319):**
+- Auto-generate session title from SDK summary on first message
+- Inline session rename in chat UI
+- Session history tab persistence
+
 ---
 
 ### Phase 8: CLI Commands ✅ Complete
@@ -149,25 +153,29 @@ Multi-project, project-scoped API refactor with improved UX.
 
 ---
 
-### Phase 10: Testing ✅ In Progress (60%)
+### Phase 10: Testing ✅ In Progress (65%)
 
-#### Unit Tests (40% complete)
+#### Unit Tests (50% complete)
 - [x] Mock provider tests
 - [x] ChatService tests
+- [x] ConfigService tests
+- [x] DbService tests (SQLite)
 - [ ] FileService tests
 - [ ] GitService tests
 - [x] Zustand store tests
+- [x] SessionLogService tests (redaction)
 
-#### Integration Tests (30% complete)
+#### Integration Tests (40% complete)
 - [x] Claude Agent SDK integration
 - [x] Chat WebSocket flow
+- [x] SQLite migration validation
 - [ ] Terminal WebSocket flow
 - [ ] Git operations
 - [ ] File operations
 
 #### E2E Tests (0% — Planned for v3)
 
-**Status:** Partial, needs completion
+**Status:** Making progress, good coverage for core services
 
 ---
 
@@ -222,13 +230,16 @@ Multi-project, project-scoped API refactor with improved UX.
 - [x] Project Switcher Bar (52px sidebar, avatars, colors, reordering) (260317)
 - [x] Keep-alive workspace switching (preserve xterm DOM) (260317)
 - [x] Sidebar tab system (Explorer/Git/History) (260317)
-- [x] Monaco Editor migration (CodeMirror → Monaco) (260317)
+- [x] Monaco Editor migration (CodeMirror → Monaco, fully removed) (260317-260319)
 - [x] Project color customization (12-color palette + custom hex) (260317)
-- [ ] Complete test coverage (60% complete)
-- [ ] Documentation (in progress)
+- [x] Auto-generate chat session titles from SDK summary (260319)
+- [x] Inline session rename UI (260319)
+- [x] SQLite migration (db.service.ts, backward YAML compat) (in progress)
+- [ ] Complete test coverage (65% complete)
+- [x] Documentation updates (260319)
 - [ ] Security audit (planned)
 
-**Target Release:** March 31, 2026
+**Release Status:** v0.5.21 released, v2.0 essentially complete
 
 ---
 
@@ -355,8 +366,8 @@ Multi-project, project-scoped API refactor with improved UX.
 | Version | Status | Features | Target Date |
 |---------|--------|----------|-------------|
 | **v1.0** | Released | Single project, basic chat, terminal | Feb 28, 2025 |
-| **v2.0** | In Progress | Multi-project, project-scoped API, improved UX | Mar 31, 2026 |
-| **v2.1** | Planned | Bug fixes, performance improvements | Apr 15, 2026 |
+| **v2.0** | Complete (v0.5.21) | Multi-project, project-scoped API, improved UX, Monaco Editor, auto-title | Mar 19, 2026 |
+| **v2.1** | Planned | Complete test coverage, SQLite finalization, bug fixes | Apr 15, 2026 |
 | **v3.0** | Planned | Collaborative editing, custom tools, plugins | Jun 30, 2026 |
 | **v4.0** | Planned | Cloud sync, advanced git, profiling UI | Sep 30, 2026 |
 
@@ -392,10 +403,11 @@ Multi-project, project-scoped API refactor with improved UX.
 | Dependency | Version | Risk | Monitoring |
 |-----------|---------|------|-----------|
 | Bun | 1.3.6+ | Medium | Check security advisories weekly |
-| Claude Agent SDK | 0.2.76 | Low | Follow Anthropic releases |
+| Claude Agent SDK | 0.2.76+ | Low | Follow Anthropic releases for model updates |
 | React | 19.2.4 | Low | Monitor for breaking changes |
-| TypeScript | 5.9.3 | Low | Plan upgrades quarterly |
+| TypeScript | 5.9.3+ | Low | Plan upgrades quarterly |
 | xterm.js | 6.0 | Low | Check for terminal rendering bugs |
+| Monaco Editor | 4.7.0+ | Low | Monitor for accessibility improvements |
 
 ---
 

package/docs/system-architecture.md

@@ -34,19 +34,19 @@
 │  │  ┌──────────────────────────────────────────────────────────┐ │   │
 │  │  │ ProviderRegistry (routes to active AI provider)         │ │   │
 │  │  │ ┌───────────────────────┬──────────────────────────┐   │ │   │
-│  │  │ │ claude-agent-sdk      │ claude-code-cli (CLI)   │   │ │   │
-│  │  │ │ @anthropic/SDK (prim) │ Fallback subprocess    │   │ │   │
+│  │  │ │ claude-agent-sdk      │ mock-provider (test)    │   │ │   │
+│  │  │ │ @anthropic/SDK (prim) │ Returns canned resp.   │   │ │   │
 │  │  │ └───────────────────────┴──────────────────────────┘   │ │   │
 │  │  └──────────────────────────────────────────────────────────┘ │   │
 │  └────────────────────────────────────────────────────────────────┘   │
 │                                                                        │
 │  Config & State (src/services/)                                       │
 │  ┌──────────────────┐  ┌──────────────────┐  ┌─────────────────┐    │
-│  │ ppm.yaml         │  │ Git Repos        │  │ Session Storage │    │
-│  │ (projects list)  │  │ (local disk)     │  │ (in-memory only)│    │
-│  │ (auth token)     │  │                  │  │                 │    │
-│  │ (AI provider     │  │                  │  │                 │    │
-│  │  settings)       │  │                  │  │                 │    │
+│  │ SQLite DB        │  │ Git Repos        │  │ Session Storage │    │
+│  │ (config, projs)  │  │ (local disk)     │  │ (SQLite + SDK)  │    │
+│  │ (session map)    │  │                  │  │ (session_map,   │    │
+│  │ (push subs,      │  │                  │  │  session_logs,  │    │
+│  │  usage, logs)    │  │                  │  │  usage_history) │    │
 │  └──────────────────┘  └──────────────────┘  └─────────────────┘    │
 └──────────────────────────────────────────────────────────────────────┘
         ↓↑
@@ -54,7 +54,8 @@
    │  Filesystem Access (Local Only)                │
    │  • Project directories (git repos)             │
    │  • File read/write operations                  │
-   │  • Config file (ppm.yaml)                      │
+   │  • SQLite database (~/.ppm/ppm.db)              │
+   │  • Legacy config file (~/.ppm/config.yaml)      │
    └────────────────────────────────────────────────┘
 ```
 
@@ -138,11 +139,15 @@ WS     /ws/project/:name/terminal/:id             → Terminal I/O
 | Service | Purpose | Key Methods |
 |---------|---------|-------------|
 | **ChatService** | Session management, message streaming | createSession, streamMessage, getHistory |
+| **ConfigService** | Config loading (YAML→SQLite migration) | load, save, getToken |
+| **DbService** | SQLite persistence (6 tables, WAL) | getDb, openTestDb, schema migrations |
 | **GitService** | Git command execution | status, diff, commit, stage, branch |
 | **FileService** | File operations with validation | read, write, tree, delete, mkdir |
 | **TerminalService** | PTY lifecycle, shell spawning | spawn, write, kill |
-| **ProjectService** | Project registry (YAML) | add, remove, get, list |
-| **ConfigService** | Config file management | load, save, getToken |
+| **ProjectService** | Project CRUD, scanning | add, remove, get, list, scan |
+| **ClaudeUsageService** | Token tracking, cost calculation | trackUsage, getUsage |
+| **PushNotificationService** | Web push subscriptions | subscribe, unsubscribe, notify |
+| **SessionLogService** | Audit logs with redaction | logSession, getLog |
 | **ProviderRegistry** | AI provider routing | getDefault, send (delegates) |
 | **CloudflaredService** | Download cloudflared binary | ensureCloudflared, getCloudflaredPath |
 | **TunnelService** | Cloudflare Quick Tunnel lifecycle | startTunnel, stopTunnel, getTunnelUrl |
@@ -170,25 +175,28 @@ interface AIProvider {
 ```
 
 **Implementations:**
-- **claude-agent-sdk** (Primary) — @anthropic-ai/claude-agent-sdk, streaming, tool use. Reads model/effort/maxTurns/budget/thinking from `ppm.yaml` AI config. Settings refreshed per query.
+- **claude-agent-sdk** (Primary) — @anthropic-ai/claude-agent-sdk, streaming, tool use. Reads model/effort/maxTurns/budget/thinking from config. Settings refreshed per query. Windows CLI fallback for Bun subprocess pipe issues. .env poisoning mitigation.
 - **mock-provider** (Testing) — Returns canned responses
-- **Note:** CLI provider removed (v2); agent SDK now sole AI provider
+- **Note:** CLI provider removed (v2); agent SDK is sole AI provider with Windows CLI fallback
 
 ---
 
-### Data Access Layer (Filesystem + Git)
-**Components:** Direct filesystem access, simple-git wrapper
+### Data Access Layer (SQLite + Filesystem + Git)
+**Components:** SQLite via bun:sqlite, direct filesystem access, simple-git wrapper
 
 **Responsibilities:**
+- Persist config, projects, session maps, usage, logs in SQLite
 - Read/write project files with path validation
 - Execute git commands via simple-git
 - Cache directory listings
 - Enforce security (no parent directory access)
 
 **Key Patterns:**
+- SQLite: WAL mode, foreign keys, lazy init, schema v1 with 6 tables
 - Path validation: `projectPath/relativePath` only, reject `..`
 - Caching: Directory trees cached with TTL
 - Error handling: Descriptive messages (file not found, permission denied)
+- Migration: Automatic YAML→SQLite migration on first run with new db.service
 
 ---
 
@@ -196,10 +204,11 @@ interface AIProvider {
 **Component:** Zustand stores in browser
 
 **Stores:**
-- **projectStore** — Active project, project list
-- **tabStore** — Open tabs (chat, editor, git, terminal)
-- **fileStore** — Selected files, editor content
-- **settingsStore** — Auth token, theme preference
+- **projectStore** — Active project, project list, localStorage persistence
+- **tabStore** — Tab facade, delegates to panelStore
+- **panelStore** — Grid layout (rows/columns), panel creation/movement, keep-alive snapshots
+- **fileStore** — File cache
+- **settingsStore** — Theme, sidebar state, git view mode, device name
 
 **Pattern:** Selectors for subscriptions (only re-render affected components)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hienlh/ppm",
-  "version": "0.5.20",
+  "version": "0.6.0",
   "description": "Personal Project Manager — mobile-first web IDE with AI assistance",
   "module": "src/index.ts",
   "type": "module",
@@ -37,8 +37,11 @@
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.2.76",
+    "@codemirror/lang-sql": "^6.10.0",
     "@inquirer/prompts": "^8.3.0",
     "@monaco-editor/react": "^4.7.0",
+    "@tanstack/react-table": "^8.21.3",
+    "@uiw/react-codemirror": "^4.25.8",
     "@xterm/addon-fit": "^0.11.0",
     "@xterm/addon-web-links": "^0.12.0",
     "@xterm/xterm": "^6.0.0",

package/src/cli/commands/init.ts

@@ -4,6 +4,7 @@ import { existsSync } from "node:fs";
 import { input, confirm, select, password } from "@inquirer/prompts";
 import { configService } from "../../services/config.service.ts";
 import { projectService } from "../../services/project.service.ts";
+import { getAllConfig } from "../../services/db.service.ts";
 
 const DEFAULT_PORT = 3210;
 
@@ -18,10 +19,14 @@ export interface InitOptions {
 }
 
 /** Check if config already exists */
+/** Check if config already exists (DB or legacy YAML) */
 export function hasConfig(): boolean {
+  try {
+    const dbConfig = getAllConfig();
+    if (Object.keys(dbConfig).length > 0) return true;
+  } catch {}
   const globalConfig = resolve(homedir(), ".ppm", "config.yaml");
-  const localConfig = resolve(process.cwd(), "ppm.yaml");
-  return existsSync(globalConfig) || existsSync(localConfig);
+  return existsSync(globalConfig);
 }
 
 export async function initProject(options: InitOptions = {}) {

package/src/cli/commands/restart.ts

@@ -37,6 +37,12 @@ export async function restartServer(options: { config?: string }) {
   // Brief pause for port release
   await Bun.sleep(500);
 
+  // Set DB profile before loading config
+  const { setDbProfile } = await import("../../services/db.service.ts");
+  if (options.config && /dev/i.test(options.config)) {
+    setDbProfile("dev");
+  }
+
   // Reload config for new server
   const { configService } = await import("../../services/config.service.ts");
   configService.load(options.config);

package/src/index.ts

@@ -19,8 +19,16 @@ program
   .option("-f, --foreground", "Run in foreground (default: background daemon)")
   .option("-d, --daemon", "Run as background daemon (default, kept for compat)")
   .option("-s, --share", "Share via public URL (Cloudflare tunnel)")
-  .option("-c, --config <path>", "Path to config file")
+  .option("-c, --config <path>", "Path to config file (YAML import into DB)")
+  .option("--profile <name>", "DB profile name (e.g. 'dev' → ppm.dev.db)")
   .action(async (options) => {
+    // Set DB profile before any DB access
+    const { setDbProfile } = await import("./services/db.service.ts");
+    if (options.profile) {
+      setDbProfile(options.profile);
+    } else if (options.config && /dev/i.test(options.config)) {
+      setDbProfile("dev");
+    }
     // Auto-init on first run
     const { hasConfig, initProject } = await import("./cli/commands/init.ts");
     if (!hasConfig()) {

package/src/providers/claude-agent-sdk.ts

@@ -13,33 +13,13 @@ import type {
 } from "./provider.interface.ts";
 import { configService } from "../services/config.service.ts";
 import { updateFromSdkEvent } from "../services/claude-usage.service.ts";
+import { getSessionMapping, setSessionMapping } from "../services/db.service.ts";
 import { resolve } from "node:path";
 import { homedir } from "node:os";
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
-
-/** Persistent PPM sessionId → SDK sessionId mapping */
-const SESSION_MAP_FILE = resolve(homedir(), ".ppm", "session-map.json");
-
-function loadSessionMap(): Record<string, string> {
-  try {
-    if (existsSync(SESSION_MAP_FILE)) return JSON.parse(readFileSync(SESSION_MAP_FILE, "utf-8"));
-  } catch {}
-  return {};
-}
-
-function saveSessionMapping(ppmId: string, sdkId: string): void {
-  const map = loadSessionMap();
-  map[ppmId] = sdkId;
-  try {
-    const dir = resolve(homedir(), ".ppm");
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-    writeFileSync(SESSION_MAP_FILE, JSON.stringify(map));
-  } catch {}
-}
+import { readFileSync, existsSync } from "node:fs";
 
 function getSdkSessionId(ppmId: string): string {
-  const map = loadSessionMap();
-  return map[ppmId] ?? ppmId;
+  return getSessionMapping(ppmId) ?? ppmId;
 }
 
 /**
@@ -473,7 +453,7 @@ export class ClaudeAgentSdkProvider implements AIProvider {
             const existingMsgs = await getSessionMessages(sessionId);
             if (existingMsgs.length > 0) {
               resumeSessionId = sessionId;
-              saveSessionMapping(sessionId, sessionId);
+              setSessionMapping(sessionId, sessionId);
               console.log(`[sdk] session ${sessionId} exists on disk (${existingMsgs.length} msgs) — will resume`);
             }
           } catch {}
@@ -525,11 +505,58 @@ export class ClaudeAgentSdkProvider implements AIProvider {
       /** Number of tool_use blocks pending results (top-level tools only, not subagent children) */
       let pendingToolCount = 0;
 
+      // Retry logic: if SDK returns error_during_execution with 0 turns on first event,
+      // it's a transient subprocess failure — retry once before surfacing the error.
+      const MAX_RETRIES = 1;
+      let retryCount = 0;
+
+      retryLoop: while (true) {
       let sdkEventCount = 0;
       for await (const msg of eventSource) {
         sdkEventCount++;
         if (sdkEventCount === 1) {
           console.log(`[sdk] first event received: type=${(msg as any).type} subtype=${(msg as any).subtype ?? "none"}`);
+          // Detect immediate failure: first event is a result with error + 0 turns
+          if ((msg as any).type === "result" && (msg as any).subtype === "error_during_execution" && ((msg as any).num_turns ?? 0) === 0 && retryCount < MAX_RETRIES) {
+            retryCount++;
+            console.warn(`[sdk] transient error on first event — retrying (attempt ${retryCount}/${MAX_RETRIES})`);
+            // Re-create query for retry — don't reuse sessionId in case SDK partially created it
+            if (!useDirectCli) {
+              const q = query({
+                prompt: message,
+                options: {
+                  // On retry, let SDK generate a fresh session to avoid conflicts
+                  sessionId: undefined,
+                  resume: undefined,
+                  ...(shouldFork && { forkSession: true }),
+                  cwd: effectiveCwd,
+                  systemPrompt: { type: "preset", preset: "claude_code" },
+                  settingSources: ["user", "project"],
+                  env: queryEnv,
+                  settings: { permissions: { allow: [], deny: [] } },
+                  allowedTools: [
+                    "Read", "Write", "Edit", "Bash", "Glob", "Grep",
+                    "WebSearch", "WebFetch", "AskUserQuestion",
+                    "Agent", "Skill", "TodoWrite", "ToolSearch",
+                  ],
+                  permissionMode: "bypassPermissions",
+                  allowDangerouslySkipPermissions: true,
+                  ...(providerConfig.model && { model: providerConfig.model }),
+                  ...(providerConfig.effort && { effort: providerConfig.effort }),
+                  maxTurns: providerConfig.max_turns ?? 100,
+                  ...(providerConfig.max_budget_usd && { maxBudgetUsd: providerConfig.max_budget_usd }),
+                  ...(providerConfig.thinking_budget_tokens != null && {
+                    thinkingBudgetTokens: providerConfig.thinking_budget_tokens,
+                  }),
+                  canUseTool,
+                  includePartialMessages: true,
+                } as any,
+              });
+              this.activeQueries.set(sessionId, q);
+              eventSource = q;
+            }
+            continue retryLoop;
+          }
         }
         // Extract parent_tool_use_id from SDK message (present on subagent-scoped messages)
         const parentId = (msg as any).parent_tool_use_id as string | undefined;
@@ -545,7 +572,7 @@ export class ClaudeAgentSdkProvider implements AIProvider {
           // SDK may assign a different session_id than our UUID
           if (initMsg.session_id && initMsg.session_id !== sessionId) {
             // Persist mapping so resume works after server restart
-            saveSessionMapping(sessionId, initMsg.session_id);
+            setSessionMapping(sessionId, initMsg.session_id);
             // Update our in-memory mapping
             const oldMeta = this.activeSessions.get(sessionId);
             if (oldMeta) {
@@ -727,9 +754,12 @@ export class ClaudeAgentSdkProvider implements AIProvider {
 
           // Surface non-success subtypes as errors so FE can display them
           if (subtype && subtype !== "success") {
-            // Extract error detail from SDK result if available
-            const sdkError = result.error ?? result.error_message ?? result.message ?? "";
+            // Extract error detail from SDK result — check multiple possible fields
+            const sdkError = result.error ?? result.error_message ?? result.message ?? result.reason ?? "";
             const sdkDetail = typeof sdkError === "string" ? sdkError : JSON.stringify(sdkError);
+            // Log full result for debugging (truncated at 2000 chars)
+            console.error(`[sdk] result error: subtype=${subtype} turns=${result.num_turns ?? 0} detail=${sdkDetail || "(none)"}`);
+            console.error(`[sdk] result full dump: ${JSON.stringify(result).slice(0, 2000)}`);
             const errorMessages: Record<string, string> = {
               error_max_turns: "Agent reached maximum turn limit.",
               error_max_budget_usd: "Agent reached budget limit.",
@@ -737,7 +767,6 @@ export class ClaudeAgentSdkProvider implements AIProvider {
             };
             const baseMsg = errorMessages[subtype] ?? `Agent stopped: ${subtype}`;
             const fullMsg = sdkDetail ? `${baseMsg}\n${sdkDetail}` : baseMsg;
-            console.error(`[sdk] result error: subtype=${subtype} turns=${result.num_turns ?? 0} detail=${sdkDetail || "(none)"} raw=${JSON.stringify(result).slice(0, 500)}`);
             yield {
               type: "error",
               message: fullMsg,
@@ -772,6 +801,8 @@ export class ClaudeAgentSdkProvider implements AIProvider {
       if (sdkEventCount === 0) {
         yield { type: "error", message: "Claude did not respond. Check that 'claude' CLI works in your terminal." };
       }
+      break; // Exit retryLoop — normal completion
+      } // end retryLoop
     } catch (e) {
       const msg = (e as Error).message ?? String(e);
       console.error(`[sdk] error: ${msg}`);

package/src/server/index.ts

@@ -485,13 +485,15 @@ export async function startServer(options: {
   }
   console.log();
 
-  // Graceful shutdown — stop server + tunnel on exit (especially important on Windows)
+  // Graceful shutdown — stop server + tunnel + DB on exit
   const shutdown = () => {
     try { server.stop(true); } catch {}
     try {
-      // Dynamic import to avoid circular — tunnel may not be loaded
       import("../services/tunnel.service.ts").then(({ tunnelService }) => tunnelService.stopTunnel()).catch(() => {});
     } catch {}
+    try {
+      import("../services/db.service.ts").then(({ closeDb }) => closeDb()).catch(() => {});
+    } catch {}
   };
   process.on("SIGINT", () => { shutdown(); process.exit(0); });
   process.on("SIGTERM", () => { shutdown(); process.exit(0); });
@@ -505,6 +507,12 @@ if (process.argv.includes("__serve__")) {
   const host = process.argv[idx + 2] ?? "0.0.0.0";
   const configPath = process.argv[idx + 3] || undefined;
 
+  // Set DB profile for daemon child (detect "dev" from config path)
+  const { setDbProfile } = await import("../services/db.service.ts");
+  if (configPath && /dev/i.test(configPath)) {
+    setDbProfile("dev");
+  }
+
   configService.load(configPath);
   await setupLogFile();
 

package/src/server/routes/chat.ts

@@ -4,6 +4,7 @@ import { mkdirSync, existsSync } from "node:fs";
 import { tmpdir } from "node:os";
 import { chatService } from "../../services/chat.service.ts";
 import { providerRegistry } from "../../providers/registry.ts";
+import { renameSession as sdkRenameSession } from "@anthropic-ai/claude-agent-sdk";
 import { listSlashItems } from "../../services/slash-items.service.ts";
 import { getCachedUsage, refreshUsageNow } from "../../services/claude-usage.service.ts";
 import { getSessionLog } from "../../services/session-log.service.ts";
@@ -106,6 +107,24 @@ chatRoutes.delete("/sessions/:id", async (c) => {
   }
 });
 
+/** PATCH /chat/sessions/:id — rename a session */
+chatRoutes.patch("/sessions/:id", async (c) => {
+  try {
+    const id = c.req.param("id");
+    const body = await c.req.json<{ title?: string }>();
+    if (!body.title?.trim()) return c.json(err("title is required"), 400);
+    const title = body.title.trim();
+    // Persist to SDK so Claude Code CLI also sees the custom title
+    await sdkRenameSession(id, title);
+    // Also update in-memory session
+    const session = chatService.getSession(id);
+    if (session) session.title = title;
+    return c.json(ok({ id, title }));
+  } catch (e) {
+    return c.json(err((e as Error).message), 500);
+  }
+});
+
 /** POST /chat/sessions/:id/fork — fork session into a new one (for rewind/branch) */
 chatRoutes.post("/sessions/:id/fork", async (c) => {
   try {

package/src/server/routes/project-scoped.ts

@@ -3,6 +3,7 @@ import { resolveProjectPath } from "../helpers/resolve-project.ts";
 import { chatRoutes } from "./chat.ts";
 import { gitRoutes } from "./git.ts";
 import { fileRoutes } from "./files.ts";
+import { sqliteRoutes } from "./sqlite.ts";
 
 type Env = { Variables: { projectPath: string; projectName: string } };
 
@@ -25,3 +26,4 @@ projectScopedRouter.use("*", async (c, next) => {
 projectScopedRouter.route("/chat", chatRoutes);
 projectScopedRouter.route("/git", gitRoutes);
 projectScopedRouter.route("/files", fileRoutes);
+projectScopedRouter.route("/sqlite", sqliteRoutes);