internaltool-mcp 1.6.25 → 1.6.26

package/index.js

@@ -1537,6 +1537,125 @@ The log is visible in InternalTool under the task's Session tab — gives the hu
       return text({ logged: true, type, name, summary })
     }
   )
+
+  // ── get_parallel_kickoffs ─────────────────────────────────────────────────────
+  server.tool(
+    'get_parallel_kickoffs',
+    `Read the decomposition plan and return ready-to-paste Cursor Agent prompts for the next group of parallel subtasks.
+
+COORDINATOR WORKFLOW:
+1. Call decompose_task to create the plan
+2. Call get_parallel_kickoffs to get one paste-ready prompt per parallel subtask
+3. Tell the user exactly how many new Cursor Agent windows to open
+4. Give them each prompt to paste — one window per subtask
+
+Cursor cannot spawn agent windows automatically. This tool generates the prompts;
+the human opens the windows. Each builder agent then runs independently.`,
+    {
+      taskId: z.string().describe("Task's MongoDB ObjectId"),
+    },
+    async ({ taskId }) => {
+      trackTaskActivity(taskId, 'get_parallel_kickoffs')
+      const taskRes = await apiWithRetry(() => api.get(`/api/tasks/${taskId}`))
+      if (!taskRes?.success) return errorText('Task not found')
+      const task = taskRes.data.task
+
+      if (!task.decomposition?.trim()) {
+        return text({
+          error: true,
+          message: 'No decomposition plan found. Call decompose_task first to break the task into subtasks.',
+        })
+      }
+
+      let dec
+      try { dec = JSON.parse(task.decomposition) } catch {
+        return errorText('Decomposition JSON is malformed — call decompose_task again.')
+      }
+
+      const subtasks   = dec.subtasks || []
+      const execOrder  = dec.executionOrder || []
+
+      // Determine which group to run next: first group that has at least one
+      // subtask not yet reflected in the board subtasks as done.
+      const boardSubtasks = task.subtasks || []
+      // Board subtask titles may carry a role prefix like "[BUILDER] Auth hardening..."
+      // Match on bare title OR prefixed title
+      const isDone = (title) => boardSubtasks.some(s => s.done && (s.title === title || s.title.endsWith(title)))
+
+      let nextGroup = null
+      let nextGroupIndex = -1
+      for (let i = 0; i < execOrder.length; i++) {
+        const group = execOrder[i]
+        const allDone = group.every(t => isDone(t))
+        if (!allDone) {
+          // Also check all prior groups are fully done (respects dependsOn)
+          const priorAllDone = execOrder.slice(0, i).every(g => g.every(t => isDone(t)))
+          if (priorAllDone) {
+            nextGroup = group
+            nextGroupIndex = i + 1
+            break
+          }
+        }
+      }
+
+      if (!nextGroup) {
+        return text({
+          allDone: true,
+          message: 'All subtask groups are complete. Move to the final review or run coverage tests.',
+        })
+      }
+
+      // Only kick off subtasks that aren't done yet
+      const pendingInGroup = nextGroup.filter(t => !isDone(t))
+      const parallelCount  = pendingInGroup.length
+      const isParallel     = parallelCount > 1
+
+      if (parallelCount === 0) {
+        return text({
+          group: nextGroupIndex,
+          allDone: true,
+          message: `All subtasks in Group ${nextGroupIndex} are already done. Call get_parallel_kickoffs again to get the next group.`,
+        })
+      }
+
+      // Build one ready-to-paste prompt per pending subtask in this group
+      const kickoffs = pendingInGroup.map((subtaskTitle, i) => {
+        const st = subtasks.find(s => s.title === subtaskTitle) || { title: subtaskTitle, role: 'builder', files: [], description: '' }
+        const fileList = (st.files || []).map(f => `  - ${f}`).join('\n')
+        const prompt = [
+          `You are a ${st.role || 'builder'} agent for TASK-011 (${task.key}).`,
+          ``,
+          `## Your subtask (${i + 1} of ${parallelCount} running in parallel)`,
+          `**Title:** ${st.title}`,
+          `**Description:** ${st.description || ''}`,
+          `**Your files:**`,
+          fileList || '  (to be determined)',
+          ``,
+          `## Steps`,
+          `1. Call \`get_agent_context\` with taskId \`${taskId}\``,
+          `2. Call \`claim_files\` with taskId \`${taskId}\` and files: [${(st.files || []).map(f => `"${f}"`).join(', ')}]`,
+          `3. Implement the subtask — only modify your claimed files`,
+          `4. Run tests to verify nothing is broken`,
+          `5. Commit your changes with a clear message referencing ${task.key}`,
+          `6. Mark the subtask done in InternalTool by calling \`update_task\` to tick off "${st.title}" in the subtasks list`,
+          ``,
+          `Do NOT touch files owned by other parallel agents.`,
+        ].join('\n')
+        return { subtask: st.title, role: st.role, files: st.files, prompt }
+      })
+
+      return text({
+        group:         nextGroupIndex,
+        totalGroups:   execOrder.length,
+        isParallel,
+        parallelCount,
+        instruction: isParallel
+          ? `⚡ GROUP ${nextGroupIndex} runs ${parallelCount} subtasks IN PARALLEL.\n\nTell the user:\n"Please open ${parallelCount} new Cursor Agent windows (Cmd+Shift+P → New Agent Session or open a new Composer tab set to Agent mode).\nPaste prompt 1 in window 1, prompt 2 in window 2. They will run independently."`
+          : `GROUP ${nextGroupIndex} has 1 sequential subtask. Paste the prompt below in a new Agent window (or handle it yourself).`,
+        kickoffs,
+      })
+    }
+  )
 }
 
 // ── Standup activity formatter ────────────────────────────────────────────────
