@vibescope/mcp-server 0.1.0 → 0.2.0

package/dist/handlers/fallback.js

@@ -40,16 +40,25 @@ export const startFallbackActivity = async (args, ctx) => {
     }
     // Get the activity details for the response
     const activityInfo = FALLBACK_ACTIVITIES.find((a) => a.activity === activity);
-    return {
-        result: {
-            success: true,
-            activity,
-            title: activityInfo?.title || activity,
-            description: activityInfo?.description || '',
-            prompt: activityInfo?.prompt || '',
-            message: response.data?.message || `Started fallback activity: ${activityInfo?.title || activity}`,
-        },
+    const result = {
+        success: true,
+        activity,
+        title: activityInfo?.title || activity,
+        description: activityInfo?.description || '',
+        prompt: activityInfo?.prompt || '',
+        message: response.data?.message || `Started fallback activity: ${activityInfo?.title || activity}`,
     };
+    // Pass through worktree guidance if provided
+    if (response.data?.git_workflow) {
+        result.git_workflow = response.data.git_workflow;
+    }
+    if (response.data?.worktree_setup) {
+        result.worktree_setup = response.data.worktree_setup;
+    }
+    if (response.data?.next_step) {
+        result.next_step = response.data.next_step;
+    }
+    return { result };
 };
 export const stopFallbackActivity = async (args, ctx) => {
     const { project_id, summary } = args;

package/dist/handlers/findings.d.ts

@@ -3,13 +3,20 @@
  *
  * Handles audit findings and knowledge base:
  * - add_finding
- * - get_findings
+ * - get_findings (supports summary_only for reduced tokens)
+ * - get_findings_stats (aggregate counts for minimal tokens)
  * - update_finding
  * - delete_finding
  */
 import type { Handler, HandlerRegistry } from './types.js';
 export declare const addFinding: Handler;
 export declare const getFindings: Handler;
+/**
+ * Get aggregate statistics about findings for a project.
+ * Returns counts by category, severity, and status without the actual finding data.
+ * This is much more token-efficient than get_findings for understanding the overall state.
+ */
+export declare const getFindingsStats: Handler;
 export declare const updateFinding: Handler;
 export declare const deleteFinding: Handler;
 /**

package/dist/handlers/findings.js

@@ -3,7 +3,8 @@
  *
  * Handles audit findings and knowledge base:
  * - add_finding
- * - get_findings
+ * - get_findings (supports summary_only for reduced tokens)
+ * - get_findings_stats (aggregate counts for minimal tokens)
  * - update_finding
  * - delete_finding
  */
@@ -32,7 +33,7 @@ export const addFinding = async (args, ctx) => {
     return { result: response.data };
 };
 export const getFindings = async (args, ctx) => {
-    const { project_id, category, severity, status, limit = 50, offset = 0, search_query } = args;
+    const { project_id, category, severity, status, limit = 50, offset = 0, search_query, summary_only = false } = args;
     validateRequired(project_id, 'project_id');
     validateUUID(project_id, 'project_id');
     const apiClient = getApiClient();
@@ -40,13 +41,32 @@ export const getFindings = async (args, ctx) => {
         category,
         severity,
         status,
-        limit
+        limit,
+        offset,
+        search_query,
+        summary_only
     });
     if (!response.ok) {
         throw new Error(response.error || 'Failed to get findings');
     }
     return { result: response.data };
 };
