wolfpack-mcp 1.0.62 → 1.0.64

package/dist/workItemReminders.js

@@ -0,0 +1,41 @@
+// Workflow reminders injected into work-item tool responses. Tool descriptions document
+// the status workflow, but agents skim them — a reminder in the response at the moment of
+// action is what reliably changes behaviour. Reminders only fire when actionable.
+// Detect if a work item description contains a plan
+export function hasPlan(description) {
+    if (!description)
+        return false;
+    // Check for markdown checklist items (plan indicators)
+    if (/- \[[ x]\]/.test(description))
+        return true;
+    // Check for --- separator with content after (agent-added section)
+    if (/\n---\n/.test(description))
+        return true;
+    return false;
+}
+// True when the description has a checklist and every task is checked off.
+export function allTasksChecked(description) {
+    if (!description)
+        return false;
+    return /- \[x\]/.test(description) && !/- \[ \]/.test(description);
+}
+const STATUS_REMINDERS = {
+    pending: 'REMINDER: This work item is in the backlog ("pending"). Claim it with pull_work_item before starting work.',
+    new: 'REMINDER: This work item is in "new". If you are picking it up, set status to "doing" (update_work_item) ' +
+        'BEFORE starting work.',
+    doing: 'REMINDER: This work item is in "doing". The moment the work is complete, set status to "review" ' +
+        '(update_work_item) and add a completion comment — do not leave it sitting in "doing".',
+};
+// Reminders to prepend to a get_work_item response, most urgent first.
+export function getWorkItemReminders(status, description) {
+    const reminders = [];
+    const statusReminder = STATUS_REMINDERS[status];
+    if (statusReminder)
+        reminders.push(statusReminder);
+    if (!hasPlan(description)) {
+        reminders.push('REMINDER: This work item has no plan. Before starting work, use update_work_progress to add a plan ' +
+            'below a "---" separator. Preserve the original description and append your plan with markdown ' +
+            'checkboxes (- [ ] task).');
+    }
+    return reminders;
+}

package/dist/workItemReminders.test.js

@@ -0,0 +1,52 @@
+import { describe, it, expect } from 'vitest';
+import { hasPlan, allTasksChecked, getWorkItemReminders } from './workItemReminders.js';
+const PLAN = 'Original text\n\n---\n\n## Plan\n\n- [x] first task\n- [ ] second task';
+const DONE_PLAN = 'Original text\n\n---\n\n## Plan\n\n- [x] first task\n- [x] second task';
+describe('hasPlan', () => {
+    it('detects markdown checklists', () => {
+        expect(hasPlan(PLAN)).toBe(true);
+    });
+    it('detects a --- separator section', () => {
+        expect(hasPlan('Original text\n---\nAgent notes')).toBe(true);
+    });
+    it.each([null, undefined, '', 'Just a plain description'])('rejects %j', (description) => {
+        expect(hasPlan(description)).toBe(false);
+    });
+});
+describe('allTasksChecked', () => {
+    it('is true when every task is checked', () => {
+        expect(allTasksChecked(DONE_PLAN)).toBe(true);
+    });
+    it('is false while unchecked tasks remain', () => {
+        expect(allTasksChecked(PLAN)).toBe(false);
+    });
+    it.each([null, undefined, '', 'No checklist here'])('is false without a checklist (%j)', (description) => {
+        expect(allTasksChecked(description)).toBe(false);
+    });
+});
+describe('getWorkItemReminders', () => {
+    it('tells agents to pull pending items', () => {
+        expect(getWorkItemReminders('pending', PLAN)).toEqual([
+            expect.stringContaining('pull_work_item'),
+        ]);
+    });
+    it('tells agents to move new items to doing', () => {
+        expect(getWorkItemReminders('new', PLAN)).toEqual([
+            expect.stringContaining('set status to "doing"'),
+        ]);
+    });
+    it('tells agents to move doing items to review when complete', () => {
+        expect(getWorkItemReminders('doing', PLAN)).toEqual([
+            expect.stringContaining('set status to "review"'),
+        ]);
+    });
+    it('adds the no-plan reminder when the description has no plan', () => {
+        const reminders = getWorkItemReminders('new', 'Just a description');
+        expect(reminders).toHaveLength(2);
+        expect(reminders[1]).toContain('no plan');
+    });
+    it('stays quiet for statuses with no required action', () => {
+        expect(getWorkItemReminders('review', PLAN)).toEqual([]);
+        expect(getWorkItemReminders('completed', PLAN)).toEqual([]);
+    });
+});

package/package.json

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