vantage-peers-mcp 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## [2.11.0] — 2026-06-14 — Day 102 CRUD baseline PR-C-bis option B: 3-entity Convex searchIndex (mission k575kc1ryps0n8br95jw3q7d0x88m2v9)
+
+Mission `mcp-crud-baseline-standard` PR-C-bis under T2. Pi-sequenced follow-up after PR-C (rename-only safe subset) — implements **option B SCOPED** per Pi arbitrage msg `jn7abynmghy5qdr9ga0b914wmh88n99w` ("GO option B SCOPED — démarre PR-C avec 3 entités prioritaires"): tasks + messages + briefingNotes get native Convex BM25 search via `.searchIndex()` schema additions + per-entity Convex queries + MCP tool wrappers.
+
+Backend choice (B over A): Convex native `.searchIndex()` is BM25-only, no embeddings, no RAG per-entity pipeline. Sub-linear scan stays in the same backend without spinning up an embedding pipeline per table. Hybrid/semantic per entity remains a future RFC.
+
+### Added — Convex schema searchIndex (3 tables)
+
+- `tasks` → `searchIndex("search_title", { searchField: "title", filterFields: ["assignedTo", "status", "project", "missionId", "orgId"] })`
+- `messages` → `searchIndex("search_content", { searchField: "content", filterFields: ["from", "channel", "sessionDay", "tenantId"] })`
+- `briefingNotes` → `searchIndex("search_content", { searchField: "content", filterFields: ["topic", "createdBy", "orgId"] })`
+
+### Added — Convex query functions
+
+- `tasks:searchTasksByKeyword` — BM25 over title with assignedTo/status/project/missionId filters + scope gate via `withOrgScope` + `filterByOrgScope` + `requireScope("view-own-tasks")`. Lite/full projection.
+- `messages:searchMessagesByKeyword` — BM25 over content with from/channel/sessionDay/tenantId filters.
+- `briefingNotes:searchBriefingNotesByKeyword` — BM25 over content with topic/createdBy filters.
+
+All three: 20-item default limit, 200 cap, lite projection on demand.
+
+### Added — MCP tool wrappers (3 canonical)
+
+- **`search_tasks_by_keyword`** — wires to `tasks:searchTasksByKeyword`. `readOnlyHint=true`.
+- **`search_messages_by_keyword`** — wires to `messages:searchMessagesByKeyword`. `readOnlyHint=true`.
+- **`search_briefing_notes_by_keyword`** — wires to `briefingNotes:searchBriefingNotesByKeyword`. `readOnlyHint=true`.
+
+### Why option B (and why scoped to 3)
+
+`grep searchIndex convex/schema.ts` previously returned zero hits; only `memories` had search infrastructure (via `@convex-dev/rag`). The original "13-entity cluster" full scope was deferred via PR-C (rename-only) after arbitrage timeout. Pi's arbitrage landed shortly after: **option B SCOPED to 3 priority entities** is the right blend of doctrine progress + bounded scope:
+- `tasks` — largest fleet audience (Eta T13 close-issue scan, dispatch-task-find, etc.).
+- `messages` — post-incident audit + messages-history skill demand.
+- `briefingNotes` — daily snapshot recall narrative.
+
+The remaining 10 entities (mission/mandate/fix_pattern/component/repo_mapping/bu/profile/deployment/diary/error/issue/recurring_task/summary) go to a per-entity RFC (mission walk-through scheduled Wed 17 June 15h with Laurent) — each entity decides B (searchIndex), A (RAG if semantic justified, e.g. episodes/diary), or N/A semantic documented (deployment/repo_mapping).
+
+### Version sync
+
+- `mcp-server/server.ts:115` SERVER_VERSION 2.10.0 → 2.11.0
+- `mcp-server/package.json` → 2.11.0
+- README + 4 cloud docs bumped to 2.11.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 3 new canonical tool names.
+
+### Refs
+
+- Mission `k575kc1ryps0n8br95jw3q7d0x88m2v9`.
+- Pi sequencing dispatch: msg `jn76360ckrrkwpqbfwa6tst7k588mpsh` ("(1) T2 PR-C-bis option B SCOPED 3 entities").
+- Pi arbitrage that selected option B: msg `jn7abynmghy5qdr9ga0b914wmh88n99w`.
+- Audit T1: `analysis/mcp-crud-baseline-vp-audit-2026-06-14.md` rows 1 (task), 3 (message), 4 (briefing_note).
+- Doctrine memory: `j57dhrmkzjerjtssnr0z9ba57n88n7q7` (5 ops per entity).
+- Predecessors: PR-A 2.8.0 (memories canonical), PR-B 2.9.0 (episode 5-op), PR-C 2.10.0 (rename-only safe subset).
+
 ## [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.

package/README.md

@@ -242,7 +242,7 @@ Example:
 ### Session (1)
 `set_summary`
 
-## Compact payloads and status aliases (v2.10.0 — feature since v2.3.0)
+## Compact payloads and status aliases (v2.11.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.10.0",
+    version: "2.11.0",
 });
 // ─────────────────────────────────────────────────────────────────────────────
 // Helper: structured error response for MCP tool handlers

package/dist/src/tools.js

