@ezmodo/mcp-server 0.13.0

package/tools/testing.js

@@ -0,0 +1,344 @@
+/**
+ * Testing Tools
+ * MCP tools for managing test cases, test suites, and test runs
+ *
+ * Consolidated:
+ * - manage_test_case (create/update/delete/record_run)
+ * - manage_test_suite (create/update/delete/add_cases/remove_cases)
+ * - list_test_cases (get single or list with filters)
+ * - list_test_suites (get single or list with filters)
+ * - get_testing_summary (unchanged)
+ */
+
+import { LINKS_ARRAY_SCHEMA } from './link-params.js';
+
+export const TESTING_TOOLS = [
+  {
+    name: 'manage_test_case',
+    description: 'Create, update, delete test cases, or record a test run. ' +
+      'Test cases belong to projects and define verification criteria with optional structured steps.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['create', 'update', 'delete', 'record_run'],
+          description: 'Action to perform',
+        },
+        // --- Identifiers ---
+        projectId: {
+          type: 'string',
+          description: 'Project ID (required for all actions)',
+        },
+        caseId: {
+          type: 'string',
+          description: 'Test case ID (required for update, delete, record_run)',
+        },
+        // --- Create/update fields ---
+        title: {
+          type: 'string',
+          description: 'Test case title (required for create, optional for update)',
+        },
+        description: {
+          type: 'string',
+          description: 'Description of what this test case verifies. Used by create and update.',
+        },
+        preconditions: {
+          type: 'string',
+          description: 'Preconditions before executing the test. Used by create and update.',
+        },
+        steps: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              instruction: {
+                type: 'string',
+                description: 'The step instruction to execute',
+              },
+              expectedResult: {
+                type: 'string',
+                description: 'The expected result after executing the step',
+              },
+            },
+          },
+          description: 'Ordered list of test steps. Used by create and update.',
+        },
+        priority: {
+          type: 'string',
+          enum: ['critical', 'high', 'medium', 'low'],
+          description: 'Priority level. Used by create and update.',
+        },
+        category: {
+          type: 'string',
+          description: 'Test category (e.g., "functional", "regression", "edge-case"). Used by create and update.',
+        },
+        links: LINKS_ARRAY_SCHEMA,
+        environments: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Target environments (e.g., ["staging", "production"]). Used by create and update.',
+        },
+        lifecycleStatus: {
+          type: 'string',
+          enum: ['active', 'needs_review', 'stale', 'deprecated'],
+          description: 'Lifecycle status. Used by create and update.',
+        },
+        retention: {
+          type: 'string',
+          enum: ['transient', 'persistent'],
+          description: 'Retention type: transient (auto-cleaned) or persistent. Used by create and update.',
+        },
+        // --- Create-only fields ---
+        originTaskId: {
+          type: 'string',
+          description: 'Origin task ID that generated this test case (create only)',
+        },
+        taskId: {
+          type: 'string',
+          description: 'Deprecated: use originTaskId instead (create only)',
+        },
+        linkedTaskIds: {
+          type: 'array',
+          items: { type: 'string' },
+          description: 'Array of task IDs this test case is linked to (create only)',
+        },
+        epicId: {
+          type: 'string',
+          description: 'Optional epic ID for context (create only)',
+        },
+        userName: {
+          type: 'string',
+          description: 'Name of the user creating the test case. Used by create and record_run.',
+        },
+        // --- Record run fields ---
+        overallStatus: {
+          type: 'string',
+          enum: ['pass', 'fail', 'skip', 'blocked'],
+          description: 'Overall result of the test run (required for record_run)',
+        },
+        stepResults: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              stepId: {
+                type: 'string',
+                description: 'The ID of the step',
+              },
+              status: {
+                type: 'string',
+                description: 'Result status for this step (pass/fail/skip/blocked)',
+              },
+              actualResult: {
+                type: 'string',
+                description: 'What actually happened when the step was executed',
+              },
+            },
+          },
+          description: 'Per-step execution results (record_run only)',
+        },
+        notes: {
+          type: 'string',
+          description: 'Additional notes about the test run (record_run only)',
+        },
+        environment: {
+          type: 'string',
+          description: 'Environment where the test was executed e.g. "staging" (record_run only)',
+        },
+        duration: {
+          type: 'number',
+          description: 'Duration of the test run in milliseconds (record_run only)',
+        },
+      },
+      required: ['action', 'projectId'],
+    },
+  },
+  {
+    name: 'manage_test_suite',
+    description: 'Create, update, delete test suites, or add/remove cases from a suite. ' +
+      'Suites are project-level groupings of test cases (e.g., regression, smoke, acceptance).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['create', 'update', 'delete', 'add_cases', 'remove_cases'],
+          description: 'Action to perform',
+        },
+        // --- Identifiers ---
+        projectId: {
+          type: 'string',
+          description: 'Project ID (required for all actions)',
+        },
+        suiteId: {
+          type: 'string',
+          description: 'Test suite ID (required for update, delete, add_cases, remove_cases)',
+        },
+        // --- Create/update fields ---
+        title: {
+          type: 'string',
+          description: 'Suite title (required for create, optional for update)',
+        },
+        description: {
+          type: 'string',
+          description: 'Suite description. Used by create and update.',
+        },
+        category: {
+          type: 'string',
+          enum: ['regression', 'smoke', 'acceptance', 'integration', 'custom'],
+          description: 'Suite category (defaults to "custom"). Used by create and update.',
+        },
+        links: LINKS_ARRAY_SCHEMA,
+        // --- Create-only fields ---
+        organizationId: {
+          type: 'string',
+          description: 'Organization ID — auto-resolved from API key if not provided (create only)',
+        },
+        userName: {
+          type: 'string',
+          description: 'Name of the user creating the suite (create only)',
+        },
+        // --- Add/remove cases fields ---
+        cases: {
+          type: 'array',
+          items: {
+            type: 'object',
+            properties: {
+              caseId: {
+                type: 'string',
+                description: 'The test case ID',
+              },
+              taskId: {
+                type: 'string',
+                description: 'Optional: the task ID the test case is linked to',
+              },
+            },
+            required: ['caseId'],
+          },
+          description: 'Array of test case references (required for add_cases, remove_cases)',
+        },
+      },
+      required: ['action', 'projectId'],
+    },
+  },
+  {
+    name: 'list_test_cases',
+    description: 'List test cases or get a single test case. ' +
+      'Provide testCaseId (+ projectId) for single lookup, or projectId with optional filters for listing.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Project ID (required)',
+        },
+        // --- Single lookup ---
+        testCaseId: {
+          type: 'string',
+          description: 'Test case ID for single lookup',
+        },
+        // --- List filters ---
+        originTaskId: {
+          type: 'string',
+          description: 'Filter by origin task ID',
+        },
+        taskId: {
+          type: 'string',
+          description: 'Deprecated: use originTaskId instead',
+        },
+        category: {
+          type: 'string',
+          description: 'Filter by test category (e.g., "functional", "regression")',
+        },
+        priority: {
+          type: 'string',
+          enum: ['critical', 'high', 'medium', 'low'],
+          description: 'Filter by priority level',
+        },
+        status: {
+          type: 'string',
+          enum: ['not_run', 'pass', 'fail', 'skip', 'blocked'],
+          description: 'Filter by latest run status',
+        },
+        epicId: {
+          type: 'string',
+          description: 'Filter by epic ID',
+        },
+        lifecycleStatus: {
+          type: 'string',
+          enum: ['active', 'needs_review', 'stale', 'deprecated'],
+          description: 'Filter by lifecycle status',
+        },
+        retention: {
+          type: 'string',
+          enum: ['transient', 'persistent'],
+          description: 'Filter by retention type',
+        },
+        limit: {
+          type: 'number',
+          description: 'Max results per page (default 50, max 200)',
+        },
+        cursor: {
+          type: 'string',
+          description: 'Pagination cursor from a previous response',
+        },
+      },
+      required: ['projectId'],
+    },
+  },
+  {
+    name: 'list_test_suites',
+    description: 'List test suites or get a single test suite. ' +
+      'Provide testSuiteId (+ projectId) for single lookup, or projectId with optional filters for listing.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Project ID (required)',
+        },
+        // --- Single lookup ---
+        testSuiteId: {
+          type: 'string',
+          description: 'Test suite ID for single lookup',
+        },
+        // --- List filters ---
+        category: {
+          type: 'string',
+          enum: ['regression', 'smoke', 'acceptance', 'integration', 'custom'],
+          description: 'Filter by suite category',
+        },
+        limit: {
+          type: 'number',
+          description: 'Max results per page (default 50, max 200)',
+        },
+        cursor: {
+          type: 'string',
+          description: 'Pagination cursor from a previous response',
+        },
+      },
+      required: ['projectId'],
+    },
+  },
+  {
+    name: 'get_testing_summary',
+    description: 'Get aggregate test statistics for a project (or a specific task) ' +
+      'including pass/fail counts, coverage, recent run history, and ' +
+      'per-environment breakdowns.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        projectId: {
+          type: 'string',
+          description: 'Project ID (required)',
+        },
+        taskId: {
+          type: 'string',
+          description: 'Optional: filter summary to a specific task',
+        },
+      },
+      required: ['projectId'],
+    },
+  },
+];

