vantage-peers-mcp 2.8.0 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,85 @@
 # Changelog
 
+## [2.10.0] — 2026-06-14 — Day 102 CRUD baseline PR-C: rename-only safe subset (mission k575kc1ryps0n8br95jw3q7d0x88m2v9)
+
+Mission `mcp-crud-baseline-standard` PR-C under T2. Third of 4 sub-PRs aligning the MCP surface with the Day 101 doctrine `j57dhrmkzjerjtssnr0z9ba57n88n7q7`. Sigma autonomous default after arbitrage timeout on the original "13-entity search_by_keyword cluster" scope — that fuller scope requires a backend search-infrastructure decision (RAG-index per entity vs Convex `.searchIndex()` per table) that is NOT a thin-wrapper PR. PR-C ships the rename-only safe subset now to keep doctrine velocity; the full cluster is deferred to a backend-RFC mission.
+
+### Added (2 canonical search tools)
+
+- **`search_components_by_keyword`** — BM25 / substring search over components by name or team. Wire-identical to `search_components` (same Convex query `components:search` 1:1, same scope filter, same defaults). `readOnlyHint=true`.
+- **`search_fix_patterns_by_semantic`** — semantic embedding-similarity search over fix patterns. Wire-identical to `search_fix_patterns` (same Convex action `search:searchFixPatterns` 1:1, same scope filter, same defaults). `readOnlyHint=true`. Note: the canonical suffix is `_by_semantic` (NOT `_by_keyword`) because the underlying ranker is embedding-cosine, not BM25 — naming follows behavior, not entity convention.
+
+### Deprecated (alias-only, removal target 2.11.0)
+
+- **`search_components`** — alias of `search_components_by_keyword`. Description leads with `DEPRECATED ALIAS …`.
+- **`search_fix_patterns`** — alias of `search_fix_patterns_by_semantic`. Description leads with `DEPRECATED ALIAS …`.
+
+### Re-targeted deprecations (FOLLOW-UP from Eta PR #750 review)
+
+- **`text_search`** — 2.8.0 originally targeted removal at 2.9.0; episode-only PR-B did not include the removal. Source comments + this entry re-target removal to **2.11.0**.
+- **`recall`** — same re-target rationale, removal now **2.11.0**.
+
+Both `text_search` and `recall` remain wire-identical to their canonical successors (`search_memories_by_keyword` / `search_memories_by_semantic`). Closes FOLLOW-UP task `k1754apqtcjpre2vd5ghbkcmzn88mhwf`.
+
+### Scope NOT in this PR (deferred)
+
+The original PR-C "13-entity search_by_keyword cluster" required adding BM25 / search infrastructure to 10+ entities that currently have NO backend search index (`grep searchIndex convex/schema.ts` → zero hits; only `memories` is indexed, via `@convex-dev/rag`). Two backend paths exist:
+
+- **Path A** — extend RAG indexing to each entity (heavy: per-table embedding pipeline, RAG namespace per entity, vector cost; gets hybrid search for free).
+- **Path B** — Convex native `.searchIndex()` per table (lightweight: schema migration + one query per entity, BM25-only, no embeddings).
+
+Either path is a multi-day backend RFC, NOT a thin-wrapper PR. Sigma sent the arbitrage to Pi (msg `jn75zy4g7bhj95bhyz2zvv6n8d88na6s`) and defaulted to PR-C path C (rename-only) after 2 cron ticks of no reply. A follow-up mission to scope the backend search infrastructure is the next mission proposal.
+
+### Version sync
+
+- `mcp-server/server.ts:115` SERVER_VERSION 2.9.0 → 2.10.0
+- `mcp-server/package.json` → 2.10.0
+- README + 4 cloud docs bumped to 2.10.0 markers (`enforce-release-sync` v1.0.1 gate).
+
+### Test fixture catch-up
+
+- `READ_ONLY_TOOLS` set in `mcp-server/src/__tests__/chatgpt-tool-annotations.test.ts` extended with the 2 new canonical names.
+
+### Refs
+
+- Mission `k575kc1ryps0n8br95jw3q7d0x88m2v9` (MCP CRUD Baseline Standard).
+- Pi authorization msg `jn74q7twhr3s1s8dvqxbzvky9588msdd` ("next: T2-PR-C 13-entity search_by_keyword cluster post #750 merge").
+- Sigma arbitrage msg to Pi: `jn75zy4g7bhj95bhyz2zvv6n8d88na6s` (3 paths A/B/C).
+- FOLLOW-UP task: `k1754apqtcjpre2vd5ghbkcmzn88mhwf` (text_search/recall deprecation slipped).
+- Audit T1: `analysis/mcp-crud-baseline-vp-audit-2026-06-14.md` § 4.
+
+## [2.9.0] — 2026-06-14 — Day 102 CRUD baseline PR-B: episode entity 5-op surface (mission k575kc1ryps0n8br95jw3q7d0x88m2v9)
+
+Mission `mcp-crud-baseline-standard` PR-B under T2. Second of 4 sub-PRs aligning the MCP surface with the Day 101 doctrine `j57dhrmkzjerjtssnr0z9ba57n88n7q7` ("5 ops per entity"). PR-B adds the missing read/list/search facades for the `episode` entity, completing the 5-op surface (the write side `store_episode` already existed since the 8-Sins doctrine).
+
+Architectural note: episodes are NOT a separate Convex table — per hotfix `7f958d0`, episodes are stored as memories with `type='episode'` (context/goal/action/outcome/insight + severity). The 4 new tools are thin wrappers that force `type='episode'` on the existing `memories:*` / `search:*` actions, so callers get an ergonomic episode-scoped surface without introducing a new backend table or duplicating index logic.
+
+### Added (4 canonical episode tools)
+
+- **`get_episode`** — fetch a single episode by memory ID. Calls `memories:getMemory` then asserts the returned row has `type='episode'`; otherwise returns a non-leaky "Episode not found" so wrong-type IDs do not leak existence of non-episode memories. Scope-aware via `scopeFilterGet`. Annotations: `readOnlyHint=true`, `openWorldHint=false`, `destructiveHint=false`.
+- **`list_episodes`** — list episodes ordered newest first. Calls `memories:listMemories` with `type='episode'` forced. Accepts `namespace?`, `createdBy?`, `limit?`, `fields?`, `cursor?` — same paging semantics as `list_memories`. Scope-aware via `scopeFilterList`. Envelope-capped via `capListResponseBytes("list_episodes")`.
+- **`search_episodes_by_keyword`** — BM25 search restricted to episodes. Calls `search:textSearch` with `type='episode'` forced. Same `guardRead` namespace gate, same 20-default / 200-cap limits.
+- **`search_episodes_by_semantic`** — semantic vector cosine search restricted to episodes. Calls `search:recall` with `type='episode'` forced. Same gate, same limits.
+
+All four are pure MCP-layer additions: no Convex schema change, no new index, no new action. tsc clean.
+
+### Why
+
+Episode = the 8-Sins / orchestrator-introspection memory type (severity + context/goal/action/outcome/insight). Until 2.9.0, recalling past episodes required `recall query='...' type='episode'` — discoverable only to callers who already knew the memory-side filter trick. Surfacing dedicated wrappers makes the episode lifecycle (write via `store_episode`, read via `get_episode`, browse via `list_episodes`, recall via the two search ops) consistent with the doctrine and self-documenting in any MCP client's tool list.
+
+`hybrid_search` remains entity-agnostic and is NOT mirrored for episodes (cross-cutting RRF tool per audit § 4).
+
+### Test fixture catch-up
+
+- `READ_ONLY_TOOLS` set in `mcp-server/src/__tests__/chatgpt-tool-annotations.test.ts` extended with the 4 new tool names.
+
+### Refs
+
+- Mission `k575kc1ryps0n8br95jw3q7d0x88m2v9` (MCP CRUD Baseline Standard, pilot Sigma + agents Sigma + Eta).
+- Pi authorization msg `jn74v2pkfz08agex4nfm2yfvfd88nzdw` — "chain T2 PR-B episode entity en autonomie scope mission".
+- Audit T1 deliverable: `analysis/mcp-crud-baseline-vp-audit-2026-06-14.md` row 7 (episode entity recommendation: add façade wrappers).
+- Architecture: hotfix `7f958d0` — episodes are memories with metadata, not a separate table.
+
 ## [2.8.0] — 2026-06-14 — Day 101 CRUD baseline PR-A: search_memories_by_keyword + search_memories_by_semantic (mission k575kc1ryps0n8br95jw3q7d0x88m2v9, task k1735qk9kx6agjjyt3e38rdvvh88mk0p)
 
 Mission `mcp-crud-baseline-standard` PR-A under T2 `[CRUD-T2] Implémentation gaps VP MCP`. First of 4 sub-PRs aligning the MCP surface with the Day 101 doctrine `j57dhrmkzjerjtssnr0z9ba57n88n7q7` ("5 ops per entity: get / list / search_by_keyword / search_by_semantic / create-or-upsert"). PR-A handles the convention drift on the `memories` entity — the only entity that already had both keyword + semantic search wired, but under non-canonical names.

