chore(mcp): upgrade docusaurus-plugin-mcp-server to 0.13.0, drop patch

.github/dependabot.yml

@@ -15,6 +15,12 @@ updates:
           - "*"
     commit-message:
       prefix: "build(deps)"
+    # docusaurus-plugin-mcp-server is upgraded manually: its FlexSearch index
+    # config must be kept in sync between docusaurus.config.ts (build) and
+    # mcp-server/server.mjs (runtime), and the wrong defaults OOM the mcp
+    # service on deploy. Auto-bumps would ship that mismatch unattended.
+    ignore:
+      - dependency-name: "docusaurus-plugin-mcp-server"
 
   - package-ecosystem: "npm"
     directory: "/mcp-server"
@@ -27,3 +33,6 @@ updates:
           - "*"
     commit-message:
       prefix: "build(deps)"
+    # See note above — manual upgrades only for this package.
+    ignore:
+      - dependency-name: "docusaurus-plugin-mcp-server"

docusaurus.config.ts

@@ -255,6 +255,20 @@ const config: Config = {
           "/developers/reference/*",
           "/overview/changelog*",
         ],
+        // FlexSearch index tuning (replaces the former patch-package patch,
+        // which was version-pinned to 0.11.0 and silently broke on upgrade).
+        // The plugin's defaults — tokenize "forward", resolution 9, and a
+        // depth-2 bidirectional context — balloon the generated search-index
+        // export to ~290MB over full page content, which OOM'd the mcp
+        // service on deploy. "strict" (whole stemmed words, no prefix
+        // expansion) + resolution 3 + no context keeps it to a few MB. The
+        // plugin's default encode() still lowercases + stems, so queries
+        // match normalized words. Keep this in sync with mcp-server/server.mjs.
+        flexsearch: {
+          tokenize: "strict",
+          resolution: 3,
+          context: false,
+        },
       },
     ],
     ["docusaurus-markdown-source-plugin", { docsPath: "/" }],

mcp-server/package.json

@@ -9,7 +9,7 @@
     "test": "node test.mjs"
   },
   "dependencies": {
-    "docusaurus-plugin-mcp-server": "^0.11.0",
+    "docusaurus-plugin-mcp-server": "^0.13.0",
     "patch-package": "^8.0.1"
   },
   "engines": {

mcp-server/server.mjs

@@ -312,6 +312,15 @@ async function start() {
       indexPath: INDEX_PATH,
       name: "ottu-docs",
       baseUrl: BASE_URL,
+      // Must match the build-side FlexSearch config in docusaurus.config.ts.
+      // The query-side index is reconstructed from the artifact, so its
+      // tokenizer/resolution have to mirror how the index was built or
+      // lookups won't match. Replaces the former 0.11.0 patch-package patch.
+      flexsearch: {
+        tokenize: "strict",
+        resolution: 3,
+        context: false,
+      },
     });
     ready = true;
   }

package.json

@@ -33,7 +33,7 @@
     "@mdx-js/react": "^3.1.1",
     "clsx": "^2.1.1",
     "docusaurus-markdown-source-plugin": "^2.2.4",
-    "docusaurus-plugin-mcp-server": "^0.11.0",
+    "docusaurus-plugin-mcp-server": "^0.13.0",
     "prism-react-renderer": "^2.4.1",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",