+/**
+ * Get aggregate statistics about findings for a project.
+ * Returns counts by category, severity, and status without the actual finding data.
+ * This is much more token-efficient than get_findings for understanding the overall state.
+ */
+export const getFindingsStats = async (args, ctx) => {
+    const { project_id } = args;
+    validateRequired(project_id, 'project_id');
+    validateUUID(project_id, 'project_id');
+    const apiClient = getApiClient();
+    const response = await apiClient.getFindingsStats(project_id);
+    if (!response.ok) {
+        throw new Error(response.error || 'Failed to get findings stats');
+    }
+    return { result: response.data };
+};
 export const updateFinding = async (args, ctx) => {
     const { finding_id, status, resolution_note, title, description, severity } = args;
     validateRequired(finding_id, 'finding_id');
@@ -81,6 +101,7 @@ export const deleteFinding = async (args, ctx) => {
 export const findingHandlers = {
     add_finding: addFinding,
     get_findings: getFindings,
+    get_findings_stats: getFindingsStats,
     update_finding: updateFinding,
     delete_finding: deleteFinding,
 };

package/dist/handlers/session.js

@@ -8,7 +8,6 @@
  * - get_help
  * - get_token_usage
  */
-import { KNOWLEDGE_BASE } from '../knowledge.js';
 import { getApiClient } from '../api-client.js';
 export const startWorkSession = async (args, ctx) => {
     const { project_id, git_url, mode = 'lite', model, role = 'developer' } = args;
@@ -114,7 +113,7 @@ export const startWorkSession = async (args, ctx) => {
     return { result };
 };
 export const heartbeat = async (args, ctx) => {
-    const { session_id } = args;
+    const { session_id, current_worktree_path } = args;
     const { session } = ctx;
     const targetSession = session_id || session.currentSessionId;
     if (!targetSession) {
@@ -125,8 +124,10 @@ export const heartbeat = async (args, ctx) => {
         };
     }
     const apiClient = getApiClient();
-    // Send heartbeat
-    const heartbeatResponse = await apiClient.heartbeat(targetSession);
+    // Send heartbeat with optional worktree path
+    const heartbeatResponse = await apiClient.heartbeat(targetSession, {
+        current_worktree_path,
+    });
     if (!heartbeatResponse.ok) {
         return {
             result: {
@@ -205,16 +206,30 @@ export const endWorkSession = async (args, ctx) => {
 };
 export const getHelp = async (args, _ctx) => {
     const { topic } = args;
-    const content = KNOWLEDGE_BASE[topic];
-    if (!content) {
+    const apiClient = getApiClient();
+    const response = await apiClient.getHelpTopic(topic);
+    if (!response.ok) {
+        // If database fetch fails, return error
+        return {
+            result: {
+                error: response.error || `Failed to fetch help topic: ${topic}`,
+            },
+        };
+    }
+    if (!response.data) {
+        // Topic not found - fetch available topics
+        const topicsResponse = await apiClient.getHelpTopics();
+        const available = topicsResponse.ok && topicsResponse.data
+            ? topicsResponse.data.map(t => t.slug)
+            : ['getting_started', 'tasks', 'validation', 'deployment', 'git', 'blockers', 'milestones', 'fallback', 'session', 'tokens', 'sprints', 'topics'];
         return {
             result: {
                 error: `Unknown topic: ${topic}`,
-                available: Object.keys(KNOWLEDGE_BASE),
+                available,
             },
         };
     }
-    return { result: { topic, content } };
+    return { result: { topic, content: response.data.content } };
 };
 // Model pricing rates (USD per 1M tokens)
 const MODEL_PRICING = {

package/dist/handlers/sprints.js

@@ -117,11 +117,12 @@ export const updateSprint = async (args, ctx) => {
     return { result: { success: true, sprint_id } };
 };
 export const getSprint = async (args, ctx) => {
-    const { sprint_id } = args;
+    const { sprint_id, summary_only = false } = args;
     validateRequired(sprint_id, 'sprint_id');
     validateUUID(sprint_id, 'sprint_id');
     const apiClient = getApiClient();
-    const response = await apiClient.proxy('get_sprint', { sprint_id });
+    // Response type varies based on summary_only
+    const response = await apiClient.proxy('get_sprint', { sprint_id, summary_only });
     if (!response.ok) {
         throw new Error(`Failed to get sprint: ${response.error}`);
     }

package/dist/handlers/tasks.js

@@ -210,7 +210,24 @@ export const updateTask = async (args, ctx) => {
         }
         throw new Error(`Failed to update task: ${response.error}`);
     }
-    return { result: { success: true, task_id } };
+    // Build result - include git workflow info when transitioning to in_progress
+    const data = response.data;
+    const result = { success: true, task_id };
+    if (data?.git_workflow) {
+        result.git_workflow = data.git_workflow;
+    }
+    if (data?.worktree_setup) {
+        result.worktree_setup = data.worktree_setup;
+    }
+    if (data?.next_step) {
+        result.next_step = data.next_step;
+    }
+    // Warn if transitioning to in_progress without git_branch
+    if (updates.status === 'in_progress' && !updates.git_branch) {
+        result.warning = 'git_branch not set. For multi-agent collaboration, set git_branch when marking in_progress to track your worktree.';
+        result.hint = 'Call update_task again with git_branch parameter after creating your worktree.';
+    }
+    return { result };
 };
 export const completeTask = async (args, ctx) => {
     const { task_id, summary } = args;
@@ -239,6 +256,10 @@ export const completeTask = async (args, ctx) => {
     if (data.context) {
         result.context = data.context;
     }
+    // Pass through warnings (e.g., missing git_branch)
+    if (data.warnings) {
+        result.warnings = data.warnings;
+    }
     // Git workflow instructions are already in API response but we need to fetch
     // task details if we want to include them (API should return these)
     result.next_action = data.next_action;

package/dist/handlers/tool-docs.d.ts

@@ -1,8 +1,9 @@
 /**
  * Tool Documentation
  *
- * This file contains detailed documentation for all MCP tools.
- * It is loaded dynamically by get_tool_info to reduce memory footprint
- * when tool documentation is not needed.
+ * Externalized documentation for all MCP tools.
+ * This file is lazy-loaded by get_tool_info to save tokens.
+ *
+ * Token savings: ~8,000 tokens per schema load when this isn't bundled.
  */
 export declare const TOOL_INFO: Record<string, string>;

package/dist/handlers/tool-docs.js

@@ -1,9 +1,10 @@
 /**
  * Tool Documentation
  *
- * This file contains detailed documentation for all MCP tools.
- * It is loaded dynamically by get_tool_info to reduce memory footprint
- * when tool documentation is not needed.
+ * Externalized documentation for all MCP tools.
+ * This file is lazy-loaded by get_tool_info to save tokens.
+ *
+ * Token savings: ~8,000 tokens per schema load when this isn't bundled.
  */
 export const TOOL_INFO = {
     start_work_session: `# start_work_session
@@ -32,7 +33,8 @@ Get token usage statistics for current session.
 Send heartbeat to maintain active status. Call every 30-60 seconds.
 
 **Parameters:**
-- session_id (optional): Uses current session if not provided`,
+- session_id (optional): Uses current session if not provided
+- current_worktree_path (optional): Report your current git worktree path (e.g., "../project-task-abc123")`,
     end_work_session: `# end_work_session
 End session and release claimed tasks.
 
@@ -629,7 +631,252 @@ Get cost breakdown by task for a project.
 - limit: Max tasks to return (default: 20)
 
 **Returns:** Tasks sorted by estimated cost with model breakdown`,
-    // Knowledge base tools
+    // Subtasks
+    add_subtask: `# add_subtask
+Add a subtask to break down a larger task.
+
+**Parameters:**
+- parent_task_id (required): UUID of the parent task
+- title (required): Subtask title
+- description (optional): Detailed description
+- priority (optional): 1-5 (defaults to parent priority)
+- estimated_minutes (optional): Time estimate
+
+**Note:** Max depth is 1 (subtasks cannot have their own subtasks).`,
+    get_subtasks: `# get_subtasks
+Get subtasks for a parent task.
+
+**Parameters:**
+- parent_task_id (required): UUID of the parent task
+- status (optional): Filter by status
+
+**Returns:** Subtasks with aggregate completion stats.`,
+    // Bodies of work
+    create_body_of_work: `# create_body_of_work
+Create a new body of work to group tasks into phases.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Title for the body of work
+- description (optional): Description
+- auto_deploy_on_completion (optional): Auto-deploy when all tasks complete (default: false)
+- deploy_environment (optional): Target environment (default: production)
+- deploy_version_bump (optional): Version bump (default: minor)
+- deploy_trigger (optional): When to trigger auto-deploy (default: all_completed_validated)`,
+    update_body_of_work: `# update_body_of_work
+Update a body of work's settings.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- title, description (optional)
+- auto_deploy_on_completion, deploy_environment, deploy_version_bump, deploy_trigger (optional)`,
+    get_body_of_work: `# get_body_of_work
+Get a body of work with all its tasks organized by phase.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
+**Returns:** Body of work with tasks grouped by pre/core/post phases.`,
+    get_bodies_of_work: `# get_bodies_of_work
+List bodies of work for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): Filter by status (draft, active, completed, cancelled)
+- limit (optional): Max items (default 50)`,
+    delete_body_of_work: `# delete_body_of_work
+Delete a body of work. Tasks are preserved but no longer grouped.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID`,
+    add_task_to_body_of_work: `# add_task_to_body_of_work
+Add a task to a body of work in a specific phase.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- task_id (required): Task UUID to add
+- phase (optional): pre, core, or post (default: core)
+- order_index (optional): Order within phase`,
+    remove_task_from_body_of_work: `# remove_task_from_body_of_work
+Remove a task from its body of work.
+
+**Parameters:**
+- task_id (required): Task UUID to remove
+
+**Note:** The task is preserved, just no longer grouped.`,
+    activate_body_of_work: `# activate_body_of_work
+Activate a draft body of work to start execution.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
+**Note:** Requires at least one task. Once active, tasks follow phase order.`,
+    add_task_dependency: `# add_task_dependency
+Add a dependency between tasks in a body of work.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+- task_id (required): Task that depends on another
+- depends_on_task_id (required): Task that must complete first
+
+**Note:** Prevents circular dependencies.`,
+    remove_task_dependency: `# remove_task_dependency
+Remove a dependency between tasks.
+
+**Parameters:**
+- task_id (required): Task UUID
+- depends_on_task_id (required): Dependency task UUID`,
+    get_task_dependencies: `# get_task_dependencies
+Get task dependencies for a body of work or specific task.
+
+**Parameters:**
+- body_of_work_id (optional): Body of work UUID
+- task_id (optional): Specific task UUID`,
+    get_next_body_of_work_task: `# get_next_body_of_work_task
+Get the next available task from a body of work.
+
+**Parameters:**
+- body_of_work_id (required): Body of work UUID
+
+**Note:** Considers phase order (pre → core → post) and dependencies.`,
+    // Sprints
+    create_sprint: `# create_sprint
+Create a new sprint with time bounds and velocity tracking.
+
+**Parameters:**
+- project_id (required): Project UUID
+- title (required): Sprint title (e.g., "Sprint 5")
+- start_date (required): Start date (YYYY-MM-DD)
+- end_date (required): End date (YYYY-MM-DD)
+- goal (optional): Sprint goal statement
+- auto_deploy_on_completion, deploy_environment, deploy_version_bump (optional)`,
+    update_sprint: `# update_sprint
+Update a sprint's details.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- title, goal, start_date, end_date (optional)
+- auto_deploy_on_completion, deploy_environment, deploy_version_bump (optional)`,
+    get_sprint: `# get_sprint
+Get a sprint with all its tasks organized by phase.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+
+**Returns:** Sprint with progress percentage, velocity points, committed points.`,
+    get_sprints: `# get_sprints
+List sprints for a project with velocity metrics.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): planning, active, in_review, retrospective, completed, cancelled
+- limit (optional): Max sprints (default 20)`,
+    delete_sprint: `# delete_sprint
+Delete a sprint. Tasks are preserved but no longer grouped.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID`,
+    start_sprint: `# start_sprint
+Start a sprint. Transitions from 'planning' to 'active'.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+
+**Note:** Locks committed_points at current total story points.`,
+    complete_sprint: `# complete_sprint
+Complete a sprint. Handles retrospective phase and auto-deployment.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- retrospective_notes (optional): Sprint retrospective notes
+- skip_retrospective (optional): Skip retrospective phase (default: false)`,
+    add_task_to_sprint: `# add_task_to_sprint
+Add a task to a sprint with optional story points.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- task_id (required): Task UUID to add
+- story_points (optional): Story point estimate
+- phase (optional): pre, core, or post (default: core)`,
+    remove_task_from_sprint: `# remove_task_from_sprint
+Remove a task from a sprint.
+
+**Parameters:**
+- sprint_id (required): Sprint UUID
+- task_id (required): Task UUID to remove
+
+**Note:** Task returns to backlog.`,
+    get_sprint_backlog: `# get_sprint_backlog
+Get tasks that can be added to a sprint.
+
+**Parameters:**
+- project_id (required): Project UUID
+- sprint_id (optional): Exclude tasks already in this sprint
+
+**Returns:** Tasks not assigned to any body of work or sprint.`,
+    get_sprint_velocity: `# get_sprint_velocity
+Get velocity metrics for completed sprints.
+
+**Parameters:**
+- project_id (required): Project UUID
+- limit (optional): Number of sprints to analyze (default 10)
+
+**Returns:** Committed vs completed points, average velocity.`,
+    // Git issues
+    add_git_issue: `# add_git_issue
+Record a git-related issue (merge conflict, push failure, etc.).
+
+**Parameters:**
+- project_id (required): Project UUID
+- issue_type (required): merge_conflict, push_failed, rebase_needed, branch_diverged, pr_not_mergeable
+- branch (required): Branch where the issue occurred
+- target_branch, conflicting_files, error_message, pr_url, task_id (optional)`,
+    resolve_git_issue: `# resolve_git_issue
+Mark a git issue as resolved.
+
+**Parameters:**
+- git_issue_id (required): Git issue UUID
+- resolution_note (optional): How the issue was resolved
+- auto_resolved (optional): Whether auto-resolved`,
+    get_git_issues: `# get_git_issues
+Get git issues for a project.
+
+**Parameters:**
+- project_id (required): Project UUID
+- status (optional): open or resolved (default: open)
+- issue_type (optional): Filter by issue type
+- branch (optional): Filter by branch
+- limit (optional): Max issues (default 50)`,
+    delete_git_issue: `# delete_git_issue
+Delete a git issue.
+
+**Parameters:**
+- git_issue_id (required): Git issue UUID`,
+    // Deployment requirements
+    add_deployment_requirement: `# add_deployment_requirement
+Add a pre-deployment requirement.
+
+**Parameters:**
+- project_id (required): Project UUID
+- type (required): migration, env_var, config, manual, breaking_change, agent_task
+- title (required): Brief description
+- description (optional): Detailed instructions
+- stage (optional): preparation, deployment, or verification (default: preparation)
+- file_path (optional): File path reference
+- blocking (optional): Whether converted task blocks other work`,
+    complete_deployment_requirement: `# complete_deployment_requirement
+Mark a deployment requirement as completed.
+
+**Parameters:**
+- requirement_id (required): Requirement UUID`,
+    get_deployment_requirements: `# get_deployment_requirements
+Get pending deployment requirements.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stage (optional): preparation, deployment, verification, or all
+- status (optional): pending, completed, converted_to_task, or all (default: pending)`,
+    // Knowledge base
     query_knowledge_base: `# query_knowledge_base
 Query aggregated project knowledge in a single call. Reduces token usage by combining multiple data sources.
 

package/dist/handlers/validation.js

@@ -33,7 +33,7 @@ export const claimValidation = async (args, ctx) => {
     return { result: response.data };
 };
 export const validateTask = async (args, ctx) => {
-    const { task_id, validation_notes, approved } = args;
+    const { task_id, validation_notes, approved, skip_pr_check } = args;
     validateRequired(task_id, 'task_id');
     validateUUID(task_id, 'task_id');
     if (approved === undefined) {
@@ -45,8 +45,20 @@ export const validateTask = async (args, ctx) => {
     const response = await apiClient.validateTask(task_id, {
         approved,
         validation_notes,
+        skip_pr_check,
     }, currentSessionId || undefined);
     if (!response.ok) {
+        // Handle PR required error specially
+        if (response.error === 'pr_required') {
+            return {
+                result: {
+                    error: 'pr_required',
+                    message: response.data?.message || 'A Pull Request is required before validation approval. Create a PR and add it via add_task_reference.',
+                    workflow: response.data?.workflow,
+                    action_required: 'Create a PR for this task and add it via add_task_reference(task_id, pr_url, label: "Pull Request")',
+                },
+            };
+        }
         throw new Error(response.error || 'Failed to validate task');
     }
     return { result: response.data };

package/dist/index.js

@@ -606,8 +606,8 @@ Returns session info, persona, and next task. Use mode:'full' for complete conte
                 },
                 task_type: {
                     type: 'string',
-                    enum: ['frontend', 'backend', 'database', 'mcp', 'testing', 'docs', 'infra', 'other'],
-                    description: 'Task category for visual grouping (frontend, backend, database, mcp, testing, docs, infra, other)',
+                    enum: ['frontend', 'backend', 'database', 'feature', 'bugfix', 'design', 'mcp', 'testing', 'docs', 'infra', 'other'],
+                    description: 'Task category (frontend, backend, database, feature, bugfix, design, mcp, testing, docs, infra, other)',
                 },
             },
             required: ['project_id', 'title'],
@@ -655,8 +655,8 @@ Returns session info, persona, and next task. Use mode:'full' for complete conte
                 },
                 task_type: {
                     type: 'string',
-                    enum: ['frontend', 'backend', 'database', 'mcp', 'testing', 'docs', 'infra', 'other'],
-                    description: 'Task category (frontend, backend, database, mcp, testing, docs, infra, other)',
+                    enum: ['frontend', 'backend', 'database', 'feature', 'bugfix', 'design', 'mcp', 'testing', 'docs', 'infra', 'other'],
+                    description: 'Task category (frontend, backend, database, feature, bugfix, design, mcp, testing, docs, infra, other)',
                 },
             },
             required: ['task_id'],
@@ -1371,6 +1371,10 @@ Returns subtasks with aggregate completion stats.`,
                     type: 'string',
                     description: 'Session ID from start_work_session (optional, uses current session if not provided)',
                 },
+                current_worktree_path: {
+                    type: ['string', 'null'],
+                    description: 'Report your current git worktree path (e.g., "../project-task-abc123"). Set to null to clear.',
+                },
             },
         },
     },
@@ -1420,7 +1424,7 @@ Returns subtasks with aggregate completion stats.`,
     },
     {
         name: 'validate_task',
-        description: 'Validate a completed task. Include test results in validation_notes.',
+        description: 'Validate a completed task. Include test results in validation_notes. For github-flow/git-flow projects, a PR must exist before approval (add via add_task_reference).',
         inputSchema: {
             type: 'object',
             properties: {
@@ -1436,6 +1440,10 @@ Returns subtasks with aggregate completion stats.`,
                     type: 'boolean',
                     description: 'Whether the task passes validation (true = approved, false = needs more work)',
                 },
+                skip_pr_check: {
+                    type: 'boolean',
+                    description: 'Skip PR existence check (use only for tasks that legitimately do not need a PR)',
+                },
             },
             required: ['task_id', 'approved'],
         },
@@ -2143,7 +2151,8 @@ Bodies of work allow organizing related tasks with optional auto-deployment on c
     },
     {
         name: 'get_body_of_work',
-        description: `Get a body of work with all its tasks organized by phase.`,
+        description: `Get a body of work with all its tasks organized by phase.
+Use summary_only: true to get task counts and next task instead of full task arrays (saves tokens).`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -2151,6 +2160,10 @@ Bodies of work allow organizing related tasks with optional auto-deployment on c
                     type: 'string',
                     description: 'Body of work UUID',
                 },
+                summary_only: {
+                    type: 'boolean',
+                    description: 'Return task counts and next task instead of full task arrays (default: false)',
+                },
             },
             required: ['body_of_work_id'],
         },
@@ -2426,7 +2439,8 @@ Sprints start in 'planning' status where tasks can be added with story points.`,
     {
         name: 'get_sprint',
         description: `Get a sprint with all its tasks organized by phase (pre/core/post).
-Includes progress percentage, velocity points, and committed points.`,
+Includes progress percentage, velocity points, and committed points.
+Use summary_only: true to get task counts and next task instead of full task arrays (saves tokens).`,
         inputSchema: {
             type: 'object',
             properties: {
@@ -2434,6 +2448,10 @@ Includes progress percentage, velocity points, and committed points.`,
                     type: 'string',
                     description: 'Sprint UUID',
                 },
+                summary_only: {
+                    type: 'boolean',
+                    description: 'Return task counts and next task instead of full task arrays (default: false)',
+                },
             },
             required: ['sprint_id'],
         },