feat: add initial state module

[yordis]

No description provided.

[cursor]

PR Summary

Medium Risk
Touches aggregate initialization and aggregate_state rebuilding paths; while largely additive and covered by tests, mistakes could change how state is constructed or surfaced across existing aggregates.

Overview
Adds an initial_state option to dispatch routes so aggregates can be initialized from a separate state module (via initial_state/0) instead of requiring struct(AggregateModule).

Plumbs this option through command dispatch (Dispatcher -> Aggregates.Supervisor -> AggregateStateBuilder) and extends aggregate_state/3 APIs to accept either a timeout or options (including initial_state) when rebuilding from the event store. Updates docs/guide and adds new tests + support fixtures covering separate state modules and backward compatibility.

^{Written by Cursor Bugbot for commit 8a8754d. This will update automatically on new commits. Configure here.}

[coderabbitai]

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

• 🔍 Trigger a full review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch split-aggregate-and-payload-mod

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[cursor]

Cursor Bugbot has reviewed your changes and found 2 potential issues.