@vibescope/mcp-server 0.4.4 → 0.4.5

package/dist/api-client/sprints.js

@@ -0,0 +1,82 @@
+/**
+ * Sprints API Methods
+ *
+ * Methods for sprint management:
+ * - createSprint: Create a new sprint
+ * - updateSprint: Update sprint details
+ * - getSprint: Get a sprint with tasks
+ * - getSprints: List sprints for a project
+ * - deleteSprint: Delete a sprint
+ * - startSprint: Activate a sprint
+ * - completeSprint: Complete a sprint
+ * - addTaskToSprint: Add a task to a sprint
+ * - removeTaskFromSprint: Remove a task from a sprint
+ * - getSprintBacklog: Get tasks available to add to a sprint
+ * - getSprintVelocity: Get velocity metrics for completed sprints
+ */
+export function createSprintsMethods(proxy) {
+    return {
+        async createSprint(projectId, params) {
+            return proxy('create_sprint', {
+                project_id: projectId,
+                ...params
+            });
+        },
+        async updateSprint(sprintId, updates) {
+            return proxy('update_sprint', {
+                sprint_id: sprintId,
+                ...updates
+            });
+        },
+        async getSprint(sprintId, summaryOnly) {
+            return proxy('get_sprint', {
+                sprint_id: sprintId,
+                summary_only: summaryOnly
+            });
+        },
+        async getSprints(projectId, params) {
+            return proxy('get_sprints', {
+                project_id: projectId,
+                ...params
+            });
+        },
+        async deleteSprint(sprintId) {
+            return proxy('delete_sprint', { sprint_id: sprintId });
+        },
+        async startSprint(sprintId) {
+            return proxy('start_sprint', { sprint_id: sprintId });
+        },
+        async completeSprint(sprintId, params) {
+            return proxy('complete_sprint', {
+                sprint_id: sprintId,
+                ...params
+            });
+        },
+        async addTaskToSprint(sprintId, taskId, params) {
+            return proxy('add_task_to_sprint', {
+                sprint_id: sprintId,
+                task_id: taskId,
+                ...params
+            });
+        },
+        async removeTaskFromSprint(sprintId, taskId) {
+            return proxy('remove_task_from_sprint', {
+                sprint_id: sprintId,
+                task_id: taskId
+            });
+        },
+        async getSprintBacklog(projectId, sprintId, params) {
+            return proxy('get_sprint_backlog', {
+                project_id: projectId,
+                sprint_id: sprintId,
+                ...params
+            });
+        },
+        async getSprintVelocity(projectId, limit) {
+            return proxy('get_sprint_velocity', {
+                project_id: projectId,
+                limit
+            });
+        }
+    };
+}

package/dist/api-client/subtasks.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Subtasks API Methods
+ *
+ * Methods for subtask management:
+ * - addSubtask: Add a subtask to a parent task
+ * - getSubtasks: Get subtasks for a parent task
+ */
+import type { ApiResponse, ProxyFn } from './types.js';
+export interface SubtasksMethods {
+    addSubtask(parentTaskId: string, params: {
+        title: string;
+        description?: string;
+        priority?: number;
+        estimated_minutes?: number;
+    }, sessionId?: string): Promise<ApiResponse<{
+        success: boolean;
+        subtask_id: string;
+        parent_task_id: string;
+    }>>;
+    getSubtasks(parentTaskId: string, status?: string): Promise<ApiResponse<{
+        subtasks: Array<{
+            id: string;
+            title: string;
+            description?: string;
+            priority: number;
+            status: string;
+            progress_percentage?: number;
+            estimated_minutes?: number;
+        }>;
+        stats: {
+            total: number;
+            completed: number;
+            progress_percentage: number;
+        };
+    }>>;
+}
+export declare function createSubtasksMethods(proxy: ProxyFn): SubtasksMethods;

package/dist/api-client/subtasks.js

