Files
giza-kmp/docs/tools/engine-interop
Kgothatso NgakoandClaude Opus 5.5 a08a878935 docs(tools): the shipped engine against the old one, both ways, three epochs (quartz-mls-marmot-update, Phase 3)
docs/tools/engine-interop runs marmot-kmp 2.3.0 over mls-kmp 1.3.1 against
quartz 1.15.2's engine -- the one a Bennu peer on that version runs -- in two
JVMs over a pipe, since one build cannot hold two versions of the quartz group.
Each side creates a room in turn; the other joins by Welcome, applies two more
commits and reads a message each way at every epoch. 20 checks, all green, so
mls 1.3.1's new epoch-0 shape costs nothing against the old engine.

The note records Phase 3, including the first draft of the epoch-0 test, which
asserted a restore-time repair mls-kmp drafted and then removed before 1.3.1.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-20 11:22:00 +02:00
..

engine-interop

The MLS engine the app ships against the one it shipped before, in two JVMs. docs/quartz-mls-marmot-update.md, Phase 3.

  • old/ is one Marmot member played by quartz 1.15.2's engine, the one a Bennu peer on that version still runs. It reads one command per line on stdin and answers on stdout (see OldPeer.kt).
  • new/ is the app's engine at the versions in gradle/libs.versions.toml: marmot-kmp over mls-kmp, through Magpie. Its driver starts the old peer as a child process and runs two scenarios: the new engine creates the room and the old one joins, then the reverse. In each, the creator commits two more adds after the Welcome, and both sides must land on the same epoch and kind:445 key and read each other's messages at every epoch.

They are two builds because they cannot be one: both depend on the com.vitorpamplona.quartz group, at 1.15.2 and 2.20.0. Magpie serves that group exclusively, and its relay has nothing older than 2.19.0, so old/ resolves from Maven Central with no Magpie at all.

Not part of ./gradlew check. It is a probe to run by hand when the engine moves.

../../../gradlew -p old installDist
../../../gradlew -p new run --args="$PWD/old/build/install/engine-interop-old/lib"

It prints ok per check and ALL PASSED, or FAIL with the step and exits 1. Move new/build.gradle.kts's versions with the catalogue's, and let the first run add them to new/gradle/magpie.lock.