@projora/mcp-server 1.0.0 → 1.1.0

package/build/index.js

@@ -471,13 +471,71 @@ async function addCommentToTask(taskId, body) {
     const result = await graphqlQuery(mutation, { taskId, body });
     return !!result?.createComment;
 }
+// Helper function to update task branch/PR info
+async function updateTaskBranchInfo(taskId, branchName, prUrl, prNumber) {
+    const input = {};
+    if (branchName !== undefined)
+        input.branchName = branchName;
+    if (prUrl !== undefined)
+        input.prUrl = prUrl;
+    if (prNumber !== undefined)
+        input.prNumber = prNumber;
+    if (Object.keys(input).length === 0)
+        return true;
+    const mutation = `
+    mutation UpdateTaskBranch($id: ID!, $input: UpdateTaskInput!) {
+      updateTask(id: $id, input: $input) {
+        id
+        branchName
+        prUrl
+        prNumber
+      }
+    }
+  `;
+    const result = await graphqlQuery(mutation, { id: taskId, input });
+    return !!result?.updateTask;
+}
+// Helper function to log time on a task
+async function logTimeOnTask(taskId, startedAt, endedAt, description) {
+    const mutation = `
+    mutation LogTime($taskId: ID!, $input: LogTimeInput!) {
+      logTime(taskId: $taskId, input: $input) {
+        id
+        durationMinutes
+        formattedDuration
+      }
+    }
+  `;
+    const result = await graphqlQuery(mutation, {
+        taskId,
+        input: {
+            description: description || null,
+            startedAt,
+            endedAt,
+        },
+    });
+    return result?.logTime || null;
+}
+// Helper to format duration in human-readable form
+function formatDuration(minutes) {
+    if (minutes < 60) {
+        return `${minutes} minute${minutes !== 1 ? 's' : ''}`;
+    }
+    const hours = Math.floor(minutes / 60);
+    const mins = minutes % 60;
+    if (mins === 0) {
+        return `${hours} hour${hours !== 1 ? 's' : ''}`;
+    }
+    return `${hours} hour${hours !== 1 ? 's' : ''} ${mins} minute${mins !== 1 ? 's' : ''}`;
+}
 // 9. Start working on a task - get full context and set status to In Progress
 server.registerTool("start_task", {
-    description: "Start working on a task. This will: 1) Set the task status to 'In Progress', 2) Add a comment noting work has started, 3) Return comprehensive task details including description, comments, GitHub repo info, and suggested branch name.",
+    description: "Start working on a task. This will: 1) Set the task status to 'In Progress', 2) Set the branch name on the task (if provided), 3) Add a comment noting work has started, 4) Return comprehensive task details including description, comments, GitHub repo info, and suggested branch name.",
     inputSchema: {
         taskKey: z.string().describe("The task key (e.g., 'PRJ-123')"),
+        branchName: z.string().optional().describe("The git branch name being used for this task. If provided, it will be saved to the task for tracking."),
     },
-}, async ({ taskKey }) => {
+}, async ({ taskKey, branchName: providedBranchName }) => {
     const query = `
       query StartTask($taskKey: String!) {
         taskByKey(taskKey: $taskKey) {
@@ -544,9 +602,10 @@ server.registerTool("start_task", {
             }
         }
     }
-    // Add a comment noting that work has started
-    const timestamp = new Date().toISOString().split('T')[0];
-    await addCommentToTask(task.id, `Started working on this task via Claude Code on ${timestamp}`);
+    // Record the start time for time tracking
+    const startTime = new Date();
+    const startTimestamp = startTime.toISOString();
+    const dateStr = startTimestamp.split('T')[0];
     // Generate suggested branch name
     const slugifiedTitle = task.title
         .toLowerCase()
@@ -554,10 +613,24 @@ server.registerTool("start_task", {
         .replace(/^-|-$/g, '')
         .substring(0, 50);
     const suggestedBranch = `feature/${task.taskKey.toLowerCase()}-${slugifiedTitle}`;
+    // Use provided branch name or suggested one
+    const branchToUse = providedBranchName || suggestedBranch;
+    // Set the branch name on the task
+    let branchSetMessage = "";
+    if (providedBranchName) {
+        await updateTaskBranchInfo(task.id, providedBranchName);
+        branchSetMessage = `\n**Branch set:** \`${providedBranchName}\`\n`;
+    }
+    // Add a comment noting that work has started
+    const branchComment = providedBranchName ? ` on branch \`${providedBranchName}\`` : '';
+    await addCommentToTask(task.id, `Started working on this task via AI assistant on ${dateStr}${branchComment}`);
     let output = `# Task: ${task.taskKey} - ${task.title}\n`;
     if (statusUpdateMessage) {
         output += statusUpdateMessage;
     }
+    if (branchSetMessage) {
+        output += branchSetMessage;
+    }
     output += `\n`;
     output += `## Overview\n`;
     output += `- **Project**: ${project.name} (${project.key})\n`;
@@ -613,19 +686,22 @@ server.registerTool("start_task", {
         }
     }
     output += `\n---\n`;
-    output += `**Tip:** When you're done, use \`complete_task\` to mark this task as Done.\n`;
+    output += `**Started at:** ${startTimestamp}\n`;
+    output += `**Tip:** When you're done, use \`complete_task\` with \`startedAt: "${startTimestamp}"\` to automatically log time spent.\n`;
     return {
         content: [{ type: "text", text: output }],
     };
 });
