feat!: add a reactive engine by S-furi · Pull Request #5131 · AlchemistSimulator/Alchemist

S-furi · 2026-02-13T18:06:36Z

No description provided.

mergify · 2026-02-13T18:07:18Z

Hi @S-furi! 👋
This pull request has conflicts 😖
Could you fix it? 🔧
Thank you! 🙏

S-furi · 2026-02-13T18:08:47Z

@DanySK I have rebased master and resolved conflicts, now we have conflicts in this branch (I guess we will force push?). Do you need something else from my side?

DanySK · 2026-02-14T21:06:23Z

@S-furi I changed the base to master, I still see conflicts

codecov · 2026-02-15T18:21:07Z

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 61.53%. Comparing base (c7b7fab) to head (af2a3ac).

Additional details and impacted files

@@              Coverage Diff              @@
##             master    #5131       +/-   ##
=============================================
+ Coverage          0   61.53%   +61.53%     
- Complexity        0       14       +14     
=============================================
  Files             0        2        +2     
  Lines             0       78       +78     
  Branches          0        4        +4     
=============================================
+ Hits              0       48       +48     
- Misses            0       24       +24     
- Partials          0        6        +6

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.
📦 JS Bundle Analysis: Save yourself from yourself by tracking and limiting bundle sizes in JS merges.

DanySK · 2026-02-15T22:19:29Z

build.gradle.kts

        }
        useJUnitPlatform()
        maxHeapSize = "1g"
+        "alchemist.engine".let { property ->


What is this for?

oops, it is a leftover to set the property to switch between classical and reactive engine. Removed in the next commit

mergify · 2026-02-15T23:04:06Z

Hi @S-furi! 👋
This pull request has conflicts 😖
Could you fix it? 🔧
Thank you! 🙏

DanySK · 2026-02-16T14:30:24Z

@nicolasfara @cric96

@S-furi created this reactive version of the alchemist engine. This radically changes how the simulator works. I'd propose a meeting where Stefano explains how it works, what is going to change, and then we replace the main Alchemist with this version.

Your feedback on the PR is also very appreciated.

cric96 · 2026-02-16T14:37:04Z

Wow! It seems promising, congrats :)
Anyway, let us try to organise a meeting and discuss this in detail!
Then, I will try to leave an in-depth review :)

# Conflicts: # .github/workflows/build-and-deploy.yml # .github/workflows/update-ancillary-files.yml # CHANGELOG.md # dokka-cache/ch.qos.logback/logback-classic/1.5.21.list # dokka-cache/ch.qos.logback/logback-classic/1.5.22.list # dokka-cache/ch.qos.logback/logback-classic/1.5.26.list # dokka-cache/de.flapdoodle.embed/de.flapdoodle.embed.mongo/4.21.0.list # dokka-cache/de.flapdoodle.embed/de.flapdoodle.embed.mongo/4.22.0.list # dokka-cache/de.flapdoodle.embed/de.flapdoodle.embed.mongo/4.24.0.list # dokka-cache/it.unibo.alchemist/alchemist-api/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-api/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-api/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-cognitive-agents/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-cognitive-agents/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-cognitive-agents/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-composeui/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-composeui/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-composeui/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-engine/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-engine/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-engine/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-euclidean-geometry/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-euclidean-geometry/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-euclidean-geometry/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-full/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-full/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-full/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-graphql-surrogates/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-graphql-surrogates/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-graphql-surrogates/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-graphql/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-graphql/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-graphql/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-implementationbase/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-implementationbase/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-implementationbase/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-biochemistry/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-biochemistry/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-biochemistry/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-protelis/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-protelis/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-protelis/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-sapere/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-sapere/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-incarnation-sapere/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-loading/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-loading/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-loading/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-maintenance-tooling/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-maintenance-tooling/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-maintenance-tooling/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-maps/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-maps/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-maps/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-physics/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-physics/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-physics/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-sapere-mathexp/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-sapere-mathexp/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-sapere-mathexp/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-smartcam/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-smartcam/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-smartcam/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-swingui/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-swingui/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-swingui/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-test/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-test/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-test/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-ui-tooling/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-ui-tooling/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-ui-tooling/42.3.32.list # dokka-cache/it.unibo.alchemist/alchemist-web-renderer/42.3.18.list # dokka-cache/it.unibo.alchemist/alchemist-web-renderer/42.3.22.list # dokka-cache/it.unibo.alchemist/alchemist-web-renderer/42.3.32.list # gradle/libs.versions.toml # package-lock.json # package.json # settings.gradle.kts # Conflicts: # alchemist-engine/src/main/kotlin/it/unibo/alchemist/core/Engine.kt # Conflicts: # alchemist-api/build.gradle.kts # alchemist-implementationbase/src/main/kotlin/it/unibo/alchemist/model/environments/AbstractEnvironment.kt # alchemist-loading/src/main/kotlin/it/unibo/alchemist/boundary/loader/LoadingSystem.kt

…ring callback invocation

…l callback Now the "laziness" concept is applied to dervied observables too.

For actions in general, it is better to use an imperative approach and retrieve the current neighborhood instead of having an up-to-date neighborhood version stored locally.

…ency graph fix: remove obsolete reactive engine loading chore(engine): use explicit synchronisation instead of thread contexts

This idea is borrowed by Androidx, where by means of Lifecycle state machines we are able to bound the lifecycle of the dependencies to the lifecycle of the owner (i.e. the registrant), properly disposing and releasing observers references withtout using weak references, hence not impacting too much negatively performance.

…tual position

