bashizip · bashizip · Jan 30, 2026 · Jan 29, 2026
diff --git a/README.md b/README.md
@@ -87,7 +87,7 @@ For endpoints, authentication, and examples, see [`docs/api-documentation.md`](d
 
 ---
 
-## Engine Status (0.8.2-alpha)
+## Engine Status (0.8.4-alpha)
 
 - **Core Execution**: BPMN parsing and execution; user, service, external, and script tasks; message/signal/timer events; XOR/AND/OR gateways.
 - **Persistence**: H2 (dev/test) and PostgreSQL (prod) with HikariCP pooling.
@@ -99,13 +99,15 @@ For endpoints, authentication, and examples, see [`docs/api-documentation.md`](d
 
 ## Release Notes
 
-*   [Version 0.8.2-alpha](docs/0.8.2-alpha-release-notes.md)
+*   [Version 0.8.4-alpha](docs/release-notes/0.8.4-alpha-release-notes.md)
+*   [Version 0.8.3-alpha](docs/release-notes/0.8.3-alpha-release-notes.md)
+*   [Version 0.8.2-alpha](docs/release-notes/0.8.2-alpha-release-notes.md)
 
 ---
 
 ## Roadmap
 
-See [`docs/roadmap-to-beta.md`](docs/roadmap-to-beta.md) for the staged milestones from `0.8.2-alpha` to `1.0.0-beta`.
+See [`docs/development/roadmap.md`](docs/development/roadmap.md) for the staged milestones from `0.8.2-alpha` to `1.0.0-beta`.
 
 ---
 

diff --git a/docs/release-notes/0.8.3-alpha-release-notes.md b/docs/release-notes/0.8.3-alpha-release-notes.md
@@ -10,7 +10,7 @@
 
 Version 0.8.3-alpha introduces a comprehensive observability stack to the Abada Engine, providing deep visibility into runtime behavior and enabling effective production diagnostics. This release implements the **three pillars of observability** using industry-standard OpenTelemetry protocols and tools.
 
-> **Roadmap Context**: This release completes the first milestone in the [Roadmap to Beta](roadmap-to-beta.md), establishing the observability foundation required for production-ready deployments.
+> **Roadmap Context**: This release completes the first milestone in the [Roadmap to Beta](../development/roadmap.md), establishing the observability foundation required for production-ready deployments.
 
 ---
 
@@ -289,7 +289,7 @@ For production deployments, consider:
 
 ## What's Next
 
-According to the [Roadmap to Beta](roadmap-to-beta.md), the next releases will focus on:
+According to the [Roadmap to Beta](../development/roadmap.md), the next releases will focus on:
 
 - **v0.8.4-alpha**: Tenda MVP (Tasklist UI) - Validate user task lifecycle from an end-user perspective
 - **v0.8.5-alpha**: Orun MVP (Cockpit UI) - Validate process monitoring and history APIs

diff --git a/docs/release-notes/0.8.4-alpha-release-notes.md b/docs/release-notes/0.8.4-alpha-release-notes.md
@@ -0,0 +1,106 @@
+# Abada Engine v0.8.4-alpha Release Notes
+
+**Release Date**: January 30, 2026  
+**Status**: Alpha Release  
+**Focus**: Tenda MVP & Platform Integration
+
+---
+
+## Overview
+
+Version 0.8.4-alpha marks a significant milestone in the Abada Platform roadmap: the transition from a "headless" engine to an integrated platform. This release introduces the first version of **Abada Tenda** (Tasklist UI) and provides a much-improved development experience for building full-stack workflow applications.
+
+> **Roadmap Context**: This release fulfills the second milestone in the [Roadmap to Beta](docs/development/roadmap.md), focusing on the end-user task lifecycle.
+
+---
+
+## What's New
+
+### 🖥️ Abada Tenda Integration (MVP)
+
+The engine now supports the initial release of **Abada Tenda**, our specialized Tasklist UI. 
+- **Task Lifecycle**: Full support for claiming, completing, and managing user tasks via the UI.
+- **Variable Handling**: Users can now view input variables and submit output variables directly through Tenda.
+- **Seamless Setup**: Docker Compose now includes Tenda as a first-class service, pre-configured to communicate with the engine.
+
+### 🛠️ Enhanced Process Management
+
+We've expanded the Engine API to provide better control over running processes:
+- **New Statuses**: Introduced `CANCELLED` and `SUSPENDED` states for process instances.
+- **Management Endpoints**: Added dedicated API endpoints for instance management and job control.
+- **External Task Failures**: Improved reporting for external task failures, including error messages and retry logic.
+
+### 🏗️ Improved Developer Experience (DX)
+
+- **Flexible Docker Strategy**: New dedicated `Dockerfile.prod` and streamlined dev/prod configurations.
+- **Sibling Project Integration**: The `build-and-run-dev.sh` script now automatically detects and builds sibling projects (`abada-tenda`, `abada-orun`) if they are present in the workspace.
+- **Sample Data Generation**: A new utility to populate the engine with realistic sample processes, tasks, and history for testing and demos.
+
+### 🧪 Advanced Instrumentation
+
+- **Process Starter Tracking**: Track who started a process and identify candidate starter groups.
+- **PostgreSQL Support**: Added production-ready PostgreSQL driver and configuration for containerized deployments.
+
+---
+
+## Technical Implementation
+
+### Core Changes
+- Refactored `JobController` to move management endpoints to `/v1/jobs`.
+- Moved cockpit-specific endpoints to a dedicated controller for better separation of concerns.
+- Implemented process instance suspension and cancellation logic in the core engine.
+
+### Infrastructure Update
+- Updated `docker-compose.yml` to include `abada-tenda` and `abada-orun` services.
+- Added `data-local` directory for persistent local development data.
+- Optimized OTLP span exporters for better Jaeger integration.
+
+---
+
+## Getting Started
+
+### Quick Start with Tenda
+
+1. **Pull the latest version**:
+   ```bash
+   ./scripts/build-and-run-dev.sh
+   ```
+
+2. **Access the Tasklist**:
+   - Abada Tenda: [http://localhost:5602](http://localhost:5602)
+   - Login with default dev credentials.
+
+3. **Generate Sample Data**:
+   ```bash
+   ./scripts/generate-sample-data.sh
+   ```
+
+---
+
+## Documentation
+
+Updated guides:
+- **[Roadmap to Beta](docs/development/roadmap.md)**: Updated progress and next steps.
+- **[API Documentation](docs/development/api.md)**: documenting new management and job control endpoints.
+
+---
+
+## Bug Fixes
+
+- Fixed duplicate container name issues in development scripts.
+- Resolved suspended status flag confusion in the process engine logic.
+- Fixed process starter tracking for anonymous starts.
+- Corrected Grafana dashboard datasource UIDs to be case-insensitive.
+
+---
+
+## What's Next
+
+According to the [Roadmap to Beta](docs/development/roadmap.md), the next major focus will be:
+
+- **v0.8.5-alpha**: Orun MVP (Cockpit UI) - Focus on history APIs and process monitoring.
+- **v0.9.0-alpha**: End-to-End Validation - Hardening the platform with complex, real-world business scenarios.
+
+---
+
+**Full Changelog**: v0.8.3-alpha...v0.8.4-alpha
diff --git a/pom.xml b/pom.xml
@@ -11,7 +11,7 @@
     </parent>
     <groupId>dev.abada</groupId>
     <artifactId>abada-engine</artifactId>
-    <version>0.8.3-alpha</version>
+    <version>0.8.4-alpha</version>
     <name>Abada Engine</name>
     <description>Lightweight, pluggable BPMN-based workflow engine</description>
     <url />