package/tools/todos.js

@@ -0,0 +1,69 @@
+/**
+ * Todo Tools
+ * MCP tools for managing personal todos (todo list)
+ *
+ * Todos are lightweight personal tasks for quick capture.
+ * They can later be promoted to full project tasks via move_to_project.
+ *
+ * Consolidated: manage_todo (create/complete/move_to_project) + list_todos
+ */
+
+export const TODO_TOOLS = [
+  {
+    name: 'manage_todo',
+    description: 'Create, complete, or promote personal todos. ' +
+      'Todos are lightweight tasks for quick capture that can be promoted to project tasks.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['create', 'complete', 'move_to_project'],
+          description: 'Action to perform',
+        },
+        // --- Identifiers ---
+        todoId: {
+          type: 'string',
+          description: 'Todo ID (required for complete, move_to_project)',
+        },
+        // --- Create fields ---
+        title: {
+          type: 'string',
+          description: 'Todo title (required for create)',
+        },
+        description: {
+          type: 'string',
+          description: 'Optional description or notes — supports markdown (create only)',
+        },
+        // --- Move to project fields ---
+        projectId: {
+          type: 'string',
+          description: 'Target project ID (required for move_to_project)',
+        },
+        epicId: {
+          type: 'string',
+          description: 'Optional epic to assign the task to (move_to_project only)',
+        },
+        componentId: {
+          type: 'string',
+          description: 'Optional component to assign the task to (move_to_project only)',
+        },
+      },
+      required: ['action'],
+    },
+  },
+  {
+    name: 'list_todos',
+    description: 'List personal todos from your todo list. Returns active todos by default.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        status: {
+          type: 'string',
+          enum: ['active', 'completed', 'all'],
+          description: 'Filter by status (default: active)',
+        },
+      },
+    },
+  },
+];

