wolfpack-mcp 1.0.115 → 1.0.116

package/README.md

@@ -285,6 +285,8 @@ Get a wiki page by ID or slug.
 
 - `page_id` (required): UUID or slug (e.g., "getting-started")
 
+Returns a `version` alongside the content. Quote it back as `expected_version` when you save.
+
 #### `create_wiki_page`
 
 Create a new wiki page.
@@ -298,8 +300,18 @@ Create a new wiki page.
 Update an existing wiki page.
 
 - `page_id` (required): The page UUID
+- `expected_version` (required): The `version` `get_wiki_page` returned
 - `title`, `content` (optional)
 
+**Read, then write.** `content` replaces the whole document, and wiki pages are edited by
+people at the same time as an agent, so a save made from a copy read earlier would throw away
+everything written since — which is what happened before #2681. `expected_version` is therefore
+required, and a save quoting a version somebody has moved past is refused with 409: read the
+page again, re-apply the change to what it says now, and save with the new version. Never
+re-send the copy you were holding.
+
+`create_wiki_page` is the exception — a page being created has no prior version.
+
 ### Journal Entries
 
 #### `list_journal_entries`

package/dist/index.js

@@ -508,6 +508,12 @@ const UpdateWikiPageSchema = z.object({
     page_id: z.string().describe('The page slug'),
     title: z.string().optional().describe('Updated title'),
     content: z.string().optional().describe('Updated content (markdown)'),
+    // Optional here, required by the server: a missing version is refused by the backend with
+    // a message saying how to get one, which is more use than a parser error (#2681).
+    expected_version: z
+        .string()
+        .optional()
+        .describe('The `version` get_wiki_page returned for this page'),
 });
 // Journal Entry schemas
 const ListJournalEntriesSchema = z.object({
@@ -1482,6 +1488,7 @@ class WolfpackMCPServer {
                         const page = await this.client.updateWikiPage(parsed.page_id, {
                             title: parsed.title,
                             content: parsed.content,
+                            expectedVersion: parsed.expected_version,
                         });
                         return {
                             content: [

package/dist/toolCatalogue.js

@@ -1036,6 +1036,8 @@ const SHARED_TOOLS = [
         name: 'get_wiki_page',
         permission: 'mcp:wiki:read',
         description: 'Get a specific wiki/documentation page by slug (URL path). Returns full content in markdown. ' +
+            'VERSION: the response carries a `version`. Pass it to update_wiki_page as expected_version when you save, ' +
+            'and read the page again — taking a fresh version — if the save is refused because somebody changed it. ' +
             'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
         inputSchema: {
             type: 'object',
@@ -1076,7 +1078,13 @@ const SHARED_TOOLS = [
     {
         name: 'update_wiki_page',
         permission: 'mcp:wiki:update',
-        description: 'Update an existing wiki page. Requires mcp:wiki:update permission. ' + CONTENT_LINKING_HELP,
+        description: 'Update an existing wiki page. Requires mcp:wiki:update permission. ' +
+            'READ BEFORE YOU WRITE: call get_wiki_page first and pass the `version` it returned as expected_version. ' +
+            'Wiki pages are edited by people at the same time as you, and `content` replaces the whole document, ' +
+            'so a save made from a copy you read earlier would throw away everything written since. ' +
+            'If the save is refused because the page changed, do NOT send the same content again: ' +
+            'call get_wiki_page, re-apply your change to what the page says now, and save with the new version. ' +
+            CONTENT_LINKING_HELP,
         // No tag_ids and no project_slug: `PATCH /api/mcp/wiki-pages/{pageId}` has
         // neither. The body model is `additionalProperties: false`, so a call
         // carrying tags was refused outright rather than ignored, and the page
@@ -1092,8 +1100,13 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Updated content (markdown)',
                 },
+                expected_version: {
+                    type: 'string',
+                    description: 'The `version` get_wiki_page returned for this page. Required: the save is refused if ' +
+                        'somebody has changed the page since, so that their edit is not thrown away.',
+                },
             },
-            required: ['page_id'],
+            required: ['page_id', 'expected_version'],
         },
     },
     // Journal Entry tools

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.115",
+  "version": "1.0.116",
   "description": "MCP server for Clachan (formerly Wolfpack), AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",