@vibescope/mcp-server 0.2.3 → 0.2.4

package/dist/api-client.js

@@ -114,6 +114,61 @@ export class VibescopeApiClient {
     async getTask(taskId) {
         return this.request('GET', `/api/mcp/tasks/${taskId}`);
     }
+    /**
+     * Get a single task by ID with optional subtasks and milestones
+     */
+    async getTaskById(taskId, params) {
+        return this.proxy('get_task', {
+            task_id: taskId,
+            include_subtasks: params?.include_subtasks,
+            include_milestones: params?.include_milestones,
+        });
+    }
+    /**
+     * Search tasks by text query with pagination
+     */
+    async searchTasks(projectId, params) {
+        return this.proxy('search_tasks', {
+            project_id: projectId,
+            query: params.query,
+            status: params.status,
+            limit: params.limit,
+            offset: params.offset,
+        });
+    }
+    /**
+     * Get tasks filtered by priority with pagination
+     */
+    async getTasksByPriority(projectId, params) {
+        return this.proxy('get_tasks_by_priority', {
+            project_id: projectId,
+            priority: params?.priority,
+            priority_max: params?.priority_max,
+            status: params?.status,
+            limit: params?.limit,
+            offset: params?.offset,
+        });
+    }
+    /**
+     * Get recent tasks (newest or oldest) with pagination
+     */
+    async getRecentTasks(projectId, params) {
+        return this.proxy('get_recent_tasks', {
+            project_id: projectId,
+            order: params?.order,
+            status: params?.status,
+            limit: params?.limit,
+            offset: params?.offset,
+        });
+    }
+    /**
+     * Get task statistics for a project
+     */
+    async getTaskStats(projectId) {
+        return this.proxy('get_task_stats', {
+            project_id: projectId,
+        });
+    }
     async updateTask(taskId, updates) {
         return this.request('PATCH', `/api/mcp/tasks/${taskId}`, updates);
     }
@@ -173,6 +228,11 @@ export class VibescopeApiClient {
     async deleteBlocker(blockerId) {
         return this.proxy('delete_blocker', { blocker_id: blockerId });
     }
+    async getBlockersStats(projectId) {
+        return this.proxy('get_blockers_stats', {
+            project_id: projectId
+        });
+    }
     // ============================================================================
     // Decision endpoints
     // ============================================================================
@@ -188,6 +248,11 @@ export class VibescopeApiClient {
     async deleteDecision(decisionId) {
         return this.proxy('delete_decision', { decision_id: decisionId });
     }
+    async getDecisionsStats(projectId) {
+        return this.proxy('get_decisions_stats', {
+            project_id: projectId
+        });
+    }
     // ============================================================================
     // Idea endpoints
     // ============================================================================
@@ -274,8 +339,12 @@ export class VibescopeApiClient {
     // ============================================================================
     // Request endpoints
     // ============================================================================
-    async getPendingRequests(projectId, sessionId) {
-        return this.proxy('get_pending_requests', { project_id: projectId }, sessionId ? {
+    async getPendingRequests(projectId, sessionId, limit, offset) {
+        return this.proxy('get_pending_requests', {
+            project_id: projectId,
+            ...(limit !== undefined && { limit }),
+            ...(offset !== undefined && { offset }),
+        }, sessionId ? {
             session_id: sessionId,
             persona: null,
             instance_id: ''
@@ -334,8 +403,11 @@ export class VibescopeApiClient {
             ...params
         });
     }
-    async getActivitySchedules(projectId) {
-        return this.proxy('get_activity_schedules', { project_id: projectId });
+    async getActivitySchedules(projectId, params) {
+        return this.proxy('get_activity_schedules', {
+            project_id: projectId,
+            ...params
+        });
     }
     // ============================================================================
     // Subtask endpoints
@@ -439,6 +511,16 @@ export class VibescopeApiClient {
             ...params
         });
     }
+    /**
+     * Report actual API token usage for accurate cost tracking.
+     * This records token usage to the session and attributes cost to the current task.
+     */
+    async reportTokenUsage(sessionId, params) {
+        return this.proxy('report_token_usage', {
+            session_id: sessionId,
+            ...params
+        });
+    }
     // ============================================================================
     // Organization endpoints
     // ============================================================================
@@ -653,6 +735,11 @@ export class VibescopeApiClient {
             ...params
         });
     }
+    async getDeploymentRequirementsStats(projectId) {
+        return this.proxy('get_deployment_requirements_stats', {
+            project_id: projectId
+        });
+    }
     async completeDeploymentRequirement(requirementId) {
         return this.proxy('complete_deployment_requirement', { requirement_id: requirementId });
     }
@@ -662,10 +749,12 @@ export class VibescopeApiClient {
             ...params
         });
     }
-    async getScheduledDeployments(projectId, includeDisabled) {
+    async getScheduledDeployments(projectId, params) {
         return this.proxy('get_scheduled_deployments', {
             project_id: projectId,
-            include_disabled: includeDisabled
+            include_disabled: params?.includeDisabled,
+            limit: params?.limit,
+            offset: params?.offset
         });
     }
     async updateScheduledDeployment(scheduleId, updates) {
@@ -696,6 +785,9 @@ export class VibescopeApiClient {
             readme_content: readmeContent
         });
     }
+    async getProjectSummary(projectId) {
+        return this.proxy('get_project_summary', { project_id: projectId });
+    }
     // ============================================================================
     // Help Topics (database-backed)
     // ============================================================================
@@ -735,11 +827,21 @@ export class VibescopeApiClient {
     async abandonCheckout(params) {
         return this.proxy('abandon_checkout', params);
     }
+    async getFileCheckoutsStats(projectId) {
+        return this.proxy('get_file_checkouts_stats', { project_id: projectId });
+    }
     // ============================================================================
     // Worktree Management
     // ============================================================================
-    async getStaleWorktrees(projectId) {
-        return this.request('GET', `/api/mcp/worktrees/stale?project_id=${projectId}`);
+    async getStaleWorktrees(projectId, params) {
+        const queryParams = new URLSearchParams({ project_id: projectId });
+        if (params?.hostname !== undefined)
+            queryParams.set('hostname', params.hostname);
+        if (params?.limit !== undefined)
+            queryParams.set('limit', String(params.limit));
+        if (params?.offset !== undefined)
+            queryParams.set('offset', String(params.offset));
+        return this.request('GET', `/api/mcp/worktrees/stale?${queryParams.toString()}`);
     }
     async clearWorktreePath(taskId) {
         return this.request('PATCH', `/api/mcp/tasks/${taskId}`, { worktree_path: null });
@@ -777,6 +879,19 @@ export class VibescopeApiClient {
     async getConnectorEvents(params) {
         return this.proxy('get_connector_events', params);
     }
+    // ============================================================================
+    // Agent onboarding endpoints
+    // ============================================================================
+    /**
+     * Confirm that agent setup is complete for a project.
+     * This marks the agent type as onboarded so future sessions don't receive setup instructions.
+     */
+    async confirmAgentSetup(projectId, agentType) {
+        return this.proxy('confirm_agent_setup', {
+            project_id: projectId,
+            agent_type: agentType
+        });
+    }
 }
 // Singleton instance
 let apiClient = null;

package/dist/handlers/blockers.d.ts

@@ -10,8 +10,19 @@
 import type { Handler, HandlerRegistry } from './types.js';
 export declare const addBlocker: Handler;
 export declare const resolveBlocker: Handler;
+/**
+ * Get a single blocker by ID.
+ * More token-efficient than get_blockers when you need details for a specific blocker.
+ */
+export declare const getBlocker: Handler;
 export declare const getBlockers: Handler;
 export declare const deleteBlocker: Handler;
+/**
+ * Get aggregate statistics about blockers for a project.
+ * Returns total count and breakdown by status without the actual blocker data.
+ * This is much more token-efficient than get_blockers for understanding the overall state.
+ */
+export declare const getBlockersStats: Handler;
 /**
  * Blockers handlers registry
  */

package/dist/handlers/blockers.js

@@ -19,16 +19,22 @@ const resolveBlockerSchema = {
     blocker_id: { type: 'string', required: true, validate: uuidValidator },
     resolution_note: { type: 'string' },
 };
+const getBlockerSchema = {
+    blocker_id: { type: 'string', required: true, validate: uuidValidator },
+};
 const getBlockersSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
     status: { type: 'string', default: 'open', validate: createEnumValidator(VALID_BLOCKER_STATUSES) },
-    limit: { type: 'number', default: 50 },
+    limit: { type: 'number', default: 10 },
     offset: { type: 'number', default: 0 },
     search_query: { type: 'string' },
 };
 const deleteBlockerSchema = {
     blocker_id: { type: 'string', required: true, validate: uuidValidator },
 };
+const getBlockersStatsSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
+};
 export const addBlocker = async (args, ctx) => {
     const { project_id, description } = parseArgs(args, addBlockerSchema);
     const apiClient = getApiClient();
@@ -47,12 +53,25 @@ export const resolveBlocker = async (args, _ctx) => {
     }
     return success(response.data);
 };
+/**
+ * Get a single blocker by ID.
+ * More token-efficient than get_blockers when you need details for a specific blocker.
+ */
+export const getBlocker = async (args, _ctx) => {
+    const { blocker_id } = parseArgs(args, getBlockerSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('get_blocker', { blocker_id });
+    if (!response.ok) {
+        return error(response.error || 'Failed to get blocker');
+    }
+    return success(response.data);
+};
 export const getBlockers = async (args, _ctx) => {
     const { project_id, status, limit, offset, search_query } = parseArgs(args, getBlockersSchema);
     const apiClient = getApiClient();
     const response = await apiClient.getBlockers(project_id, {
         status,
-        limit,
+        limit: Math.min(limit ?? 10, 200),
         offset,
         search_query
     });
@@ -70,12 +89,28 @@ export const deleteBlocker = async (args, _ctx) => {
     }
     return success(response.data);
 };
+/**
+ * Get aggregate statistics about blockers for a project.
+ * Returns total count and breakdown by status without the actual blocker data.
+ * This is much more token-efficient than get_blockers for understanding the overall state.
+ */
+export const getBlockersStats = async (args, _ctx) => {
+    const { project_id } = parseArgs(args, getBlockersStatsSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.getBlockersStats(project_id);
+    if (!response.ok) {
+        return error(response.error || 'Failed to get blockers stats');
+    }
+    return success(response.data);
+};
 /**
  * Blockers handlers registry
  */
 export const blockerHandlers = {
     add_blocker: addBlocker,
     resolve_blocker: resolveBlocker,
+    get_blocker: getBlocker,
     get_blockers: getBlockers,
+    get_blockers_stats: getBlockersStats,
     delete_blocker: deleteBlocker,
 };

package/dist/handlers/bodies-of-work.d.ts

@@ -30,6 +30,8 @@ export declare const addTaskDependency: Handler;
 export declare const removeTaskDependency: Handler;
 export declare const getTaskDependencies: Handler;
 export declare const getNextBodyOfWorkTask: Handler;
+export declare const archiveBodyOfWork: Handler;
+export declare const unarchiveBodyOfWork: Handler;
 /**
  * Bodies of Work handlers registry
  */

package/dist/handlers/bodies-of-work.js

@@ -19,7 +19,7 @@
  */
 import { parseArgs, uuidValidator, createEnumValidator } from '../validators.js';
 import { getApiClient } from '../api-client.js';
-const BODY_OF_WORK_STATUSES = ['draft', 'active', 'completed', 'cancelled'];
+const BODY_OF_WORK_STATUSES = ['draft', 'active', 'completed', 'cancelled', 'archived'];
 const TASK_PHASES = ['pre', 'core', 'post'];
 const DEPLOY_ENVIRONMENTS = ['development', 'staging', 'production'];
 const VERSION_BUMPS = ['patch', 'minor', 'major'];
@@ -259,6 +259,33 @@ export const getNextBodyOfWorkTask = async (args, ctx) => {
     }
     return { result: response.data };
 };
+// ============================================================================
+// Archive / Unarchive Handlers
+// ============================================================================
+const archiveBodyOfWorkSchema = {
+    body_of_work_id: { type: 'string', required: true, validate: uuidValidator },
+};
+const unarchiveBodyOfWorkSchema = {
+    body_of_work_id: { type: 'string', required: true, validate: uuidValidator },
+};
+export const archiveBodyOfWork = async (args, ctx) => {
+    const { body_of_work_id } = parseArgs(args, archiveBodyOfWorkSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('archive_body_of_work', { body_of_work_id });
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to archive body of work' }, isError: true };
+    }
+    return { result: response.data };
+};
+export const unarchiveBodyOfWork = async (args, ctx) => {
+    const { body_of_work_id } = parseArgs(args, unarchiveBodyOfWorkSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('unarchive_body_of_work', { body_of_work_id });
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to unarchive body of work' }, isError: true };
+    }
+    return { result: response.data };
+};
 /**
  * Bodies of Work handlers registry
  */
@@ -275,4 +302,6 @@ export const bodiesOfWorkHandlers = {
     remove_task_dependency: removeTaskDependency,
     get_task_dependencies: getTaskDependencies,
     get_next_body_of_work_task: getNextBodyOfWorkTask,
+    archive_body_of_work: archiveBodyOfWork,
+    unarchive_body_of_work: unarchiveBodyOfWork,
 };

package/dist/handlers/connectors.js

@@ -68,7 +68,7 @@ export const getConnectors = async (args, _ctx) => {
     const response = await apiClient.getConnectors(project_id, {
         type,
         status,
-        limit,
+        limit: Math.min(limit ?? 50, 50),
         offset
     });
     if (!response.ok) {
@@ -161,7 +161,7 @@ export const getConnectorEvents = async (args, _ctx) => {
         connector_id,
         project_id,
         status,
-        limit,
+        limit: Math.min(limit ?? 50, 50),
         offset
     });
     if (!response.ok) {

package/dist/handlers/decisions.d.ts

@@ -10,8 +10,19 @@
  */
 import type { Handler, HandlerRegistry } from './types.js';
 export declare const logDecision: Handler;
+/**
+ * Get a single decision by ID.
+ * More token-efficient than get_decisions when you need details for a specific decision.
+ */
+export declare const getDecision: Handler;
 export declare const getDecisions: Handler;
 export declare const deleteDecision: Handler;
+/**
+ * Get aggregate statistics about decisions for a project.
+ * Returns total count without the actual decision data.
+ * This is more token-efficient than get_decisions for understanding overall state.
+ */
+export declare const getDecisionsStats: Handler;
 /**
  * Decisions handlers registry
  */

package/dist/handlers/decisions.js

@@ -18,15 +18,21 @@ const logDecisionSchema = {
     rationale: { type: 'string' },
     alternatives_considered: { type: 'array' },
 };
+const getDecisionSchema = {
+    decision_id: { type: 'string', required: true, validate: uuidValidator },
+};
 const getDecisionsSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
-    limit: { type: 'number', default: 50 },
+    limit: { type: 'number', default: 10 },
     offset: { type: 'number', default: 0 },
     search_query: { type: 'string' },
 };
 const deleteDecisionSchema = {
     decision_id: { type: 'string', required: true, validate: uuidValidator },
 };
+const getDecisionsStatsSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
+};
 export const logDecision = async (args, ctx) => {
     const { project_id, title, description, rationale, alternatives_considered } = parseArgs(args, logDecisionSchema);
     const { session } = ctx;
@@ -42,11 +48,24 @@ export const logDecision = async (args, ctx) => {
     }
     return { result: { success: true, title, decision_id: response.data?.decision_id } };
 };
+/**
+ * Get a single decision by ID.
+ * More token-efficient than get_decisions when you need details for a specific decision.
+ */
+export const getDecision = async (args, _ctx) => {
+    const { decision_id } = parseArgs(args, getDecisionSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.proxy('get_decision', { decision_id });
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to get decision' }, isError: true };
+    }
+    return { result: response.data };
+};
 export const getDecisions = async (args, _ctx) => {
     const { project_id, limit, offset, search_query } = parseArgs(args, getDecisionsSchema);
     const apiClient = getApiClient();
     const response = await apiClient.getDecisions(project_id, {
-        limit,
+        limit: Math.min(limit ?? 10, 200),
         offset,
         search_query
     });
@@ -68,11 +87,27 @@ export const deleteDecision = async (args, _ctx) => {
     }
     return { result: { success: true } };
 };
+/**
+ * Get aggregate statistics about decisions for a project.
+ * Returns total count without the actual decision data.
+ * This is more token-efficient than get_decisions for understanding overall state.
+ */
+export const getDecisionsStats = async (args, _ctx) => {
+    const { project_id } = parseArgs(args, getDecisionsStatsSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.getDecisionsStats(project_id);
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to get decisions stats' }, isError: true };
+    }
+    return { result: response.data };
+};
 /**
  * Decisions handlers registry
  */
 export const decisionHandlers = {
     log_decision: logDecision,
+    get_decision: getDecision,
     get_decisions: getDecisions,
+    get_decisions_stats: getDecisionsStats,
     delete_decision: deleteDecision,
 };

package/dist/handlers/deployment.d.ts

@@ -24,6 +24,12 @@ export declare const cancelDeployment: Handler;
 export declare const addDeploymentRequirement: Handler;
 export declare const completeDeploymentRequirement: Handler;
 export declare const getDeploymentRequirements: Handler;
+/**
+ * Get aggregate statistics about deployment requirements for a project.
+ * Returns total count and breakdowns by status, stage, and type.
+ * More token-efficient than get_deployment_requirements when you just need to understand the overall state.
+ */
+export declare const getDeploymentRequirementsStats: Handler;
 export declare const scheduleDeployment: Handler;
 export declare const getScheduledDeployments: Handler;
 export declare const updateScheduledDeployment: Handler;

package/dist/handlers/deployment.js

@@ -63,7 +63,7 @@ const addDeploymentRequirementSchema = {
     file_path: { type: 'string' },
     stage: { type: 'string', default: 'preparation', validate: createEnumValidator(REQUIREMENT_STAGES) },
     blocking: { type: 'boolean', default: false },
-    recurring: { type: 'boolean', default: false },
+    recurring: { type: 'boolean', default: true },
 };
 const completeDeploymentRequirementSchema = {
     requirement_id: { type: 'string', required: true, validate: uuidValidator },
@@ -72,6 +72,11 @@ const getDeploymentRequirementsSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
     status: { type: 'string', default: 'pending', validate: createEnumValidator(REQUIREMENT_STATUSES) },
     stage: { type: 'string', validate: createEnumValidator([...REQUIREMENT_STAGES, 'all']) },
+    limit: { type: 'number', default: 50 },
+    offset: { type: 'number', default: 0 },
+};
+const getDeploymentRequirementsStatsSchema = {
+    project_id: { type: 'string', required: true, validate: uuidValidator },
 };
 const scheduleDeploymentSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
@@ -87,6 +92,8 @@ const scheduleDeploymentSchema = {
 const getScheduledDeploymentsSchema = {
     project_id: { type: 'string', required: true, validate: uuidValidator },
     include_disabled: { type: 'boolean', default: false },
+    limit: { type: 'number', default: 50 },
+    offset: { type: 'number', default: 0 },
 };
 const updateScheduledDeploymentSchema = {
     schedule_id: { type: 'string', required: true, validate: uuidValidator },
@@ -216,17 +223,33 @@ export const completeDeploymentRequirement = async (args, ctx) => {
     return { result: response.data };
 };
 export const getDeploymentRequirements = async (args, ctx) => {
-    const { project_id, status, stage } = parseArgs(args, getDeploymentRequirementsSchema);
+    const { project_id, status, stage, limit, offset } = parseArgs(args, getDeploymentRequirementsSchema);
     const apiClient = getApiClient();
     const response = await apiClient.getDeploymentRequirements(project_id, {
         status: status,
-        stage: stage
+        stage: stage,
+        limit,
+        offset
     });
     if (!response.ok) {
         return { result: { error: response.error || 'Failed to get deployment requirements' }, isError: true };
     }
     return { result: response.data };
 };
+/**
+ * Get aggregate statistics about deployment requirements for a project.
+ * Returns total count and breakdowns by status, stage, and type.
+ * More token-efficient than get_deployment_requirements when you just need to understand the overall state.
+ */
+export const getDeploymentRequirementsStats = async (args, ctx) => {
+    const { project_id } = parseArgs(args, getDeploymentRequirementsStatsSchema);
+    const apiClient = getApiClient();
+    const response = await apiClient.getDeploymentRequirementsStats(project_id);
+    if (!response.ok) {
+        return { result: { error: response.error || 'Failed to get deployment requirements stats' }, isError: true };
+    }
+    return { result: response.data };
+};
 // ============================================================================
 // Scheduled Deployments
 // ============================================================================
@@ -269,9 +292,13 @@ export const scheduleDeployment = async (args, ctx) => {
     return { result: response.data };
 };
 export const getScheduledDeployments = async (args, ctx) => {
-    const { project_id, include_disabled } = parseArgs(args, getScheduledDeploymentsSchema);
+    const { project_id, include_disabled, limit, offset } = parseArgs(args, getScheduledDeploymentsSchema);
     const apiClient = getApiClient();
-    const response = await apiClient.getScheduledDeployments(project_id, include_disabled);
+    const response = await apiClient.getScheduledDeployments(project_id, {
+        includeDisabled: include_disabled,
+        limit,
+        offset
+    });
     if (!response.ok) {
         return { result: { error: response.error || 'Failed to get scheduled deployments' }, isError: true };
     }
@@ -359,6 +386,7 @@ export const deploymentHandlers = {
     add_deployment_requirement: addDeploymentRequirement,
     complete_deployment_requirement: completeDeploymentRequirement,
     get_deployment_requirements: getDeploymentRequirements,
+    get_deployment_requirements_stats: getDeploymentRequirementsStats,
     // Scheduled deployments
     schedule_deployment: scheduleDeployment,
     get_scheduled_deployments: getScheduledDeployments,