package/tools/watchers.js

@@ -0,0 +1,81 @@
+/**
+ * Watching Tools
+ * MCP tools for task subscriptions and the notification inbox (E-41)
+ *
+ * NOTE: none of these take a userId. The acting user is the API key's owner,
+ * resolved server-side. A userId parameter would let an agent subscribe a
+ * colleague to anything.
+ */
+
+export const WATCHER_TOOLS = [
+  {
+    name: 'manage_watch',
+    description: 'Watch or unwatch a task. Watching subscribes YOU (the API key owner) to notifications ' +
+      'about the task: status changes and new comments. Use this for "watch this task for me" or ' +
+      '"stop notifying me about this". Both actions are idempotent. ' +
+      'Note you are subscribed automatically to tasks you are assigned, own, or comment on — ' +
+      'this tool is for following work that is not yours.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['watch', 'unwatch'],
+          description: 'Whether to start or stop watching the task',
+        },
+        taskId: {
+          type: 'string',
+          description: 'The task ID to watch or unwatch (required)',
+        },
+      },
+      required: ['action', 'taskId'],
+    },
+  },
+  {
+    name: 'list_watched',
+    description: 'List the tasks you are watching, with their current status, priority, project and ' +
+      'when each last changed. Answers "what is happening on the work I follow?" in one call — ' +
+      'do NOT follow this with get_task per row. Each result also carries `reason`, why you are ' +
+      'subscribed (manual, assignee, owner or commenter). Results are ordered most-recently-changed ' +
+      'first, and PAGED: read `total` and `hasMore` rather than the row count — a short page and the ' +
+      'end of the list look identical otherwise, which is how you conclude a subscription is gone.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        organizationId: {
+          type: 'string',
+          description: 'Organization to list watched tasks for (required)',
+        },
+        limit: {
+          type: 'number',
+          description: 'Page size (default 50, max 200)',
+        },
+        offset: {
+          type: 'number',
+          description: 'Rows to skip, for paging past the first page (default 0)',
+        },
+      },
+      required: ['organizationId'],
+    },
+  },
+  {
+    name: 'list_notifications',
+    description: 'List your in-app notifications — mentions, replies, assignments, status changes on ' +
+      'watched tasks. Defaults to UNREAD only, which is usually what "what have I missed?" means. ' +
+      'Pass unreadOnly: false to include already-read history.',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        unreadOnly: {
+          type: 'boolean',
+          description: 'Only unread notifications (default: true)',
+          default: true,
+        },
+        limit: {
+          type: 'number',
+          description: 'Maximum results (default 20, max 100)',
+        },
+      },
+    },
+  },
+];

