vantage-peers-mcp 2.5.0 → 2.7.0

package/CHANGELOG.md

@@ -1,5 +1,59 @@
 # Changelog
 
+## [2.7.0] — 2026-06-13 — Day 100 get_by_id surface Phase 2b (task k172735brsw6bc3j2dkkkfxqrx88kkjq)
+
+Phase 2b wires 2 MCP wrappers calling the Phase 2a Convex queries deployed
+in commit 2ebdaba (PR #735 + hotfix 7f958d0):
+
+- **get_message** — `messages:getById` plumbing. Fetch full message row by
+  Convex doc ID (channel, sender, sessionDay, tenant scope) for read-receipt
+  audit, delete confirmation, or fix-pattern referencing.
+- **get_recurring_task** — `recurringTasks:getById` plumbing. Fetch
+  recurring task definition (cron schedule, prompt, assignee, last-fire
+  metadata) before pause/update/delete.
+
+Both follow the existing `get_memory` / `get_briefing_note` pattern:
+`scopeFilterGet(oauthCtx, row)` for scope-aware cross-tenant collapse,
+read-only annotations.
+
+**get_episode** was DROPPED from Phase 2b scope: episodes are stored as
+memories with episode metadata (no separate `episodes` table in
+`convex/schema.ts`). Use existing `get_memory` to fetch episode rows by
+their memory document ID. Hotfix 7f958d0 removed the invalid
+`episodes:getById` query that broke `convex deploy` typecheck.
+
+Phase 2a CHANGELOG entry deferred — Convex changes shipped in main repo
+CHANGELOG, not mcp-server.
+
+Total MCP `get_*` tools after Phase 2b: 16 (was 14 after Phase 1, 10 before
+Day 100 task).
+
+## [2.6.0] — 2026-06-13 — Day 100 get_by_id surface Phase 1 (task k172735brsw6bc3j2dkkkfxqrx88kkjq)
+
+Pi reported get_<entity>_by_id MCP surface gaps observed during Day 100 fleet ops.
+Phase 1 adds 4 plumbing-only read tools mapping to pre-existing Convex queries:
+
+- **get_task** — `tasks:getById` plumbing. Fetch full task record (description, dependsOn,
+  missionId, completionNote, claimedByInstance, startedAt) by Convex doc ID.
+- **get_fix_pattern** — `fixPatterns:get` plumbing. Fetch fix pattern with full linked
+  fix attempts history.
+- **get_mandate** — `mandates:get` plumbing. Fetch spending mandate with limits, current
+  spend, approver chain for validateSpending/settleMandate pre-checks.
+- **get_repo_mapping** — `githubRepoMapping:getByRepo` plumbing. Fetch GitHub repo→VP project
+  mapping by repo slug.
+
+All 4 tools apply `scopeFilterGet(oauthCtx, row)` for scope-aware cross-tenant collapse,
+mirroring the existing `get_memory` / `get_briefing_note` pattern (Day 92 S3.1 wave).
+
+Annotations test (chatgpt-tool-annotations.test.ts) READ_ONLY_TOOLS set extended with
+the 4 new tools. Pre-existing 84/97 count mismatch in same test is unrelated (separate
+F-list track).
+
+Phase 2 (follow-on PR) will add get_message / get_episode / get_recurring_task
+(Convex query additions required).
+Phase 3 (separate mission) will audit deployment entity (table+queries+tool) and the
+cross-backend cloud proxy redeploy cadence.
+
 ## [2.5.0] — 2026-06-06 — Day 92 VP MCP quality overhaul (mission k57a36y8)
 
 Day 92 mission `k57a36y8w5t085bqr23dsmvb2d882506` ships a fleet-wide VP MCP quality bump

package/dist/src/tools.js

@@ -5725,4 +5725,172 @@ export function registerTools(server, convex, oauthCtx) {
             return mcpError(error.message ?? String(error));
         }
     });
