contextforge-mcp 0.1.55 → 0.1.57

package/dist/index.js

@@ -71,14 +71,14 @@ function logTool(toolName, details) {
         memory_link_project: "🔗",
         memory_unlink_project: "🔓",
         memory_current_project: "📍",
-        issues_list: "📋",
-        issues_start: "▶️",
-        issues_resolve: "✅",
-        issues_what_next: "🎯",
-        issues_create: "➕",
-        issues_assign: "👤",
-        issues_resolve_by_name: "✅",
-        issues_delete: "🗑️",
+        tasks_list: "📋",
+        tasks_start: "▶️",
+        tasks_resolve: "✅",
+        tasks_what_next: "🎯",
+        tasks_create: "➕",
+        tasks_assign: "👤",
+        tasks_resolve_by_name: "✅",
+        tasks_delete: "🗑️",
         collaborators_list: "👥",
         project_share: "🔗",
     };
@@ -912,10 +912,10 @@ const TOOLS = [
             required: [],
         },
     },
-    // ============ Issues (Task Management) ============
+    // ============ Tasks (Task Management) ============
     {
-        name: "issues_list",
-        description: 'List issues assigned to you. Shows pending issues by default. Use status "all" to see everything, or "resolved" for completed issues.',
+        name: "tasks_list",
+        description: 'List tasks assigned to you. Shows pending tasks by default. Use status "all" to see everything, or "resolved" for completed tasks.',
         inputSchema: {
             type: "object",
             properties: {
@@ -931,75 +931,75 @@ const TOOLS = [
                 scope: {
                     type: "string",
                     enum: ["mine", "all"],
-                    description: '"mine" shows only issues assigned to or created by you (default), "all" shows all issues in your organization/shared projects',
+                    description: '"mine" shows only tasks assigned to or created by you (default), "all" shows all tasks in your organization/shared projects',
                 },
                 limit: {
                     type: "number",
-                    description: "Maximum number of issues (1-100, default: 20)",
+                    description: "Maximum number of tasks (1-100, default: 20)",
                 },
             },
             required: [],
         },
     },
     {
-        name: "issues_start",
-        description: 'Mark an issue as "in_progress". Use this when you start working on an issue.',
+        name: "tasks_start",
+        description: 'Mark a task as "in_progress". Use this when you start working on a task.',
         inputSchema: {
             type: "object",
             properties: {
                 issue_id: {
                     type: "string",
-                    description: "Issue UUID to start working on",
+                    description: "Task UUID to start working on",
                 },
             },
             required: ["issue_id"],
         },
     },
     {
-        name: "issues_resolve",
-        description: 'Mark an issue as "resolved". Use this when you finish working on an issue.',
+        name: "tasks_resolve",
+        description: 'Mark a task as "resolved". Use this when you finish working on a task.',
         inputSchema: {
             type: "object",
             properties: {
                 issue_id: {
                     type: "string",
-                    description: "Issue UUID to mark as resolved",
+                    description: "Task UUID to mark as resolved",
                 },
             },
             required: ["issue_id"],
         },
     },
     {
-        name: "issues_what_next",
-        description: "Get a recommendation of what issue to work on next, based on priority and due dates. Use this when you want to know what task to focus on.",
+        name: "tasks_what_next",
+        description: "Get a recommendation of what task to work on next, based on priority and due dates. Use this when you want to know what task to focus on.",
         inputSchema: {
             type: "object",
             properties: {},
             required: [],
         },
     },
-    // ============ Issues - Create & Assign ============
+    // ============ Tasks - Create & Assign ============
     {
-        name: "issues_create",
-        description: "Create a new issue in a project. Optionally assign it to a collaborator by their email.",
+        name: "tasks_create",
+        description: "Create a new task in a project. Optionally assign it to a collaborator by their email.",
         inputSchema: {
             type: "object",
             properties: {
                 title: {
                     type: "string",
-                    description: "Title of the issue",
+                    description: "Title of the task",
                 },
                 description: {
                     type: "string",
-                    description: "Detailed description of the issue (optional)",
+                    description: "Detailed description of the task (optional)",
                 },
                 project_id: {
                     type: "string",
-                    description: "Project UUID to create the issue in",
+                    description: "Project UUID to create the task in",
                 },
                 project_name: {
                     type: "string",
-                    description: "Project name to create the issue in (alternative to project_id)",
+                    description: "Project name to create the task in (alternative to project_id)",
                 },
                 priority: {
                     type: "string",
@@ -1008,7 +1008,7 @@ const TOOLS = [
                 },
                 assignee_email: {
                     type: "string",
-                    description: "Email of a collaborator to assign this issue to (optional)",
+                    description: "Email of a collaborator to assign this task to (optional)",
                 },
                 due_date: {
                     type: "string",
@@ -1019,59 +1019,112 @@ const TOOLS = [
                     items: { type: "string" },
                     description: "Tags for categorization (optional)",
                 },
+                space_id: {
+                    type: "string",
+                    description: "Space UUID to link this task to (optional)",
+                },
             },
             required: ["title"],
         },
     },
     {
-        name: "issues_assign",
-        description: "Assign an issue to a collaborator by their email address.",
+        name: "tasks_update",
+        description: "Update a task's title, description, status, priority, tags, due date, or assignee. Provide issue_id or short_id to identify the task, plus one or more fields to update.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                issue_id: {
+                    type: "string",
+                    description: "Task UUID (optional if short_id is provided)",
+                },
+                short_id: {
+                    type: "string",
+                    description: 'Short ID of the task (e.g., "4w3123") - alternative to issue_id',
+                },
+                title: {
+                    type: "string",
+                    description: "New title for the task",
+                },
+                description: {
+                    type: "string",
+                    description: "New description for the task",
+                },
+                status: {
+                    type: "string",
+                    enum: ["pending", "in_progress", "resolved"],
+                    description: "New status for the task",
+                },
+                priority: {
+                    type: "string",
+                    enum: ["low", "medium", "high", "urgent"],
+                    description: "New priority level",
+                },
+                tags: {
+                    type: "array",
+                    items: { type: "string" },
+                    description: "New tags (replaces existing tags)",
+                },
+                due_date: {
+                    type: "string",
+                    description: "New due date in ISO format, or null to clear",
+                },
+                assignee_email: {
+                    type: "string",
+                    description: "Email of a collaborator to assign this task to",
+                },
+            },
+            required: [],
+        },
+    },
+    {
+        name: "tasks_assign",
+        description: "Assign a task to a collaborator by their email address.",
         inputSchema: {
             type: "object",
             properties: {
                 issue_id: {
                     type: "string",
-                    description: "Issue UUID to assign (optional if short_id or issue_title is provided)",
+                    description: "Task UUID to assign (optional if short_id or issue_title is provided)",
                 },
                 short_id: {
                     type: "string",
-                    description: 'Short ID of the issue (e.g., "4w3123") - easier to reference than full UUID',
+                    description: 'Short ID of the task (e.g., "4w3123") - easier to reference than full UUID',
                 },
                 issue_title: {
                     type: "string",
-                    description: "Issue title to search for (optional if issue_id or short_id is provided)",
+                    description: "Task title to search for (optional if issue_id or short_id is provided)",
                 },
                 assignee_email: {
                     type: "string",
-                    description: "Email of the collaborator to assign the issue to",
+                    description: "Email of the collaborator to assign the task to",
                 },
             },
             required: ["assignee_email"],
         },
     },
     {
-        name: "issues_resolve_by_name",
-        description: "Resolve an issue by searching for it by title. Use this when you only know the issue name.",
+        name: "tasks_resolve_by_name",
+        description: "Resolve a task by searching for it by title. Use this when you only know the task name.",
         inputSchema: {
             type: "object",
             properties: {
                 title: {
                     type: "string",
-                    description: "Issue title to search for (partial match)",
+                    description: "Task title to search for (partial match)",
                 },
             },
             required: ["title"],
         },
     },
     {
-        name: "issues_delete",
-        description: "Delete an issue by ID or short_id. This performs a soft delete (sets deleted_at timestamp).",
+        name: "tasks_delete",
+        description: "Delete a task by ID or short_id. This performs a soft delete (sets deleted_at timestamp).",
         inputSchema: {
             type: "object",
             properties: {
                 issue_id: {
                     type: "string",
-                    description: "Issue UUID or short_id (6 alphanumeric characters)",
+                    description: "Task UUID or short_id (6 alphanumeric characters)",
                 },
             },
             required: ["issue_id"],
@@ -1080,7 +1133,7 @@ const TOOLS = [
     // ============ Collaborators ============
     {
         name: "collaborators_list",
-        description: "List collaborators on a shared project. Shows who has access and what issues are assigned to them.",
+        description: "List collaborators on a shared project. Shows who has access and what tasks are assigned to them.",
         inputSchema: {
             type: "object",
             properties: {
@@ -2080,21 +2133,21 @@ async function main() {
                         ],
                     };
                 }
-                // ============ Issues (Task Management) ============
-                case "issues_list": {
+                // ============ Tasks (Task Management) ============
+                case "tasks_list": {
                     const status = args?.status; // API defaults to 'pending' if not specified
                     const projectId = args?.project_id;
                     const scope = args?.scope || "mine";
                     const limit = args?.limit || 20;
-                    logTool(name, scope === "all" ? "all issues" : status || "pending");
-                    const result = await apiClient.listIssues({
+                    logTool(name, scope === "all" ? "all tasks" : status || "pending");
+                    const result = await apiClient.listTasks({
                         status,
                         project_id: projectId,
                         scope,
                         limit,
                     });
                     const elapsed = Date.now() - startTime;
-                    logSuccess(`Found ${result.issues?.length || 0} issue(s) in ${elapsed}ms`);
+                    logSuccess(`Found ${result.issues?.length || 0} task(s) in ${elapsed}ms`);
                     const issues = result.issues || [];
                     const issueCount = issues.length;
                     if (issueCount === 0) {
@@ -2102,11 +2155,16 @@ async function main() {
                             content: [
                                 {
                                     type: "text",
-                                    text: "📋 No issues found",
+                                    text: "📋 No tasks found",
                                 },
                             ],
                         };
                     }
+                    // Derive dashboard base URL from API URL
+                    const apiUrl = process.env.CONTEXTFORGE_API_URL || "";
+                    const dashboardBaseUrl = apiUrl.includes("localhost") || apiUrl.includes("127.0.0.1")
+                        ? "http://localhost:3001"
+                        : "https://contextforge.dev";
                     // Format each issue as a readable line
                     const issueLines = issues.map((i) => {
                         const statusEmoji = i.status === "pending"
@@ -2127,9 +2185,10 @@ async function main() {
                         const createdBy = i.created_by_email
                             ? `\n  ✍️ Created by: ${i.created_by_email}`
                             : "";
-                        return `[${i.short_id}] ${i.title}\n  ${statusEmoji} ${i.status} | ${priorityLabel} ${i.priority} | 📁 ${i.project?.name || "No project"}${resolvedBy}${createdBy}`;
+                        const taskUrl = `\n  🔗 ${dashboardBaseUrl}/dashboard/tasks/${i.id}`;
+                        return `[${i.short_id}] ${i.title}\n  ${statusEmoji} ${i.status} | ${priorityLabel} ${i.priority} | 📁 ${i.project?.name || "No project"}${resolvedBy}${createdBy}${taskUrl}`;
                     });
-                    const responseText = `📋 Found ${issueCount} issue${issueCount === 1 ? "" : "s"}\n\n${issueLines.join("\n\n")}\n\n💡 Use issues_start <issue_id> to begin working on an issue`;
+                    const responseText = `📋 Found ${issueCount} task${issueCount === 1 ? "" : "s"}\n\n${issueLines.join("\n\n")}\n\n💡 Use tasks_start <issue_id> to begin working on a task`;
                     return {
                         content: [
                             {
@@ -2139,13 +2198,13 @@ async function main() {
                         ],
                     };
                 }
-                case "issues_start": {
+                case "tasks_start": {
                     const issueId = args?.issue_id;
                     if (!issueId) {
                         throw new Error("issue_id is required");
                     }
                     logTool(name, issueId);
-                    const result = await apiClient.updateIssueStatus(issueId, "in_progress");
+                    const result = await apiClient.updateTaskStatus(issueId, "in_progress");
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Started working on "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2154,7 +2213,7 @@ async function main() {
                                 type: "text",
                                 text: formatResponse({
                                     message: `▶️ Now working on: ${result.issue?.title}`,
-                                    hint: "Use issues_resolve when you complete this issue",
+                                    hint: "Use tasks_resolve when you complete this task",
                                     details: {
                                         id: result.issue?.id,
                                         description: result.issue?.description,
@@ -2164,13 +2223,13 @@ async function main() {
                         ],
                     };
                 }
-                case "issues_resolve": {
+                case "tasks_resolve": {
                     const issueId = args?.issue_id;
                     if (!issueId) {
                         throw new Error("issue_id is required");
                     }
                     logTool(name, issueId);
-                    const result = await apiClient.updateIssueStatus(issueId, "resolved");
+                    const result = await apiClient.updateTaskStatus(issueId, "resolved");
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Resolved "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2178,29 +2237,29 @@ async function main() {
                             {
                                 type: "text",
                                 text: formatResponse({
-                                    message: `✅ Issue resolved: ${result.issue?.title}`,
-                                    hint: "Use issues_what_next to see your next task",
+                                    message: `✅ Task resolved: ${result.issue?.title}`,
+                                    hint: "Use tasks_what_next to see your next task",
                                 }),
                             },
                         ],
                     };
                 }
-                case "issues_what_next": {
+                case "tasks_what_next": {
                     logTool(name);
-                    const result = await apiClient.getNextIssue();
+                    const result = await apiClient.getNextTask();
                     const elapsed = Date.now() - startTime;
                     if (!result.issue) {
-                        logInfo(`No pending issues in ${elapsed}ms`);
+                        logInfo(`No pending tasks in ${elapsed}ms`);
                         return {
                             content: [
                                 {
                                     type: "text",
-                                    text: "🎉 No pending issues assigned to you. Great job!\n\n💡 Check with your team lead for new tasks",
+                                    text: "🎉 No pending tasks assigned to you. Great job!\n\n💡 Check with your team lead for new tasks",
                                 },
                             ],
                         };
                     }
-                    logSuccess(`Next issue: "${result.issue.title}" in ${elapsed}ms`);
+                    logSuccess(`Next task: "${result.issue.title}" in ${elapsed}ms`);
                     const priorityEmoji = result.issue.priority === "urgent"
                         ? "🔴"
                         : result.issue.priority === "high"
@@ -2218,12 +2277,12 @@ async function main() {
                         content: [
                             {
                                 type: "text",
-                                text: `🎯 Next recommended issue:\n\n[${result.issue.short_id || result.issue.id.slice(0, 6)}] ${result.issue.title}\n${priorityEmoji} ${result.issue.priority} | 📁 ${result.issue.project?.name || "No project"}${dueDate}${desc}\n\n📊 ${result.pending_count || 0} pending issues remaining\n\n💡 Use issues_start ${result.issue.id} to begin working`,
+                                text: `🎯 Next recommended task:\n\n[${result.issue.short_id || result.issue.id.slice(0, 6)}] ${result.issue.title}\n${priorityEmoji} ${result.issue.priority} | 📁 ${result.issue.project?.name || "No project"}${dueDate}${desc}\n\n📊 ${result.pending_count || 0} pending tasks remaining\n\n💡 Use tasks_start ${result.issue.id} to begin working`,
                             },
                         ],
                     };
                 }
-                case "issues_create": {
+                case "tasks_create": {
                     const title = args?.title;
                     const description = args?.description;
                     const projectId = args?.project_id;
@@ -2232,11 +2291,12 @@ async function main() {
                     const assigneeEmail = args?.assignee_email;
                     const dueDate = args?.due_date;
                     const tags = args?.tags;
+                    const spaceId = args?.space_id;
                     if (!title) {
                         throw new Error("title is required");
                     }
                     logTool(name, `"${title}"`);
-                    const result = await apiClient.createIssue({
+                    const result = await apiClient.createTask({
                         title,
                         description,
                         project_id: projectId,
@@ -2245,18 +2305,19 @@ async function main() {
                         assignee_email: assigneeEmail,
                         due_date: dueDate,
                         tags,
+                        space_id: spaceId,
                     });
                     const elapsed = Date.now() - startTime;
-                    logSuccess(`Created issue "${result.issue?.title}" in ${elapsed}ms`);
+                    logSuccess(`Created task "${result.issue?.title}" in ${elapsed}ms`);
                     return {
                         content: [
                             {
                                 type: "text",
                                 text: formatResponse({
-                                    message: `➕ Issue created: [${result.issue?.short_id}] ${result.issue?.title}`,
+                                    message: `➕ Task created: [${result.issue?.short_id}] ${result.issue?.title}`,
                                     hint: assigneeEmail
                                         ? `Assigned to ${assigneeEmail}`
-                                        : "Use issues_assign to assign this issue to a collaborator",
+                                        : "Use tasks_assign to assign this task to a collaborator",
                                     details: {
                                         id: result.issue?.short_id,
                                         title: result.issue?.title,
@@ -2268,7 +2329,7 @@ async function main() {
                         ],
                     };
                 }
-                case "issues_assign": {
+                case "tasks_assign": {
                     const issueId = args?.issue_id;
                     const shortId = args?.short_id;
                     const issueTitle = args?.issue_title;
@@ -2280,7 +2341,7 @@ async function main() {
                         throw new Error("Either issue_id, short_id, or issue_title is required");
                     }
                     logTool(name, `→ ${assigneeEmail}`);
-                    const result = await apiClient.assignIssue({
+                    const result = await apiClient.assignTask({
                         issue_id: issueId,
                         short_id: shortId,
                         issue_title: issueTitle,
@@ -2292,18 +2353,18 @@ async function main() {
                         content: [
                             {
                                 type: "text",
-                                text: `👤 Issue assigned!\n\n[${result.issue?.short_id || result.issue?.id?.slice(0, 6)}] ${result.issue?.title}\n📧 Assigned to: ${assigneeEmail}\n\n💡 The collaborator can now see this issue with issues_list`,
+                                text: `👤 Task assigned!\n\n[${result.issue?.short_id || result.issue?.id?.slice(0, 6)}] ${result.issue?.title}\n📧 Assigned to: ${assigneeEmail}\n\n💡 The collaborator can now see this task with tasks_list`,
                             },
                         ],
                     };
                 }
-                case "issues_resolve_by_name": {
+                case "tasks_resolve_by_name": {
                     const title = args?.title;
                     if (!title) {
                         throw new Error("title is required");
                     }
                     logTool(name, `"${title}"`);
-                    const result = await apiClient.resolveIssueByName(title);
+                    const result = await apiClient.resolveTaskByName(title);
                     const elapsed = Date.now() - startTime;
                     logSuccess(`Resolved "${result.issue?.title}" in ${elapsed}ms`);
                     return {
@@ -2311,29 +2372,81 @@ async function main() {
                             {
                                 type: "text",
                                 text: formatResponse({
-                                    message: `✅ Issue resolved: ${result.issue?.title}`,
-                                    hint: "Use issues_what_next to see your next task",
+                                    message: `✅ Task resolved: ${result.issue?.title}`,
+                                    hint: "Use tasks_what_next to see your next task",
                                 }),
                             },
                         ],
                     };
                 }
-                case "issues_delete": {
+                case "tasks_delete": {
                     const issueId = args?.issue_id;
                     if (!issueId) {
                         throw new Error("issue_id is required");
                     }
                     logTool(name, issueId);
-                    const result = await apiClient.deleteIssue(issueId);
+                    const result = await apiClient.deleteTask(issueId);
+                    const elapsed = Date.now() - startTime;
+                    logSuccess(`Deleted task "${result.title}" in ${elapsed}ms`);
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: formatResponse({
+                                    message: `🗑️ Task deleted: [${result.short_id}] ${result.title}`,
+                                    hint: "The task has been soft-deleted and will no longer appear in listings",
+                                }),
+                            },
+                        ],
+                    };
+                }
+                case "tasks_update": {
+                    const issueId = args?.issue_id;
+                    const shortId = args?.short_id;
+                    if (!issueId && !shortId) {
+                        throw new Error("Either issue_id or short_id is required");
+                    }
+                    const updateFields = {};
+                    if (args?.title !== undefined)
+                        updateFields.title = args.title;
+                    if (args?.description !== undefined)
+                        updateFields.description = args.description;
+                    if (args?.status !== undefined)
+                        updateFields.status = args.status;
+                    if (args?.priority !== undefined)
+                        updateFields.priority = args.priority;
+                    if (args?.tags !== undefined)
+                        updateFields.tags = args.tags;
+                    if (args?.due_date !== undefined)
+                        updateFields.due_date = args.due_date;
+                    if (args?.assignee_email !== undefined)
+                        updateFields.assignee_email = args.assignee_email;
+                    if (Object.keys(updateFields).length === 0) {
+                        throw new Error("At least one field to update is required (title, description, status, priority, tags, due_date, assignee_email)");
+                    }
+                    logTool(name, shortId || issueId);
+                    const result = await apiClient.updateTask({
+                        issue_id: issueId,
+                        short_id: shortId,
+                        ...updateFields,
+                    });
                     const elapsed = Date.now() - startTime;
-                    logSuccess(`Deleted issue "${result.title}" in ${elapsed}ms`);
+                    const updatedFieldNames = Object.keys(updateFields).join(", ");
+                    logSuccess(`Updated task "${result.issue?.title}" (${updatedFieldNames}) in ${elapsed}ms`);
                     return {
                         content: [
                             {
                                 type: "text",
                                 text: formatResponse({
-                                    message: `🗑️ Issue deleted: [${result.short_id}] ${result.title}`,
-                                    hint: "The issue has been soft-deleted and will no longer appear in listings",
+                                    message: `✏️ Task updated: [${result.issue?.short_id}] ${result.issue?.title}`,
+                                    hint: `Updated fields: ${updatedFieldNames}`,
+                                    details: {
+                                        id: result.issue?.short_id,
+                                        title: result.issue?.title,
+                                        status: result.issue?.status,
+                                        priority: result.issue?.priority,
+                                        project: result.issue?.project?.name,
+                                    },
                                 }),
                             },
                         ],
@@ -2362,14 +2475,14 @@ async function main() {
                         };
                     }
                     const collabLines = collaborators.map((c) => {
-                        const issueStats = `${c.issues_count || 0} issues (${c.issues_pending || 0} pending, ${c.issues_in_progress || 0} in progress)`;
+                        const issueStats = `${c.issues_count || 0} tasks (${c.issues_pending || 0} pending, ${c.issues_in_progress || 0} in progress)`;
                         return `📧 ${c.email}\n  📊 ${issueStats}`;
                     });
                     return {
                         content: [
                             {
                                 type: "text",
-                                text: `👥 ${collabCount} collaborator${collabCount === 1 ? "" : "s"} on "${result.project?.name || "this project"}"\n\n${collabLines.join("\n\n")}\n\n💡 Use issues_create or issues_assign to assign tasks`,
+                                text: `👥 ${collabCount} collaborator${collabCount === 1 ? "" : "s"} on "${result.project?.name || "this project"}"\n\n${collabLines.join("\n\n")}\n\n💡 Use tasks_create or tasks_assign to assign tasks`,
                             },
                         ],
                     };