chore(release): 3.5.2

Bump to 3.5.2 and assign the vector search guidance, Search docs regrouping and vector example notes.

Author: rockyshi1993

CHANGELOG.md

@@ -1,18 +1,19 @@
 # CHANGELOG
 
-> Summary index — the 3.5.1 versioned details are in [changelogs/v3.5.1.md](./changelogs/v3.5.1.md). A versioned note does not establish npm publication; check the registry and immutable tag before deployment.
-> **Last updated**: 2026-10-28
+> Summary index — the 3.5.2 versioned details are in [changelogs/v3.5.2.md](./changelogs/v3.5.2.md). A versioned note does not establish npm publication; check the registry and immutable tag before deployment.
+> **Last updated**: 2026-11-02
 
 ---
 
 ## Unreleased
 
-README, docs-site share card and release tooling fixes are assigned to **3.5.1** ([versioned notes](./changelogs/v3.5.1.md)); GridFS buckets are in [3.5.0](./changelogs/v3.5.0.md); the Search index lifecycle API is in [3.4.0](./changelogs/v3.4.0.md); the weekly-scan cache-key, health-check and lockfile security fixes are in [3.3.4](./changelogs/v3.3.4.md); the schema-dsl 3.0.5 upgrade is in [3.3.3](./changelogs/v3.3.3.md); the audited 3.3.2 repairs are in its [versioned notes](./changelogs/v3.3.2.md) and the [next-change staging log](https://github.com/devcodex-labs/monSQLize/blob/main/changelogs/unreleased.md). Untagged checkouts remain release candidates.
+Vector search guidance, Search docs regrouping and the vector example are assigned to **3.5.2** ([versioned notes](./changelogs/v3.5.2.md)); README, docs-site share card and release tooling fixes are in [3.5.1](./changelogs/v3.5.1.md); GridFS buckets are in [3.5.0](./changelogs/v3.5.0.md); the Search index lifecycle API is in [3.4.0](./changelogs/v3.4.0.md); the weekly-scan cache-key, health-check and lockfile security fixes are in [3.3.4](./changelogs/v3.3.4.md); the schema-dsl 3.0.5 upgrade is in [3.3.3](./changelogs/v3.3.3.md); the audited 3.3.2 repairs are in its [versioned notes](./changelogs/v3.3.2.md) and the [next-change staging log](https://github.com/devcodex-labs/monSQLize/blob/main/changelogs/unreleased.md). Untagged checkouts remain release candidates.
 
 ## Version Overview
 
 | Version | Date | Summary | Details |
 |---------|------|---------|---------|
+| [v3.5.2](./changelogs/v3.5.2.md) | 2026-11-02 | Patch: corrected vector search guidance, regrouped Search docs and a new vector search example; no runtime changes | [View](./changelogs/v3.5.2.md) |
 | [v3.5.1](./changelogs/v3.5.1.md) | 2026-10-28 | Patch: README support wording and native-driver example, docs-site share card and locale meta; no runtime changes | [View](./changelogs/v3.5.1.md) |
 | [v3.5.0](./changelogs/v3.5.0.md) | 2026-10-27 | Minor: GridFS buckets with upload, download, ranges, ensureIndexes and phase-1 resumable upload | [View](./changelogs/v3.5.0.md) |
 | [v3.4.0](./changelogs/v3.4.0.md) | 2026-10-27 | Minor: Search index lifecycle API for Atlas Search and Vector Search | [View](./changelogs/v3.4.0.md) |

README.md

@@ -14,7 +14,7 @@ Upgrade and security: [Migration Guide](./MIGRATION.md) · [Private Vulnerabilit
 
 The npm `latest` dist-tag and GitHub Pages are the stable channel; `main` may contain the next release. Pages deployment accepts only a versioned Git tag whose package version is already present on npm, so unpublished APIs are not promoted as stable documentation. The Google site ownership verification file is copied separately from the workflow commit, with its source commit and content hash recorded in the deployment summary.
 
-This source tree targets **3.5.1**, a documentation patch with no runtime changes (see the [3.5.1 notes](./changelogs/v3.5.1.md)); 3.5.0 added GridFS buckets on `msq.gridfs()` and `model.gridfs()`, and 3.4.0 added the Search index lifecycle API for Atlas Search and Vector Search. The 3.3.2 cache, Model, pagination and sync fixes, including cold-cache upgrades and checkpoint rollback limits, are described in the [3.3.2 notes](./changelogs/v3.3.2.md) and [migration guide](./MIGRATION.md). Read the upgrade guide in [English](https://github.com/devcodex-labs/monSQLize/blob/main/docs/en/upgrade-3.3.2.md) or [简体中文](https://github.com/devcodex-labs/monSQLize/blob/main/docs/zh/upgrade-3.3.2.md). Untagged checkouts remain release candidates; verify the immutable tag and requested registry version before deployment. Candidate preparation does not publish npm or update stable Pages.
+This source tree targets **3.5.2**, a documentation patch with no runtime changes (see the [3.5.2 notes](./changelogs/v3.5.2.md)); 3.5.0 added GridFS buckets on `msq.gridfs()` and `model.gridfs()`, and 3.4.0 added the Search index lifecycle API for Atlas Search and Vector Search. The 3.3.2 cache, Model, pagination and sync fixes, including cold-cache upgrades and checkpoint rollback limits, are described in the [3.3.2 notes](./changelogs/v3.3.2.md) and [migration guide](./MIGRATION.md). Read the upgrade guide in [English](https://github.com/devcodex-labs/monSQLize/blob/main/docs/en/upgrade-3.3.2.md) or [简体中文](https://github.com/devcodex-labs/monSQLize/blob/main/docs/zh/upgrade-3.3.2.md). Untagged checkouts remain release candidates; verify the immutable tag and requested registry version before deployment. Candidate preparation does not publish npm or update stable Pages.
 
 This development source is pinned to verified registry `schema-dsl@3.0.5`. The v3 package remains subject to the full release gate before an immutable tag and npm publication.
 

changelogs/unreleased.md

@@ -1,8 +1,8 @@
 # Unreleased
 
-## Changes after v3.5.1
+## Changes after v3.5.2
 
-No changes have been staged after 3.5.1. The README, docs-site share card and release-candidate ancestry check are assigned to the [3.5.1 versioned notes](./v3.5.1.md); GridFS buckets are in [3.5.0](./v3.5.0.md). Publication is established by the npm registry and immutable tag, not this file.
+No changes have been staged after 3.5.2. The vector search guidance, Search docs regrouping and vector example are assigned to the [3.5.2 versioned notes](./v3.5.2.md); the README and docs-site share card are in [3.5.1](./v3.5.1.md). Publication is established by the npm registry and immutable tag, not this file.
 
 ## Archived preparation notes for the 3.3.2 candidate
 

changelogs/v3.5.2.md

@@ -0,0 +1,18 @@
+# monSQLize v3.5.2
+
+> Release date: 2026-11-02
+> Publication authority: the immutable tag and npm registry. An untagged checkout is a release candidate; the date above does not establish registry availability.
+
+## Highlights
+
+Patch release for documentation. There are no runtime or library changes: public APIs, defaults, bundle output and dependency versions are the same as 3.5.1.
+
+## Documentation
+
+- The Vector Search page no longer claims that no vector index lifecycle API is provided; it links the Search index page, which manages Atlas Search and Vector Search indexes since 3.4.0.
+- `vectorSearch()` and the Search index pages are grouped under Search and vectors in the docs site, and the capability traceability tables gain a Search index row. Pages that belong in the sidebar but were unlisted are now published.
+- A runnable `examples/docs/vector-search.ts` example is added, long Search index behavior tables are split for mobile, and terminology is unified across English and Chinese pages.
+
+## Upgrade and rollback
+
+No migration is required. Rollback to 3.5.1 is safe and changes only the packaged README and changelog.

package-lock.json

@@ -1,6 +1,6 @@
 {
     "name": "monsqlize",
-    "version": "3.5.1",
+    "version": "3.5.2",
     "description": "TypeScript production data runtime layer for MongoDB today, with cache, transactions, pools, models, sync, and observability",
     "type": "commonjs",
     "main": "./dist/cjs/index.cjs",
@@ -21,6 +21,7 @@
         "./package.json": "./package.json"
     },
     "files": [
+        "changelogs/v3.5.2.md",
         "changelogs/v3.5.1.md",
         "changelogs/v3.5.0.md",
         "changelogs/v3.4.0.md",

package.json

@@ -1,6 +1,6 @@
 {
-  "generatedAt": "2026-10-28",
-  "packageVersion": "3.5.1",
+  "generatedAt": "2026-11-02",
+  "packageVersion": "3.5.2",
   "support": {
     "node": {
       "declared": ">=18.0.0",