v3.0.0

3.0.0 (2026-06-17)

⚠ BREAKING CHANGES

• establish io.miragon as the bpmn-to-code home (3.0.0) (#1)

Features

• add attachedElements to FlowNodeDefinition for bidirectional boundary event references (#228) (fb67b8a)
• add bpmn-to-code-testing module (#208) (18b47d7)
• add compensation event support (#245) (f4e5a0f)
• add dry-run support to publish pipelines (#328) (e50862d)
• add engine to processApi (#93) (b78a4e6), closes #91
• add EVENT_SUB_PROCESS type and escalation extraction (#237) (281e496)
• add example-folder with gradle & maven examples (9aca1de)
• add isDefault flag to sequence flows (#234) (e09ccb5)
• add issue templates (#95) (98e0a6a)
• add issue templates #94 (dd4351b)
• add module to use bpmn-to-code in the web (7a0ed69)
• add more elements to api (eeef51c)
• add name fields and rename BpmnRelations edges (#289) (#295) (4c148e7)
• add parentId to FlowNodeDefinition (#218) (b123437)
• add release skill to simplify publishing process (#152) (8bf0b4e)
• add scaffold-process-project skill (#185) (#266) (3da87aa)
• add v1-to-v2 migration skill and changelog (#283) (e9b92e2)
• add Variables to generated API (#61) (cdad5dd)
• AI-powered BPMN style guide skills (#262) (0cff8f0)
• allow to turn off versioning (0f1523d)
• BPMN validation layer with built-in rules (#192) (a207c44)
• core: expose variable mapping expressions in the domain model (#349) (2cb7aeb)
• create process-api's without file-system (0167fae)
• create processApi files from bpmnModels (a8434f6)
• detect collisions in bpmn-model (#87) (01c2dcf)
• detect engine mismatch and add engine-matched demo samples (#365) (3018bdb)
• dont show empty objects (12c27a1)
• emit KDoc on generated ProcessApi nested objects and shared types (#298) (c2b8e27)
• enforce per-class test coverage (≥ 75%) via JaCoCo (#259) (2693e44)
• enrich FlowNodeDefinition with properties and attachedToRef (#216) (59f8c8d)
• establish io.miragon as the bpmn-to-code home (3.0.0) (#1) (6c3a686)
• expose call-activity variable mappings for testing assertions (#370) (b0c8a19)
• expose Flows and Relations in generated API (#219) (#232) (668596d)
• extend v1-to-v2 migration skill with useVersioning removal and LLM prompt (#286) (f76f438)
• extract asyncBefore/asyncAfter/exclusive markers (#246) (16c44f4)
• extract displayName from BPMN flow nodes (#263) (34e053e)
• extract sequence flows and incoming/outgoing references (#214) (1ada410)
• extract shared BPMN types into standalone files (#248) (1dc4458)
• extract variables from multi-instance tasks (#103) (02fe8b4)
• extract variantName from process-level extension properties (#249) (fea74a3)
• generate JSON representation of BpmnModel (#223) (db56803)
• include displayName of flow nodes in JSON output (#264) (b84a225)
• issue-113: add call-activities to test-processes (#116) (d2b2364)
• issue-113: export call activities to process-api (#120) (b6e22d1)
• issue-114: add basic project-management skills (#122) (eccaf94)
• issue-115: extract variables from call activity in/out mappings (#150) (916a51d)
• issue-125: add migrate-to-bpmn-to-code-apis skill and rename skills (#147) (f13af91)
• issue-125: add user-centric skills and skills index (#146) (01fbc46)
• issue-130: local mcp for bpmn-to-code (#133) (df6efb0)
• issue-141: require clarification on MCP tool parameters (#144) (43ee13f)
• issue-149: extract additional variables from BPMN extension properties (#151) (0f50280)
• issue-153: add VitePress documentation site (#154) (d1bf8c0)
• issue-156: show latest version chip in docs navbar (#157) (f1f5ce4)
• issue-167: distribute user-facing skills as Claude Code plugin (#169) (6cda586)
• issue-72: add context7.json for AI doc indexing (#166) (6d37106)
• modify release pipeline (#96) (478f483)
• prepare for beta-publishing (cf76201)
• publish shared types via bpmn-to-code-runtime artifact (#304) (7f0c455)
• quality: add Detekt static analysis (#313) (f93f8d3)
• quality: extend JaCoCo coverage to all modules except MCP (#315) (b408cb9)
• release 0.0.17 (#99) (0c8c91e)
• rename process-api versioning-file (e6054c5)
• replace PROCESS_ENGINE string constant with typed BpmnEngine enum (#293) (acb80bf)
• skill: rewrite release skill with interactive version detection (#194) (3ce9edf)
• skill: use AskUserQuestion for confirmation in create-ticket (#182) (a3b214f)
• sort JSON flow nodes in process-flow order using DFS (#225) (e2e2ed2)
• sort process-api output (#92) (a376ed9), closes #90
• split per-element Variables into Inputs/Outputs by direction (#296) (bc8ad46)
• standalone BPMN validation (#200) (23e56b3)
• type variable direction via sealed VariableName; add toString to wrappers (#299) (565309c)
• typed element groups and per-element variables in generated API (#226) (98fd223)
• update metadata for gradle-task (9e721dc)
• use $$"..." syntax for generated BpmnFlow conditions (#320) (72449e0)
• use const val for Kotlin API string constants (#60) (c9f9563)
• use UPPER_SNAKE_CASE for generated constants (0a4de00)
• variant-aware model merging for multi-file BPMN processes (#252) (2700e7c)
• verbose model output for Gradle and Maven plugins (#325) (f1ddc1d)
• web: merge JSON and Code API into single tabbed page (#269) (1a1015e)
• web: redesign UI with docs-aligned styling (#173) (11f69cf)
• web: reskin web generator UI to match docs landing aesthetic (#272) (c638fd6)
• web: show version badge in web UI header (#168) (b9128a7)
• wrap leaf string constants in typed wrappers (#288) (#294) (3fbeeb0)

Bug Fixes

• adapt maven build command (f11fc72)
• add ant to as api-dep to mvn dependencies (8c81efe)
• add maven publishing config to bpmn-to-code-core (#285) (1cceaa7)
• address findings from repo analysis (#307) (e4db6bd)
• address high-severity findings from repo analysis (#306) (f821ff7)
• build docker image for amd64, add cors-config and revert logging (43eedeb)
• change goal for maven plugin (f704074)
• ci: enable artifact signing and fix Docker config cache for release (#316) (ff84ff6)
• ci: post coverage comment even when coverage check fails (#312) (69ce331)
• close file descriptors by storing BPMN content as ByteArray (#311) (81b19e5)
• consistent indentation for Flows/Relations in generated Kotlin output (#282) (fcd34f0)
• docs build pipeline and link correction (#191) (04477be)
• docs for 0.0.4 (4576af5)
• docs: improve mobile responsiveness (#175) (b2d4f0c), closes #174
• eliminate double ByteArrayInputStream and document runCatching guard (#314) (e8dab5f)
• escape quotes in generated Kotlin BpmnFlow condition (#318) (22115b6), closes #317
• file can be added again, after it got removed (cbbf266)
• gradle: inject JaCoCo agent into TestKit daemon to fix zero coverage (#322) (5099290)
• handle special-chars in process-config (01b61d0)
• hide include-sources toggle in JSON export tab (#305) (d46ff69)
• include escalations in model merge and sort (#242) (885af9a)
• issue-159: add missing kotlin-logging and slf4j dependencies to plugin modules (#160) (92108f6)
• issue-177: eliminate all CI build warnings (#178) (2e62765)
• kotlin: escape double quotes in generated conditions (2.0.3) (#327) (2636991)
• load files outside of current root (53fab1b)
• normalize whitespace in BPMN element names (#297) (c5208f8)
• one parameter per line in ModelInstanceUtils constructors (20719fc)
• preserve additionalInputVariables across variants (#324) (6eca584), closes #323
• prevent duplicates in processApi (#98) (8ec1f65)
• publishToMavenLocal and generateBpmnModelJson failures (#300) (d3e2993)
• release-please: disable component prefix in tag (#343) (11483e1)
• release-please: use block markers for gradle.properties (#345) (aff1aad)
• remove duplicate flat variables from generated Variables API (#265) (b56a3e2)
• remove typo in docs (e4b9a3a)
• resolve discrepancies between BPMN models and generated API outputs (#256) (4573eb1)
• resolve maven publish build service classloader conflict (#284) (f05100e)
• resolve MCP server stdio issues and standardize fat JAR naming (#140) (9891726)
• testing: bundle BPMN model + logging deps transitively (#352) (fb4a246)
• tolerate engine-mismatched models in Zeebe extractor instead of crashing (#367) (475d109)
• update to 0.0.8 (8324d6a)
• use should-write option to determine what objects are included in api (a601abf)
• web: correct broken doc links on landing page (#355) (8fdf49c)
• web: make Docker Exec tasks configuration-cache compatible (#339) (684e39c)
• web: prevent <none>:<none> dangling images on Docker rebuild (#330) (7406bdd)