| v7.1.7 | # Version 7.1.7 Patch release: **OCL parser fixes + IMG2UML merge-into-existing-model**. Closes #198, #202, and #338. No metamodel or public API changes — the OCL work is a grammar fix plus a diagnostics layer, and the IMG2UML change adds an optional parameter while preserving the original behaviour when the active diagram is empty. ## Highlights - **OCL accepts attributes named `size` (closes #198)**: `size` is a reserved lexer keyword for the OCL `->size()` / `.size()` collection operation, | High | 4/21/2026 |
| v7.1.6 | # Version 7.1.6 Minor release: **identifier story overhaul + more permissive PlantUML importer**. Closes #230, #225, #108, #236 and completes the `is_id` work from #478 / #486. Frontend submodule advances twice to expose the two new attribute checkboxes. ## Highlights - **New `Property.is_external_id` (closes #230, #225, #108)**: B-UML now distinguishes the internal surrogate PK (`is_id`) from user-facing identifiers (`is_external_id`). Composite keys supported. Flag round-trips through metam | High | 4/21/2026 |
| v7.1.5 | # Version 7.1.5 Patch release: **the DB Agent template now generates without an internal server error**. Backend-only fix — no metamodel, generator, or public API contract changes. The frontend submodule pointer is unchanged. ## Highlights - **DB Agent template generation no longer fails with `NameError: name 'ReceiveTextEvent' is not defined`**: the shipped `dbagent.json` template has an event-only transition (`"event": "ReceiveTextEvent"` with no conditions), which `agent_model_builder.agen | High | 4/21/2026 |
| v7.1.4 | Patch release: **the "From Spreadsheet" project creation flow now accepts XLSX workbooks as advertised**. Backend-only fix — no metamodel, generator, or public API contract changes. The frontend submodule pointer is unchanged. ## Highlights - **XLSX uploads in `/besser_api/csv-to-domain-model` no longer fail with _"Unsupported file type '.xlsx'"_** ([#501](https://github.com/BESSER-PEARL/BESSER/issues/501)). The Project Hub "From Spreadsheet" dialog already exposed `accept=".csv,.xlsx,.xls | High | 4/21/2026 |
| v7.1.3 | Patch release. ## Highlights - **Standalone agent ZIP now contains the full BAF project.** `BAFGenerator` was being constructed without an `output_dir`, so it wrote to `<backend-CWD>/output` instead of the request's temp dir. The downstream zipper walked the (empty) temp dir and shipped an `agent_output.zip` that only held the raw `agent_model.py`. Both constructor branches in `_handle_agent_generation` now pin `output_dir` to the request temp dir. WebApp-embedded agent flow was unaffecte | High | 4/15/2026 |
| v7.1.2 | Patch release: adds **multi-agent support** to the Full Web App generator and hardens the GitHub → Render deployment pipeline. No metamodel or API changes. ## Highlights - **Multi-agent Full Web App**: projects with multiple `AgentDiagram`s now generate one agent per diagram under `agents/<slug>/`. GUI `AgentComponent`s route per-component via a new `VITE_AGENT_URLS` JSON map. `docker-compose.yml` and `render.yaml` emit one service per agent. - **Stable Render service names**: the generat | Medium | 4/14/2026 |
| v7.1.1 | Patch release: fixes the Render deployment pipeline for WebApps that include an agent. All changes are scoped to the agent generator, its templates, and the GitHub/Render deploy integration — no metamodel or API changes. ## Highlights - **BAF upgrade**: generated agents now target `besser-agentic-framework==4.3.2`, which ships the new `baf.*` import namespace that the agent template already uses. - **Config format migration**: generated agents read `config.yaml` instead of `config.ini` (BAF 4. | Medium | 4/14/2026 |
| v7.1.0 | # Version 7.1.0 Bug fix and quality-of-life release: resolves 13+ issues across BESSER, the Web Modeling Editor, and the Modeling Agent, with improvements to validation, deployment, GitHub sync, and the AI-assisted modeling experience. ## Highlights - **Deserialization fix**: Pickle roundtrip for models with enumerations no longer crashes ([#490](https://github.com/BESSER-PEARL/BESSER/issues/490)). - **SQLAlchemy reserved keyword handling**: Class names like `List`, `Table`, `Column` n | Medium | 4/13/2026 |
| v7.0.0 | # Version 7.0.0 Major release: redesigned web editor, AI-powered modeling assistant, modular backend architecture, expanded metamodel styling, multi-diagram projects, and comprehensive security hardening. ## Highlights - **New Web Modeling Editor UI**: Complete frontend rewrite with modern stack (Vite, Tailwind CSS, Radix UI, Redux Toolkit). - **AI Modeling Assistant Enhanced**: Major upgrade to the conversational AI assistant with 2 new diagram types, voice input, file conversion, code gener | Medium | 4/1/2026 |
| v6.5.2 | Final state support for state machines, converter fixes, and initial/final node tooltips. ## New Features **Final State for State Machines** - Added `final` parameter to `State` and `StateMachine.new_state()` in the metamodel. - Full round-trip support in JSON-to-BUML and BUML-to-JSON converters: final states are represented as regular `State` elements with a separate `StateFinalNode` and transition, matching UML semantics. - New `state_machine_builder.py` for generating Python code from `Stat | Low | 3/20/2026 |
| v6.5.1 | Derived attribute support, major editor connection fix, and comprehensive frontend stability improvements. ## New Features **Derived Attributes** - Added `isDerived` property support for class attributes in the domain model. - Round-trip support in JSON-to-BUML and BUML-to-JSON converters for derived attributes. - Generated BUML code now emits the `is_derived` flag when set. **Frontend: Derived Attribute UI** ([BESSER-WEB-MODELING-EDITOR](https://github.com/BESSER-PEARL/BESSER-WEB-MODELING-ED | Low | 3/20/2026 |
| v6.5.0 | ## New Features **Database Reply Action for Agents** ([#459](https://github.com/BESSER-PEARL/BESSER/pull/459)) - Added a new `DBReply` action to the agent metamodel, enabling agent states to query relational databases as part of their responses. - Supports two query modes: `sql` (raw SQL) and `llm_query` (LLM-assisted natural language to SQL). - Supports five SQL operation types: `any`, `select`, `insert`, `update`, and `delete`. - Configurable database selection: `default` (application DB) or | Low | 3/18/2026 |
| v6.4.6 | ## Bug Fixes **UML Assistant Cannot Add Attributes or Methods** ([BESSER-WEB-MODELING-EDITOR#52](https://github.com/BESSER-PEARL/BESSER-WEB-MODELING-EDITOR/issues/52)) - The `ClassDiagramModifier` only handled `modify_attribute` and `modify_method` actions but the agent backend sends `add_attribute` and `add_method` when the user asks to add new members to an existing class. - Added `add_attribute` and `add_method` to the modifier's supported action list, the `ModelModification` action type uni | Low | 3/16/2026 |
| v6.4.5 | ## Bug Fixes **Navigability Checks in Pydantic and FastAPI Generators** ([#450](https://github.com/BESSER-PEARL/BESSER/issues/450)) - The Pydantic generator now checks `is_navigable` on the second end before producing nested creations, preventing code generation for non-navigable association ends. - The FastAPI generator now wraps all association-detail logic (for both local and inherited associations) inside navigability guards, covering every multiplicity combination. **Agent Configuration T | Low | 3/16/2026 |
| v6.4.4 | ## Bug Fixes **Self-Association Support for All Generators** ([#441](https://github.com/BESSER-PEARL/BESSER/issues/441)) - Extended the self-association fix (introduced in v6.4.3 for Java) to the Pydantic, REST API (FastAPI), and Django generators. - All generators now correctly detect when both ends of an association point to the same class and generate fields for both ends using role names. - Added dedicated test suites for each fixed generator. **Structural Metamodel Fixes** - Fixed `timest | Low | 3/9/2026 |
| v6.4.3 | ## Bug Fixes ### Java Generator: Self-Association Support (#441) - The Java generator now correctly handles self-associations (e.g., `Employee` manages `Employee`). - Previously, the Jinja2 template crashed because it identified association ends by type name, which fails when both ends point to the same class. - Self-associations now generate fields for both ends using role names, with proper getters, setters, and `addTo` methods. - Added test suite for the Java generator covering both normal a | Low | 3/6/2026 |
| v6.4.2 | # Version 6.4.2 Adds agent model validation, classical intent classifier support, and improvements to the GitHub deployment pipeline. ### Features **Agent Validation** - New `Agent.validate()` checks for state/intent name collisions and unresolved intents in transitions. - `/validate-diagram` now runs actual agent validation. **Classical Intent Classifier** - Agent template generates `SimpleIntentClassifierConfiguration` when IC technology is `classical`. - Render deploy installs | Low | 3/6/2026 |
| v6.4.1 | ## Version 6.4.1 This patch release fixes agent deployment on Render, a UI builder bug, and adds app redeployment support in the web modeling editor. ### Fixes #### Agent Deployment on Render (Fix #442) - Fixed agent crash (`NameError: name 'nn' is not defined`) when deploying a webapp with an agent to Render. - Root cause: the frontend did not include agent configuration (LLM, intent classifier, platform) in the `deploy-webapp` request payload, causing the agent to fall back to the | Low | 3/4/2026 |
| v6.4.0 | # Version 6.4.0 This release introduces RAG support for agents, optional attributes with default values, and a JSON object generator. --- ## New Features ### RAG Support for Agents - New metamodel classes: `RAG`, `RAGVectorStore`, `RAGTextSplitter`, and `RAGReply`. - `Agent` supports a `rags` list and `new_rag()` factory method. - BAF template generates Chroma vector store setup, text splitter configuration, and `session.run_rag()` calls. - Full round-trip support in JSON-to-BU | Low | 2/26/2026 |
| v6.3.0 | # Version 6.3.0 ## New Features ### BESSER Action Language Integration - Added full **BESSER Action Language (BAL)** grammar support - Implemented a new **BAL editor** with syntax highlighting - Added BAL user documentation (language overview and standard library description) ### Web App Generator Enhancements - Added support for BAL methods - Added a modal for function return values in the web app generator, allowing users to easily view and use function outputs ### Backend | Low | 2/12/2026 |
| v6.2.2 | # Version 6.2.2 ## Fixes - Fix #397: **REST API generator** — Include attributes and associations from all ancestor classes when building create and bulk-create constructors, so chains like `A <- B <- C` pass base-class fields and inherited relationships correctly. - Fix #418: **Pydantic/OCL generator** — Fix validator generation and OCL parsing output so constraints compile and execute correctly. - Fix #416: **Pydantic generator** — Fix any datatype mapping to `typing.Any` so generated | Low | 2/4/2026 |
| v6.2.1 | # Version 6.2.1 This patch aligns the generated frontend Dockerfile with the Node.js version used by the refreshed web app generator stack. ## Documentation - Clarify the WME vs BESSER contribution workflow, including the cross-repo checklist for new diagram types and DSLs. - Refresh contributor guidance, web editor references, and utilities documentation to match the current repository layout. ## Fixes - **Web app generator**: Update the generated frontend Dockerfile to u | Low | 2/2/2026 |
| v6.2.0 | # Version 6.2.0 This release refreshes the web app generator frontend stack, fixes React generation issues, and improves deployment defaults. ## New Features ### Frontend generator architecture refresh - The web app generator now creates a page component per screen instead of relying on a runtime renderer, making the frontend easier to read, customize, and maintain. ### Vite migration for generated frontends - The React template now uses Vite for development and production builds.
| Low | 1/30/2026 |
| v6.1.0 | # Version 6.1.0 This release introduces the ability to **link state machines or quantum circuits to methods** in the Web Modeling Editor, **GitHub project versioning** (experimental), and **Knowledge Graph import to Class Diagram**. ## New Features ### Method Implementation Types - Methods can now reference state machines or quantum circuits as their implementation. - Added `MethodImplementationType` enum to support different method behaviors: `none`, `code`, `state_machine`, and `q | Low | 1/28/2026 |
| v6.0.1 | # Version 6.0.1 Fixes for chart data binding with nested fields, series colors, and GUI code generation. ## Bug Fixes ### Chart Data Binding for Nested Fields - All chart types (LineChart, BarChart, PieChart, RadarChart, RadialBarChart) now support dot notation for nested fields (e.g., `measures.value`). - Added `getNestedValue()` helper to access nested properties and handle arrays within paths. - Charts automatically transform nested data to `{ name: ..., value: ... }` format for | Low | 1/23/2026 |
| v6.0.0 | # Version 6.0.0 This release introduces **GitHub OAuth integration and automatic deployment on Render**, along with improved environment configuration, frontend flexibility across environments, and important backend code-generation fixes. ## New Features ### GitHub OAuth Integration & Render Auto-Deployment - Added **GitHub OAuth integration for WME**, enabling secure authentication and repository authorization. - Implemented a **deployment API that automatically provisions and d | Low | 1/22/2026 |
| v5.6.1 | # Version 5.6.1 ## New Features * Added feedback in the Community menu, allowing users to easily submit feedback alongside Contributing Guide and Report a Problem links ## Improvements ### SQLAlchemy Generator - Joined Table Inheritance Fix * Fixed inheritance condition detection for abstract parent classes in joined table inheritance * Child classes now correctly generate foreign key columns to abstract parent tables Example of fixed inheritance: ```python class Louable(B | Low | 1/12/2026 |
| v5.6.0 | # Version 5.6.0 This release introduces **OCL Constraint Validation** in the generated backend and frontend, along with improved error handling in React components and comprehensive documentation restructuring. ## New Features ### OCL Constraint Validation in Backend - Added automatic generation of **Pydantic field validators from OCL constraints** defined in B-UML models. - OCL expressions are parsed using BESSER's ANTLR-based OCL parser and transformed into Python validation co | Low | 1/2/2026 |
| v5.5.0 | # Version 5.5.0 This release introduces significant enhancements to the **Backend Generator** with class method execution endpoints, and major improvements to the **React Generator** for dashboard components, chart data series modeling, and method execution buttons in the generated frontend. ## New Features and Improvements ### Backend Generator – Class Method Endpoints - Added automatic generation of **API endpoints for class methods** defined in B-UML models, enabling direct method | Low | 12/23/2025 |
| v5.4.1 | # Version 5.4.1 ## Fixes - **[#368](https://github.com/BESSER-PEARL/BESSER/issues/368)** Resolved a bug where the OCL parser incorrectly handled constraints due to mismatches between the editor and backend parsing logic. OCL constraints are now parsed consistently and correctly across both components. | Low | 12/19/2025 |
| v5.4.0 | # Version 5.4.0 This release introduces the **Quantum Circuit Editor**, a visual drag-and-drop interface for building quantum circuits directly in the Web Modeling Editor, along with Qiskit code generation capabilities. ## New Features and Improvements ### Quantum Circuit Editor * Added a new **Quantum Circuit Editor** component to the Web Modeling Editor, enabling users to visually design quantum circuits using a drag-and-drop interface. * Implemented a comprehensive **gate palette | Low | 12/18/2025 |
| v5.3.0 | # Version 5.3.0 This release introduces enhancements to the table component in the GUI editor, reverse engineering capabilities from CSV files, and improvements to the React code generator with optimized conditional component generation. ## New Features and Improvements ### **Reverse Engineering** - Added **CSV to B-UML domain model conversion** functionality for reverse engineering class diagrams from CSV files. - Introduced `csv_to_domain_model()` utility that automatically infers | Low | 12/11/2025 |
| v5.2.1 | # Version 5.2.1 ## New Features and Improvements ### Method Code Support - Added the possibility to include code blocks for structural elements in the editor and generators: - Added method generation support in Django and Python class templates, handling both code and metadata for method definitions. - Added support for `code` attribute in methods for BUML to JSON conversion. ## Fixes ### Django Generator - Updated Docker configuration and requirements for improved compat | Low | 11/27/2025 |
| v5.2.0 | # Version 5.2.0 This release delivers major enhancements to the agent modeling framework, a full overhaul of the validation pipeline, improvements to the REST API generator and Pydantic model generation, and several fixes that strengthen correctness and consistency across the toolchain. ## New Features and Improvements ### **No-Code Editor & WebApp Generator** - Added the ability to **link agents directly from the no-code editor**, enabling users to reference agents visually during mod | Low | 11/21/2025 |
| v5.1.0 | # Version 5.1.0 This update brings improved support for GUI diagrams in the Web Modeling Editor, Oracle database compatibility, and an enhanced Docker setup for production deployment. ## New Features and Improvements ### Database - Added support for **Oracle** in the SQLAlchemy generator and templates. - SQL generation now includes **ENUM type definitions** for enumeration models. ### Docker and Deployment - Updated frontend Docker setup to use **serve** instead of nginx, and | Low | 11/12/2025 |
| v5.0.0 | # Version 5.0.0 A **no-code editor** for designing web application GUIs is here! A **code generator** to produce a full web application from your GUI designs and data model (class diagram) is now available! --- ## New Features and Improvements ### Web Modeling Editor - Added support for creating and editing GUIs from a **no-code visual editor** (see [GUI modeling](https://besser.readthedocs.io/en/latest/buml_language/model_types/gui.html)). - Added a new shape to create **plai | Low | 11/7/2025 |
| v4.3.0 | # Version 4.3.0 ## New Features and Improvements ### Web Modeling Editor - Added multilingual support for [BAF](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework) generation: agents can now be generated to communicate in multiple languages, including English, Luxembourgish, Spanish, French, German, and Portuguese. ### BESSER Low-code Platform - SQLAlchemy code generator: added explicit handling of abstract classes and [concrete inheritance](https://docs.sqlalchemy.org/en/20 | Low | 9/18/2025 |
| v4.2.0 | # Version 4.2.0 ## New Features and Improvements ### Web Modeling Editor - Integrated IMG2UML into the editor, enabling direct conversion of UML images into editable models. - Introduced association popup component for enhanced object linking functionality, enabling users to connect objects to related classes in both standard and icon object diagrams. - Added an icon attribute to class metadata, allowing classes to store an icon that is displayed for instantiated objects in object dia | Low | 8/27/2025 |
| v4.1.1 | # Version 4.1.1 ## Improvements and Fixes This release includes fixes and enhancements to the JSON Schema generator used for the [Smart Data Models](https://smartdatamodels.org/) initiative. - Resolved issues where relationships were not correctly represented in the generated schema. - Corrected the serialization and typing of `datetime`, `time`, and `date` fields to align with expected formats. - Relationships with a minimum cardinality of 1 or more are now properly included in the ` | Low | 8/1/2025 |
| v4.1.0 | # Version 4.1.0 ## New Features and Improvements - Extended the JSON Schema generator to create schemas compatible with the [Smart Data Models](https://smartdatamodels.org/) initiative. This generator is also available via the [BESSER Web Modeling Editor](https://editor.besser-pearl.org/). - Added support for multiple inheritance in the SQLAlchemy generator. ## Documentation - [JSON Schema generator documentation](../../generators/json_schema) has been updated to include instruction | Low | 7/29/2025 |
| v4.0.2 | This release fixes the OCL grammar to properly support size() method calls (e.g., `self.title.size() > 10`) in OCL constraints. ## Fixes - Fixed issue: [310](https://github.com/BESSER-PEARL/BESSER/issues/310) | Low | 7/24/2025 |
| v4.0.1 | # Version 4.0.1 This release includes bug fixes and improvements to the OCL validation process. ## Fixes - Ensures `ends` are properly initialized in the `Association` class to avoid potential runtime issues. - Improves error and validation messages in the OCL validator. | Low | 7/15/2025 |
| v4.0.0 | # Version 4.0.0 ## New Features and Improvements ### Web Modeling Editor - Introduced project management support, allowing users to create projects and organize all related models (e.g., class diagram, object model, etc.) within a single project workspace. - Added support for creating and editing **Object Diagrams**, allowing you to represent instances of classes and their relationships defined in the Class Diagram (or structural model). - Added support for **OCL constraints** in Obje | Low | 7/15/2025 |
| v3.0.0 | Version 3.0.0 ============= New Features and Improvements ----------------------------- **Web Modeling Editor**: * Added support for Agent model creation and visualization * Agent code generation: Generate fully functional conversational agents directly from agent models using [BESSER Agentic Framework (BAF)](https://github.com/BESSER-PEARL/BESSER-Agentic-Framework) * Enhanced structural models with metadata support - you can now add descriptions and URIs to classes **BESSER Lo | Low | 6/10/2025 |
| v2.6.1 | Version 2.6.1 ============= New Features and Improvements ----------------------------- **BESSER Low-code Platform** * SQL & SQLAlchemy Generator: Enhanced the generators to support association classes Fixes ----- **BESSER Low-code Platform** * Fixed issues: [282 ](https://github.com/BESSER-PEARL/BESSER/issues/282), [282 ](https://github.com/BESSER-PEARL/BESSER/issues/281) | Low | 5/7/2025 |
| v2.6.0 | Version 2.6.0 ============= New Features and Improvements ----------------------------- **BESSER Low-code Platform** * NN Metamodel: Enhanced default configurations for neural network layers and improved flexibility in setting module attributes. * PyTorch and TensorFlow Code Generators: Streamlined type hinting and shape handling, and updated default parameter settings for improved compatibility in PyTorch code generation. * Django Generator: Added support for generating a Django ap | Low | 4/28/2025 |
| v2.5.1 | Improvements -------------- - Includes automatic installation of the following packages when using ``pip install besser[nn]``: - pillow>=11.1.0 - numpy>=2.2.4 - torch>=2.6.0 - Added support for neural network packages with local installation via ``--nn`` flag in setup_environment.py >The neural network dependencies have been made optional to reduce the installation footprint for users who don't need these capabilities. | Low | 3/31/2025 |
| v2.5.0 | # New Features - Neural Network metamodel extension: B-UML now supports the definition of neural networks (Inspired by deep learning frameworks like PyTorch and TensorFlow). - Grammar to define NNs: A textual notation is available to support the definition of neural networks in B-UML. | Low | 3/26/2025 |
| v2.4.0 | # New Features and Improvements **Web Modeling Editor** - Now, our WME is online! You can access it at [https://editor.besser-pearl.org](https://editor.besser-pearl.org) - New interface design. - Integrated storage capabilities allow seamless model persistence and cross-device access. - Added support for modeling collaboration using the WME. Now, multiple users can work on the same model simultaneously. - Optimized Docker Compose configuration for improved resource efficiency and faster | Low | 3/17/2025 |
| v2.3.0 | # New Features - Feature metamodel extension: In B-UML you can define now feature models to define structured representations of the features (functionalities or characteristics) of a system, capturing their variability and dependencies. - JSON Schema generator: This generator consumes a B-UML structural model and produces the equivalent JSON schema that can be used to validate whether given JSON objects conform to the schema. # Improvements - The `is_derived` boolean attribute was inc | Low | 3/4/2025 |
