@dv.nghiem/flowdeck 0.3.5 → 0.3.6

package/dist/hooks/memory-hook.d.ts

@@ -2,6 +2,13 @@ import { type Session } from "../services/memory-store";
 export declare function onSessionCreated(directory: string, contentSessionId: string, prompt?: string): Session;
 export declare function onToolExecuted(contentSessionId: string, toolName: string, toolInput: Record<string, unknown>, toolResponse: string | null, directory: string): void;
 export declare function onMessageUpdated(contentSessionId: string, role: string, content: string, directory: string): void;
+/**
+ * Called when OpenCode compacts a session (session.compacted event).
+ *
+ * Previously this silently dropped the summary if the session was not in
+ * activeSessions (e.g. after plugin reload or cross-process sessions). Now it
+ * falls back to a DB lookup so the summary is never lost.
+ */
 export declare function onSessionCompact(contentSessionId: string, summary: string): void;
 export declare function onSessionEnd(contentSessionId: string, lastMessage?: string): void;
 export declare function getSessionContext(directory: string, contentSessionId: string): {

package/dist/hooks/memory-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/memory-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,OAAO,EACb,MAAM,0BAA0B,CAAA;AAwBjC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAYtG;AAED,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,GAChB,IAAI,CAsBN;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CAyBN;AAED,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAKhF;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CASjF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,EAAE,CAAA;CAC5B,CAYA;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAA"}
+{"version":3,"file":"memory-hook.d.ts","sourceRoot":"","sources":["../../src/hooks/memory-hook.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,OAAO,EAGb,MAAM,0BAA0B,CAAA;AAgGjC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAYtG;AAED,wBAAgB,cAAc,CAC5B,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClC,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,GAChB,IAAI,CA4BN;AAED,wBAAgB,gBAAgB,CAC9B,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,MAAM,GAChB,IAAI,CA6BN;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CA+BhF;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CA2BjF;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG;IAC9E,OAAO,EAAE,MAAM,CAAA;IACf,gBAAgB,EAAE,OAAO,EAAE,CAAA;CAC5B,CAIA;AAED,wBAAgB,YAAY,CAAC,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAE3D;AAED,eAAO,MAAM,UAAU;;;;;;;;CAQtB,CAAA"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAkGjD,QAAA,MAAM,MAAM,EAAE,MAqPb,CAAA;AAED,eAAe,MAAM,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAkGjD,QAAA,MAAM,MAAM,EAAE,MAsPb,CAAA;AAED,eAAe,MAAM,CAAA"}

package/dist/index.js

@@ -1709,23 +1709,34 @@ import { Database } from "bun:sqlite";
 import { existsSync as existsSync15, mkdirSync as mkdirSync10 } from "fs";
 import { join as join15 } from "path";
 import { homedir } from "os";
-var MEMORY_DIR = join15(homedir(), ".flowdeck-memory");
-var DB_PATH = join15(MEMORY_DIR, "memory.db");
-function ensureDir() {
-  if (!existsSync15(MEMORY_DIR)) {
-    mkdirSync10(MEMORY_DIR, { recursive: true });
-  }
+function resolveMemoryDir() {
+  return process.env.FLOWDECK_MEMORY_DIR ?? join15(homedir(), ".flowdeck-memory");
 }
+var JS_RETRY_COUNT = 3;
+var JS_RETRY_BASE_MS = 50;
 var db = null;
+function debugLog(msg) {
+  if (process.env.FLOWDECK_MEMORY_DEBUG) {
+    console.error(`[FlowDeck Memory] ${msg}`);
+  }
+}
 function getDb() {
   if (!db) {
-    ensureDir();
-    db = new Database(DB_PATH);
+    const dir = resolveMemoryDir();
+    if (!existsSync15(dir))
+      mkdirSync10(dir, { recursive: true });
+    const dbPath = join15(dir, "memory.db");
+    db = new Database(dbPath);
+    debugLog(`DB opened: ${dbPath}`);
     initializeSchema(db);
   }
   return db;
 }
 function initializeSchema(database) {
+  database.run("PRAGMA journal_mode = WAL");
+  database.run("PRAGMA busy_timeout = 5000");
+  database.run("PRAGMA synchronous = NORMAL");
+  database.run("PRAGMA wal_autocheckpoint = 1000");
   const schema = `
     CREATE TABLE IF NOT EXISTS sessions (
       id INTEGER PRIMARY KEY AUTOINCREMENT,
@@ -1753,6 +1764,7 @@ function initializeSchema(database) {
       id INTEGER PRIMARY KEY AUTOINCREMENT,
       session_id INTEGER NOT NULL UNIQUE,
       content TEXT NOT NULL,
+      metadata TEXT,
       created_at TEXT NOT NULL DEFAULT (datetime('now')),
       FOREIGN KEY (session_id) REFERENCES sessions(id)
     );
@@ -1764,6 +1776,49 @@ function initializeSchema(database) {
     CREATE INDEX IF NOT EXISTS idx_sessions_directory ON sessions(directory);
   `;
   database.run(schema);
+  const summaryColumns = database.prepare("PRAGMA table_info(summaries)").all().map((c) => c.name);
+  if (!summaryColumns.includes("metadata")) {
+    database.run("ALTER TABLE summaries ADD COLUMN metadata TEXT");
+    debugLog("Migrated summaries table: added metadata column");
+  }
+}
+function isBusyError(err) {
+  if (!err || typeof err !== "object")
+    return false;
+  const e = err;
+  return e.code === "SQLITE_BUSY" || (e.message?.includes("database is locked") ?? false);
+}
+function sleepSync(ms) {
+  try {
+    Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+  } catch {
+    const end = Date.now() + ms;
+    while (Date.now() < end) {}
+  }
+}
+function executeWrite(fn, context) {
+  for (let attempt = 0;attempt <= JS_RETRY_COUNT; attempt++) {
+    const start = Date.now();
+    try {
+      const result = fn();
+      const duration = Date.now() - start;
+      if (attempt > 0) {
+        debugLog(`${context}: succeeded after ${attempt} JS retr${attempt === 1 ? "y" : "ies"} (${duration}ms)`);
+      } else {
+        debugLog(`${context}: completed in ${duration}ms`);
+      }
+      return result;
+    } catch (err) {
+      if (isBusyError(err) && attempt < JS_RETRY_COUNT) {
+        const delay = JS_RETRY_BASE_MS * (attempt + 1);
+        debugLog(`${context}: SQLITE_BUSY — JS retry ${attempt + 1}/${JS_RETRY_COUNT} after ${delay}ms`);
+        sleepSync(delay);
+        continue;
+      }
+      throw err;
+    }
+  }
+  throw new Error(`${context}: exhausted all retries`);
 }
 function serializeToolInput(input) {
   if (!input)
@@ -1791,7 +1846,7 @@ function initSession(contentSessionId, project, directory) {
     database.prepare("UPDATE sessions SET last_active_at = ?, prompt_count = prompt_count + 1 WHERE id = ?").run(now, existing.id);
     return { ...existing, last_active_at: now, prompt_count: (existing.prompt_count || 0) + 1 };
   }
-  const result = database.prepare("INSERT INTO sessions (content_session_id, project, directory, created_at, last_active_at) VALUES (?, ?, ?, ?, ?)").run(contentSessionId, project, directory, now, now);
+  const result = database.prepare("INSERT INTO sessions (content_session_id, project, directory, created_at, last_active_at, prompt_count) VALUES (?, ?, ?, ?, ?, ?)").run(contentSessionId, project, directory, now, now, 1);
   return {
     id: result.lastInsertRowid,
     content_session_id: contentSessionId,
@@ -1805,27 +1860,38 @@ function initSession(contentSessionId, project, directory) {
 function storeObservation(sessionId, toolName, toolInput, toolResponse, directory) {
   const database = getDb();
   const now = new Date().toISOString();
-  const result = database.prepare("INSERT INTO observations (session_id, tool_name, tool_input, tool_response, directory, created_at) VALUES (?, ?, ?, ?, ?, ?)").run(sessionId, toolName, serializeToolInput(toolInput), toolResponse ? toolResponse.slice(0, 1e4) : null, directory, now);
-  database.prepare("UPDATE sessions SET last_active_at = ? WHERE id = ?").run(now, sessionId);
+  const serializedInput = serializeToolInput(toolInput);
+  const truncatedResponse = toolResponse ? toolResponse.slice(0, 1e4) : null;
+  const result = executeWrite(database.transaction(() => {
+    const r = database.prepare("INSERT INTO observations (session_id, tool_name, tool_input, tool_response, directory, created_at) VALUES (?, ?, ?, ?, ?, ?)").run(sessionId, toolName, serializedInput, truncatedResponse, directory, now);
+    database.prepare("UPDATE sessions SET last_active_at = ? WHERE id = ?").run(now, sessionId);
+    return r;
+  }), `storeObservation(${toolName})`);
   return {
     id: result.lastInsertRowid,
     session_id: sessionId,
     tool_name: toolName,
-    tool_input: parseToolInput(serializeToolInput(toolInput)),
-    tool_response: toolResponse ? toolResponse.slice(0, 1e4) : null,
+    tool_input: parseToolInput(serializedInput),
+    tool_response: truncatedResponse,
     directory,
     created_at: now
   };
 }
-function storeSummary(sessionId, content) {
+function storeSummary(sessionId, content, metadata) {
   const database = getDb();
   const now = new Date().toISOString();
-  database.prepare("INSERT OR REPLACE INTO summaries (session_id, content, created_at) VALUES (?, ?, ?)").run(sessionId, content, now);
-  database.prepare("UPDATE sessions SET summary = ? WHERE id = ?").run(content, sessionId);
+  const serializedMetadata = metadata ? JSON.stringify(metadata) : null;
+  const id = executeWrite(database.transaction(() => {
+    database.prepare("INSERT OR REPLACE INTO summaries (session_id, content, metadata, created_at) VALUES (?, ?, ?, ?)").run(sessionId, content, serializedMetadata, now);
+    database.prepare("UPDATE sessions SET summary = ? WHERE id = ?").run(content.slice(0, 2000), sessionId);
+    return database.prepare("SELECT last_insert_rowid() as id").get().id;
+  }), `storeSummary(session=${sessionId})`);
+  debugLog(`storeSummary: wrote ${content.length} chars${metadata ? ` + ${JSON.stringify(metadata).length}B metadata` : ""} for session ${sessionId}`);
   return {
-    id: database.prepare("SELECT last_insert_rowid() as id").get().id,
+    id,
     session_id: sessionId,
     content,
+    metadata: metadata ?? null,
     created_at: now
   };
 }
@@ -1844,6 +1910,20 @@ function getObservationsForSession(sessionId) {
     tool_input: parseToolInput(obs.tool_input)
   }));
 }
+function getSessionSummary(sessionId) {
+  const database = getDb();
+  const row = database.prepare("SELECT * FROM summaries WHERE session_id = ?").get(sessionId);
+  if (!row)
+    return null;
+  return {
+    ...row,
+    metadata: row.metadata ? JSON.parse(row.metadata) : null
+  };
+}
+function getSessionByContentSessionId(contentSessionId) {
+  const database = getDb();
+  return database.prepare("SELECT * FROM sessions WHERE content_session_id = ?").get(contentSessionId) || null;
+}
 function getRecentObservations(directory, limit = 50) {
   const database = getDb();
   const rows = database.prepare(`SELECT o.*, s.project, s.content_session_id, s.created_at as session_created
@@ -1905,11 +1985,15 @@ function getContextForDirectory(directory, maxObservations = 20) {
       lines.push(`Output: ${preview}${observation.tool_response.length > 300 ? "..." : ""}`);
     }
   }
-  const summaries = getDb().prepare(`SELECT su.* FROM summaries su
+  const summaryRows = getDb().prepare(`SELECT su.* FROM summaries su
        JOIN sessions s ON su.session_id = s.id
        WHERE s.directory = ?
        ORDER BY su.created_at DESC
        LIMIT 3`).all(directory);
+  const summaries = summaryRows.map((r) => ({
+    ...r,
+    metadata: r.metadata ? JSON.parse(r.metadata) : null
+  }));
   if (summaries.length > 0) {
     lines.push(`
 ## Session Summaries`);
@@ -1917,12 +2001,20 @@ function getContextForDirectory(directory, maxObservations = 20) {
       const date = sum.created_at ? new Date(sum.created_at).toLocaleDateString() : "unknown";
       lines.push(`
 ### [${date}]`);
-      lines.push(sum.content.slice(0, 500));
+      lines.push(sum.content.slice(0, 2000));
     }
   }
   return lines.join(`
 `);
 }
+function getDbSettings() {
+  const database = getDb();
+  const journalMode = database.prepare("PRAGMA journal_mode").get().journal_mode;
+  const busyTimeout = database.prepare("PRAGMA busy_timeout").get().timeout;
+  const synchronous = database.prepare("PRAGMA synchronous").get().synchronous;
+  const walAutocheckpoint = database.prepare("PRAGMA wal_autocheckpoint").get().wal_autocheckpoint;
+  return { journal_mode: journalMode, busy_timeout: busyTimeout, synchronous, wal_autocheckpoint: walAutocheckpoint };
+}
 
 // src/tools/memory-search.ts
 var memorySearchTool = tool16({
@@ -1942,8 +2034,14 @@ var memorySearchTool = tool16({
         return JSON.stringify({ error: "Session not found", session_id: args.session_id });
       }
       const observations = getObservationsForSession(targetSession.id);
+      const summary = getSessionSummary(targetSession.id);
       return JSON.stringify({
         session: targetSession,
+        summary: summary ? {
+          content: summary.content,
+          metadata: summary.metadata,
+          created_at: summary.created_at
+        } : null,
         observations: observations.map((o) => ({
           tool_name: o.tool_name,
           tool_input: o.tool_input,
@@ -1990,69 +2088,57 @@ var memorySearchTool = tool16({
 
 // src/tools/memory-status.ts
 import { tool as tool17 } from "@opencode-ai/plugin";
-import { Database as Database2 } from "bun:sqlite";
 import { existsSync as existsSync16 } from "fs";
 import { join as join16 } from "path";
 import { homedir as homedir2 } from "os";
-var DB_PATH2 = join16(homedir2(), ".flowdeck-memory", "memory.db");
+function resolveDbPath() {
+  return join16(process.env.FLOWDECK_MEMORY_DIR ?? join16(homedir2(), ".flowdeck-memory"), "memory.db");
+}
 var memoryStatusTool = tool17({
   description: "Check FlowDeck memory database status, statistics, and recent sessions",
   args: {},
-  async execute(_args, _context) {
+  async execute(_args, context) {
+    const directory = context?.directory ?? process.cwd();
+    const dbPath = resolveDbPath();
     try {
-      const exists = existsSync16(DB_PATH2);
-      const result = {
-        database_exists: exists,
-        path: DB_PATH2,
-        status: exists ? "ACTIVE" : "NOT_INITIALIZED",
-        statistics: null
-      };
-      if (exists) {
-        try {
-          const db2 = new Database2(DB_PATH2);
-          const sessions = db2.prepare("SELECT COUNT(*) as count FROM sessions").get();
-          const observations = db2.prepare("SELECT COUNT(*) as count FROM observations").get();
-          const summaries = db2.prepare("SELECT COUNT(*) as count FROM summaries").get();
-          const recentSessions = db2.prepare(`
-            SELECT 
-              id,
-              content_session_id,
-              project,
-              directory,
-              created_at,
-              last_active_at,
-              prompt_count
-            FROM sessions
-            ORDER BY last_active_at DESC
-            LIMIT 5
-          `).all();
-          result.statistics = {
-            sessions: sessions.count,
-            observations: observations.count,
-            summaries: summaries.count,
-            recent_sessions: recentSessions.map((s) => {
-              const obsCount = db2.prepare("SELECT COUNT(*) as count FROM observations WHERE session_id = ?").get(s.id);
-              return {
-                project: s.project,
-                directory: s.directory,
-                observations_in_session: obsCount.count,
-                last_active: s.last_active_at,
-                prompt_count: s.prompt_count
-              };
-            })
-          };
-          db2.close();
-        } catch (err) {
-          result.status = "ERROR";
-          result.statistics = { error: String(err) };
-        }
+      const exists = existsSync16(dbPath);
+      if (!exists) {
+        return JSON.stringify({
+          database_exists: false,
+          path: dbPath,
+          status: "NOT_INITIALIZED"
+        }, null, 2);
       }
-      return JSON.stringify(result, null, 2);
+      const settings = getDbSettings();
+      const recentSessions = getRecentSessions(directory, 5);
+      const sessionStats = recentSessions.map((s) => {
+        const observations = getObservationsForSession(s.id);
+        const summary = getSessionSummary(s.id);
+        return {
+          project: s.project,
+          directory: s.directory,
+          content_session_id: s.content_session_id,
+          observations_in_session: observations.length,
+          last_active: s.last_active_at,
+          prompt_count: s.prompt_count,
+          has_summary: !!summary,
+          summary_length: summary?.content.length ?? 0,
+          summary_preview: summary?.content.slice(0, 200) ?? null,
+          handoff_metadata: summary?.metadata ?? null
+        };
+      });
+      return JSON.stringify({
+        database_exists: true,
+        path: dbPath,
+        status: "ACTIVE",
+        pragma_settings: settings,
+        recent_sessions_in_directory: sessionStats
+      }, null, 2);
     } catch (err) {
       return JSON.stringify({
         status: "ERROR",
         error: String(err),
-        path: DB_PATH2
+        path: dbPath
       }, null, 2);
     }
   }
@@ -2060,7 +2146,7 @@ var memoryStatusTool = tool17({
 
 // src/hooks/memory-hook.ts
 var MAX_TOOL_RESPONSE = 1e4;
-var MAX_PROMPT_LENGTH = 2000;
+var MAX_SUMMARY_STORAGE = 50000;
 var activeSessions = new Map;
 function extractProjectFromDirectory(directory) {
   const parts = directory.split("/");
@@ -2071,6 +2157,59 @@ function truncate(str, max) {
     return str || "";
   return str.slice(0, max);
 }
+function buildHandoffMetadata(sessionId, directory, summaryText, observations) {
+  const fileTools = new Set(["edit", "create", "view", "read", "hash-edit", "str-replace-editor"]);
+  const importantFilesSet = new Set;
+  for (const obs of observations) {
+    if (fileTools.has(obs.tool_name) && obs.tool_input) {
+      const path = obs.tool_input.path;
+      if (path)
+        importantFilesSet.add(path);
+    }
+  }
+  const toolNamesUsed = [...new Set(observations.map((o) => o.tool_name).filter((t) => t !== "assistant_message"))];
+  function extractBullets(text) {
+    return text.split(`
+`).filter((l) => /^\s*[-*]/.test(l)).map((l) => l.replace(/^\s*[-*]\s+/, "").trim()).filter(Boolean);
+  }
+  const sections = {};
+  let currentSection = "";
+  const currentLines = [];
+  for (const line of summaryText.split(`
+`)) {
+    const header = line.match(/^##\s+\d+\.\s+(.+)/);
+    if (header) {
+      if (currentSection)
+        sections[currentSection] = currentLines.join(`
+`).trim();
+      currentSection = header[1].trim();
+      currentLines.length = 0;
+    } else {
+      currentLines.push(line);
+    }
+  }
+  if (currentSection)
+    sections[currentSection] = currentLines.join(`
+`).trim();
+  const completed = extractBullets(sections["Work Completed"] ?? "");
+  const pending = extractBullets(sections["Remaining Tasks"] ?? "");
+  return {
+    workflow_name: extractProjectFromDirectory(directory),
+    current_status: "compacted",
+    current_stage: null,
+    completed_stages: completed,
+    pending_stages: pending,
+    key_decisions: [],
+    blockers: [],
+    important_files: [...importantFilesSet].slice(0, 30),
+    approvals: [],
+    open_questions: [],
+    next_steps: pending.slice(0, 5),
+    tool_names_used: toolNamesUsed.slice(0, 20),
+    observation_count: observations.length,
+    updated_at: new Date().toISOString()
+  };
+}
 function onSessionCreated(directory, contentSessionId, prompt) {
   const project = extractProjectFromDirectory(directory);
   const session = initSession(contentSessionId, project, directory);
@@ -2095,7 +2234,11 @@ function onToolExecuted(contentSessionId, toolName, toolInput, toolResponse, dir
     };
     activeSessions.set(contentSessionId, ctx);
   }
-  storeObservation(ctx.sessionId, truncate(toolName, 200), toolInput, toolResponse ? truncate(toolResponse, MAX_TOOL_RESPONSE) : null, directory);
+  try {
+    storeObservation(ctx.sessionId, truncate(toolName, 200), toolInput, toolResponse ? truncate(toolResponse, MAX_TOOL_RESPONSE) : null, directory);
+  } catch (err) {
+    console.warn(`[FlowDeck Memory] Failed to store observation for tool "${toolName}":`, err);
+  }
 }
 function onMessageUpdated(contentSessionId, role, content, directory) {
   if (role !== "assistant")
@@ -2114,33 +2257,64 @@ function onMessageUpdated(contentSessionId, role, content, directory) {
     };
     activeSessions.set(contentSessionId, ctx);
   }
-  storeObservation(ctx.sessionId, "assistant_message", { role }, truncate(content, MAX_TOOL_RESPONSE), directory);
+  try {
+    storeObservation(ctx.sessionId, "assistant_message", { role }, truncate(content, MAX_TOOL_RESPONSE), directory);
+  } catch (err) {
+    console.warn("[FlowDeck Memory] Failed to store assistant message observation:", err);
+  }
 }
 function onSessionCompact(contentSessionId, summary) {
-  const ctx = activeSessions.get(contentSessionId);
-  if (!ctx)
-    return;
-  storeSummary(ctx.sessionId, truncate(summary, MAX_PROMPT_LENGTH));
+  let ctx = activeSessions.get(contentSessionId);
+  if (!ctx) {
+    const dbSession = getSessionByContentSessionId(contentSessionId);
+    if (!dbSession) {
+      console.warn(`[FlowDeck Memory] onSessionCompact: no session found for contentSessionId=${contentSessionId} — summary discarded`);
+      return;
+    }
+    ctx = {
+      sessionId: dbSession.id,
+      contentSessionId,
+      project: dbSession.project,
+      directory: dbSession.directory
+    };
+    activeSessions.set(contentSessionId, ctx);
+  }
+  const storedContent = truncate(summary, MAX_SUMMARY_STORAGE);
+  try {
+    const observations = getObservationsForSession(ctx.sessionId);
+    const metadata = buildHandoffMetadata(ctx.sessionId, ctx.directory, summary, observations);
+    storeSummary(ctx.sessionId, storedContent, metadata);
+  } catch (err) {
+    console.warn(`[FlowDeck Memory] Failed to store compaction summary for session ${ctx.sessionId}:`, err);
+  }
 }
 function onSessionEnd(contentSessionId, lastMessage) {
-  const ctx = activeSessions.get(contentSessionId);
-  if (!ctx)
-    return;
-  if (lastMessage && lastMessage.trim()) {
-    storeSummary(ctx.sessionId, truncate(lastMessage, MAX_PROMPT_LENGTH));
+  let ctx = activeSessions.get(contentSessionId);
+  if (!ctx) {
+    const dbSession = getSessionByContentSessionId(contentSessionId);
+    if (dbSession) {
+      ctx = {
+        sessionId: dbSession.id,
+        contentSessionId,
+        project: dbSession.project,
+        directory: dbSession.directory
+      };
+    }
+  }
+  if (ctx && lastMessage && lastMessage.trim()) {
+    try {
+      const observations = getObservationsForSession(ctx.sessionId);
+      const metadata = buildHandoffMetadata(ctx.sessionId, ctx.directory, lastMessage, observations);
+      storeSummary(ctx.sessionId, truncate(lastMessage, MAX_SUMMARY_STORAGE), metadata);
+    } catch (err) {
+      console.warn(`[FlowDeck Memory] Failed to store end-of-session summary for session ${ctx?.sessionId}:`, err);
+    }
   }
   activeSessions.delete(contentSessionId);
 }
 function getSessionContext(directory, contentSessionId) {
   const context = getContextForDirectory(directory, 30);
   const previousSessions = getRecentSessions(directory, 5);
-  if (previousSessions.length > 0 && activeSessions.has(contentSessionId)) {
-    const ctx = activeSessions.get(contentSessionId);
-    for (const prev of previousSessions) {
-      if (prev.content_session_id === contentSessionId)
-        continue;
-    }
-  }
   return { context, previousSessions };
 }
 function clearSession(contentSessionId) {
@@ -6423,7 +6597,7 @@ var plugin = async (input, _options) => {
           const delEvent = event?.event ?? event;
           const sessionId = delEvent?.sessionID ?? delEvent?.sessionId ?? "";
           if (sessionId) {
-            memoryHook.clearSession(sessionId);
+            memoryHook.onSessionEnd(sessionId);
           }
         }
       } catch (err) {

package/dist/services/memory-store.d.ts

@@ -1,3 +1,23 @@
+/**
+ * Structured handoff artifact persisted alongside the text summary.
+ * Derived from observations + LLM compaction output.
+ */
+export interface HandoffMetadata {
+    workflow_name: string | null;
+    current_status: string;
+    current_stage: string | null;
+    completed_stages: string[];
+    pending_stages: string[];
+    key_decisions: string[];
+    blockers: string[];
+    important_files: string[];
+    approvals: string[];
+    open_questions: string[];
+    next_steps: string[];
+    tool_names_used: string[];
+    observation_count: number;
+    updated_at: string;
+}
 export interface Observation {
     id?: number;
     session_id: number;
@@ -21,6 +41,7 @@ export interface Summary {
     id?: number;
     session_id: number;
     content: string;
+    metadata?: HandoffMetadata | null;
     created_at?: string;
 }
 export interface SearchResult {
@@ -29,12 +50,24 @@ export interface SearchResult {
 }
 export declare function initSession(contentSessionId: string, project: string, directory: string): Session;
 export declare function storeObservation(sessionId: number, toolName: string, toolInput: unknown, toolResponse: string | null, directory: string): Observation;
-export declare function storeSummary(sessionId: number, content: string): Summary;
+export declare function storeSummary(sessionId: number, content: string, metadata?: HandoffMetadata | null): Summary;
 export declare function getRecentSessions(directory: string, limit?: number): Session[];
 export declare function getObservationsForSession(sessionId: number): Observation[];
 export declare function getSessionSummary(sessionId: number): Summary | null;
+export declare function getSessionByContentSessionId(contentSessionId: string): Session | null;
 export declare function getRecentObservations(directory: string, limit?: number): SearchResult[];
 export declare function searchObservations(directory: string, query: string, limit?: number): SearchResult[];
 export declare function getContextForDirectory(directory: string, maxObservations?: number): string;
 export declare function closeDatabase(): void;
+/**
+ * Returns current connection-level PRAGMA values.
+ * Intended for diagnostics and tests — queries via the shared singleton so the
+ * values reflect what this module actually set, not a second connection.
+ */
+export declare function getDbSettings(): {
+    journal_mode: string;
+    busy_timeout: number;
+    synchronous: number;
+    wal_autocheckpoint: number;
+};
 //# sourceMappingURL=memory-store.d.ts.map

package/dist/services/memory-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.ts"],"names":[],"mappings":"AAkEA,MAAM,WAAW,WAAW;IAC1B,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAA;IAC1C,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,kBAAkB,EAAE,MAAM,CAAA;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACvB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,WAAW,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;CACjB;AAoBD,wBAAgB,WAAW,CAAC,gBAAgB,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CA8BjG;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,EAClB,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,SAAS,EAAE,MAAM,GAChB,WAAW,CAqBb;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAgBxE;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAI,GAAG,OAAO,EAAE,CAUzE;AAED,wBAAgB,yBAAyB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAU1E;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAGnE;AAED,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CAyBnF;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,SAAK,GAAG,YAAY,EAAE,CA2B/F;AAED,wBAAgB,sBAAsB,CAAC,SAAS,EAAE,MAAM,EAAE,eAAe,SAAK,GAAG,MAAM,CAwCtF;AAED,wBAAgB,aAAa,IAAI,IAAI,CAKpC"}
+{"version":3,"file":"memory-store.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.ts"],"names":[],"mappings":"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"}

package/dist/services/memory-store.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=memory-store.test.d.ts.map

package/dist/services/memory-store.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-store.test.d.ts","sourceRoot":"","sources":["../../src/services/memory-store.test.ts"],"names":[],"mappings":""}

package/dist/tools/memory-search.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-search.d.ts","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAG/D,eAAO,MAAM,gBAAgB,EAAE,cAwE7B,CAAA"}
+{"version":3,"file":"memory-search.d.ts","sourceRoot":"","sources":["../../src/tools/memory-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQ/D,eAAO,MAAM,gBAAgB,EAAE,cAgF7B,CAAA"}

package/dist/tools/memory-status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-status.d.ts","sourceRoot":"","sources":["../../src/tools/memory-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQ/D,eAAO,MAAM,gBAAgB,EAAE,cAoE7B,CAAA"}
+{"version":3,"file":"memory-status.d.ts","sourceRoot":"","sources":["../../src/tools/memory-status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAU/D,eAAO,MAAM,gBAAgB,EAAE,cAkE7B,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dv.nghiem/flowdeck",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "FlowDeck — structured planning and execution workflows for OpenCode",
   "type": "module",
   "main": "./dist/index.js",