Skip to content

Remold v0.2.4

Choose a tag to compare

@github-actions github-actions released this 07 Nov 07:18
· 496 commits to main since this release

v0.2.4 Release Notes (draft for commander review)

Status: released 2026-11-07 (v0.2.4).
Previous release: v0.2.3 (0036550).

Highlights

  • @RemoldReinit scope: new scope element with SELF / INCLUDE_SUBCLASSES (default preserves
    existing behaviour). SELF reinitializes only exact declaring-class instances; host Class is
    canonicalized so JBR's old-version "shadow" Class cannot corrupt identity filtering after a
    structural redefine. A scope on a static field is ignored with a single [REINIT-SCOPE] warn.
  • Forge Mixin template hot update: plugin-forge now drives IMixinTransformer.reload
    reflectively and cascades a re-weave + redefineDynamic to loaded targets (ForgeMixinHotSwap).
    Previously a changed @Mixin class was defined into the target loader while MixinInfo stayed
    stale, so @Inject bodies in targets never updated.
  • Mixin @Inject self-evolution: added/renamed @Inject handler methods now hot-swap.
    MixinClassInfoSync runs before reloadMixin (the conform check reads that metadata) and
    rolls back members when reload is rejected.
  • Profiler / entity probe robustness: ProfilerTransformer.transform uses per-call local state
    (reentrant, no shared-field clobbering); stale static-field Class refs are normalized via
    ClassIdentity.canonicalize; toggleEntityProbe catches Throwable and rolls back from a
    pre-call snapshot (failed enable restores the registration, failed disable re-registers).
  • Verification tooling: probeAll aggregate task (not in check) with zero exclusions; new
    seconds-scale probes for multi-mixin targets, @Inject evolution, sourceBytecodeCache real-path
    matrix, LayoutGate reject→recover, @RemoldReinit scope, shadow-Class identity.

Fixes

  • plugin-mixin: MixinInfo.reloadMixin validated new @Inject handlers against the previous
    ClassInfo, rejecting added/renamed handlers with Conform error ... please restart client;
    sync now happens before reload, with SyncToken rollback.
  • plugin-forge: Mixin template changes were not reloaded (targets kept old handlers); new
    ForgeMixinHotSwap reloads the template and cascades target re-weaving.
  • core profiler: shared mutable transformer state caused NullPointerException: this.classReader is null and intermittent ClassFormatError when ClassWriter.getCommonSuperClass re-entered the
    transformer; transform is now stateless per call.
  • core profiler/LibTool: static-field Class references rewritten by JBR redefinition (shadow
    Class with old fields, getInstances=0, silent no-op retransform) are canonicalized at API
    boundaries.
  • core layout: type-change reject summaries no longer claim the reader scan failed; the note is
    limited to REMOVED_FIELD.
  • plugin-arc: Injector used the package-private RemoldAgent.inst field across the
    app/bootstrap loader boundary (IllegalAccessError); it now uses public RemoldAgent.getInst().

Verification

  • JUnit: 461 tests, 0 skipped, 0 failures.
  • :tests:initFixOracle: all assertions pass.
  • ./gradlew probeAll (explicit, not wired into check): all Gradle-hosted JVM probes pass,
    including alignBaselineProbe and offsetStabilityProbe (47/47). Aggregate probes include
    scopeReinitProbe 35/0, cacheSourceMatrixProbe 23/0, layoutRejectRecoverProbe 41/0,
    doubleBraceProbe 80/0, P0.5 63/0, two-phase 42/0, lambda-bridge 35/0, retry 15/0,
    initFix-fallback 14/0, inject-conflict 8/0, reader-scan 1/0, and the entity/shadow/class-identity
    probes. External container scripts (Fabric C3/C5/multi-mixin, Forge C5/multi-mixin) are listed by
    probeAll but run separately with their own evidence files.
  • Mutation checks (seconds-scale, recorded in evidence): scope exact-class filter removal → red;
    cache first-load write / putIfAbsent removal → red; layout live-instance reject removal → red;
    cancellable revert and reload-order revert → red.

Known limits / manual acceptance

  • Manual acceptance still pending: docs/acceptance/01-manual-checklist.md (template scenarios
    1–8, build/result columns intentionally empty for the user to confirm; real Fabric 1.21.1 client).
  • Forge upstream Mixin 0.8.5/0.8.7 semantics: cross-mixin same-name @Unique fields are merged
    into a single field (Fabric sponge-mixin disambiguates to <sessionId>$<modId>$<name>$0).
    Remold's re-weave keeps the merged field stable; this is upstream behaviour, not a Remold defect.
  • Forge ClassInfo member sync for newly added Mixin members is not implemented on the Forge
    side (Fabric covers it via MixinClassInfoSync); structural contract changes still require a
    restart.
  • NeoForge Mixin compatibility is not verified end-to-end. NeoForgeHotswapPlugin and the
    shared ModLauncherMixinBridge/ForgeMixinHotSwap code path exist, but there is no NeoForge
    MDK probe and no real runServer evidence: NeoForge mixin re-weaving, template hot update,
    @Unique/@Inject retention and mixin-config registration are all unverified on NeoForge
    (tracked as 🔶 in docs/status.md §Forge/NeoForge rows). Do not treat Forge 1.21.1 evidence as
    covering NeoForge.
  • Container probes cover real servers (Fabric KnotServer, Forge runServer), not a client GUI;
    evidence hashes are per-process (Mixin sessionId) and not cross-run comparable.
  • alignBaselineProbe/offsetStabilityProbe are JBR-sensitive and require
    -XX:+AllowEnhancedClassRedefinition. offsetStabilityProbe Probe E's strict "cached Field
    accessor auto-updated" assertion holds on JBR 25.0.2 (the intended p05 JDK); on JBR 21 the
    accessor keeps the stale offset and reads the adjacent s2=200L slot, which is an
    environment difference, not offset corruption. probeAll must be run with JBR 25.0.2
    (-Pp05.jbr=<jbr-25.0.2>); Probe D/D2 now poll compilation.log for Tier-4 compilation
    (up to 30 rounds) instead of a fixed 100 ms warmup, which removes the batch-load flake.

Artifacts (build check)

  • core/build/libs/remold-agent.jar — 1.4 MB; MANIFEST: Premain-Class/Agent-Class =
    remold.RemoldAgent, Boot-Class-Path: remold-agent.jar, Can-Redefine-Classes: true,
    Can-Retransform-Classes: true; shaded content only remold/ + libs/.
  • plugin-{fabric,forge,mixin,arc}/build/libs/remold-plugin-*-0.2.4.jar.