package/README.md

@@ -242,7 +242,7 @@ Example:
 ### Session (1)
 `set_summary`
 
-## Compact payloads and status aliases (v2.8.0 — feature since v2.3.0)
+## Compact payloads and status aliases (v2.10.0 — feature since v2.3.0)
 
 ### `fields=lite` — reduced token payloads
 

package/dist/server.js

@@ -102,7 +102,7 @@ const convexUrl = loadConvexUrl();
 const convex = new ConvexHttpClient(convexUrl);
 const server = new McpServer({
     name: "vantage-peers",
-    version: "2.8.0",
+    version: "2.10.0",
 });
 // ─────────────────────────────────────────────────────────────────────────────
 // Helper: structured error response for MCP tool handlers

package/dist/src/tools.js

@@ -917,8 +917,9 @@ export function registerTools(server, convex, oauthCtx) {
     });
     // ── recall ──────────────────────────────────────────────────────────────────
     // DEPRECATED (Day 101 v2.8.0) — alias of search_memories_by_semantic. Retained
-    // for one minor version as a back-compat shim. New callers should use
-    // `search_memories_by_semantic`. To be removed in 2.9.0.
+    // as a back-compat shim. New callers should use `search_memories_by_semantic`.
+    // Removal target re-targeted to 2.11.0 (slipped past 2.9.0 — episode-only PR;
+    // see FOLLOW-UP task k1754apqtcjpre2vd5ghbkcmzn88mhwf for arbitrage).
     server.tool("recall", "DEPRECATED ALIAS of search_memories_by_semantic — semantic vector search over VantagePeers memories, ranked by cosine similarity. " +
         "WHEN: use at session start or before decisions — prefer over text_search for intent-based queries. New callers: use search_memories_by_semantic. " +
         "EXAMPLE: recall query='Pi feedback rules' namespace='global' type='feedback' limit=20.", {
@@ -975,8 +976,9 @@ export function registerTools(server, convex, oauthCtx) {
     });
     // ── text_search ─────────────────────────────────────────────────────────────
     // DEPRECATED (Day 101 v2.8.0) — alias of search_memories_by_keyword. Retained
-    // for one minor version as a back-compat shim. New callers should use
-    // `search_memories_by_keyword`. To be removed in 2.9.0.
+    // as a back-compat shim. New callers should use `search_memories_by_keyword`.
+    // Removal target re-targeted to 2.11.0 (slipped past 2.9.0 — episode-only PR;
+    // see FOLLOW-UP task k1754apqtcjpre2vd5ghbkcmzn88mhwf for arbitrage).
     server.tool("text_search", "DEPRECATED ALIAS of search_memories_by_keyword — BM25 full-text keyword search over VantagePeers memories for exact term matching. " +
         "WHEN: use when search_memories_by_semantic returns too-broad results and you need a specific exact phrase or ID. New callers: use search_memories_by_keyword. " +
         "EXAMPLE: text_search query='Day 92 C3 descriptions' namespace='project/vantage-peers' limit=10.", {
@@ -1025,7 +1027,7 @@ export function registerTools(server, convex, oauthCtx) {
     // ── search_memories_by_keyword ─────────────────────────────────────────────
     // Day 101 v2.8.0 — canonical name under MCP CRUD baseline doctrine.
     // Mirrors text_search 1:1 (same Convex action `search:textSearch`).
-    // text_search is retained as a deprecated alias until 2.9.0.
+    // text_search is retained as a deprecated alias (removal re-targeted 2.11.0).
     server.tool("search_memories_by_keyword", "BM25 full-text keyword search over VantagePeers memories for exact term matching. " +
         "WHEN: use when search_memories_by_semantic returns too-broad results and you need a specific exact phrase or ID. " +
         "EXAMPLE: search_memories_by_keyword query='Day 92 C3 descriptions' namespace='project/vantage-peers' limit=10.", {
@@ -1074,7 +1076,7 @@ export function registerTools(server, convex, oauthCtx) {
     // ── search_memories_by_semantic ────────────────────────────────────────────
     // Day 101 v2.8.0 — canonical name under MCP CRUD baseline doctrine.
     // Mirrors recall 1:1 (same Convex action `search:recall`).
-    // recall is retained as a deprecated alias until 2.9.0.
+    // recall is retained as a deprecated alias (removal re-targeted 2.11.0).
     server.tool("search_memories_by_semantic", "Semantic vector search over VantagePeers memories, ranked by cosine similarity. " +
         "WHEN: use at session start or before decisions — prefer over search_memories_by_keyword for intent-based queries. " +
         "EXAMPLE: search_memories_by_semantic query='Pi feedback rules' namespace='global' type='feedback' limit=20.", {
@@ -1240,6 +1242,225 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── get_episode ────────────────────────────────────────────────────────────
+    // Day 102 v2.9.0 — episode entity 5-op surface (PR-B).
+    // Thin wrapper: episodes are stored as memories with type='episode'
+    // (no separate table — see hotfix 7f958d0). This calls memories:getMemory
+    // and asserts type='episode' so callers get a non-leaky 404 on wrong-type IDs.
+    server.tool("get_episode", "Fetch a single episode by its memory document ID. Episodes are memories with type='episode' carrying context/goal/action/outcome/insight + severity. " +
+        "WHEN: use when you have an episodeId from store_episode or a prior search and need the full record. " +
+        "EXAMPLE: get_episode episodeId='j57dy3049btafda9m2f5d2ggk987ph3f'.", {
+        episodeId: z.string().describe("Episode (memory) document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get episode",
+    }, async ({ episodeId }) => {
+        try {
+            const memory = await convex.query("memories:getMemory", {
+                memoryId: episodeId,
+            });
+            const filtered = scopeFilterGet(oauthCtx, memory);
+            if (filtered === null) {
+                return mcpError(`Episode not found: ${episodeId}`);
+            }
+            if (filtered?.type !== "episode") {
+                return mcpError(`Episode not found: ${episodeId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
+    // ── list_episodes ──────────────────────────────────────────────────────────
+    // Day 102 v2.9.0 — episode entity 5-op surface (PR-B).
+    // Thin wrapper on memories:listMemories with type='episode' forced.
+    server.tool("list_episodes", "List episodes (memories with type='episode') ordered newest first. " +
+        "WHEN: use to enumerate episodes by namespace or creator before recall/audit. " +
+        "EXAMPLE: list_episodes namespace='orchestrator/sigma' limit=20.", {
+        namespace: z
+            .string()
+            .optional()
+            .describe("Filter to a specific namespace — omit to list across all"),
+        createdBy: z
+            .string()
+            .optional()
+            .describe("Filter by creator role (e.g. 'sigma', 'pi')"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Max items to return. Default 20 (envelope-safe). Cap 200."),
+        fields: z
+            .enum(["lite", "full"])
+            .optional()
+            .describe("'lite' returns compact payload (less tokens), 'full' is default."),
+        cursor: z
+            .string()
+            .optional()
+            .describe("S3.3 B8 — opaque pagination cursor from a prior call's `nextCursor`."),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "List episodes",
+    }, async ({ namespace, createdBy, limit, fields, cursor }) => {
+        try {
+            const nsDenied = guardRead(namespace);
+            if (nsDenied)
+                return nsDenied;
+            let backendCursor;
+            if (cursor !== undefined && cursor !== "") {
+                try {
+                    const decoded = decodeCursor(cursor);
+                    if (decoded && "backendCursor" in decoded) {
+                        backendCursor = decoded.backendCursor;
+                    }
+                }
+                catch (err) {
+                    return mcpError(err?.message ?? "invalid cursor");
+                }
+            }
+            const effectiveLimit = limit === undefined ? undefined : clampLimit(limit);
+            const queryArgs = {
+                namespace,
+                type: "episode",
+                createdBy,
+                limit: effectiveLimit ?? 20,
+                fields: fields ?? "lite",
+            };
+            if (backendCursor !== undefined) {
+                queryArgs.paginationOpts = {
+                    numItems: effectiveLimit ?? 50,
+                    cursor: backendCursor,
+                };
+            }
+            const memories = await convex.query("memories:listMemories", queryArgs);
+            const rawList = Array.isArray(memories)
+                ? memories
+                : Array.isArray(memories?.page)
+                    ? memories.page
+                    : [];
+            const filteredList = scopeFilterList(oauthCtx, rawList);
+            const filteredEnvelope = Array.isArray(memories)
+                ? filteredList
+                : { ...memories, page: filteredList };
+            const text = capListResponseBytes(filteredEnvelope, JSON.stringify(filteredEnvelope, null, 2), "list_episodes");
+            return {
+                content: [{ type: "text", text }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
+    // ── search_episodes_by_keyword ─────────────────────────────────────────────
+    // Day 102 v2.9.0 — episode entity 5-op surface (PR-B).
+    // Thin wrapper on search:textSearch with type='episode' forced.
+    server.tool("search_episodes_by_keyword", "BM25 full-text keyword search restricted to episodes (memories with type='episode'). " +
+        "WHEN: use when search_episodes_by_semantic returns too-broad results and you need an exact phrase or ID inside an episode field. " +
+        "EXAMPLE: search_episodes_by_keyword query='convex deploy schema' namespace='orchestrator/sigma' limit=10.", {
+        query: z.string().describe("Search query text"),
+        namespace: z
+            .string()
+            .optional()
+            .describe("Namespace filter (e.g. 'orchestrator/sigma')"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Max items to return. Default 20 (envelope-safe). Cap 200."),
+        fields: z
+            .enum(["lite", "full"])
+            .optional()
+            .describe("'lite' returns compact payload (less tokens), 'full' is default."),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Search episodes by keyword (BM25)",
+    }, async ({ query, namespace, limit, fields }) => {
+        try {
+            const nsDenied = guardRead(namespace);
+            if (nsDenied)
+                return nsDenied;
+            const results = await convex.action("search:textSearch", {
+                query,
+                namespace,
+                type: "episode",
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
+    // ── search_episodes_by_semantic ────────────────────────────────────────────
+    // Day 102 v2.9.0 — episode entity 5-op surface (PR-B).
+    // Thin wrapper on search:recall with type='episode' forced.
+    server.tool("search_episodes_by_semantic", "Semantic vector search restricted to episodes (memories with type='episode'), ranked by cosine similarity. " +
+        "WHEN: use to recall structured past events by intent — failure modes, lessons, similar contexts. " +
+        "EXAMPLE: search_episodes_by_semantic query='hook false positive blocked publish' namespace='orchestrator/sigma' limit=20.", {
+        query: z
+            .string()
+            .describe("Natural language query to search for relevant episodes"),
+        namespace: z
+            .string()
+            .optional()
+            .describe("Filter to a specific namespace — omit to search all"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Max items to return. Default 20 (envelope-safe). Cap 200."),
+        fields: z
+            .enum(["lite", "full"])
+            .optional()
+            .describe("'lite' returns compact payload (less tokens), 'full' is default."),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Search episodes by semantic (vector cosine)",
+    }, async ({ query, namespace, limit, fields }) => {
+        try {
+            const nsDenied = guardRead(namespace);
+            if (nsDenied)
+                return nsDenied;
+            const results = await convex.action("search:recall", {
+                query,
+                namespace,
+                type: "episode",
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(results, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── get_profile ─────────────────────────────────────────────────────────────
     server.tool("get_profile", "Fetch an orchestrator profile with static identity and dynamic session state fields. " +
         "WHEN: use to check peer status, capabilities, or current task before assigning work. " +
@@ -3507,6 +3728,9 @@ export function registerTools(server, convex, oauthCtx) {
         }
     });
     // ── search_components ───────────────────────────────────────────────────────
+    // DEPRECATED (Day 102 v2.10.0) — alias of search_components_by_keyword.
+    // Retained for one minor version as a back-compat shim. New callers should
+    // use `search_components_by_keyword`. To be removed in 2.11.0.
     server.tool("search_components", 
     // S3.3 B8 follow-up batch 3 FINAL — DOCTRINE EXCEPTION.
     // @cursorPagingException relevance-ranked-not-chronological
@@ -3514,8 +3738,8 @@ export function registerTools(server, convex, oauthCtx) {
     // anchor would skip high-relevance older matches in favor of newer
     // low-relevance ones, breaking the search contract. Pagination on
     // semantic search should be score-based (offset / topK), not time-based.
-    "Search components by name or team substring with optional type filter. " +
-        "WHEN: use before register_component to check if a similar component already exists in the registry. " +
+    "DEPRECATED ALIAS of search_components_by_keyword — search components by name or team substring with optional type filter. " +
+        "WHEN: use before register_component to check if a similar component already exists in the registry. New callers: use search_components_by_keyword. " +
         "EXAMPLE: search_components query='check-tasks' type='skill' limit=10.", {
         query: z
             .string()
@@ -3557,6 +3781,52 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── search_components_by_keyword ───────────────────────────────────────────
+    // Day 102 v2.10.0 — canonical name under MCP CRUD baseline doctrine (PR-C).
+    // Mirrors search_components 1:1 (same Convex query `components:search`).
+    // search_components is retained as a deprecated alias until 2.11.0.
+    server.tool("search_components_by_keyword", "BM25 / substring keyword search over components by name or team with optional type filter. " +
+        "WHEN: use before register_component to check if a similar component already exists in the registry. " +
+        "EXAMPLE: search_components_by_keyword query='check-tasks' type='skill' limit=10.", {
+        query: z
+            .string()
+            .describe("Search term to match against component name or team"),
+        type: componentTypeSchema.optional().describe("Filter by component type"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Max items to return. Default 20 (envelope-safe). Cap 200."),
+        fields: z
+            .enum(["lite", "full"])
+            .optional()
+            .describe("'lite' returns compact payload (less tokens), 'full' is default."),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Search components by keyword",
+    }, async ({ query, type, limit, fields }) => {
+        try {
+            const results = await convex.query("components:search", {
+                query,
+                type,
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            const filteredResults = scopeFilterList(oauthCtx, Array.isArray(results) ? results : []);
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify(filteredResults, null, 2) },
+                ],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── create_recurring_task ───────────────────────────────────────────────────
     server.tool("create_recurring_task", "Create a recurring task template that auto-generates tasks on a cron schedule. " +
         "WHEN: use for daily standups, weekly reviews, or any repeating work item pattern. " +
@@ -4978,14 +5248,18 @@ export function registerTools(server, convex, oauthCtx) {
         }
     });
     // ── search_fix_patterns ─────────────────────────────────────────────────────
+    // DEPRECATED (Day 102 v2.10.0) — alias of search_fix_patterns_by_semantic.
+    // Underlying behavior is embedding-similarity ranking (NOT BM25), hence
+    // "_by_semantic" is the canonical suffix per the CRUD baseline doctrine.
+    // To be removed in 2.11.0.
     server.tool("search_fix_patterns", 
     // S3.3 B8 follow-up batch 3 FINAL — DOCTRINE EXCEPTION.
     // @cursorPagingException semantic-action-not-chronological
     // Rationale: backed by `convex.action("search:searchFixPatterns")` which
     // runs an embedding-similarity ranker; cursor paging by `createdBefore`
     // would corrupt relevance ordering. Same rationale as search_components.
-    "Semantic search over fix patterns by symptom description, ranked by relevance. " +
-        "WHEN: call BEFORE fixing any bug to check if a matching pattern exists and reuse the validated fix. " +
+    "DEPRECATED ALIAS of search_fix_patterns_by_semantic — semantic search over fix patterns by symptom description, ranked by relevance. " +
+        "WHEN: call BEFORE fixing any bug to check if a matching pattern exists and reuse the validated fix. New callers: use search_fix_patterns_by_semantic. " +
         "EXAMPLE: search_fix_patterns query='message disappears after sending on mobile' limit=5.", {
         query: z
             .string()
@@ -5028,6 +5302,53 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── search_fix_patterns_by_semantic ────────────────────────────────────────
+    // Day 102 v2.10.0 — canonical name under MCP CRUD baseline doctrine (PR-C).
+    // Mirrors search_fix_patterns 1:1 (same Convex action `search:searchFixPatterns`).
+    // search_fix_patterns is retained as a deprecated alias until 2.11.0.
+    server.tool("search_fix_patterns_by_semantic", "Semantic vector search over fix patterns by symptom description, ranked by relevance. " +
+        "WHEN: call BEFORE fixing any bug to check if a matching pattern exists and reuse the validated fix. " +
+        "EXAMPLE: search_fix_patterns_by_semantic query='message disappears after sending on mobile' limit=5.", {
+        query: z
+            .string()
+            .describe("Describe the problem — e.g. 'message disappears after sending'"),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(200)
+            .optional()
+            .describe("Max items to return. Default 20 (envelope-safe). Cap 200."),
+        fields: z
+            .enum(["lite", "full"])
+            .optional()
+            .describe("'lite' returns compact payload (less tokens), 'full' is default."),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Search fix patterns by semantic",
+    }, async ({ query, limit, fields }) => {
+        try {
+            const results = await convex.action("search:searchFixPatterns", {
+                query,
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            const filteredResults = scopeFilterList(oauthCtx, Array.isArray(results) ? results : []);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify(filteredResults, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── list_fix_patterns ───────────────────────────────────────────────────────
     server.tool("list_fix_patterns", "List fix patterns filtered by source project, newest first with cursor paging support. " +
         "WHEN: use to audit the knowledge base or review all patterns for a specific project. " +

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vantage-peers-mcp",
-  "version": "2.8.0",
+  "version": "2.10.0",
   "description": "MCP server for VantagePeers — shared memory, messaging, and task coordination for AI agent teams",
   "type": "module",
   "main": "./dist/server.js",