feat: preparation for Release 3.0

Author: irockel

README.md

@@ -1,5 +1,15 @@
 
 # TDA - Thread Dump Analyzer
+
+> [!IMPORTANT]
+> **2026-01-30 - TDA 3.0 is now available!** 🚀
+> This major release brings significant enhancements:
+> *   **Extended MCP Server**: Now with **Carrier Thread Pinning** detection and support for **SMR (Safe Memory Relocation)** parsing.
+> *   **Modernized UI**: Completely refreshed look and feel using **FlatLaf**.
+> *   **Usability Improvements**: Fixed several long-standing issues, including improved split-pane management and faster parsing.
+> *   **Native macOS Support**: Now providing a dedicated macOS binary.
+> *   **Logging**: Especially for troubleshooting in MCP Mode.
+
 [![Java CI with Maven](https://github.com/irockel/tda/actions/workflows/build.yml/badge.svg)](https://github.com/irockel/tda/actions/workflows/build.yml)
 [![Renovate](https://img.shields.io/badge/renovate-enabled-brightgreen.svg)](https://github.com/irockel/tda/issues?q=is%3Aissue+is%3Aopen+label%3Adependencies)
 [![Dependencies](https://img.shields.io/librariesio/github/irockel/tda)](https://libraries.io/github/irockel/tda)
@@ -26,6 +36,7 @@ TDA supports Java 1.4.x through Java 21+, including specialized support for **Vi
   - [4. JSON-based Thread Dumps (Experimental)](#4-json-based-thread-dumps-experimental)
   - [5. MCP Server (Headless Analysis)](#5-mcp-server-headless-analysis)
 - [🏗 Building from Source](#-building-from-source)
+- [🛠️ Troubleshooting](#️-troubleshooting)
 - [📜 Changelog](CHANGELOG.md)
 - [📜 License](#-license)
 
@@ -159,18 +170,6 @@ The MCP server exposes the following tools:
 | `get_zombie_threads` | None                      | Returns a list of zombie threads (unresolved SMR addresses) with timestamps and dump names. |
 | `clear`             | None                      | Resets the server state and clears the internal thread store for a new log file.               |
 
-#### Troubleshooting
-
-- **Logging**: TDA maintains a log file for troubleshooting. The location depends on your operating system:
-    - **macOS**: `~/Library/Logs/TDA/tda.log`
-    - **Windows**: `%LOCALAPPDATA%\TDA\Logs\tda.log`
-    - **Linux/Unix**: `~/.tda/logs/tda.log`
-  You can check this file if TDA or the MCP server doesn't behave as expected.
-- **Path issues**: Ensure you use absolute paths for the JAR file and the log files you want to parse.
-- **Headless mode**: If you see errors related to `java.awt.HeadlessException`, double-check that `-Djava.awt.headless=true` is set.
-- **Permissions**: Make sure the user running the MCP server has read permissions for the log files.
-- **Memory issues**: If you see `OutOfMemoryError`s, you can increase the memory allocation by setting `-Xmx`.
-
 #### 🤖 AI Agent Configuration (Cursor / Junie)
 
 To ensure that AI agents use TDA efficiently and don't attempt to read large log files directly (which is slow and expensive), you should configure a **System Prompt**.
@@ -221,6 +220,40 @@ The resulting standalone JAR will also be located in the `tda/target/` directory
 
 ---
 
+## 🛠️ Troubleshooting
+
+If you encounter issues while using TDA, check the following sections for guidance.
+
+### 1. Logging
+TDA maintains a centralized log file to help diagnose issues. If something isn't working as expected, the log file is the first place to look.
+
+#### Log File Locations
+*   **macOS**: `~/Library/Logs/TDA/tda.log`
+*   **Windows**: `%LOCALAPPDATA%\TDA\Logs\tda.log`
+*   **Linux/Unix**: `~/.tda/logs/tda.log`
+
+#### Error Indicators (UI Mode)
+In standalone or plugin mode, TDA will display a **red dot** in the status bar (next to the memory indicator) if a critical error has occurred. Hover over the dot to see a tooltip reminding you to check the log file.
+
+### 2. MCP Server Specifics
+Running TDA as a headless MCP server has specific requirements:
+
+*   **Headless Environment**: Ensure you pass `-Djava.awt.headless=true` when running the JAR. TDA is a Swing-based application, and the MCP mode must bypass UI initialization.
+*   **Std-in/Std-out Pollution**: The MCP protocol communicates via `stdin` and `stdout`. Avoid using any commands or scripts that print additional information to `stdout`, as this will corrupt the JSON-RPC stream and cause the AI client to lose connection.
+*   **Absolute Paths**: When calling `parse_log`, always use **absolute paths** for the log file. The working directory of the MCP server might not be what you expect depending on how your AI client (e.g., Claude Desktop) launches it.
+*   **Permissions**: Ensure the user running the AI client has read permissions for the log files being analyzed.
+
+### 3. Memory Management
+Thread dumps from large production systems can be hundreds of megabytes. 
+
+*   **OutOfMemoryErrors**: If TDA crashes or fails to parse a large file, increase the heap size using the `-Xmx` flag:
+    ```bash
+    java -Xmx2g -jar tda.jar
+    ```
+*   **Max Logfile Size**: TDA has a safety limit for log file sizes. You can adjust this in the **Preferences** dialog (UI mode) or by manually editing the configuration if necessary.
+
+---
+
 ## 📜 License
 TDA is licensed under the **Lesser GNU General Public License (LGPL)**.
 

docs/index.html

@@ -63,6 +63,25 @@ <h1 class="text-4xl md:text-6xl font-extrabold mb-6 leading-tight">
             <p class="text-xl text-slate-300 mb-6 max-w-2xl mx-auto">
                 TDA (Thread Dump Analyzer) is a powerful tool for parsing and analyzing Java thread dumps, helping you identify performance bottlenecks and deadlocks in seconds.
             </p>
+            <!-- TDA 3.0 Announcement Box -->
+            <div class="mb-12 inline-block bg-blue-600/30 backdrop-blur-md border border-blue-400/50 rounded-2xl p-6 text-left max-w-3xl mx-auto shadow-2xl">
+                <div class="flex items-center mb-4">
+                    <span class="bg-blue-500 text-white text-xs font-black px-3 py-1 rounded-full uppercase tracking-wider mr-3">New Release</span>
+                    <h2 class="text-2xl font-bold text-white">TDA 3.0 is here! 🚀</h2>
+                </div>
+                <p class="text-blue-100 mb-4 font-medium">
+                    This major update modernizes the TDA experience and brings powerful new analysis capabilities to both the GUI and the MCP server.
+                </p>
+                <ul class="grid grid-cols-1 md:grid-cols-2 gap-x-6 gap-y-2 text-sm text-slate-200">
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span><b>Carrier Thread Pinning</b> detection in MCP</span></li>
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span><b>SMR (Safe Memory Reclamation)</b> parsing (also in MCP)</span></li>
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span><b>Native Stack Information in MCP</b> parsing</span></li>
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span>Modern UI with <b>FlatLaf</b></span></li>
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span>Improved split-pane & usability fixes</span></li>
+                    <li class="flex items-start"><i class="fas fa-check-circle text-blue-400 mt-1 mr-2"></i> <span>Logging for Troubleshooting in MCP Mode</span></li>
+                </ul>
+            </div>
+
             <div class="mb-10">
                 <span class="inline-flex items-center px-4 py-1.5 rounded-full text-sm font-bold bg-blue-500/20 text-blue-300 border border-blue-500/30">
                     <i class="fas fa-unlock-alt mr-2"></i> Free & Open Source

pom.xml

@@ -5,7 +5,7 @@
 
     <groupId>de.grimmfrost.tda</groupId>
     <artifactId>tda-parent</artifactId>
-    <version>2.7</version>
+    <version>3.0</version>
     <packaging>pom</packaging>
 
     <name>TDA Parent</name>

tda-macos-binary/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.grimmfrost.tda</groupId>
         <artifactId>tda-parent</artifactId>
-        <version>2.7</version>
+        <version>3.0</version>
     </parent>
 
     <artifactId>tda-macos-binary</artifactId>

tda/dependency-reduced-pom.xml

@@ -3,7 +3,7 @@
   <parent>
     <artifactId>tda-parent</artifactId>
     <groupId>de.grimmfrost.tda</groupId>
-    <version>2.7</version>
+    <version>3.0</version>
   </parent>
   <modelVersion>4.0.0</modelVersion>
   <artifactId>tda</artifactId>

tda/pom.xml

@@ -5,7 +5,7 @@
   <parent>
     <groupId>de.grimmfrost.tda</groupId>
     <artifactId>tda-parent</artifactId>
-    <version>2.7</version>
+    <version>3.0</version>
   </parent>
 
   <artifactId>tda</artifactId>

tda/src/main/java/de/grimmfrost/tda/mcp/MCPServer.java

@@ -73,13 +73,13 @@ private static int getId(String line) {
 
     private static void handleInitialize(JsonObject request) {
         JsonObject result = new JsonObject();
-        result.addProperty("protocolVersion", "2024-11-05");
+        result.addProperty("protocolVersion", "2025-11-25");
         JsonObject capabilities = new JsonObject();
         capabilities.add("tools", new JsonObject());
         result.add("capabilities", capabilities);
         JsonObject serverInfo = new JsonObject();
         serverInfo.addProperty("name", "tda-mcp-server");
-        serverInfo.addProperty("version", "1.0.0");
+        serverInfo.addProperty("version", "3.0.0");
         result.add("serverInfo", serverInfo);
 
         sendResponse(request.get("id").getAsInt(), result);

tda/src/main/resources/de/grimmfrost/tda/doc/README

@@ -1,17 +1,17 @@
 <html>
 <link rel="stylesheet" type="text/css" href="stylesheet.css" title="Style">
 <body bgcolor="#f5f5f5">
-<h3>TDA - Thread Dump Analyzer -- Version 2.7</h3>
+<h3>TDA - Thread Dump Analyzer -- Version 3.0</h3>
 
-<p>Note: This is the 2.7 release of the software, for an usage overview see <b><a href="https://github.com/irockel/tda">README</a> on GitHub</b>.</p>
+<p>Note: This is the 3.0 release of the software, for an usage overview see <b><a href="https://github.com/irockel/tda">README</a> on GitHub</b>.</p>
 
 <p>Recent changes are:</p>
 
-<h4>Version 2.7</h4>
+<h4>Version 3.0</h4>
 <ul>
 <li>Introduced logging for easier debugging in MCP mode, added red dot in UI mode if error occurred with tooltip to check logfile.</li>
 <li>Experimental support for JSON based jmap thread dumps.</li>
-<li>Support for SMR parsing in thread dumps (Java 11+).</li>
+<li>Support for SMR (Safe Memory Reclamation) parsing in thread dumps (Java 11+).</li>
 <li>Detect stuck Carrier Threads used by Virtual Threads in Java 21+ thread dumps.</li>
 <li>Extended MCP Server for fetching pinned Carrier Threads.</li>
 <li>Added a method to the MCP Server to enable the Agent to fetch a list of threads which are running in native code, including library information if available.</li>

visualvm-lib-component/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.grimmfrost.tda</groupId>
         <artifactId>tda-parent</artifactId>
-        <version>2.7</version>
+        <version>3.0</version>
     </parent>
 
     <artifactId>visualvm-lib-component</artifactId>

visualvm-logfile-component/pom.xml

@@ -6,7 +6,7 @@
     <parent>
         <groupId>de.grimmfrost.tda</groupId>
         <artifactId>tda-parent</artifactId>
-        <version>2.7</version>
+        <version>3.0</version>
     </parent>
 
     <artifactId>visualvm-logfile-component</artifactId>