release: merge develop into main for v0.20.2

Author: DavidsonGomes

CHANGELOG.md

@@ -5,6 +5,12 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.20.2] - 2026-04-13
+
+### Added
+
+- **Durable chat history via JSONL logs** — chat messages are now append-only logged to `ADWs/logs/chat/{agent}_{session}.jsonl`. On session join, if the in-memory history is empty (e.g., after server restart), the JSONL log is read and restored automatically. This makes chat history survive restarts, `sessions.json` cleanups, and 7-day expiry
+
 ## [0.20.1] - 2026-04-13
 
 ### Added

cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@evoapi/evo-nexus",
-  "version": "0.20.1",
+  "version": "0.20.2",
   "description": "Unofficial open source toolkit for Claude Code — AI-powered business operating system",
   "keywords": [
     "claude-code",

dashboard/terminal-server/src/server.js

@@ -7,6 +7,7 @@ const { v4: uuidv4 } = require('uuid');
 const ClaudeBridge = require('./claude-bridge');
 const { ChatBridge } = require('./chat-bridge');
 const SessionStore = require('./utils/session-store');
+const ChatLogger = require('./utils/chat-logger');
 
 class TerminalServer {
   constructor(options = {}) {
@@ -20,6 +21,7 @@ class TerminalServer {
     this.claudeBridge = new ClaudeBridge();
     this.chatBridge = new ChatBridge();
     this.sessionStore = new SessionStore();
+    this.chatLogger = new ChatLogger(this.baseFolder);
     this.autoSaveInterval = null;
     this.isShuttingDown = false;
 
@@ -403,6 +405,7 @@ class TerminalServer {
               ts: Date.now(),
             };
             chatSession.chatHistory.push(userMsg);
+            this.chatLogger.append(chatSession.agentName, wsInfo.claudeSessionId, userMsg);
 
             // Accumulate assistant response for history
             let assistantBlocks = [];
@@ -475,12 +478,14 @@ class TerminalServer {
                   }
                   // Save assistant message to history
                   if (assistantBlocks.length > 0) {
-                    chatSession.chatHistory.push({
+                    const assistantMsg = {
                       role: 'assistant',
                       blocks: assistantBlocks,
                       ts: Date.now(),
                       streaming: false,
-                    });
+                    };
+                    chatSession.chatHistory.push(assistantMsg);
+                    this.chatLogger.append(chatSession.agentName, wsInfo.claudeSessionId, assistantMsg);
                   }
                   this.saveSessionsToDisk();
                   this.broadcastToSession(wsInfo.claudeSessionId, { type: 'chat_complete' });
@@ -548,14 +553,25 @@ class TerminalServer {
     session.lastActivity = new Date();
     session.lastAccessed = Date.now();
 
+    // Restore chat history from JSONL logs if session cache is empty
+    let chatHistory = session.chatHistory || [];
+    if (chatHistory.length === 0 && session.agentName && session.mode === 'chat') {
+      const restored = this.chatLogger.read(session.agentName, claudeSessionId);
+      if (restored.length > 0) {
+        session.chatHistory = restored;
+        chatHistory = restored;
+        if (this.dev) console.log(`[chat-logger] Restored ${restored.length} messages for session ${claudeSessionId}`);
+      }
+    }
+
     this.sendToWebSocket(wsInfo.ws, {
       type: 'session_joined',
       sessionId: claudeSessionId,
       sessionName: session.name,
       workingDir: session.workingDir,
       active: session.active,
       outputBuffer: session.outputBuffer.slice(-200),
-      chatHistory: session.chatHistory || [],
+      chatHistory,
     });
 
     if (this.dev) console.log(`WebSocket ${wsId} joined session ${claudeSessionId}`);

dashboard/terminal-server/src/utils/chat-logger.js

@@ -0,0 +1,81 @@
+/**
+ * ChatLogger — append-only JSONL logs for chat conversations.
+ *
+ * Stores chat messages in workspace/ADWs/logs/chat/{agentName}_{sessionId}.jsonl
+ * Each line is a JSON object: { role, text?, blocks?, files?, ts }
+ *
+ * This is the durable source of truth for chat history.
+ * sessions.json is a fast-access cache; JSONL survives restarts and cleanups.
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+class ChatLogger {
+  constructor(workspaceRoot) {
+    this.logsDir = path.join(workspaceRoot || process.cwd(), 'workspace', 'ADWs', 'logs', 'chat');
+    this._ensureDir();
+  }
+
+  _ensureDir() {
+    try {
+      fs.mkdirSync(this.logsDir, { recursive: true });
+    } catch {}
+  }
+
+  _logPath(agentName, sessionId) {
+    const safe = (agentName || 'unknown').replace(/[^a-zA-Z0-9_-]/g, '_');
+    const shortId = sessionId.slice(0, 8);
+    return path.join(this.logsDir, `${safe}_${shortId}.jsonl`);
+  }
+
+  /**
+   * Append a message to the chat log.
+   */
+  append(agentName, sessionId, message) {
+    try {
+      const logPath = this._logPath(agentName, sessionId);
+      const line = JSON.stringify(message) + '\n';
+      fs.appendFileSync(logPath, line, 'utf8');
+    } catch (err) {
+      console.error(`[chat-logger] Failed to append: ${err.message}`);
+    }
+  }
+
+  /**
+   * Read full chat history from JSONL log.
+   * Returns array of messages, or empty array if not found.
+   */
+  read(agentName, sessionId) {
+    try {
+      const logPath = this._logPath(agentName, sessionId);
+      if (!fs.existsSync(logPath)) return [];
+
+      const content = fs.readFileSync(logPath, 'utf8').trim();
+      if (!content) return [];
+
+      const messages = [];
+      for (const line of content.split('\n')) {
+        if (!line.trim()) continue;
+        try {
+          messages.push(JSON.parse(line));
+        } catch {
+          // Skip malformed lines
+        }
+      }
+      return messages;
+    } catch (err) {
+      console.error(`[chat-logger] Failed to read: ${err.message}`);
+      return [];
+    }
+  }
+
+  /**
+   * Check if a log exists for a session.
+   */
+  exists(agentName, sessionId) {
+    return fs.existsSync(this._logPath(agentName, sessionId));
+  }
+}
+
+module.exports = ChatLogger;

pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "evo-nexus"
-version = "0.20.1"
+version = "0.20.2"
 description = "Unofficial open source toolkit for Claude Code — AI-powered business operating system"
 requires-python = ">=3.10"
 dependencies = [