+    // ── get_task ────────────────────────────────────────────────────────────────
+    // Day 100 — Phase 1 get_by_id surface fix (task k172735brsw6bc3j2dkkkfxqrx88kkjq).
+    // Pi reported get_<entity>_by_id surface incomplete. Convex tasks:getById exists.
+    server.tool("get_task", "Fetch a single task by its Convex document ID with all fields: title, description, status, priority, assignment, dependencies, mission link, completion note. " +
+        "WHEN: use when you have a specific taskId from list_tasks/create_task and need the full record (brief, VERIFICATION block, completionNote). " +
+        "EXAMPLE: get_task taskId='k172735brsw6bc3j2dkkkfxqrx88kkjq'.", {
+        taskId: z.string().describe("Task document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get task",
+    }, async ({ taskId }) => {
+        try {
+            const row = await convex.query("tasks:getById", { taskId });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Task not found: ${taskId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
+    // ── get_fix_pattern ─────────────────────────────────────────────────────────
+    // Day 100 — Phase 1 get_by_id surface fix. Convex fixPatterns:get exists.
+    server.tool("get_fix_pattern", "Fetch a single fix pattern by its Convex document ID, including all linked fix attempts. " +
+        "WHEN: use when you have a patternId from list_fix_patterns/search_fix_patterns and need the full record with attempts history. " +
+        "EXAMPLE: get_fix_pattern patternId='m9748paffd0emrbwyskj868e1x88kvhj'.", {
+        patternId: z.string().describe("Fix pattern document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get fix pattern",
+    }, async ({ patternId }) => {
+        try {
+            const row = await convex.query("fixPatterns:get", { patternId });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Fix pattern not found: ${patternId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
+    // ── get_mandate ─────────────────────────────────────────────────────────────
+    // Day 100 — Phase 1 get_by_id surface fix. Convex mandates:get exists.
+    server.tool("get_mandate", "Fetch a single spending mandate by its Convex document ID with limits, current spend, and approver chain. " +
+        "WHEN: use when you have a mandateId from list_mandates and need the full record before validateSpending/settleMandate. " +
+        "EXAMPLE: get_mandate mandateId='k57dy3049btafda9m2f5d2ggk987ph3f'.", {
+        mandateId: z.string().describe("Mandate document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get mandate",
+    }, async ({ mandateId }) => {
+        try {
+            const row = await convex.query("mandates:get", { mandateId });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Mandate not found: ${mandateId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
+    // ── get_repo_mapping ────────────────────────────────────────────────────────
+    // Day 100 — Phase 1 get_by_id surface fix. Convex githubRepoMapping:getByRepo exists.
+    // Lookup key is `repo` (string e.g. "vantageos-agency/vantage-peers-plugin"), not a doc ID.
+    server.tool("get_repo_mapping", "Fetch a single GitHub repo→VP project mapping by repo slug (owner/name). " +
+        "WHEN: use when you have a repo identifier (e.g. from a webhook or PR URL) and need the canonical VP project mapping. " +
+        "EXAMPLE: get_repo_mapping repo='vantageos-agency/vantage-peers-plugin'.", {
+        repo: z
+            .string()
+            .describe("GitHub repo slug in owner/name form (e.g. 'vantageos-agency/vantage-peers-plugin')"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get repo mapping",
+    }, async ({ repo }) => {
+        try {
+            const row = await convex.query("githubRepoMapping:getByRepo", {
+                repo,
+            });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Repo mapping not found: ${repo}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
+    // ── get_message ─────────────────────────────────────────────────────────────
+    // Day 100 — Phase 2b get_by_id surface fix (task k172735brsw6bc3j2dkkkfxqrx88kkjq).
+    // Convex messages:getById landed in Phase 2a (PR #735, commit 2ebdaba).
+    // Note: episodes were dropped from Phase 2b scope — episodes are stored as
+    // memories with episode metadata (no separate table), use get_memory instead.
+    server.tool("get_message", "Fetch a single peer message by its Convex document ID with full body, channel, sender, sessionDay, and tenant scope. " +
+        "WHEN: use when you have a messageId from list_messages/check_messages and need the raw row (e.g. for read-receipt audit, delete confirmation, or referencing in a fix pattern). " +
+        "EXAMPLE: get_message messageId='jn7eg21wdaxzdcpdxwkvhaxqnh88jqg2'.", {
+        messageId: z.string().describe("Message document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get message",
+    }, async ({ messageId }) => {
+        try {
+            const row = await convex.query("messages:getById", { messageId });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Message not found: ${messageId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
+    // ── get_recurring_task ──────────────────────────────────────────────────────
+    // Day 100 — Phase 2b get_by_id surface fix. Convex recurringTasks:getById
+    // landed in Phase 2a (PR #735, commit 2ebdaba).
+    server.tool("get_recurring_task", "Fetch a single recurring task definition by its Convex document ID with cron schedule, prompt, assignee, and last-fire metadata. " +
+        "WHEN: use when you have a recurringTaskId from list_recurring_tasks and need the full row before pause_recurring_task / update_recurring_task / delete_recurring_task. " +
+        "EXAMPLE: get_recurring_task recurringTaskId='k57dy3049btafda9m2f5d2ggk987ph3f'.", {
+        recurringTaskId: z.string().describe("Recurring task document ID"),
+    }, {
+        readOnlyHint: true,
+        openWorldHint: false,
+        destructiveHint: false,
+        title: "Get recurring task",
+    }, async ({ recurringTaskId }) => {
+        try {
+            const row = await convex.query("recurringTasks:getById", {
+                recurringTaskId,
+            });
+            const filtered = scopeFilterGet(oauthCtx, row);
+            if (filtered === null) {
+                return mcpError(`Recurring task not found: ${recurringTaskId}`);
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify(filtered, null, 2) }],
+            };
+        }
+        catch (error) {
+            return mcpError(error.message ?? String(error));
+        }
+    });
 }

package/package.json

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