Merge branch 'release/v3.2.0' into main

Author: DirtyNative

.gitignore

@@ -115,4 +115,7 @@ lib/generated_plugin_registrant.dart
 # End of https://www.toptal.com/developers/gitignore/api/dart,flutter,visualstudiocode
 
 **/.idea/
-**/*.iml
+**/*.iml
+
+# Any log file
+**/*.log

custom_lint.yaml

@@ -0,0 +1,3 @@
+custom_lint:
+  rules:
+    - continuum_missing_apply_handlers

packages/continuum/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.0] - 2026-01-14
+
+### Added
+
+- Added a custom lint rule that reports when a non-abstract `@Aggregate()` class mixes in the generated `_$<Aggregate>EventHandlers` but does not implement all required `apply<Event>(...)` methods.
+- Added a Quick Fix action to implement missing `apply<Event>(...)` handler stubs.
+- Added a runnable example package under `example/` showing the lint in action.
+
 ## [3.1.1] - 2026-01-13
 
 ### Fixed

packages/continuum/README.md

@@ -364,6 +364,51 @@ targets:
         enabled: true
 ```
 
+## Custom Lints (Recommended)
+
+Continuum can optionally surface common mistakes *immediately in the editor* using a custom lint plugin.
+
+### Why use it?
+
+Some Continuum patterns rely on generated mixins (for example `_$UserEventHandlers`). If a concrete `@Aggregate()` class forgets to implement one of the required `apply<Event>(...)` handlers, Dart can sometimes delay the failure until runtime (or until the class is instantiated, depending on how the type is used).
+
+The `continuum_lints` package detects this situation early and reports it as a diagnostic while you type.
+
+### Setup
+
+Add these dev dependencies:
+
+```yaml
+dev_dependencies:
+  custom_lint: ^0.8.1
+  continuum_lints: ^3.1.1
+```
+
+Enable the analyzer plugin in your `analysis_options.yaml`:
+
+```yaml
+analyzer:
+  plugins:
+    - custom_lint
+```
+
+Optionally, configure which rules are enabled (recommended to keep things explicit):
+
+```yaml
+custom_lint:
+  enable_all_lint_rules: false
+  rules:
+    - continuum_missing_apply_handlers
+```
+
+### CI usage
+
+`dart analyze` does not run custom lints. In CI, run:
+
+```bash
+dart run custom_lint
+```
+
 ## Working with Persistence
 
 ### Event Stores

packages/continuum/analysis_options.yaml

@@ -57,6 +57,9 @@ linter:
 
 # Analyzer settings.
 analyzer:
+  plugins:
+    - custom_lint
+
   # Exclude certain files or directories from analysis.
   exclude:
     - "**/*.g.dart"

packages/continuum/pubspec.yaml

@@ -1,6 +1,6 @@
 name: continuum
 description: An event sourcing library for Dart with code generation support.
-version: 3.1.1
+version: 3.2.0
 repository: https://github.com/zooper/continuum
 homepage: https://zooper.dev
 
@@ -16,6 +16,7 @@ dependencies:
 
 dev_dependencies:
   build_runner: ^2.4.0
+  custom_lint: ^0.8.1
   lints: ^6.0.0
   mockito: ^5.4.0
   test: ^1.25.6

packages/continuum_generator/CHANGELOG.md

@@ -5,6 +5,14 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.2.0] - 2026-01-14
+
+### Added
+
+- Added a custom lint rule that reports when a non-abstract `@Aggregate()` class mixes in the generated `_$<Aggregate>EventHandlers` but does not implement all required `apply<Event>(...)` methods.
+- Added a Quick Fix action to implement missing `apply<Event>(...)` handler stubs.
+- Added a runnable example package under `example/` showing the lint in action.
+
 ## [3.1.1] - 2026-01-13
 
 ### Fixed

packages/continuum_generator/analysis_options.yaml

@@ -58,6 +58,9 @@ linter:
 
 # Analyzer settings.
 analyzer:
+  plugins:
+    - custom_lint
+
   # Exclude certain files or directories from analysis.
   exclude:
     - "**/*.g.dart"

packages/continuum_generator/pubspec.yaml

@@ -1,6 +1,6 @@
 name: continuum_generator
 description: Code generator for the continuum event sourcing library.
-version: 3.1.1
+version: 3.2.0
 repository: https://github.com/zooper/continuum
 homepage: https://zooper.dev
 
@@ -12,13 +12,14 @@ resolution: workspace
 dependencies:
   analyzer: ^8.0.0
   build: ^4.0.0
-  continuum: ^3.0.1
+  continuum: ^3.2.0
   source_gen: ^4.0.0
   glob: ^2.1.3
 
 dev_dependencies:
   build_runner: ^2.4.0
   build_test: ^3.5.4
+  custom_lint: ^0.8.1
   lints: ^6.0.0
   source_gen_test: ^1.0.0
   test: ^1.25.6

packages/continuum_lints/CHANGELOG.md

@@ -0,0 +1,14 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+
+- Added a custom lint rule that reports when a non-abstract `@Aggregate()` class mixes in the generated `_$<Aggregate>EventHandlers` but does not implement all required `apply<Event>(...)` methods.
+- Added a Quick Fix action to implement missing `apply<Event>(...)` handler stubs.
+- Added a runnable example package under `example/` showing the lint in action.