fix: finalize auto index rollout verification

Author: rockyshi1993

README.md

@@ -502,6 +502,7 @@ Current TypeScript documentation and examples are the source of truth for the v2
 
 - Complete docs: [English](https://vextjs.github.io/monSQLize/) · [简体中文](https://vextjs.github.io/monSQLize/zh/)
 - Constructor configuration: [English](https://vextjs.github.io/monSQLize/configuration) · [简体中文](https://vextjs.github.io/monSQLize/zh/configuration)
+- Production rollout: [English](https://vextjs.github.io/monSQLize/production-rollout) · [简体中文](https://vextjs.github.io/monSQLize/zh/production-rollout)
 - Common scenarios: [English](https://vextjs.github.io/monSQLize/recipes) · [简体中文](https://vextjs.github.io/monSQLize/zh/recipes)
 - Example source: [examples index](https://github.com/vextjs/monSQLize/blob/main/examples/README.md)
 - Documentation source: [docs/en](https://github.com/vextjs/monSQLize/tree/main/docs/en) · [docs/zh](https://github.com/vextjs/monSQLize/tree/main/docs/zh)
@@ -548,7 +549,7 @@ npm run test:real-env:private
 
 `test:examples`, `test:server-matrix`, and `config.useMemoryServer` use a fixed `mongodb-memory-server` policy: MongoDB `7.0.14` by default, binaries cached under `.cache/mongodb-memory-server/binaries`, and temporary data paths created under `.cache/mongodb-memory-server/db` with forced cleanup for project-managed paths. Stale managed data paths whose owner PID is no longer alive are pruned before new memory-server launches. Override with `MONSQLIZE_MEMORY_MONGO_BINARY_VERSION`, `MONSQLIZE_REPLSET_BINARY_VERSION`, `MONGOMS_DOWNLOAD_DIR`, or `MONSQLIZE_MEMORY_SERVER_DB_DIR` when needed.
 
-`test:coverage` is the independent 90% coverage governance gate for the published CJS runtime artifact. `test:audit` checks production dependencies against the npm registry. `test:real-env:private` is intentionally opt-in and expects private environment variables. Coverage and private real-environment checks are not part of the default CI or release gate.
+`test:coverage` is the independent 90% coverage governance gate for the published CJS runtime plus source-level gap coverage resolved through sourcemaps. `test:audit` checks production dependencies against the npm registry. `test:real-env:private` is intentionally opt-in and expects private environment variables. Coverage and private real-environment checks are not part of the default CI or release gate.
 
 ## Roadmap
 

changelogs/unreleased.md

@@ -14,6 +14,8 @@
 
 ## Fixed / changed
 
+- Fixed Model `autoIndex=true` scheduling to preflight declared indexes with `listIndexes()`, skip matching existing indexes, create only missing indexes, and report conflicts through warning logs / `model-index-error` without destructive index changes.
+- Fixed Batch 1 validation findings: `getDefaults()` now returns isolated deep-frozen snapshots, aggregate `$merge` / `$out` cache tests assert explicit target invalidation instead of implicit broad invalidation, cache invalidation docs list descriptor shapes, and legacy Redis lock wording no longer implies a running Redis service is bundled.
 - Fixed aggregate direct `.toArray()` to honor cache/meta execution paths, extended `find()` ObjectId auto-conversion to comparison operators, forwarded CountQueue abort signals into MongoDB count options, and added a warning when sync idempotency falls back to in-memory storage.
 - Upgraded `schema-dsl` to `2.1.3` and moved Model schema compilation/validation onto a MonSQLize runtime-scoped `schema-dsl/runtime` engine. `schemaDsl` now supports runtime options, extension registration, external runtime injection, explicit validation disablement, and fail-closed dependency resolution diagnostics.
 - Fixed `schemaDsl: { runtime, extensions }` lifecycle handling so injected runtimes register extensions once during `connect()` instead of registering the same factory during construction and reconnect setup.
@@ -52,4 +54,5 @@
 - Fixed documentation-site footer localization so the English and Chinese home pages no longer show both language footer navigation blocks at the same time.
 - Hid hand-written Markdown table-of-contents blocks in the Rspress documentation site so they no longer duplicate the generated right-side page outline.
 - Corrected the multi-pool documentation path: the page now presents `new MonSQLize({ pools: [...] })` as the recommended setup, removes stale pinned install versions, and aligns adjacent connection, pool-chain, API index, capability index, function-cache, and Saga installation docs with the current package.
-- Repositioned `withCache()` / `FunctionCache` as hidden legacy compatibility surfaces, removed them from current cache/navigation/API recommendation paths, aligned cache examples with database query caching, and corrected stable docs drift for pool health status, Node.js runtime version, and the 98/98 docs-example matrix.
+- Repositioned `withCache()` / `FunctionCache` as hidden legacy compatibility surfaces, removed them from current cache/navigation/API recommendation paths, aligned cache examples with database query caching, and corrected stable docs drift for pool health status, Node.js runtime version, and the 104/104 docs-example matrix.
+- Fixed the independent coverage runner to preserve the 90% gate while counting source-level gap coverage through sourcemaps, and refreshed the verification docs/profile facts to the current 104/104 docs matrix and 57 runnable examples.

docs/en/README.md

@@ -12,6 +12,7 @@ This documentation starts with the common application path: connect to MongoDB,
 | Match docs to runnable source | [`examples.md`](./examples.md) | Links each topic to a GitHub example source |
 | Add database caching | [`cache.md`](./cache.md) | Collection query cache, Redis L2 cache, and distributed invalidation |
 | Control collection-vs-Model writes | [`write-path-policy.md`](./write-path-policy.md) | Optional guard when selected namespaces must go through Model writes |
+| Prepare production rollout | [`production-rollout.md`](./production-rollout.md) | Data backfill, Change Stream CDC, index preflight, and traffic-switch checks |
 | Follow scenario guides | [`recipes.md`](./recipes.md) | Guides for connection, cache, Redis, SSH, pools, and Model usage |
 | Browse the full API surface | [`api-index.md`](./api-index.md) | Reference entry for lower-level and compatibility APIs |
 | Check runtime boundaries | [`capability-index.md`](./capability-index.md) | Capability map with links to deeper reference pages |
@@ -30,8 +31,9 @@ This documentation starts with the common application path: connect to MongoDB,
    - [`examples.md`](./examples.md)
 6. Cache guide: [`cache.md`](./cache.md)
 7. Write path policy: [`write-path-policy.md`](./write-path-policy.md)
-8. Scenario guides: [`recipes.md`](./recipes.md)
-9. API and runtime reference:
+8. Production rollout: [`production-rollout.md`](./production-rollout.md)
+9. Scenario guides: [`recipes.md`](./recipes.md)
+10. API and runtime reference:
    - [`api-index.md`](./api-index.md)
    - [`capability-index.md`](./capability-index.md)
    - [`support-matrix.md`](./support-matrix.md)

docs/en/api-index.md

@@ -27,6 +27,7 @@ This index documents the current stable MongoDB adapter APIs and shared runtime
 | [Change Stream sync](sync-backup.md) | **Change Stream data sync: real-time backup to multiple databases** |
 | [Transaction optimizations](transaction-optimizations.md) | Transaction optimization strategies |
 | [Distributed deployment](distributed-deployment.md) | **Distributed deployment guide for multi-instance cache consistency** |
+| [Production rollout](production-rollout.md) | Production data backfill, CDC sync, index preflight, and traffic-switch checks |
 | [Event system](events.md) | Event system |
 
 ---
@@ -59,11 +60,11 @@ This index documents the current stable MongoDB adapter APIs and shared runtime
 
 | Document | Method | Description |
 |----------|--------|-------------|
-| [Update operations guide](update-operations.md) | All update methods | Complete update operations guide |
+| [Update methods overview](update-operations.md) | All update methods | Method choice, traditional operators, and pipeline handoff |
 | [Upsert guide](upsert-guide.md) | **Upsert guide** | Insert when missing, update when present |
 | [Update one document](update-one.md) | `updateOne()` | Update one document |
 | [Update many documents](update-many.md) | `updateMany()` | Update many documents |
-| [Aggregation pipeline updates](update-aggregation.md) | Aggregation pipeline update | Field-to-field calculation and conditional assignment |
+| [Aggregation pipeline update guide](update-aggregation.md) | Aggregation pipeline update | Field-to-field calculation, conditional assignment, and pipeline details |
 | [Batch update](updateBatch.md) | `updateBatch()` | Large batch update with batching and retry |
 | [Replace one document](replace-one.md) | `replaceOne()` | Replace a whole document |
 | [Find one and update](find-one-and-update.md) | `findOneAndUpdate()` | Atomically update and return |
@@ -151,7 +152,7 @@ This index documents the current stable MongoDB adapter APIs and shared runtime
 
 **Update**
 
-- [Update operations guide](update-operations.md) - Complete update operations guide
+- [Update methods overview](update-operations.md) - Method choice, traditional operators, and pipeline handoff
 - [Update one document](update-one.md) - `updateOne`
 - [Update many documents](update-many.md) - `updateMany`
 - [Replace one document](replace-one.md) - `replaceOne`
@@ -213,6 +214,7 @@ This index documents the current stable MongoDB adapter APIs and shared runtime
 | Document | Description |
 |----------|-------------|
 | [Runtime consistency and boundaries](runtime-architecture.md) | Runtime capability boundaries and consistency contracts |
+| [Production rollout](production-rollout.md) | Data migration sync, index sync, and production traffic-switch checklist |
 | [Support matrix](support-matrix.md) | Support matrix |
 | [Roadmap boundaries](roadmap-boundaries.md) | Roadmap boundaries |
 | [Validation notes](validation.md) | Validation notes |
@@ -251,3 +253,4 @@ Recommended reading order for new users:
 9. [Cache system](cache.md) - Understand the cache mechanism.
 10. [Transaction management](transaction.md) - Learn transaction management.
 11. [Distributed deployment](distributed-deployment.md) - Multi-instance deployment for production.
+12. [Production rollout](production-rollout.md) - Data migration, index sync, and traffic-switch checks.