package/tools/work-templates.js

@@ -0,0 +1,96 @@
+/**
+ * Work Template Tools
+ * MCP tools for E-211 task/epic templates (work_templates).
+ *
+ * A work template is a reusable blueprint for a task or an epic (a `kind`). A
+ * task template carries a taskBlueprint; an epic template carries an
+ * epicBlueprint with a nested child-task list. Templates are org-level (or
+ * project-scoped) and are instantiated either manually (action "instantiate") or
+ * by a recurring task schedule (manage_recurring_task with a templateId).
+ */
+
+import { TASK_TYPE_PROPERTY } from './task-type.js';
+
+const TASK_BLUEPRINT_SCHEMA = {
+  type: 'object',
+  description: 'Reusable task shape (used when kind="task", and as each child of an epic template).',
+  properties: {
+    title: { type: 'string' },
+    description: { type: 'string' },
+    steps: { type: 'array', items: { type: 'string' } },
+    taskType: TASK_TYPE_PROPERTY,
+    priority: { type: 'string', enum: ['low', 'medium', 'high', 'urgent'] },
+    componentId: { type: 'string' },
+    tagIds: { type: 'array', items: { type: 'string' } },
+  },
+  required: ['title'],
+};
+
+const EPIC_BLUEPRINT_SCHEMA = {
+  type: 'object',
+  description: 'Reusable epic shape (used when kind="epic"), including its child tasks.',
+  properties: {
+    title: { type: 'string' },
+    description: { type: 'string' },
+    status: { type: 'string' },
+    color: { type: 'string' },
+    tasks: {
+      type: 'array',
+      items: TASK_BLUEPRINT_SCHEMA,
+      description: 'Child tasks created under the epic on instantiation.',
+    },
+  },
+  required: ['title'],
+};
+
+export const WORK_TEMPLATE_TOOLS = [
+  {
+    name: 'manage_work_template',
+    description: 'Create, update, delete, list, get, or instantiate a work template (E-211) — a ' +
+      'reusable blueprint for a task or an epic. "instantiate" creates a real task (kind=task) or an ' +
+      'epic plus its child tasks (kind=epic) into a project, applying optional overrides. Templates ' +
+      'can also be referenced by a recurring schedule (manage_recurring_task templateId).',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        action: {
+          type: 'string',
+          enum: ['create', 'update', 'delete', 'list', 'get', 'instantiate'],
+          description: 'Action to perform. "list" needs organizationId (optional kind filter); ' +
+            '"get"/"update"/"delete"/"instantiate" need templateId. "create" needs organizationId, ' +
+            'kind, name, and the matching blueprint.',
+        },
+        // --- Identifiers ---
+        organizationId: { type: 'string', description: 'Organization ID (required for create, list).' },
+        templateId: { type: 'string', description: 'Template ID (required for get, update, delete, instantiate).' },
+        projectId: {
+          type: 'string',
+          description: 'Scope the template to a project (create/update; omit = org-wide). For ' +
+            'instantiate this is REQUIRED — the project the task/epic is created into.',
+        },
+        // --- Create / update fields ---
+        kind: { type: 'string', enum: ['task', 'epic'], description: 'Template kind (required for create).' },
+        name: { type: 'string', description: 'Template name (required for create).' },
+        description: { type: 'string', description: 'What the template is for.' },
+        category: { type: 'string', description: 'Org-scoped categorization.' },
+        taskBlueprint: TASK_BLUEPRINT_SCHEMA,
+        epicBlueprint: EPIC_BLUEPRINT_SCHEMA,
+        // --- Instantiate overrides ---
+        title: { type: 'string', description: 'Instantiate: override the blueprint title.' },
+        epicId: { type: 'string', description: 'Instantiate (task kind): attach the new task to this epic.' },
+        milestoneId: { type: 'string', description: 'Instantiate (epic kind): link the new epic to this milestone.' },
+        componentId: { type: 'string', description: 'Instantiate (task kind): override component.' },
+        priority: {
+          type: 'string',
+          enum: ['low', 'medium', 'high', 'urgent'],
+          description: 'Instantiate: override priority.',
+        },
+        assigneeId: { type: 'string', description: 'Instantiate (task kind): assignee ID.' },
+        assigneeName: { type: 'string', description: 'Instantiate (task kind): assignee name.' },
+        assigneeType: { type: 'string', enum: ['human', 'ai'], description: 'Instantiate (task kind): assignee type.' },
+        tagIds: { type: 'array', items: { type: 'string' }, description: 'Instantiate: tag IDs to apply.' },
+      },
+      required: ['action'],
+    },
+  },
+];