Version 8.2.1¶
Patch release: OCL validation that evaluates what users write, BPMN from the
assistant, and configurable backend metadata. Checking OCL constraints
against an object diagram now evaluates constraints that navigate
associations, use true / false or ->notEmpty(). The modeling
assistant keeps BPMN data objects and opens a generated BPMN model in the BPMN
section. The FastAPI backend generator takes the API’s title, description and
version. No metamodel changes.
B-OCL¶
Constraints that navigate associations are evaluated. In
self.books->forAll(b | b.pages > 0), the iteratorbwas typed as the context class, sob.pagesfailed with “Property ‘pages’ not found in context ‘Library’” and the constraint was dropped from the results. An iterator without a declared type now takes the element type of what it iterates: a property, an association end,allInstances(), or a nestedselect/reject. The check that skips constraints over unset attributes now only looks at attributes of the context class, so such constraints are no longer skipped either.trueandfalse. Boolean literals were not built as booleans, soself.isOpen = trueandif ... then ... else true endifcrashed the evaluation.->notEmpty(). A common collection operation that B-OCL rejected as a syntax error, so users had to write->size() > 0. It is now part of the grammar, the pretty printer and normalization.Collection operations in the interpreter. BESSER now requires
bocl1.0.3, which evaluatesisEmpty(),notEmpty()andcollect(...)->sum()instead of reporting them as “not evaluated”, and makesforAllover an empty collection true. It also fixesforAllsometimes failing to return a Boolean, depending on iteration order, which left constraints such asself.authors->forAll(a | a.age >= 18)unevaluated at random.“Not evaluated” instead of “invalid syntax”. When valid OCL reaches something the evaluator cannot handle yet,
/validate-diagramreports “not evaluated” with the reason, instead of telling the user their syntax is wrong. Real syntax errors are still reported as syntax errors.Getting started with OCL. Object Constraint Language (OCL) gains a “New to OCL?” section with a tutorial link and eight common constraint patterns.
Generators¶
Backend API metadata.
BackendGeneratortakesapi_title,api_descriptionandapi_version. The generated FastAPI app uses them, and its root endpoint reports the title and version. The defaults are unchanged. See Backend Generator.Extending a generated backend. A new section of Backend Generator shows how to add routes, middleware and settings in a separate module that imports the generated
app, so regenerating never overwrites custom code.
Web modeling editor¶
BPMN models from the assistant open in the BPMN section. A BPMN model generated through the agentic interface used to replace the open Class Diagram. The switch to the BPMN diagram fell back to the Class Diagram because BPMN is the only type whose project name (
BPMN) differs from the editor’s (BPMNDiagram). The assistant now also refuses to write a model when the switch does not land on the requested diagram, instead of overwriting the one that is open.BPMN data objects from the assistant. Data objects and their input and output associations described in a prompt or an uploaded process document now reach the diagram instead of being dropped. Each task’s data objects are laid out in a row under it, with room for their labels.
Spec-Driven Agent runs. The run card names each agent action with its target (
write frontend/src/App.jsx), and a finished run has a “View files” button that opens the generated project in a read-only file viewer.Interface polish. The fixes from the editor styling review, a “Star us on GitHub” link in the sidebar, and dropdowns with fixed options keep the width of their widest option. The agentic interface walkthrough is served at
/demo-agentic.
Deploy alongside¶
The modeling agent has matching changes and should be deployed with this release: BPMN data objects (modeling-agent #31, needed for the data-object fix above) and progress messages that name the diagram being built instead of always mentioning classes (modeling-agent #32).
Upgrade notes¶
bocl1.0.3 no longer pinspydantic==2.6.3andfastapi==0.110.0exactly, so a fresh install now resolves the currentpydantic2.x.BESSER now installs on Python 3.13, which the old
pydanticpin prevented, and the test suite passes there. CI still tests 3.11 and 3.12.notEmptyis now a B-OCL keyword, likeisEmptyand the other collection operations. An attribute literally namednotEmptycan no longer be navigated in a constraint.