chore(release): prepare V9.0.0 migration

Author: Ahoo-Wang

AGENTS.md

@@ -143,7 +143,7 @@ Dashboard code uses React 19, TypeScript 6, Vite 8, Ant Design 6, React Router 7
 
 ## Version Management
 
-The project version is the `version` property in `gradle.properties` and is currently `8.16.3`. Keep dependent documentation, examples, package metadata, and release notes in sync when bumping it. Third-party versions are centralized in `gradle/libs.versions.toml` and the `wow-dependencies` module.
+The project version is the `version` property in `gradle.properties` and is currently `9.0.0`. Keep dependent documentation, examples, package metadata, and release notes in sync when bumping it. Third-party versions are centralized in `gradle/libs.versions.toml` and the `wow-dependencies` module.
 
 ## CI And Release Workflows
 

README.md

@@ -75,7 +75,7 @@ The current source tree declares:
 
 | Component | Baseline |
 | --- | --- |
-| Wow | `8.16.3` |
+| Wow | `9.0.0` |
 | Java | 17+ |
 | Spring Boot | `4.1.1` |
 | Kotlin | `2.4.10` |

README.zh-CN.md

@@ -75,7 +75,7 @@ HTTP 命令 → 聚合决策 → 领域事件 → 溯源状态 → 投影 / Saga
 
 | 组件 | 基线 |
 | --- | --- |
-| Wow | `8.16.3` |
+| Wow | `9.0.0` |
 | Java | 17+ |
 | Spring Boot | `4.1.1` |
 | Kotlin | `2.4.10` |

compensation/dashboard/package.json