-// 9b. Complete a task - mark as Done and add completion comment
+// 9b. Complete a task - mark as Done, log time, and add completion comment
 server.registerTool("complete_task", {
-    description: "Mark a task as complete/done. This will: 1) Set the task status to 'Done', 2) Add a comment with an optional summary of what was accomplished.",
+    description: "Mark a task as complete/done. This will: 1) Set the task status to 'Done', 2) Log the time spent (if startedAt is provided), 3) Set the PR URL (if provided), 4) Add a comment with the summary and time logged.",
     inputSchema: {
         taskKey: z.string().describe("The task key (e.g., 'PRJ-123')"),
-        summary: z.string().optional().describe("Optional summary of what was accomplished"),
+        summary: z.string().optional().describe("Summary of what was accomplished"),
+        startedAt: z.string().optional().describe("ISO timestamp of when work started (from start_task). Used to calculate and log time spent."),
+        prUrl: z.string().optional().describe("URL of the pull request created for this task"),
     },
-}, async ({ taskKey, summary }) => {
+}, async ({ taskKey, summary, startedAt, prUrl }) => {
     // Get the task
     const getTaskQuery = `
       query GetTaskId($taskKey: String!) {
@@ -645,6 +721,8 @@ server.registerTool("complete_task", {
     }
     const task = taskData.taskByKey;
     const previousStatus = task.status?.name || 'No status';
+    const endTime = new Date();
+    const endTimestamp = endTime.toISOString();
     // Find the "Done" status
     const doneStatus = await findStatusByName('done');
     if (!doneStatus) {
@@ -659,9 +737,47 @@ server.registerTool("complete_task", {
             content: [{ type: "text", text: `Failed to update task status. Check your permissions.` }],
         };
     }
+    // Log time if startedAt was provided
+    let timeLogMessage = "";
+    let durationMinutes = 0;
+    if (startedAt) {
+        try {
+            const startDate = new Date(startedAt);
+            durationMinutes = Math.round((endTime.getTime() - startDate.getTime()) / 60000);
+            if (durationMinutes > 0) {
+                // Format timestamps for the API (YYYY-MM-DD HH:MM:SS)
+                const formatForApi = (date) => {
+                    return date.toISOString().replace('T', ' ').substring(0, 19);
+                };
+                const timeLog = await logTimeOnTask(task.id, formatForApi(startDate), formatForApi(endTime), `AI-assisted work session${summary ? `: ${summary.substring(0, 100)}` : ''}`);
+                if (timeLog) {
+                    timeLogMessage = `Time logged: ${timeLog.formattedDuration}`;
+                }
+            }
+        }
+        catch (e) {
+            // If parsing fails, just skip time logging
+            console.error("Failed to parse startedAt timestamp:", e);
+        }
+    }
+    // Set PR URL if provided
+    let prSetMessage = "";
+    if (prUrl) {
+        // Extract PR number from URL if possible (e.g., https://github.com/owner/repo/pull/123)
+        const prMatch = prUrl.match(/\/pull\/(\d+)/);
+        const prNumber = prMatch ? parseInt(prMatch[1], 10) : undefined;
+        await updateTaskBranchInfo(task.id, undefined, prUrl, prNumber);
+        prSetMessage = `PR linked: ${prUrl}\n`;
+    }
     // Add completion comment
-    const timestamp = new Date().toISOString().split('T')[0];
-    let commentBody = `Task completed via Claude Code on ${timestamp}`;
+    const dateStr = endTimestamp.split('T')[0];
+    let commentBody = `Task completed via AI assistant on ${dateStr}`;
+    if (durationMinutes > 0) {
+        commentBody += `\n\n**Time spent:** ${formatDuration(durationMinutes)}`;
+    }
+    if (prUrl) {
+        commentBody += `\n\n**Pull Request:** ${prUrl}`;
+    }
     if (summary) {
         commentBody += `\n\n**Summary:**\n${summary}`;
     }
@@ -669,6 +785,12 @@ server.registerTool("complete_task", {
     let output = `# Task Completed: ${task.taskKey}\n\n`;
     output += `**${task.title}**\n\n`;
     output += `Status updated: ${previousStatus} → ${updated.status.name}\n`;
+    if (timeLogMessage) {
+        output += `${timeLogMessage}\n`;
+    }
+    if (prSetMessage) {
+        output += `${prSetMessage}`;
+    }
     if (summary) {
         output += `\nSummary added to task comments.\n`;
     }
@@ -817,6 +939,59 @@ server.registerTool("log_time", {
         content: [{ type: "text", text: `Logged ${result.logTime.formattedDuration} on ${taskKey}${description ? `: ${description}` : ''}` }],
     };
 });
+// 12b. Link branch or PR to a task
+server.registerTool("link_branch", {
+    description: "Link a git branch or pull request to a task. This helps track which branch/PR is associated with the task.",
+    inputSchema: {
+        taskKey: z.string().describe("The task key (e.g., 'PRJ-123')"),
+        branchName: z.string().optional().describe("The git branch name"),
+        prUrl: z.string().optional().describe("URL of the pull request"),
+    },
+}, async ({ taskKey, branchName, prUrl }) => {
+    if (!branchName && !prUrl) {
+        return {
+            content: [{ type: "text", text: `Please provide either a branch name or PR URL.` }],
+        };
+    }
+    // First get the task ID
+    const getTaskQuery = `
+      query GetTaskId($taskKey: String!) {
+        taskByKey(taskKey: $taskKey) {
+          id
+          branchName
+          prUrl
+        }
+      }
+    `;
+    const taskData = await graphqlQuery(getTaskQuery, { taskKey });
+    if (!taskData || !taskData.taskByKey) {
+        return {
+            content: [{ type: "text", text: `Task '${taskKey}' not found.` }],
+        };
+    }
+    // Extract PR number from URL if possible
+    let prNumber;
+    if (prUrl) {
+        const prMatch = prUrl.match(/\/pull\/(\d+)/);
+        prNumber = prMatch ? parseInt(prMatch[1], 10) : undefined;
+    }
+    const success = await updateTaskBranchInfo(taskData.taskByKey.id, branchName, prUrl, prNumber);
+    if (!success) {
+        return {
+            content: [{ type: "text", text: `Failed to update task. Check your permissions.` }],
+        };
+    }
+    let output = `Updated ${taskKey}:\n`;
+    if (branchName) {
+        output += `  Branch: ${branchName}\n`;
+    }
+    if (prUrl) {
+        output += `  PR: ${prUrl}\n`;
+    }
+    return {
+        content: [{ type: "text", text: output }],
+    };
+});
 // 13. Update task (general)
 server.registerTool("update_task", {
     description: "Update task fields (title, description, priority, assignee, due date, estimate)",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@projora/mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server for Projora task management - integrate with Claude Code and OpenCode to manage tasks, update statuses, and track work",
   "type": "module",
   "bin": {