@@ -2111,6 +2111,60 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── search_messages_by_keyword ─────────────────────────────────────────────
+    // Day 102 v2.11.0 — CRUD baseline PR-C-bis option B (mission k575kc1r).
+    // BM25 keyword search over message content. Backed by Convex
+    // `messages:searchMessagesByKeyword` using the `search_content` searchIndex.
+    server.tool("search_messages_by_keyword", "BM25 full-text keyword search over message content, ranked by relevance. " +
+        "WHEN: use for post-incident audit or to find peer DMs by topic — e.g. 'find messages about deploy' across the recent sessionDay window. " +
+        "EXAMPLE: search_messages_by_keyword query='convex deploy' from='pi' sessionDay=102 limit=10.", {
+        query: z.string().describe("Search term to match against message content"),
+        from: z.string().optional().describe("Filter by sender role"),
+        channel: z
+            .string()
+            .optional()
+            .describe("Filter by channel — e.g. 'sigma', 'broadcast'"),
+        sessionDay: z
+            .number()
+            .int()
+            .optional()
+            .describe("Filter to a specific session day"),
+        tenantId: z.string().optional().describe("Filter by tenant id"),
+        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 messages by keyword (BM25)",
+    }, async ({ query, from, channel, sessionDay, tenantId, limit, fields }) => {
+        try {
+            const results = await convex.query("messages:searchMessagesByKeyword", {
+                query,
+                from,
+                channel,
+                sessionDay,
+                tenantId,
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── list_broadcast_status ───────────────────────────────────────────────────
     // S3.3 B8 follow-up batch 3 FINAL — DOCTRINE EXCEPTION.
     // @cursorPagingException single-object-shape-not-list
@@ -2351,6 +2405,63 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── search_tasks_by_keyword ────────────────────────────────────────────────
+    // Day 102 v2.11.0 — CRUD baseline PR-C-bis option B (mission k575kc1r).
+    // BM25 keyword search over task titles. Backed by Convex `tasks:searchTasksByKeyword`
+    // which uses the `search_title` searchIndex. Filter axes: assignedTo, status,
+    // project, missionId — all pushed into the index for sub-linear scan.
+    server.tool("search_tasks_by_keyword", "BM25 full-text keyword search over task titles, ranked by relevance. " +
+        "WHEN: use to find tasks by topic/keyword when list_tasks filters are too broad — e.g. 'find tasks about hook' across all assignees. " +
+        "EXAMPLE: search_tasks_by_keyword query='hook PostToolUse' status='todo' limit=10.", {
+        query: z.string().describe("Search term to match against task title"),
+        assignedTo: z
+            .string()
+            .optional()
+            .describe("Filter by assignee role"),
+        status: z
+            .enum(["todo", "in_progress", "review", "blocked", "done"])
+            .optional()
+            .describe("Filter by status"),
+        project: z.string().optional().describe("Filter by project name"),
+        missionId: z
+            .string()
+            .optional()
+            .describe("Filter by mission Convex ID"),
+        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 tasks by keyword (BM25)",
+    }, async ({ query, assignedTo, status, project, missionId, limit, fields }) => {
+        try {
+            const results = await convex.query("tasks:searchTasksByKeyword", {
+                query,
+                assignedTo,
+                status,
+                project,
+                missionId,
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── update_task ─────────────────────────────────────────────────────────────
     server.tool("update_task", "Update any mutable field on a task; only provided fields are patched, updatedAt auto-set. " +
         "WHEN: use to reassign, reprioritize, or add context to an existing task without recreating it. " +
@@ -3477,6 +3588,51 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpConvexError(error);
         }
     });
+    // ── search_briefing_notes_by_keyword ────────────────────────────────────────
+    // Day 102 v2.11.0 — CRUD baseline PR-C-bis option B (mission k575kc1r).
+    // BM25 keyword search over briefing note content. Backed by Convex
+    // `briefingNotes:searchBriefingNotesByKeyword` using the `search_content` searchIndex.
+    server.tool("search_briefing_notes_by_keyword", "BM25 full-text keyword search over briefing note content, ranked by relevance. " +
+        "WHEN: use to recall briefings about a topic/decision when list_briefing_notes filters are too coarse — e.g. 'find briefings about migration plan'. " +
+        "EXAMPLE: search_briefing_notes_by_keyword query='migration plan' topic='daily' limit=10.", {
+        query: z
+            .string()
+            .describe("Search term to match against briefing note content"),
+        topic: z.string().optional().describe("Filter by topic"),
+        createdBy: z.string().optional().describe("Filter by creator role"),
+        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 briefing notes by keyword (BM25)",
+    }, async ({ query, topic, createdBy, limit, fields }) => {
+        try {
+            const results = await convex.query("briefingNotes:searchBriefingNotesByKeyword", {
+                query,
+                topic,
+                createdBy,
+                limit: limit ?? 20,
+                fields: fields ?? "lite",
+            });
+            return {
+                content: [{ type: "text", text: JSON.stringify(results, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpConvexError(error);
+        }
+    });
     // ── register_component ──────────────────────────────────────────────────────
     server.tool("register_component", "Register or upsert a component (agent/skill/hook/plugin) in the VantagePeers registry by name+type. " +
         "WHEN: use when publishing a new version of an agent skill or hook so peers can discover and use it. " +

package/package.json

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