@@ -0,0 +1,23 @@
+/**
+ * Subtasks API Methods
+ *
+ * Methods for subtask management:
+ * - addSubtask: Add a subtask to a parent task
+ * - getSubtasks: Get subtasks for a parent task
+ */
+export function createSubtasksMethods(proxy) {
+    return {
+        async addSubtask(parentTaskId, params, sessionId) {
+            return proxy('add_subtask', {
+                parent_task_id: parentTaskId,
+                ...params
+            }, sessionId ? { session_id: sessionId } : undefined);
+        },
+        async getSubtasks(parentTaskId, status) {
+            return proxy('get_subtasks', {
+                parent_task_id: parentTaskId,
+                status
+            });
+        }
+    };
+}

package/dist/api-client.d.ts

@@ -1427,6 +1427,13 @@ export declare class VibescopeApiClient {
     completeDeploymentRequirement(requirementId: string): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    reorderDeploymentRequirements(projectId: string, params: {
+        stage: string;
+        requirement_ids: string[];
+    }): Promise<ApiResponse<{
+        success: boolean;
+        reordered: number;
+    }>>;
     scheduleDeployment(projectId: string, params: {
         scheduled_at: string;
         schedule_type?: string;
@@ -1730,6 +1737,21 @@ export declare class VibescopeApiClient {
         project_id: string;
         agent_type: string;
     }>>;
+    sendProjectMessage(projectId: string, message: string, sessionId?: string): Promise<ApiResponse<{
+        success: boolean;
+        message_id: string;
+        sent_at: string;
+    }>>;
+    getProjectMessages(projectId: string, limit?: number): Promise<ApiResponse<{
+        messages: Array<{
+            id: string;
+            sender_type: string;
+            sender_name: string | null;
+            content: string;
+            created_at: string;
+        }>;
+        count: number;
+    }>>;
 }
 export declare function getApiClient(): VibescopeApiClient;
 export declare function initApiClient(config: ApiClientConfig): VibescopeApiClient;

package/dist/api-client.js

@@ -863,6 +863,12 @@ export class VibescopeApiClient {
     async completeDeploymentRequirement(requirementId) {
         return this.proxy('complete_deployment_requirement', { requirement_id: requirementId });
     }
+    async reorderDeploymentRequirements(projectId, params) {
+        return this.proxy('reorder_deployment_requirements', {
+            project_id: projectId,
+            ...params,
+        });
+    }
     async scheduleDeployment(projectId, params) {
         return this.proxy('schedule_deployment', {
             project_id: projectId,
@@ -1012,6 +1018,15 @@ export class VibescopeApiClient {
             agent_type: agentType
         });
     }
+    async sendProjectMessage(projectId, message, sessionId) {
+        return this.proxy('send_project_message', { project_id: projectId, message }, sessionId ? { session_id: sessionId, persona: null, instance_id: '' } : undefined);
+    }
+    async getProjectMessages(projectId, limit) {
+        return this.proxy('get_project_messages', {
+            project_id: projectId,
+            ...(limit !== undefined && { limit }),
+        });
+    }
 }
 // Singleton instance
 let apiClient = null;

package/dist/handlers/blockers.js

@@ -10,6 +10,7 @@
 import { success, error } from './types.js';
 import { parseArgs, uuidValidator, createEnumValidator, VALID_BLOCKER_STATUSES, } from '../validators.js';
 import { getApiClient } from '../api-client.js';
+import { autoPostActivity } from './chat.js';
 // Argument schemas for type-safe parsing
 const addBlockerSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
@@ -42,6 +43,9 @@ export const addBlocker = async (args, ctx) => {
     if (!response.ok) {
         return error(response.error || 'Failed to add blocker');
     }
+    // Auto-post blocker activity to project chat
+    const persona = ctx.session.currentPersona || 'Agent';
+    void autoPostActivity(project_id, `🚧 **${persona}** reported a blocker: ${description}`, ctx.session.currentSessionId);
     return success(response.data);
 };
 export const resolveBlocker = async (args, _ctx) => {

package/dist/handlers/chat.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Chat handlers
+ *
+ * Handlers for project chat tools:
+ * - send_project_message: Post a message to the project chat
+ * - get_project_messages: Read recent messages from project chat
+ *
+ * Also exports autoPostActivity — a fire-and-forget helper used by other
+ * handlers to log agent boot progress and key events to the chat window.
+ */
+import type { Handler, HandlerRegistry } from './types.js';
+export declare const sendProjectMessage: Handler;
+export declare const getProjectMessages: Handler;
+/**
+ * Auto-post an agent activity message to the project chat.
+ *
+ * Fire-and-forget: errors are silently swallowed so auto-posting never
+ * interrupts or breaks the main tool response.
+ */
+export declare function autoPostActivity(projectId: string, message: string, sessionId?: string | null): Promise<void>;
+export declare const chatHandlers: HandlerRegistry;

package/dist/handlers/chat.js

@@ -0,0 +1,59 @@
+/**
+ * Chat handlers
+ *
+ * Handlers for project chat tools:
+ * - send_project_message: Post a message to the project chat
+ * - get_project_messages: Read recent messages from project chat
+ *
+ * Also exports autoPostActivity — a fire-and-forget helper used by other
+ * handlers to log agent boot progress and key events to the chat window.
+ */
+import { parseArgs, uuidValidator } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+const sendProjectMessageSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
+    message: { type: 'string', required: true },
+};
+const getProjectMessagesSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
+    limit: { type: 'number' },
+};
+export const sendProjectMessage = async (args, ctx) => {
+    const { project_id, message } = parseArgs(args, sendProjectMessageSchema);
+    const api = getApiClient();
+    const response = await api.sendProjectMessage(project_id, message, ctx.session.currentSessionId || undefined);
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to send message' }, isError: true };
+    }
+    return { result: response.data };
+};
+export const getProjectMessages = async (args, _ctx) => {
+    const { project_id, limit } = parseArgs(args, getProjectMessagesSchema);
+    const api = getApiClient();
+    const response = await api.getProjectMessages(project_id, limit);
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to fetch messages' }, isError: true };
+    }
+    return { result: response.data };
+};
+/**
+ * Auto-post an agent activity message to the project chat.
+ *
+ * Fire-and-forget: errors are silently swallowed so auto-posting never
+ * interrupts or breaks the main tool response.
+ */
+export async function autoPostActivity(projectId, message, sessionId) {
+    if (!projectId)
+        return;
+    try {
+        const api = getApiClient();
+        await api.sendProjectMessage(projectId, message, sessionId ?? undefined);
+    }
+    catch {
+        // Silently ignore — activity logging must never break main functionality
+    }
+}
+export const chatHandlers = {
+    send_project_message: sendProjectMessage,
+    get_project_messages: getProjectMessages,
+};

