[ISSUE #9174]🐛Restore mapped-file retirement fixture modules for CI

[mxsm]

Which Issue(s) This PR Fixes(Closes)

• Fixes [Bug🐛] Restore mapped-file retirement fixture modules for CI #9174

Brief Description

Move the mapped-file retirement fixture source modules from the ignored fixture_corpus/build/ directory to fixture_corpus/test_cases/.

Reference edges.rs, frontiers.rs, and samples.rs through explicit #[path = "test_cases/..."] attributes in fixture_corpus/build.rs. This ensures clean Git checkouts contain every declared test module without adding an exception to the repository-wide build-output ignore rule. The generated fixture bytes and SHA-256 manifest remain unchanged.

How Did You Test This Change?

• cargo fmt --all -- --check - passed
• cargo test -p rocketmq-store-local --lib mapped_file::retirement::fixture_corpus::tests::checked_in_lifecycle_corpus_is_byte_exact_decodable_and_hash_complete -- --exact - passed (1 passed)
• cargo clippy --workspace --no-deps --all-targets --all-features -- -D warnings - passed
• cargo +nightly-2026-07-05 check --locked --all-targets --all-features from fuzz/ - passed
• git diff --cached --check - passed

Summary by CodeRabbit

• Tests
  • Added comprehensive deterministic test fixtures for mapped-file retirement workflows.
  • Added coverage for compaction, recovery, corruption, truncation, sequence limits, marker handling, quarantine, and path replacement scenarios.
  • Added sample records and metadata covering initialization, bootstrap, generation transitions, retirement stages, and lifecycle snapshots.

[rocketmq-rust-bot]

🔊@mxsm 🚀Thanks for your contribution🎉！

💡CodeRabbit(AI) will review your code first🔥！

Note

🚨The code review suggestions from CodeRabbit are to be used as a reference only, and the PR submitter can decide whether to make changes based on their own judgment. Ultimately, the project management personnel will conduct the final code review💥.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 56a431e3-9552-4c76-95d1-72dd0d9e4728

📥 Commits

Reviewing files that changed from the base of the PR and between d7c0455 and 63cbff2.

📒 Files selected for processing (4)

• rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/build.rs
• rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/edges.rs
• rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/frontiers.rs
• rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/samples.rs

---

Walkthrough

The change restores retirement fixture modules through explicit paths and adds deterministic sample, edge-case, and frontier fixtures for ledger, acknowledgement, snapshot, marker, compaction, and tail-repair validation.

Changes

Retirement fixture corpus

Layer / File(s)	Summary
Sample data and module wiring rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/build.rs, rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/samples.rs	Explicit module paths expose deterministic records, metadata, identifiers, and lifecycle snapshot helpers.
Encoding and validation edge cases rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/edges.rs	Fixtures cover acknowledgement ordering, reconstruction, truncation, corruption, overflow, oversized fields, reserved data, and incomplete marker pairs.
Compaction and tail-repair frontiers rocketmq-store-local/src/mapped_file/retirement/fixture_corpus/test_cases/frontiers.rs	Fixtures cover compaction, tail repair, marker commits, orphan generations, acknowledged suffix loss, and invalid repaired records.

Estimated code review effort: 4 (Complex) | ~45 minutes

Possibly related PRs

• mxsm/rocketmq-rust#8765: Related store recovery fixtures for corruption, truncation, and encoded ledger records.
• mxsm/rocketmq-rust#8776: Related mapped-file retirement correctness and Miri validation.
• mxsm/rocketmq-rust#9172: Related bootstrap and retirement durability logic supported by these fixtures.

Suggested labels: testing🧪

Poem

A rabbit checks each ledger byte,
Through torn slots in the moonlit night.
Frontiers turn and tails repair,
Snapshots guard their checksums there.
Three modules hop back into sight—
CI now follows paths just right.

✨ Finishing Touches 💡 1

🛠️ Fix failing CI checks 💡

• Create stacked PR
• Commit on current branch

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch mxsm/issue-9174-retirement-fixture-test-cases

---

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.}