@@ -2967,7 +3086,7 @@ function writeCursorWorkspace(task, projectAgentConfig, startPath) {
         const BUILT_IN = {
           scout: `# Scout Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n\n## Constraints\n- READ ONLY — do not write or modify any file\n- You CAN read files, run tests, and use MCP tools\n\n## Workflow\n1. Call \`get_agent_context\` with taskId \`${taskId}\`\n2. Read every source file systematically\n3. Call \`scout_task\` with confirmed=false, then confirmed=true + your report\n`,
           builder: `# Builder Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n\n**Claimed files:**\n${fileLine}\n\n${scoutLine}\n${decLine}\n\n## Constraints\n- Only modify your claimed files\n- Every change needs a test update\n- Run tests before marking done\n\n## Workflow\n1. Call \`get_agent_context\` with taskId \`${taskId}\`\n2. Implement the feature\n3. Use the \`run-tests\` skill to verify\n4. Call \`commit_helper\` then \`raise_pr\`\n`,
-          coordinator: `# Coordinator Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n\n## Constraints\n- Do NOT write code — plan and delegate only\n- Each subtask must have exclusive file ownership\n\n## Workflow\n1. Call \`get_agent_context\` with taskId \`${taskId}\`\n2. Break work into subtasks with role + files + description\n3. Call \`decompose_task\` with taskId \`${taskId}\` to save the plan\n`,
+          coordinator: `# Coordinator Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n\n## Constraints\n- Do NOT write code — plan and delegate only\n- Each subtask must have exclusive file ownership\n- Cursor CANNOT auto-spawn agents — you generate prompts, the human opens windows\n\n## Workflow\n1. Call \`get_agent_context\` with taskId \`${taskId}\` to read the scout report\n2. Call \`decompose_task\` with taskId \`${taskId}\` to break work into parallel groups\n3. Call \`get_parallel_kickoffs\` with taskId \`${taskId}\` — this returns one ready-to-paste prompt per parallel subtask\n4. Tell the user exactly:\n   - How many new Cursor Agent windows to open\n   - Which prompt to paste in each window (copy verbatim from the kickoffs output)\n5. After all groups in a parallel batch are done, call \`get_parallel_kickoffs\` again for the next group\n\n## Important\nParallel = multiple Cursor Agent windows open at the same time.\nEach window is an independent builder — it claims its own files, implements, commits.\nYou (coordinator) do not implement anything — only plan and hand off.\n`,
           reviewer: `# Reviewer Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n\n## Constraints\n- Read the full diff before approving\n- Post specific, file-level comments\n\n## Workflow\n1. Call \`get_agent_context\` with taskId \`${taskId}\`\n2. Call \`review_pr\` to fetch the diff\n3. Call \`post_pr_review\` with your verdict\n`,
         }
         agentBody = BUILT_IN[role] || `# ${role} Agent — ${taskKey}\n\n**Task ID:** \`${taskId}\`\n**Task:** ${taskTitle}\n`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "internaltool-mcp",
-  "version": "1.6.25",
+  "version": "1.6.26",
   "description": "MCP server for InternalTool — connect AI assistants (Claude Code, Cursor) to your project and task management platform",
   "type": "module",
   "main": "index.js",