wolfpack-mcp 1.0.115 → 1.0.117

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/client.js

@@ -196,9 +196,9 @@ export class WolfpackClient {
             throw error;
         }
     }
-    async updateWorkProgress(workItemId, description, teamSlug) {
+    async updateWorkProgress(workItemId, body, teamSlug) {
         try {
-            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/progress`, teamSlug), { description });
+            return await this.api.put(this.withTeamSlug(`/work-items/${workItemId}/progress`, teamSlug), body);
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {
@@ -389,6 +389,20 @@ export class WolfpackClient {
     async updateIssue(issueId, data, teamSlug) {
         return this.api.patch(this.withTeamSlug(`/issues/${issueId}`, teamSlug), data);
     }
+    /**
+     * An entity's change timeline (#2684). `project_slug` is only needed to resolve a refId,
+     * so `withTeamSlug` supplies the configured project when the caller names none.
+     */
+    async getTimeline(entityType, entityId, options) {
+        const params = new URLSearchParams();
+        if (options?.since)
+            params.append('since', options.since);
+        if (options?.limit !== undefined)
+            params.append('limit', options.limit.toString());
+        const query = params.toString();
+        const path = `/timeline/${encodeURIComponent(entityType)}/${encodeURIComponent(entityId)}`;
+        return this.api.get(this.withTeamSlug(`${path}${query ? `?${query}` : ''}`, options?.teamSlug));
+    }
     // Wiki Page methods
     async listWikiPages(options) {
         const params = new URLSearchParams();
@@ -420,9 +434,16 @@ export class WolfpackClient {
         }
         return this.fetchAllPages('/wiki-pages', params);
     }
-    async getWikiPage(pageId) {
+    async getWikiPage(pageId, view) {
+        const params = new URLSearchParams();
+        if (view?.mode)
+            params.append('mode', view.mode);
+        // Repeated rather than joined: the route takes an array, and a heading can contain
+        // whatever punctuation a separator would have claimed.
+        view?.section?.forEach((heading) => params.append('section', heading));
+        const query = params.toString();
         try {
-            return await this.api.get(`/wiki-pages/${encodeURIComponent(pageId)}`);
+            return await this.api.get(`/wiki-pages/${encodeURIComponent(pageId)}${query ? `?${query}` : ''}`);
         }
         catch (error) {
             if (error && typeof error === 'object' && 'status' in error && error.status === 404) {

package/dist/index.js

@@ -110,13 +110,29 @@ const GetWorkItemSchema = z.object({
     work_item_id: refIdString().describe('The refId (number) of the work item'),
     project_slug: z.string().optional().describe('Project slug (required when looking up by refId)'),
 });
+/**
+ * One targeted edit. Loose on purpose: which fields a given `type` needs is the backend's rule,
+ * said once in `contentEditService`, and a second copy here would be the thing that drifts
+ * (#2679). The refusals it raises are written to be read by whoever sent the edit.
+ */
+const ContentEditSchema = z.object({
+    type: z.string().describe('replace, replace_section, append_to_section, …'),
+    old: z.string().optional().describe('replace: the text to find, which must occur exactly once'),
+    new: z.string().optional().describe('replace: what to put in its place'),
+    section: z.array(z.string()).optional().describe('Section operations: the heading path'),
+    content: z.string().optional().describe('Section operations: the markdown to put there'),
+});
 const UpdateWorkProgressSchema = z.object({
     work_item_id: refIdString().describe('The ID of the work item'),
-    description: z.string().describe('Updated description/notes for the work item'),
+    description: z.string().optional().describe('Updated description/notes for the work item'),
     project_slug: z
         .string()
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `description` instead of sending it in full'),
 });
 /** The risk vocabulary, as the backend's `VALID_RISKS` holds it. */
 const VALID_RISKS = ['High', 'Medium', 'Low'];
@@ -200,6 +216,10 @@ const UpdateWorkItemSchema = z.object({
         .string()
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `description` instead of sending it in full'),
 });
 const PullWorkItemSchema = z.object({
     work_item_id: refIdString().describe('The ID of the work item to pull from backlog'),
@@ -335,6 +355,10 @@ const UpdateRadarItemSchema = z.object({
         .string()
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `description` instead of sending it in full'),
 });
 // Issue schemas
 const ListIssuesSchema = z.object({
@@ -453,6 +477,10 @@ const UpdateIssueSchema = z.object({
         .string()
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `description` instead of sending it in full'),
 });
 // Search schema
 const SearchSchema = z.object({
@@ -487,6 +515,24 @@ const ListWikiPagesSchema = z.object({
 });
 const GetWikiPageSchema = z.object({
     page_id: z.string().describe('The page slug'),
+    mode: z
+        .enum(['full', 'outline'])
+        .optional()
+        .describe('"outline" returns the heading tree and no content'),
+    section: z
+        .array(z.string())
+        .optional()
+        .describe('Read one section by heading path, outermost first'),
+});
+// Timeline schema (#2684). `entity_type` is left a plain string: the backend refuses an
+// unknown one with a message naming the types that have a timeline, which tells the caller
+// more than a parser error would.
+const GetTimelineSchema = z.object({
+    entity_type: z.string().describe('The kind of content whose history you want'),
+    entity_id: z.string().describe('The page slug, or the refId for everything else'),
+    project_slug: z.string().optional().describe('Project slug, needed to resolve a refId'),
+    since: z.coerce.string().optional().describe('Only changes at or after this moment (ISO 8601)'),
+    limit: z.number().optional().describe('Maximum number of changes to return'),
 });
 const CreateWikiPageSchema = z.object({
     project_slug: z
@@ -507,7 +553,18 @@ const CreateWikiPageSchema = z.object({
 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)'),
+    content: z.string().optional().describe('Updated content (markdown) — replaces the whole page'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply instead of sending the whole page'),
+    // Optional here, required by the server for everything but a `replace` edit: 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` from the read this write is based on'),
 });
 // Journal Entry schemas
 const ListJournalEntriesSchema = z.object({
@@ -544,6 +601,10 @@ const UpdateJournalEntrySchema = z.object({
         .string()
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `content` instead of sending it in full'),
 });
 // Idea schemas (the Idea Factory)
 const PROJECT_SLUG_DESCRIPTION = 'Project slug (required for multi-project users, use list_projects to get slugs)';
@@ -571,6 +632,10 @@ const UpdateIdeaSchema = z.object({
     content: z.string().optional().describe('Updated content (markdown)'),
     stage: z.string().optional().describe('New stage: spark, exploring, building, shipped or parked'),
     project_slug: z.string().optional().describe(PROJECT_SLUG_DESCRIPTION),
+    edits: z
+        .array(ContentEditSchema)
+        .optional()
+        .describe('Targeted edits to apply to `content` instead of sending it in full'),
 });
 const BoostIdeaSchema = z.object({
     idea_id: refIdString().describe('The idea refId (number)'),
@@ -926,6 +991,21 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text }],
                         };
                     }
+                    // Timeline handler (#2684)
+                    case 'get_timeline': {
+                        const parsed = GetTimelineSchema.parse(args);
+                        const timeline = await this.client.getTimeline(parsed.entity_type, parsed.entity_id, {
+                            teamSlug: parsed.project_slug || this.client.getProjectSlug() || undefined,
+                            since: parsed.since,
+                            limit: parsed.limit,
+                        });
+                        const text = timeline.changes.length === 0
+                            ? `No changes recorded${parsed.since ? ` since ${parsed.since}` : ''} for ${parsed.entity_type} ${parsed.entity_id}.`
+                            : JSON.stringify(stripUuids(timeline), null, 2);
+                        return {
+                            content: [{ type: 'text', text }],
+                        };
+                    }
                     // Work Item handlers
                     case 'list_work_items': {
                         const parsed = ListWorkItemsSchema.parse(args);
@@ -983,7 +1063,7 @@ class WolfpackMCPServer {
                     case 'update_work_progress': {
                         const parsed = UpdateWorkProgressSchema.parse(args);
                         const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
-                        const workItem = await this.client.updateWorkProgress(parsed.work_item_id, parsed.description, teamSlug);
+                        const workItem = await this.client.updateWorkProgress(parsed.work_item_id, { description: parsed.description, edits: parsed.edits }, teamSlug);
                         if (workItem) {
                             // Writing a description is not a claim that work has started: it is also how a
                             // plan is added before pickup and how the record is tidied after handover, so
@@ -1046,6 +1126,8 @@ class WolfpackMCPServer {
                             fields.tags = parsed.tags;
                         if (parsed.closing_comment !== undefined)
                             fields.closingComment = parsed.closing_comment;
+                        if (parsed.edits !== undefined)
+                            fields.edits = parsed.edits;
                         const workItem = await this.client.updateWorkItem(parsed.work_item_id, fields, teamSlug);
                         if (workItem) {
                             // Build a summary of what changed
@@ -1300,6 +1382,7 @@ class WolfpackMCPServer {
                             description: parsed.description,
                             notes: parsed.notes,
                             stage: parsed.stage,
+                            edits: parsed.edits,
                         }, teamSlug);
                         return {
                             content: [
@@ -1419,6 +1502,7 @@ class WolfpackMCPServer {
                             expectedBehavior: parsed.expected_behavior,
                             actualBehavior: parsed.actual_behavior,
                             tags: parsed.tags,
+                            edits: parsed.edits,
                         }, teamSlug);
                         return {
                             content: [
@@ -1450,7 +1534,10 @@ class WolfpackMCPServer {
                     }
                     case 'get_wiki_page': {
                         const parsed = GetWikiPageSchema.parse(args);
-                        const page = await this.client.getWikiPage(parsed.page_id);
+                        const page = await this.client.getWikiPage(parsed.page_id, {
+                            mode: parsed.mode,
+                            section: parsed.section,
+                        });
                         if (page) {
                             return {
                                 content: [{ type: 'text', text: JSON.stringify(stripUuids(page), null, 2) }],
@@ -1482,6 +1569,8 @@ class WolfpackMCPServer {
                         const page = await this.client.updateWikiPage(parsed.page_id, {
                             title: parsed.title,
                             content: parsed.content,
+                            edits: parsed.edits,
+                            expectedVersion: parsed.expected_version,
                         });
                         return {
                             content: [
@@ -1545,6 +1634,7 @@ class WolfpackMCPServer {
                         const entry = await this.client.updateJournalEntry(parsed.entry_id, {
                             title: parsed.title,
                             content: parsed.content,
+                            edits: parsed.edits,
                         }, teamSlug);
                         return {
                             content: [
@@ -1598,7 +1688,12 @@ class WolfpackMCPServer {
                     }
                     case 'update_idea': {
                         const parsed = UpdateIdeaSchema.parse(args);
-                        const idea = await this.client.updateIdea(parsed.idea_id, { title: parsed.title, content: parsed.content, stage: parsed.stage }, parsed.project_slug || this.client.getProjectSlug() || undefined);
+                        const idea = await this.client.updateIdea(parsed.idea_id, {
+                            title: parsed.title,
+                            content: parsed.content,
+                            stage: parsed.stage,
+                            edits: parsed.edits,
+                        }, parsed.project_slug || this.client.getProjectSlug() || undefined);
                         return {
                             content: [
                                 {

package/dist/toolCatalogue.js

@@ -50,6 +50,80 @@ const CONTENT_LINKING_HELP = 'CROSS-REFERENCES: In any markdown content, you can
     '#j123 or #journal-123 for journal entries, #c123 or #case-123 for cases, #p123 or #proc-123 for procedures. ' +
     'Use @username to mention team members (triggers notifications). ' +
     'Standard markdown links also work: [link text](/project/{slug}/work-items/123).';
+/**
+ * How to change part of a stored body instead of sending it all back (#2679).
+ *
+ * Said once because seven update tools carry it, and an agent that learned the contract on one
+ * of them has to find the same contract on the next.
+ */
+const EDITS_HELP = 'SURGICAL EDITS: prefer `edits` to sending `content` in full. It costs a fraction of the ' +
+    'tokens, and it cannot corrupt the parts of the document you did not mean to touch. ' +
+    'Edits apply in order, all or nothing: if any one of them fails, nothing is written. ' +
+    '`{"type": "replace", "old": "...", "new": "..."}` swaps one exact run of text, which must ' +
+    'occur exactly once — quote enough of the surrounding lines to make it unique. Whitespace and ' +
+    'indentation are compared exactly. A failed match tells you how many times it matched and ' +
+    'shows the closest lines, so you can correct the quote without re-reading the document.';
+/**
+ * The section operations, offered only where the body is markdown and carries a version.
+ *
+ * `delete_section` removes part of a document; it is not a delete tool in the sense this
+ * package's CLAUDE.md forbids, which is about destroying an entity. The same removal has always
+ * been expressible by sending a shorter `content`, and nothing here reaches an entity the
+ * caller could not already edit.
+ */
+const SECTION_EDITS_HELP = 'Markdown sections can also be addressed by heading path, which is stable where a line number ' +
+    'is not: `replace_section`, `append_to_section`, `insert_before_section`, ' +
+    '`insert_after_section` and `delete_section` take `section` (e.g. ["Deployment", "Rollback"]) ' +
+    'and, except for the delete, `content`. They act on the heading and everything nested under ' +
+    'it. Because they quote no text of their own they REQUIRE `expected_version` from the read ' +
+    'they are based on. Call get_wiki_page with mode="outline" to see the heading paths.';
+const REPLACE_ONLY_EDIT_TYPES = ['replace'];
+const ALL_EDIT_TYPES = [
+    'replace',
+    'replace_section',
+    'append_to_section',
+    'insert_before_section',
+    'insert_after_section',
+    'delete_section',
+];
+/** The `edits` property, with the section operations only where they are supported. */
+function editsSchema(sections) {
+    return {
+        type: 'array',
+        description: sections
+            ? 'Targeted edits to apply to the stored content instead of replacing it. Mutually exclusive with `content`.'
+            : 'Targeted edits to apply to the stored content instead of replacing it. Mutually exclusive with `content`. This content type takes `replace` only.',
+        items: {
+            type: 'object',
+            properties: {
+                type: {
+                    type: 'string',
+                    enum: sections ? ALL_EDIT_TYPES : REPLACE_ONLY_EDIT_TYPES,
+                    description: 'Which operation to apply.',
+                },
+                old: {
+                    type: 'string',
+                    description: '`replace`: the text to find. Must occur exactly once. Whitespace is exact.',
+                },
+                new: { type: 'string', description: '`replace`: what to put in its place.' },
+                ...(sections
+                    ? {
+                        section: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Section operations: the heading path, outermost first. The trailing headings alone are enough while they are unambiguous.',
+                        },
+                        content: {
+                            type: 'string',
+                            description: 'Section operations other than `delete_section`: the markdown to put there.',
+                        },
+                    }
+                    : {}),
+            },
+            required: ['type'],
+        },
+    };
+}
 /**
  * The risk vocabulary, said the same way on every tool that carries it (#2633).
  *
@@ -147,6 +221,65 @@ const SHARED_TOOLS = [
             required: ['query'],
         },
     },
+    // Timeline tool (#2684)
+    {
+        name: 'get_timeline',
+        // Takes the read scope of whatever it is asked about — `mcp:wiki:read` for a page,
+        // `mcp:work_items:read` for a work item — and checks it per entity type, so it
+        // declares none of its own. Reading a page's history is reading the page.
+        permission: null,
+        description: 'Read what has changed on one piece of content, newest change first: who changed it, when, ' +
+            'and what the change was. Every kind of content with a timeline is read through this one tool. ' +
+            'WHAT YOU GET BACK: each change carries a `summary`, and the fields it touched split two ways — ' +
+            '`fieldChanges` (short values, as `from` and `to`) and `diffs` (long or multi-line values, as a ' +
+            'unified `diff -u` patch of the lines that changed). A change with neither, such as an approval ' +
+            'or a comment, is described by its `summary` alone. ' +
+            'SINCE IT WAS LAST APPROVED: approvals are changes on the same timeline, so read the timeline, ' +
+            'find the newest change whose `category` is "approval", and call again with `since` set to its ' +
+            '`timestamp` — what comes back is everything that has happened to the content since it was signed off. ' +
+            'PERMISSIONS: this needs the same read permission as reading the content itself (mcp:wiki:read for a ' +
+            'page, mcp:work_items:read for a work item, and so on) and nothing further. Each timeline is that ' +
+            "one thing's own history: a case's timeline does not include the work items raised from it, so read " +
+            'those with entity_type "work_item" and the refId of the item you want.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                entity_type: {
+                    type: 'string',
+                    enum: [
+                        'wiki_page',
+                        'work_item',
+                        'issue',
+                        'radar_item',
+                        'journal_entry',
+                        'procedure',
+                        'case',
+                    ],
+                    description: 'The kind of content whose history you want',
+                },
+                entity_id: {
+                    type: 'string',
+                    description: 'The reference you already hold: the slug for a wiki page, the refId (number) for ' +
+                        'everything else — a work item\'s "123", an issue\'s "45".',
+                },
+                project_slug: {
+                    type: 'string',
+                    description: 'Project slug; required with a refId when you belong to more than one project ' +
+                        '(use list_projects to get slugs)',
+                },
+                since: {
+                    type: 'string',
+                    description: 'Only changes at or after this moment (ISO 8601, e.g. "2026-10-07T09:00:00Z"). Pass an ' +
+                        "approval change's `timestamp` to see what has changed since the content was approved.",
+                },
+                limit: {
+                    type: 'number',
+                    description: 'Maximum number of changes to return; defaults to 20',
+                },
+            },
+            required: ['entity_type', 'entity_id'],
+        },
+    },
     // Work Item tools
     {
         name: 'list_work_items',
@@ -282,7 +415,8 @@ const SHARED_TOOLS = [
             'STATUS: This tool never changes status — editing the description is also how a plan is added before pickup and how the record is tidied after handover (#2634). The response names the status it left the item in. Moving an item is always your own call: pull_work_item to start it, update_work_item to set "doing" when you pick it back up, and "review" with a completion comment when it is done. ' +
             'CRITICAL: NEVER overwrite or remove the original description text. Preserve all existing content exactly as-is. Append your plan below a "---" separator. You may only modify content you previously added (your plan section). ' +
             'BEST PRACTICE: Append a plan with markdown checkboxes (- [ ] task). Check off completed tasks (- [x] task) as you progress. Include sections for: Plan (checklist), Approach (strategy), and Notes (discoveries/decisions). ' +
-            CONTENT_LINKING_HELP,
+            CONTENT_LINKING_HELP +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -295,8 +429,9 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
-            required: ['work_item_id', 'description'],
+            required: ['work_item_id'],
         },
     },
     {
@@ -315,7 +450,8 @@ const SHARED_TOOLS = [
             'what makes the board show who is working on what. ' +
             'When moving to "review", add a completion comment via create_work_item_comment. When moving to "blocked", add a comment explaining the blocker. ' +
             'When you take an item back out of "review" to rework it, set it to "doing" first — an item being changed is not an item waiting to be reviewed. ' +
-            'closing_comment is only accepted together with status "closed" — never use it for progress or completion notes.',
+            'closing_comment is only accepted together with status "closed" — never use it for progress or completion notes.' +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -404,6 +540,7 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
             required: ['work_item_id'],
         },
@@ -720,7 +857,8 @@ const SHARED_TOOLS = [
         name: 'update_radar_item',
         permission: 'mcp:radar:update',
         description: 'Update an existing radar/initiative item. Requires mcp:radar:update permission. ' +
-            CONTENT_LINKING_HELP,
+            CONTENT_LINKING_HELP +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -743,6 +881,7 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
             required: ['item_id'],
         },
@@ -951,7 +1090,8 @@ const SHARED_TOOLS = [
             'empty array clears it. Tagging an issue that is not assigned to you needs ' +
             'mcp:issues:tag_all, and that scope allows a tags-only update — send any other ' +
             'field alongside and the usual assignment rule applies. ' +
-            CONTENT_LINKING_HELP,
+            CONTENT_LINKING_HELP +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -999,6 +1139,7 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
             required: ['issue_id'],
         },
@@ -1036,6 +1177,12 @@ 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. ' +
+            'LONG PAGES: pass mode="outline" first to see the heading tree and the size of each section, ' +
+            'then section=["Heading"] to read just the one you need — far cheaper than reading the page. ' +
+            'VERSION: every 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. ' +
+            'APPROVALS: `approvals` lists who has signed the page off as it currently reads, with the date each ' +
+            'approved. It is empty if nobody has, and an approval the page has been edited past is not listed. ' +
             'IMAGES: Image references in the content (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
         inputSchema: {
             type: 'object',
@@ -1044,6 +1191,20 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'The page slug (URL path like "getting-started")',
                 },
+                mode: {
+                    type: 'string',
+                    enum: ['full', 'outline'],
+                    description: '"full" (default) returns the page content. "outline" returns the heading tree — ' +
+                        'heading path, level, line range and size — and no content.',
+                },
+                section: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Read one section instead of the page. A heading path, outermost first, e.g. ' +
+                        '["Deployment", "Rollback"]. The trailing headings alone are enough while they are ' +
+                        'unambiguous, so ["Rollback"] usually works. Returns the heading and everything ' +
+                        'nested under it.',
+                },
             },
             required: ['page_id'],
         },
@@ -1076,7 +1237,17 @@ 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. ' +
+            EDITS_HELP +
+            ' ' +
+            SECTION_EDITS_HELP +
+            ' READ BEFORE YOU WRITE: wiki pages are edited by people at the same time as you. A `content` write ' +
+            'replaces the whole document, so a save made from a copy you read earlier would throw away everything ' +
+            'written since — call get_wiki_page first and pass the `version` it returned as expected_version, ' +
+            'which is required for `content` and for a section operation. ' +
+            '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
@@ -1090,9 +1261,22 @@ const SHARED_TOOLS = [
                 title: { type: 'string', description: 'Updated title' },
                 content: {
                     type: 'string',
-                    description: 'Updated content (markdown)',
+                    description: 'Updated content (markdown). Replaces the whole page — prefer `edits` for anything smaller.',
+                },
+                edits: editsSchema(true),
+                expected_version: {
+                    type: 'string',
+                    description: 'The `version` from the get_wiki_page read this write is based on. The save is ' +
+                        'refused with a conflict if the page changed since, naming who changed it — re-read ' +
+                        'and re-apply, so that their edit is not thrown away. Required for `content`, and ' +
+                        'for `edits` containing a section operation; a `replace` edit quotes the exact text ' +
+                        'it rewrites, which is a stronger precondition over the only region it touches.',
                 },
             },
+            // `expected_version` is required for everything except a `replace` edit, which is the one
+            // request that quotes its own precondition — so the rule is stated on the field and
+            // enforced by the route (#2679 / #2681) rather than written as a schema the caller has to
+            // satisfy before the refusal can explain itself.
             required: ['page_id'],
         },
     },
@@ -1167,7 +1351,8 @@ const SHARED_TOOLS = [
         name: 'update_journal_entry',
         permission: 'mcp:journal:update',
         description: 'Update an existing journal entry. Requires mcp:journal:update permission. ' +
-            CONTENT_LINKING_HELP,
+            CONTENT_LINKING_HELP +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -1184,6 +1369,7 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
             required: ['entry_id'],
         },
@@ -1266,7 +1452,8 @@ const SHARED_TOOLS = [
         description: 'Update an idea, or move it to another stage. The stages are "spark" (just raised), ' +
             '"exploring", "building", "shipped" and "parked" — moving an idea along is how the project ' +
             'sees what became of it. Requires mcp:ideas:update permission. ' +
-            CONTENT_LINKING_HELP,
+            CONTENT_LINKING_HELP +
+            EDITS_HELP,
         inputSchema: {
             type: 'object',
             properties: {
@@ -1281,6 +1468,7 @@ const SHARED_TOOLS = [
                     type: 'string',
                     description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
                 },
+                edits: editsSchema(false),
             },
             required: ['idea_id'],
         },

package/package.json

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