package/dist/handlers/deployment.d.ts

@@ -12,6 +12,8 @@
  * - add_deployment_requirement
  * - complete_deployment_requirement
  * - get_deployment_requirements
+ * - get_deployment_requirements_stats
+ * - reorder_deployment_requirements
  */
 import type { Handler, HandlerRegistry } from './types.js';
 export declare const requestDeployment: Handler;
@@ -30,6 +32,7 @@ export declare const getDeploymentRequirements: Handler;
  * More token-efficient than get_deployment_requirements when you just need to understand the overall state.
  */
 export declare const getDeploymentRequirementsStats: Handler;
+export declare const reorderDeploymentRequirements: Handler;
 export declare const scheduleDeployment: Handler;
 export declare const getScheduledDeployments: Handler;
 export declare const updateScheduledDeployment: Handler;

package/dist/handlers/deployment.js

@@ -12,6 +12,8 @@
  * - add_deployment_requirement
  * - complete_deployment_requirement
  * - get_deployment_requirements
+ * - get_deployment_requirements_stats
+ * - reorder_deployment_requirements
  */
 import { ValidationError, parseArgs, uuidValidator, createEnumValidator, } from '../validators.js';
 import { getApiClient } from '../api-client.js';
@@ -251,6 +253,26 @@ export const getDeploymentRequirementsStats = async (args, ctx) => {
     return { result: response.data };
 };
 // ============================================================================
