v3.12.0

[Tochemey]

🚀 Highlights

This release focuses on robustness, resilience, and developer experience, with significant improvements across clustering, grains, scheduling, and maintenance.

✨ New Features

• ✨ Remoting calls for Grains Enables remote interactions with Grains for distributed workflows. (@Tochemey · feat: ✨ add remoting call for Grains #1027)
• 🧪 Basic TestKit support for Grains Introduces foundational testing utilities to simplify Grain testing. (@Tochemey · feat: add basic testkit capabilities for Grains #1033)
• 🧭 Default supervisor configuration SpawnOn now uses the system-wide default supervisor strategy. A new option, WithDefaultSupervisor, has been added to explicitly configure it. (@Tochemey · refactor the address, actor path implementation and add default supervisor option #1018)

🐛 Bug Fixes

• Grain activation revamp Prevents panics and duplicate activations during Grain lifecycle handling. (@Tochemey · fix: revamp grain activation implementation to avoid panic and duplication #1023)
• Recovery support for Grain de/activation Adds recovery capabilities to improve fault tolerance. (@Tochemey · fix: add a recovery capabilities to grain de/activation #1030)
• Actor count correctness Fixes mismatches as well as underflow and overflow issues in actor counts. (@Tochemey · fix: fix mismatch, underflow and overflow actors count #1035)
• Scheduler reliability Fixes an issue where ScheduleOnce() did not always trigger as expected. (@majiayu000 · fix: bug: ScheduleOnce() doesn't always trigger #1039)

♻️ Refactors & Improvements

• Address implementation overhaul Revamps address handling and adds support for configuring a default supervisor. (@Tochemey · refactor: revamp address implementation and option to set default supervisor #1019)
• Supervisor system overhaul (@Tochemey · refactor the address, actor path implementation and add default supervisor option #1018)
  • Supervisor logic has been moved into its own dedicated package: supervisor
  • Migrating existing code only requires replacing actor with supervisor Breaking Change
• Improved relocation semantics (@Tochemey · refactor the address, actor path implementation and add default supervisor option #1018)
  • Ensures child actors are not relocated unintentionally during relocation
  • Adds support to relocate actors with their configured supervisor strategy
• Restart behaviour revamp The Restart implementation now restarts the entire child family tree, ensuring consistent recovery semantics. (@Tochemey · refactor the address, actor path implementation and add default supervisor option #1018)
• Cluster storage DB file creation Reimplements DB file creation logic for improved reliability. (@Tochemey · refactor: reimplement cluster storage db file creation #1025)
• Cluster singleton resilience Makes singleton spawning more robust in clustered environments. (@Tochemey · refactor: make cluster singleton spawning more resilient #1038)
• Reduced shutdown log noise Avoids unnecessary log spam during actor system shutdown. (@Tochemey · refactor: avoid unnecessary log spam on actor system shutdown #1032)
• General code maintenance Internal refactors and cleanup for long-term maintainability. (@Tochemey · refactor: code maintenance #1026)

🧹 Chores & Dependency Updates

• Cluster engine dependency upgrade Keeps the cluster engine up to date. (@Tochemey · chore: upgrade cluster engine dependency #1041)
• Dependency maintenance Routine dependency updates and housekeeping. (@Tochemey · chore(deps): dependencies maintenance #1042)

🙌 New Contributors

• @majiayu000 made their first contribution in fix: bug: ScheduleOnce() doesn't always trigger #1039
• @TrueBrain made significant contribution in enhancing the cluster engine in bug: singletons fail to relocate on leader leaving a cluster #1036

Full Changelog: https://github.com/Tochemey/goakt/blob/main/changelog.md

---

This discussion was created from the release v3.12.0.