@@ -1,7 +1,7 @@
 {
   "name": "wow-compensation-dashboard",
   "private": true,
-  "version": "8.16.3",
+  "version": "9.0.0",
   "type": "module",
   "scripts": {
     "dev": "vite",

document/design/assets/Load-Aggregate.svg

@@ -8,7 +8,7 @@ __Sequence Diagram__
 end title
 
 participant AggregateRepository
-participant SnapshotRepository
+participant SnapshotStore
 participant AggregateFactory
 participant StateAggregate
 database Snapshot
@@ -17,15 +17,15 @@ database EventStore
 autonumber "<b>[00]</b>"
 
 [-> AggregateRepository++: load(aggregateId)
-AggregateRepository -> SnapshotRepository++: load(aggregateId)
-SnapshotRepository -> Snapshot++: load(aggregateId)
-SnapshotRepository <-- Snapshot--: snapshot
+AggregateRepository -> SnapshotStore++: load(aggregateId)
+SnapshotStore -> Snapshot++: load(aggregateId)
+SnapshotStore <-- Snapshot--: snapshot
 
 alt snapshot exist
     create StateAggregate
-    SnapshotRepository -> StateAggregate ++: deserialize snapshot to stateAggregate
-    SnapshotRepository <-- StateAggregate: stateAggregate
-    AggregateRepository <-- SnapshotRepository--: stateAggregate
+    SnapshotStore -> StateAggregate ++: deserialize snapshot to stateAggregate
+    SnapshotStore <-- StateAggregate: stateAggregate
+    AggregateRepository <-- SnapshotStore--: stateAggregate
 else snapshot not exist
     AggregateRepository -> AggregateFactory++: create(aggregateId)
     create StateAggregate

document/design/uml/Load-Aggregate-Sequence-Diagram.puml

@@ -17,12 +17,12 @@ Do not migrate every write path or add production infrastructure in the same cha
 
 ## Version Baseline
 
-The current Wow `8.16.3` source declares:
+The current Wow `9.0.0` source declares:
 
 | Component | Version |
 | --- | --- |
 | JDK | 17+ |
-| Wow | `8.16.3` |
+| Wow | `9.0.0` |
 | Spring Boot | `4.1.1` |
 | Kotlin | `2.4.10` |
 | KSP | `2.3.11` |
@@ -57,8 +57,8 @@ Align the platform and compiler in the annotated modules:
 
 ```kotlin
 dependencies {
-    implementation(platform("me.ahoo.wow:wow-bom:8.16.3"))
-    ksp(platform("me.ahoo.wow:wow-bom:8.16.3"))
+    implementation(platform("me.ahoo.wow:wow-bom:9.0.0"))
+    ksp(platform("me.ahoo.wow:wow-bom:9.0.0"))
 
     implementation("me.ahoo.wow:wow-api") // api module
     ksp("me.ahoo.wow:wow-compiler")
@@ -72,7 +72,7 @@ Request the base Starter and the `webflux-support` feature in the server module:
 ```kotlin
 dependencies {
     implementation(platform("org.springframework.boot:spring-boot-dependencies:4.1.1"))
-    implementation(platform("me.ahoo.wow:wow-bom:8.16.3"))
+    implementation(platform("me.ahoo.wow:wow-bom:9.0.0"))
 
     implementation("me.ahoo.wow:wow-spring-boot-starter")
     implementation("me.ahoo.wow:wow-spring-boot-starter") {

documentation/docs/en/guide/existing-project.md

@@ -27,7 +27,7 @@ This page was executed on 2026-08-27 against template commit [`1dc9267b7f276c8c3
 | Gradle Wrapper | `9.7.1` |
 | JDK used for the run | `17.0.7` |
 
-The current Wow documentation source is `8.16.3`, while the verified template pins `8.13.0`. The repositories evolve independently. Always inspect the cloned template's [`gradle/libs.versions.toml`](https://github.com/Ahoo-Wang/wow-project-template/blob/main/gradle/libs.versions.toml); change versions only as one reviewed compatibility baseline for a selected [Wow release](https://github.com/Ahoo-Wang/Wow/releases).
+The current Wow documentation source is `9.0.0`, while the verified template pins `8.13.0`. The repositories evolve independently. Always inspect the cloned template's [`gradle/libs.versions.toml`](https://github.com/Ahoo-Wang/wow-project-template/blob/main/gradle/libs.versions.toml); change versions only as one reviewed compatibility baseline for a selected [Wow release](https://github.com/Ahoo-Wang/Wow/releases).
 
 ## Before You Start
 

documentation/docs/en/guide/getting-started.md

@@ -24,6 +24,7 @@ A green local build can close the source gate. It does not close the other four.
 | CRUD/transaction scripts/direct table writes, no Wow history | [Migrating from Traditional Architecture](./migration/traditional-architecture.md) | Establish commands, aggregates, events, import, and traffic ownership |
 | Exact Wow v6 tag | [Migrate Wow v6 to v8](./migration/v6-to-v8.md) | Diff pinned platform/API/storage contracts and perform a hard data cutover where required |
 | Wow v8 with custom dispatcher/message-bus/Spring lifecycle ownership | [Runtime Orchestration Migration](./migration/runtime-orchestration.md) | Move lifecycle source code to the unified `WowRuntime`; this is not automatically a data migration |
+| Wow v8.16.x using old query APIs or `SnapshotRepository` | [V9 Query Migration](./query/v9-query-migration.md) | Migrate Gateway/Backend, filters, masking, SnapshotStore, and Spring bean names |
 
 Do not combine first adoption and a v6→v8 upgrade into one undifferentiated release. Select a bounded context and an
 exact source/target version for each change window.
@@ -35,6 +36,7 @@ exact source/target version for each change window.
 | Traditional architecture | Domain boundary, historical import, shadow catch-up, read/write cutover | Wow version/platform upgrade assumptions |
 | v6→v8 | Pinned Gradle/platform matrix, source breaks, storage formats, data cutover | Redesigning every domain |
 | Runtime orchestration | `RuntimeComponent`, message receiver admission, Spring lifecycle ownership, shutdown | Event/snapshot format conversion unless another section requires it |
+| V9 query migration | Query Gateway/Backend, filter/masking, SnapshotStore naming, and the Condition migration window | Deployment or production cutover proof |
 | Runtime lifecycle | Stable post-migration semantics | The migration procedure itself |
 
 The [release notes](https://github.com/Ahoo-Wang/Wow/releases) describe version changes. The selected tag's source,
@@ -149,6 +151,7 @@ See [v6 → v8: Mongo Ownership Guard](./migration/v6-to-v8.md#mongo-ownership-g
 | [Migrating from Traditional Architecture](./migration/traditional-architecture.md) | First adoption and traffic ownership |
 | [Migrate Wow v6 to v8](./migration/v6-to-v8.md) | Existing Wow platform/storage upgrade |
 | [Runtime Orchestration Migration](./migration/runtime-orchestration.md) | Unified lifecycle source migration |
+| [V9 Query Migration](./query/v9-query-migration.md) | V8.16.x to V9 query and SnapshotStore source migration |
 | [Runtime Lifecycle](./advanced/runtime-lifecycle.md) | Stable runtime model after migration |
 | [Troubleshooting](./troubleshooting.md) | Evidence-first diagnosis when a gate fails |
 

documentation/docs/en/guide/migration.md

@@ -78,7 +78,7 @@ See [Snapshot Queries](./query/snapshot-query.md), [Event Stream Queries](./quer
 
 ## Compatibility and Migration
 
-`Condition`, `Operator`, and `ConditionDsl` are deprecated compatibility inputs; the canonical contract uses `FilterExpression`. See [V9 Query Migration](./query/v9-query-migration.md) for the breaking Gateway/Backend JVM type mapping, the no-bridge policy, and unchanged transport contracts.
+The canonical V9 JVM contract is `FilterExpression` and `FilterDsl`. V9.0.x temporarily retains deprecated `Condition`/`Operator`, `ConditionDsl`, legacy query constructors, and count client overloads, all normalized to `FilterExpression`; these compatibility APIs are scheduled for removal in 9.1.0. REST `condition`/`operator` input remains compatible during the same window. See [V9 Query Migration](./query/v9-query-migration.md) for the breaking Gateway/Backend JVM mapping, compatibility boundary, and binding migration.
 
 ## JSON Schema