…` detekt error

…es instead of entire LSASpace

commit cbc430612a9a9063264da4f229fec1f7dc270ecd Author: S-furi <stefano.furi7@gmail.com> Date: Fri Feb 20 14:02:00 2026 +0100 perf(api): make use of persistent collections in observable collections this led to a great improvement in memory usage especially for neighbor-related streams where set of nodes where occupying large chunks of memory. This usage of persistent structures improved equality checks speed with an overall time reduction of approx a 10% wrt standard kotlin collections usage (from 22s independent test (SAPERE) to 20s) commit ef9301aed3555d7d97c262a755085ace39bc9c24 Author: S-furi <stefano.furi7@gmail.com> Date: Fri Feb 20 11:53:17 2026 +0100 perf(engine): introduce `BatchManager` to avoid redundant reschedule requests commit 6c04f40fcea4ce9f644cf2b9e162b999199d524e Author: S-furi <stefano.furi7@gmail.com> Date: Fri Feb 20 11:18:14 2026 +0100 perf(sapere): introduce finer-grained observables for lsa spaces

sonarqubecloud · 2026-03-06T00:19:16Z

Quality Gate passed

Issues
8 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

DanySK changed the base branch from feat/reactive-engine to master February 14, 2026 21:05

DanySK changed the title ~~chore(reactive-engine): rebase master and solve conflicts~~ feat!: add a reactive engine (#5066) Feb 14, 2026

S-furi force-pushed the feat/reactive-engine branch 2 times, most recently from eb116fc to faad9c8 Compare February 15, 2026 17:11

DanySK added the auto-update-rebase label Feb 15, 2026

DanySK reviewed Feb 15, 2026

View reviewed changes

S-furi force-pushed the feat/reactive-engine branch from a29cc48 to 7ee9c71 Compare February 16, 2026 09:03

DanySK changed the title ~~feat!: add a reactive engine (#5066)~~ feat!: add a reactive engine Feb 16, 2026

DanySK requested review from cric96 and nicolasfara February 16, 2026 14:28

DanySK force-pushed the feat/reactive-engine branch 13 times, most recently from c5afdb5 to 4102b95 Compare February 21, 2026 13:01

S-furi and others added 29 commits March 6, 2026 00:18

docs: improve Javadoc

aca51b8

chore(api): provide a way to register to an observable without trigge…

5a0850f

…ring callback invocation

chore(biochemestry): port BiomolPresentInNeighbor to kotlin

4e59b41

feat!: fully transition to observable neighborhoods

29fca73

feat!: make node counting observable

c425552

fix(biochemistry): use current node count in assertions

5995c80

chore(api): add updateOrNull with observable map values

878efbc

feat!: fully transition to observable positions

c7d8009

chore(api): add way to register to observables without sending initia…

a65d0eb

…l callback Now the "laziness" concept is applied to dervied observables too.

fix(scafi): avoid depending on observables

bce4e43

For actions in general, it is better to use an imperative approach and retrieve the current neighborhood instead of having an up-to-date neighborhood version stored locally.

feat!: replace Engine with reactive counterpart and get rid of depend…

99774bd

…ency graph fix: remove obsolete reactive engine loading chore(engine): use explicit synchronisation instead of thread contexts

fix: properly implement and call dispose on nodes and reactions

443eb01

chore: try avoid memory leaks for region observers

02585df

chore(api): cleanup conditions if conditions are set mulitple times

e65ac89

refactor(api): extract lifecycle components into multiple files

4a75a51

fix: fix line length

327a501

chore(docs): remove useless whitespace

511af3b

fix(cognitive-agents): use getCurrentPosition to retireve node's ac…

217ceb7

…tual position

test(engine): simplify engine test suite (fixed detekt error)

eebb7a7

chore(implementation-base): suppress `AbstractClassCanBeConcreteClass…

9006e78

…` detekt error

fix(test): retrieve current position from observable when asserting

b4e7e90

fix(sapere): trigger LSAReaction update only on target molecule chang…

04c1930

…es instead of entire LSASpace

fix(implementation-base): merge conditions into single observable source

f1cb76e

fix(sapere): use generalised molecules for dsl expressions test failure

0e3490a

fix(sapere): keep observing for neighbrhoods LSA spaces changes

72584f5

fix: fix checkstyle error

f0bc2f5

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat!: add a reactive engine#5131

feat!: add a reactive engine#5131
S-furi wants to merge 29 commits intoAlchemistSimulator:masterfrom
S-furi:feat/reactive-engine

S-furi commented Feb 13, 2026

Uh oh!

mergify bot commented Feb 13, 2026

Uh oh!

S-furi commented Feb 13, 2026

Uh oh!

DanySK commented Feb 14, 2026

Uh oh!

codecov bot commented Feb 15, 2026 •

edited

Loading

Uh oh!

DanySK Feb 15, 2026

Uh oh!

S-furi Feb 16, 2026

Uh oh!

mergify bot commented Feb 15, 2026

Uh oh!

DanySK commented Feb 16, 2026

Uh oh!

cric96 commented Feb 16, 2026

Uh oh!

sonarqubecloud bot commented Mar 6, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

S-furi commented Feb 13, 2026

Uh oh!

mergify bot commented Feb 13, 2026

Uh oh!

S-furi commented Feb 13, 2026

Uh oh!

DanySK commented Feb 14, 2026

Uh oh!

codecov bot commented Feb 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Codecov Report

Uh oh!

DanySK Feb 15, 2026

Choose a reason for hiding this comment

Uh oh!

S-furi Feb 16, 2026

Choose a reason for hiding this comment

Uh oh!

mergify bot commented Feb 15, 2026

Uh oh!

DanySK commented Feb 16, 2026

Uh oh!

cric96 commented Feb 16, 2026

Uh oh!

sonarqubecloud bot commented Mar 6, 2026

Quality Gate passed

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

codecov bot commented Feb 15, 2026 •

edited

Loading