diff --git a/README.md b/README.md index 174e03d..db47410 100644 --- 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 index f0908a5..5c71356 100644 --- 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 new file mode 100644 index 0000000..e6fe9fe --- /dev/null +++ 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 index 0b3e85a..e30848b 100644 --- a/pom.xml +++ b/pom.xml @@ -11,7 +11,7 @@ dev.abada abada-engine - 0.8.3-alpha + 0.8.4-alpha Abada Engine Lightweight, pluggable BPMN-based workflow engine