wolfpack-mcp 1.0.80 → 1.0.82

package/dist/client.js

@@ -240,6 +240,22 @@ export class WolfpackClient {
             throw error;
         }
     }
+    // Review check methods
+    async listWorkItemChecks(filter, teamSlug) {
+        const params = new URLSearchParams();
+        if (filter.workItemId)
+            params.set('workItemId', filter.workItemId);
+        if (filter.status)
+            params.set('status', filter.status);
+        const query = params.toString();
+        return this.api.get(this.withTeamSlug(`/work-item-checks${query ? `?${query}` : ''}`, teamSlug));
+    }
+    async claimWorkItemCheck(workItemId, checkId, teamSlug) {
+        return this.api.post(this.withTeamSlug(`/work-items/${workItemId}/checks/${checkId}/claim`, teamSlug), {});
+    }
+    async completeWorkItemCheck(workItemId, checkId, data, teamSlug) {
+        return this.api.post(this.withTeamSlug(`/work-items/${workItemId}/checks/${checkId}/complete`, teamSlug), data);
+    }
     // Radar Item (Initiative/Roadmap) methods
     async listRadarItems(options) {
         const params = new URLSearchParams();

package/dist/index.js

@@ -214,6 +214,28 @@ const SubmitWorkItemFormSchema = z.object({
         .optional()
         .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
 });
+const ListWorkItemChecksSchema = z.object({
+    work_item_id: refIdString()
+        .optional()
+        .describe('The refId of a work item; omit for your reviewer inbox'),
+    status: z.enum(['pending', 'passed', 'failed']).optional().describe('Filter by check status'),
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+});
+const ClaimWorkItemCheckSchema = z.object({
+    work_item_id: refIdString().describe('The refId of the work item'),
+    check_id: z.string().describe('The check ID (from list_work_item_checks)'),
+    project_slug: z
+        .string()
+        .optional()
+        .describe('Project slug (required for multi-project users, use list_projects to get slugs)'),
+});
+const CompleteWorkItemCheckSchema = ClaimWorkItemCheckSchema.extend({
+    status: z.enum(['passed', 'failed']).describe('The verdict'),
+    summary: z.string().optional().describe('Short summary of the review findings'),
+});
 // Radar Item (Initiative/Roadmap) schemas
 const ListRadarItemsSchema = z.object({
     project_slug: z.string().optional().describe('Project slug to filter radar items'),
@@ -641,6 +663,11 @@ const AddDiscussionCommentSchema = z.object({
 const PASSTHROUGH_FIELDS = new Set(['formDefinition', 'formValues', 'formContent']);
 // Strip UUID v4 fields from response objects so agents use refId/slug instead.
 // Preserves Clerk user IDs (user_xxx format) and operational fields (categoryId, radarItemId).
+/** Present a review check with its ID under `checkId` (stripUuids would drop `id`). */
+function formatWorkItemCheck(check) {
+    const { id, workItemId: _workItemId, ...rest } = check;
+    return { checkId: id, ...rest };
+}
 function stripUuids(obj) {
     if (obj === null || obj === undefined)
         return obj;
@@ -835,9 +862,12 @@ class WolfpackMCPServer {
                             'Call this before updating to see current content. ' +
                             'WORKFLOW: When asked to work on an item, check its status and follow the required state transitions ' +
                             '(pending→pull first, new→doing, review→doing when you are picking the work back up, ' +
-                            'blocked/ready/completed/closed→new→doing, then review when done). ' +
+                            'ready/completed/closed→new→doing, then review when done). ' +
+                            'AGENTS: a "blocked" item is not yours to restart — a human clears the blocker. Leave it where it is, ' +
+                            'comment if you can help clear it, and take the next claimable item instead. ' +
                             'PLANNING: Check if the description contains a plan (markdown checklist). If not, APPEND one using update_work_progress - preserve all original description text and add your plan below a "---" separator. ' +
                             'FORMS: Procedure-created work items may include formDefinition (field definitions with name, label, type, required, options) and formValues (current values). Use submit_work_item_form to fill in form values. ' +
+                            'REVIEW CHECKS: items under review may carry review checks (code-review, security-review, ...); see list_work_item_checks and claim/complete_work_item_check. ' +
                             'IMAGES: Image references in the description (e.g. `![alt](/api/files/...)`) can be viewed using the download_image tool.',
                         inputSchema: {
                             type: 'object',
@@ -885,6 +915,7 @@ class WolfpackMCPServer {
                             'STATUS WORKFLOW: "pending" (backlog) → "new" (to do) → "doing" (in progress) → "review" (work done) → "ready" (awaiting deployment) → "completed" (deployed). ' +
                             'Use "blocked" when work cannot proceed. AGENTS: you cannot start un-started work here — ' +
                             'a status change on a "pending" or "new" item that is not assigned to you is refused. ' +
+                            'Nor can you move an item OUT of "blocked": clearing a blocker is a human decision. ' +
                             'Take it with pull_work_item, which assigns it to you and puts it in "doing"; that is ' +
                             '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. ' +
@@ -1035,6 +1066,80 @@ class WolfpackMCPServer {
                             required: ['work_item_id', 'form_values'],
                         },
                     },
+                    {
+                        name: 'list_work_item_checks',
+                        description: 'List review checks (key controls such as code-review, security-review, e2e-review) on work items. ' +
+                            'With work_item_id: every check on that item. Without it: your REVIEWER INBOX — pending checks on ' +
+                            'work items in the work pools you belong to that are unclaimed or held by you, each with workItemRefId and workItemTitle. ' +
+                            'Checks on blocked items are left out — blocked work is not picked up, and claiming one is refused. ' +
+                            'REVIEW WORKFLOW: claim a check with claim_work_item_check, get_work_item to read the work, review it, ' +
+                            'then complete_work_item_check with "passed" or "failed" and a short summary. ' +
+                            'A failed check sends the item back to its developer with your summary as feedback; do not change the item status yourself.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: {
+                                    type: 'string',
+                                    description: 'The refId of a work item; omit for your reviewer inbox',
+                                },
+                                status: {
+                                    type: 'string',
+                                    enum: ['pending', 'passed', 'failed'],
+                                    description: 'Filter by check status',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                        },
+                    },
+                    {
+                        name: 'claim_work_item_check',
+                        description: 'Claim a pending, unclaimed review check on a work item so other reviewers know it is being handled. ' +
+                            'Only one reviewer can hold a check; the claim is refused if someone else got there first.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The refId of the work item' },
+                                check_id: {
+                                    type: 'string',
+                                    description: 'The check ID (checkId from list_work_item_checks)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                            required: ['work_item_id', 'check_id'],
+                        },
+                    },
+                    {
+                        name: 'complete_work_item_check',
+                        description: 'Record the verdict on a review check: "passed" or "failed", with a short summary of the findings. ' +
+                            'A claimed check can only be completed by its claimant (or an admin). When every check on the item is ' +
+                            'resolved the owning procedure continues — with a failed check it returns the item to the developer with the summaries as feedback.',
+                        inputSchema: {
+                            type: 'object',
+                            properties: {
+                                work_item_id: { type: 'string', description: 'The refId of the work item' },
+                                check_id: {
+                                    type: 'string',
+                                    description: 'The check ID (checkId from list_work_item_checks)',
+                                },
+                                status: { type: 'string', enum: ['passed', 'failed'], description: 'The verdict' },
+                                summary: {
+                                    type: 'string',
+                                    description: 'Short summary of the review findings (what was checked, what failed)',
+                                },
+                                project_slug: {
+                                    type: 'string',
+                                    description: 'Project slug (required for multi-project users, use list_projects to get slugs)',
+                                },
+                            },
+                            required: ['work_item_id', 'check_id', 'status'],
+                        },
+                    },
                     // Radar Item (Initiative/Roadmap) tools
                     {
                         name: 'list_radar_items',
@@ -2314,6 +2419,43 @@ class WolfpackMCPServer {
                             content: [{ type: 'text', text: 'Work item not found' }],
                         };
                     }
+                    case 'list_work_item_checks': {
+                        const parsed = ListWorkItemChecksSchema.parse(args);
+                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
+                        const checks = await this.client.listWorkItemChecks({ workItemId: parsed.work_item_id, status: parsed.status }, teamSlug);
+                        const text = checks.length === 0
+                            ? parsed.work_item_id
+                                ? 'No review checks on this work item'
+                                : 'No review checks waiting for you'
+                            : JSON.stringify(checks.map(formatWorkItemCheck), null, 2);
+                        return { content: [{ type: 'text', text }] };
+                    }
+                    case 'claim_work_item_check': {
+                        const parsed = ClaimWorkItemCheckSchema.parse(args);
+                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
+                        const check = await this.client.claimWorkItemCheck(parsed.work_item_id, parsed.check_id, teamSlug);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Claimed ${check.kind} check on #${check.workItemRefId} "${check.workItemTitle}"\n\n${JSON.stringify(formatWorkItemCheck(check), null, 2)}`,
+                                },
+                            ],
+                        };
+                    }
+                    case 'complete_work_item_check': {
+                        const parsed = CompleteWorkItemCheckSchema.parse(args);
+                        const teamSlug = parsed.project_slug || this.client.getProjectSlug() || undefined;
+                        const check = await this.client.completeWorkItemCheck(parsed.work_item_id, parsed.check_id, { status: parsed.status, summary: parsed.summary }, teamSlug);
+                        return {
+                            content: [
+                                {
+                                    type: 'text',
+                                    text: `Marked ${check.kind} check on #${check.workItemRefId} as ${check.status}\n\n${JSON.stringify(formatWorkItemCheck(check), null, 2)}`,
+                                },
+                            ],
+                        };
+                    }
                     // Radar Item handlers
                     case 'list_radar_items': {
                         const parsed = ListRadarItemsSchema.parse(args);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wolfpack-mcp",
-  "version": "1.0.80",
+  "version": "1.0.82",
   "description": "MCP server for Wolfpack AI-enhanced software delivery tools",
   "main": "dist/index.js",
   "type": "module",