+// Reorder Deployment Requirements
+// ============================================================================
+const reorderDeploymentRequirementsSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
+    stage: { type: 'string', required: true, validate: createEnumValidator(REQUIREMENT_STAGES) },
+    requirement_ids: { type: 'object', required: true },
+};
+export const reorderDeploymentRequirements = async (args, ctx) => {
+    const { project_id, stage, requirement_ids } = parseArgs(args, reorderDeploymentRequirementsSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.reorderDeploymentRequirements(project_id, {
+        stage,
+        requirement_ids: requirement_ids,
+    });
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to reorder deployment requirements' }, isError: true };
+    }
+    return { result: response.data };
+};
+// ============================================================================
 // Scheduled Deployments
 // ============================================================================
 export const scheduleDeployment = async (args, ctx) => {
@@ -387,6 +409,7 @@ export const deploymentHandlers = {
     complete_deployment_requirement: completeDeploymentRequirement,
     get_deployment_requirements: getDeploymentRequirements,
     get_deployment_requirements_stats: getDeploymentRequirementsStats,
+    reorder_deployment_requirements: reorderDeploymentRequirements,
     // Scheduled deployments
     schedule_deployment: scheduleDeployment,
     get_scheduled_deployments: getScheduledDeployments,

package/dist/handlers/discovery.js

@@ -159,6 +159,7 @@ export const TOOL_CATEGORIES = {
             { name: 'complete_deployment_requirement', brief: 'Mark step done' },
             { name: 'get_deployment_requirements', brief: 'List pre-deploy steps' },
             { name: 'get_deployment_requirements_stats', brief: 'Get requirements statistics' },
+            { name: 'reorder_deployment_requirements', brief: 'Reorder steps within a stage' },
             { name: 'schedule_deployment', brief: 'Schedule future deployment' },
             { name: 'get_scheduled_deployments', brief: 'List scheduled deployments' },
             { name: 'update_scheduled_deployment', brief: 'Update schedule config' },

package/dist/handlers/index.d.ts

@@ -29,6 +29,7 @@ export * from './roles.js';
 export * from './connectors.js';
 export * from './cloud-agents.js';
 export * from './version.js';
+export * from './chat.js';
 import type { HandlerRegistry } from './types.js';
 /**
  * Build the complete handler registry from all modules

package/dist/handlers/index.js

@@ -29,6 +29,7 @@ export * from './roles.js';
 export * from './connectors.js';
 export * from './cloud-agents.js';
 export * from './version.js';
+export * from './chat.js';
 import { milestoneHandlers } from './milestones.js';
 import { sessionHandlers } from './session.js';
 import { ideaHandlers } from './ideas.js';
@@ -53,6 +54,7 @@ import { roleHandlers } from './roles.js';
 import { connectorHandlers } from './connectors.js';
 import { cloudAgentHandlers } from './cloud-agents.js';
 import { versionHandlers } from './version.js';
+import { chatHandlers } from './chat.js';
 /**
  * Build the complete handler registry from all modules
  */
@@ -82,5 +84,6 @@ export function buildHandlerRegistry() {
         ...connectorHandlers,
         ...cloudAgentHandlers,
         ...versionHandlers,
+        ...chatHandlers,
     };
 }

package/dist/handlers/session.js

@@ -15,6 +15,7 @@ import { getApiClient } from '../api-client.js';
 import { getAgentGuidelinesTemplate, getAgentGuidelinesSummary } from '../templates/agent-guidelines.js';
 import { getFallbackHelpContent, getAvailableHelpTopics } from '../templates/help-content.js';
 import { normalizeGitUrl } from '../utils.js';
+import { autoPostActivity } from './chat.js';
 /**
  * Simple hash for content change detection.
  */
@@ -495,6 +496,12 @@ export const startWorkSession = async (args, ctx) => {
             ? `start_fallback_activity(project_id: "${data.project.id}", activity: "code_review")`
             : 'signal_idle() — no tasks available and fallback activities are disabled.';
     }
+    // Auto-post boot activity to project chat
+    if (data.project?.id) {
+        const persona = data.persona || 'Agent';
+        const nextTaskInfo = data.next_task ? ` Next task: **${data.next_task.title}**` : '';
+        void autoPostActivity(data.project.id, `🤖 **${persona}** started a work session.${nextTaskInfo}`, data.session_id);
+    }
     return { result };
 };
 export const heartbeat = async (args, ctx) => {

package/dist/handlers/tasks.js

@@ -25,6 +25,7 @@ import os from 'os';
 import { parseArgs, uuidValidator, taskStatusValidator, priorityValidator, progressValidator, minutesValidator, createEnumValidator, ValidationError, } from '../validators.js';
 import { getApiClient } from '../api-client.js';
 import { capPagination, PAGINATION_LIMITS } from '../utils.js';
+import { autoPostActivity } from './chat.js';
 // Auto-detect machine hostname for worktree tracking
 const MACHINE_HOSTNAME = os.hostname();
 // Valid task types
@@ -481,6 +482,12 @@ export const completeTask = async (args, ctx) => {
             timing: 'Remove immediately after PR is created and complete_task is called',
         };
     }
+    // Auto-post completion activity to project chat
+    if (ctx.session.currentProjectId) {
+        const persona = ctx.session.currentPersona || 'Agent';
+        const summaryText = summary ? `: ${summary}` : '';
+        void autoPostActivity(ctx.session.currentProjectId, `✅ **${persona}** completed a task${summaryText}`, ctx.session.currentSessionId || undefined);
+    }
     return { result };
 };
 export const deleteTask = async (args, ctx) => {

package/dist/handlers/tool-docs.js

@@ -955,6 +955,13 @@ Get pending deployment requirements.
 - project_id (required): Project UUID
 - stage (optional): preparation, deployment, verification, or all
 - status (optional): pending, completed, converted_to_task, or all (default: pending)`,
+    reorder_deployment_requirements: `# reorder_deployment_requirements
+Reorder deployment requirements within a stage.
+
+**Parameters:**
+- project_id (required): Project UUID
+- stage (required): preparation, deployment, or verification
+- requirement_ids (required): Array of requirement UUIDs in desired order`,
     // 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/tools/deployment.js

@@ -262,6 +262,19 @@ export const deploymentTools = [
             required: ['project_id'],
         },
     },
+    {
+        name: 'reorder_deployment_requirements',
+        description: `Reorder deployment requirements within a stage. Pass the requirement IDs in the desired order.`,
+        inputSchema: {
+            type: 'object',
+            properties: {
+                project_id: { type: 'string', description: 'Project UUID' },
+                stage: { type: 'string', enum: ['preparation', 'deployment', 'verification'], description: 'Deployment stage' },
+                requirement_ids: { type: 'array', items: { type: 'string' }, description: 'Ordered array of requirement UUIDs' },
+            },
+            required: ['project_id', 'stage', 'requirement_ids'],
+        },
+    },
     {
         name: 'schedule_deployment',
         description: `Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.`,

package/docs/TOOLS.md

@@ -2,9 +2,9 @@
 
 > Auto-generated from tool definitions. Do not edit manually.
 >
-> Generated: 2026-02-21
+> Generated: 2026-02-22
 >
-> Total tools: 159
+> Total tools: 160
 
 ## Table of Contents
 
@@ -18,7 +18,7 @@
 - [ideas](#ideas) - Feature ideas tracking (6 tools)
 - [findings](#findings) - Audit findings/knowledge base (6 tools)
 - [validation](#validation) - Cross-agent task validation (3 tools)
-- [deployment](#deployment) - Deployment coordination (17 tools)
+- [deployment](#deployment) - Deployment coordination (18 tools)
 - [fallback](#fallback) - Background activities when idle (4 tools)
 - [bodies_of_work](#bodies-of-work) - Group tasks into bodies of work (12 tools)
 - [sprints](#sprints) - Time-bounded sprints with velocity tracking (11 tools)
@@ -1192,6 +1192,20 @@ Get aggregate statistics about deployment requirements for a project. Returns to
 
 ---
 
+### reorder_deployment_requirements
+
+Reorder deployment requirements within a stage. Pass the requirement IDs in the desired order.
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `project_id` | `string` | Yes | Project UUID |
+| `stage` | `"preparation" | "deployment" | "verification"` | Yes | Deployment stage |
+| `requirement_ids` | `string[]` | Yes | Ordered array of requirement UUIDs |
+
+---
+
 ### schedule_deployment
 
 Schedule a deployment for a specific time. Supports one-time and recurring schedules with auto-trigger or manual trigger modes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vibescope/mcp-server",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "MCP server for Vibescope - AI project tracking tools",
   "type": "module",
   "main": "dist/index.js",