@vibescope/mcp-server 0.1.0 → 0.2.0

package/README.md

@@ -13,7 +13,7 @@ Use directly in your MCP config without installing:
   "mcpServers": {
     "vibescope": {
       "command": "npx",
-      "args": ["-y", "@vibescope/mcp-server"],
+      "args": ["-y", "-p", "@vibescope/mcp-server", "vibescope-mcp"],
       "env": {
         "VIBESCOPE_API_KEY": "your-api-key"
       }

package/dist/api-client.d.ts

@@ -81,7 +81,9 @@ export declare class VibescopeApiClient {
         };
         error?: string;
     }>>;
-    heartbeat(sessionId: string): Promise<ApiResponse<{
+    heartbeat(sessionId: string, options?: {
+        current_worktree_path?: string | null;
+    }): Promise<ApiResponse<{
         success: boolean;
         session_id: string;
         timestamp: string;
@@ -276,6 +278,20 @@ export declare class VibescopeApiClient {
     }): Promise<ApiResponse<{
         success: boolean;
         task_id: string;
+        git_workflow?: {
+            workflow: string;
+            base_branch: string;
+            suggested_branch: string;
+            worktree_required: boolean;
+        };
+        worktree_setup?: {
+            message: string;
+            commands: string[];
+            worktree_path: string;
+            branch_name: string;
+            cleanup_command: string;
+        };
+        next_step?: string;
     }>>;
     completeTask(taskId: string, params: {
         summary?: string;
@@ -297,6 +313,7 @@ export declare class VibescopeApiClient {
             deployment?: string;
         };
         next_action: string;
+        warnings?: string[];
     }>>;
     deleteTask(taskId: string): Promise<ApiResponse<{
         success: boolean;
@@ -434,6 +451,9 @@ export declare class VibescopeApiClient {
         severity?: string;
         status?: string;
         limit?: number;
+        offset?: number;
+        search_query?: string;
+        summary_only?: boolean;
     }): Promise<ApiResponse<{
         findings: Array<{
             id: string;
@@ -447,6 +467,14 @@ export declare class VibescopeApiClient {
             resolution_note?: string;
             created_at: string;
         }>;
+        total_count?: number;
+        has_more?: boolean;
+    }>>;
+    getFindingsStats(projectId: string): Promise<ApiResponse<{
+        total: number;
+        by_status: Record<string, number>;
+        by_severity: Record<string, number>;
+        by_category: Record<string, number>;
     }>>;
     addFinding(projectId: string, params: {
         title: string;
@@ -550,16 +578,33 @@ export declare class VibescopeApiClient {
     validateTask(taskId: string, params: {
         approved: boolean;
         validation_notes?: string;
+        skip_pr_check?: boolean;
     }, sessionId?: string): Promise<ApiResponse<{
         success: boolean;
         approved: boolean;
         task_id: string;
         message?: string;
+        workflow?: string;
     }>>;
     startFallbackActivity(projectId: string, activity: string, sessionId?: string): Promise<ApiResponse<{
         success: boolean;
         activity: string;
         message: string;
+        git_workflow?: {
+            workflow: string;
+            base_branch: string;
+            worktree_recommended: boolean;
+            note: string;
+        };
+        worktree_setup?: {
+            message: string;
+            commands: string[];
+            worktree_path: string;
+            branch_name: string;
+            cleanup_command: string;
+            report_worktree: string;
+        };
+        next_step?: string;
     }>>;
     stopFallbackActivity(projectId: string, summary?: string, sessionId?: string): Promise<ApiResponse<{
         success: boolean;
@@ -1023,6 +1068,7 @@ export declare class VibescopeApiClient {
         file_path?: string;
         stage?: string;
         blocking?: boolean;
+        recurring?: boolean;
     }): Promise<ApiResponse<{
         success: boolean;
         requirement_id: string;
@@ -1108,6 +1154,15 @@ export declare class VibescopeApiClient {
         success: boolean;
         project_id: string;
     }>>;
+    getHelpTopic(slug: string): Promise<ApiResponse<{
+        slug: string;
+        title: string;
+        content: string;
+    } | null>>;
+    getHelpTopics(): Promise<ApiResponse<Array<{
+        slug: string;
+        title: string;
+    }>>>;
 }
 export declare function getApiClient(): VibescopeApiClient;
 export declare function initApiClient(config: ApiClientConfig): VibescopeApiClient;

package/dist/api-client.js

@@ -55,9 +55,10 @@ export class VibescopeApiClient {
     async startSession(params) {
         return this.request('POST', '/api/mcp/sessions/start', params);
     }
-    async heartbeat(sessionId) {
+    async heartbeat(sessionId, options) {
         return this.request('POST', '/api/mcp/sessions/heartbeat', {
-            session_id: sessionId
+            session_id: sessionId,
+            ...options
         });
     }
     async endSession(sessionId) {
@@ -221,6 +222,11 @@ export class VibescopeApiClient {
             ...params
         });
     }
+    async getFindingsStats(projectId) {
+        return this.proxy('get_findings_stats', {
+            project_id: projectId
+        });
+    }
     async addFinding(projectId, params, sessionId) {
         return this.proxy('add_finding', {
             project_id: projectId,
@@ -679,6 +685,15 @@ export class VibescopeApiClient {
             readme_content: readmeContent
         });
     }
+    // ============================================================================
+    // Help Topics (database-backed)
+    // ============================================================================
+    async getHelpTopic(slug) {
+        return this.proxy('get_help_topic', { slug });
+    }
+    async getHelpTopics() {
+        return this.proxy('get_help_topics', {});
+    }
 }
 // Singleton instance
 let apiClient = null;

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

@@ -77,11 +77,12 @@ export const updateBodyOfWork = async (args, ctx) => {
     return { result: { success: true, body_of_work_id } };
 };
 export const getBodyOfWork = async (args, ctx) => {
-    const { body_of_work_id } = args;
+    const { body_of_work_id, summary_only = false } = args;
     validateRequired(body_of_work_id, 'body_of_work_id');
     validateUUID(body_of_work_id, 'body_of_work_id');
     const apiClient = getApiClient();
-    const response = await apiClient.proxy('get_body_of_work', { body_of_work_id });
+    // Response type varies based on summary_only
+    const response = await apiClient.proxy('get_body_of_work', { body_of_work_id, summary_only });
     if (!response.ok) {
         throw new Error(`Failed to get body of work: ${response.error}`);
     }

package/dist/handlers/deployment.js

@@ -130,7 +130,7 @@ export const cancelDeployment = async (args, ctx) => {
     return { result: response.data };
 };
 export const addDeploymentRequirement = async (args, ctx) => {
-    const { project_id, type, title, description, file_path, stage = 'preparation', blocking = false } = args;
+    const { project_id, type, title, description, file_path, stage = 'preparation', blocking = false, recurring = false } = args;
     validateRequired(project_id, 'project_id');
     validateUUID(project_id, 'project_id');
     validateRequired(type, 'type');
@@ -150,7 +150,8 @@ export const addDeploymentRequirement = async (args, ctx) => {
         description,
         file_path,
         stage: stage,
-        blocking
+        blocking,
+        recurring
     });
     if (!response.ok) {
         throw new Error(response.error || 'Failed to add deployment requirement');

package/dist/handlers/discovery.d.ts

@@ -4,6 +4,9 @@
  * Handles tool discovery and documentation:
  * - discover_tools
  * - get_tool_info
+ *
+ * Note: Tool documentation is lazy-loaded from tool-docs.ts to save tokens.
+ * This saves ~8,000 tokens per schema load.
  */
 import type { Handler, HandlerRegistry } from './types.js';
 export declare const discoverTools: Handler;