feat: introduce EnterStagingRequest for RegionEngine

[WenyXu]

I hereby agree to the terms of the GreptimeDB CLA.

Refer to a related PR or issue link (optional)

#6558

What's changed and what's your intention?

This PR introduces EnterStagingRequest as a new region operation that enables safe partition rule changes by transitioning regions into staging mode with isolated manifest management. This allows zero-downtime partition expression updates while maintaining data consistency.

The EnterStagingRequest follows a carefully designed flow:

1. Check Current State: If already in staging mode, validate partition expression matches
2. Flush Memtable: If memtable contains data, flush it first with FlushReason::EnterStaging
3. Clear Staging Directory(asynchronous): Remove any existing staging manifest files
4. Create Staging Manifest(asynchronous): Write new manifest with updated partition expression
5. Switch State: Transition region to Staging mode
6. Resume Writes: Allow pending write requests to continue

PR Checklist

Please convert it to a draft if some of the following conditions are not met.

• I have written the necessary rustdoc comments.
• I have added the necessary unit tests and integration tests.
• This PR requires documentation updates.
• API changes are backward compatible.
• Schema or data changes are backward compatible.

[Copilot]

Pull Request Overview

This PR introduces the EnterStagingRequest API for the RegionEngine, enabling safe partition rule changes through a carefully orchestrated staging mode transition. The implementation adds a new intermediate EnteringStaging state that stalls writes during the transition, flushes memtables with the old partition expression, creates isolated staging manifests with the new partition expression, and then resumes writes in staging mode.

Key changes include:

• New EnterStagingRequest API and RegionLeaderState::EnteringStaging state for safe partition expression updates
• Modified manifest update signature to use is_staging: bool parameter instead of region state
• Enhanced flush handling with new FlushReason::EnterStaging variant and is_staging parameter propagation

Reviewed Changes

Copilot reviewed 25 out of 25 changed files in this pull request and generated 5 comments.

Show a summary per file

File	Description
src/store-api/src/region_request.rs	Adds EnterStagingRequest struct and extends RegionRequest enum with EnterStaging variant
src/mito2/src/worker/handle_enter_staging.rs	New file implementing core enter staging logic including request handling, manifest creation, and result processing
src/mito2/src/worker/handle_write.rs	Adds write stalling support for EnteringStaging state to queue requests during transition
src/mito2/src/region.rs	Adds EnteringStaging state, staging_partition_expr field, and state transition methods
src/mito2/src/manifest/manager.rs	Changes update() signature to use is_staging boolean, adds staging manifest tracking and clear_staging_manifests()
src/mito2/src/manifest/checkpointer.rs	Simplifies maybe_do_checkpoint() by removing state parameter (staging check moved to caller)
src/mito2/src/flush.rs	Adds FlushReason::EnterStaging variant and is_staging field to RegionFlushTask
src/mito2/src/worker/handle_flush.rs	Propagates is_staging parameter and updates flush handling to skip metadata updates in staging mode
src/mito2/src/worker/handle_manifest.rs	Updates all update_manifest() calls to pass is_staging parameter
src/mito2/src/worker/handle_alter.rs	Updates flush task creation to pass is_staging parameter
src/mito2/src/worker.rs	Adds EnterStaging request handling and background notification processing
src/mito2/src/region/opener.rs	Initializes staging_partition_expr field and refactors manifest options creation
src/mito2/src/manifest/storage.rs	Adds manifest_dir() helper function
src/mito2/src/error.rs	Adds StagingPartitionExprMismatch error for partition expression validation
src/mito2/src/engine/staging_test.rs	Comprehensive tests for enter staging functionality including partition expression validation and write stalling
src/mito2/src/engine/listener.rs	Adds NotifyEnterStagingResultListener for test coordination
src/mito2/src/request.rs	Adds EnterStagingRequest to worker request types and EnterStagingResult for background notifications
src/metric-engine/src/engine.rs	Adds EnterStaging request handling for physical regions
src/datanode/src/region_server.rs	Maps EnterStaging request to RegionChange::None
Test files (multiple)	Updates existing tests to use new manifest update signature

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 25 out of 25 changed files in this pull request and generated 6 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Pull request overview

Copilot reviewed 26 out of 26 changed files in this pull request and generated 2 comments.

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[evenyag]

Do we need to send result to the worker? So it can handle stalled requests.