@vibescope/mcp-server 0.0.1 → 0.1.0

package/dist/cli.d.ts

@@ -8,10 +8,6 @@
  *   1 = Non-compliant (block exit, loop back)
  *   2 = Error (allow exit with warning)
  */
-export interface AuthContext {
-    userId: string;
-    apiKeyId: string;
-}
 export interface VerificationResult {
     status: 'compliant' | 'non_compliant' | 'no_session' | 'error';
     reason: string;
@@ -28,7 +24,6 @@ export interface VerificationResult {
         session_duration_minutes: number | null;
     };
 }
+export declare function normalizeGitUrl(url: string): string;
 export declare function detectGitUrl(): string | null;
-export declare function hashApiKey(key: string): string;
-export declare function validateApiKey(supabase: any, apiKey: string): Promise<AuthContext | null>;
 export declare function verify(gitUrl?: string, projectId?: string): Promise<VerificationResult>;

package/dist/cli.js

@@ -8,19 +8,30 @@
  *   1 = Non-compliant (block exit, loop back)
  *   2 = Error (allow exit with warning)
  */
-import { createClient } from '@supabase/supabase-js';
-import { createHash } from 'crypto';
 import { execSync } from 'child_process';
-import { normalizeGitUrl } from './utils.js';
 // ============================================================================
-// Configuration
+// Configuration (read at runtime for testability)
 // ============================================================================
-const SUPABASE_URL = process.env.SUPABASE_URL || process.env.PUBLIC_SUPABASE_URL;
-const SUPABASE_SERVICE_KEY = process.env.SUPABASE_SERVICE_KEY;
-const API_KEY = process.env.VIBESCOPE_API_KEY;
+function getApiKey() {
+    return process.env.VIBESCOPE_API_KEY;
+}
+function getApiUrl() {
+    return process.env.VIBESCOPE_API_URL || 'https://vibescope.dev';
+}
 // ============================================================================
 // Git URL Detection
 // ============================================================================
+export function normalizeGitUrl(url) {
+    // Remove .git suffix
+    let normalized = url.replace(/\.git$/, '');
+    // Convert SSH to HTTPS format
+    if (normalized.startsWith('git@')) {
+        normalized = normalized
+            .replace(/^git@/, 'https://')
+            .replace(/:([^/])/, '/$1');
+    }
+    return normalized;
+}
 export function detectGitUrl() {
     try {
         const url = execSync('git config --get remote.origin.url', {
@@ -28,7 +39,6 @@ export function detectGitUrl() {
             timeout: 5000,
             stdio: ['pipe', 'pipe', 'pipe'],
         }).trim();
-        // Normalize: remove .git suffix, convert SSH to HTTPS format
         return normalizeGitUrl(url);
     }
     catch {
@@ -36,252 +46,42 @@ export function detectGitUrl() {
     }
 }
 // ============================================================================
-// Authentication (reused from index.ts)
-// ============================================================================
-export function hashApiKey(key) {
-    return createHash('sha256').update(key).digest('hex');
-}
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-export async function validateApiKey(supabase, apiKey) {
-    const keyHash = hashApiKey(apiKey);
-    const { data, error } = await supabase
-        .from('api_keys')
-        .select('id, user_id')
-        .eq('key_hash', keyHash)
-        .single();
-    if (error || !data) {
-        return null;
-    }
-    // Cast to expected shape since we're using untyped client
-    const row = data;
-    return {
-        userId: row.user_id,
-        apiKeyId: row.id,
-    };
-}
-// ============================================================================
 // Verification Logic
 // ============================================================================
 export async function verify(gitUrl, projectId) {
-    // Check environment
-    if (!SUPABASE_URL || !SUPABASE_SERVICE_KEY) {
-        return {
-            status: 'error',
-            reason: 'Missing SUPABASE_URL or SUPABASE_SERVICE_KEY environment variables',
-        };
-    }
-    if (!API_KEY) {
+    // Check environment (read at runtime for testability)
+    const apiKey = getApiKey();
+    if (!apiKey) {
         return {
             status: 'error',
             reason: 'VIBESCOPE_API_KEY environment variable not set',
         };
     }
-    const supabase = createClient(SUPABASE_URL, SUPABASE_SERVICE_KEY);
-    // Validate API key
-    const auth = await validateApiKey(supabase, API_KEY);
-    if (!auth) {
-        return {
-            status: 'error',
-            reason: 'Invalid VIBESCOPE_API_KEY',
-        };
-    }
     // Auto-detect git URL if not provided
     if (!gitUrl && !projectId) {
         gitUrl = detectGitUrl() || undefined;
     }
-    // Find project
-    let projectQuery = supabase
-        .from('projects')
-        .select('id, name, git_url')
-        .eq('user_id', auth.userId);
-    if (projectId) {
-        projectQuery = projectQuery.eq('id', projectId);
-    }
-    else if (gitUrl) {
-        projectQuery = projectQuery.eq('git_url', gitUrl);
-    }
-    else {
-        return {
-            status: 'no_session',
-            reason: 'Could not detect git URL and no project_id provided',
-            continuation_prompt: 'Could not detect which project you are working on. Please call start_work_session(git_url: "...") with your repository URL.',
-        };
-    }
-    const { data: project, error: projectError } = await projectQuery.single();
-    if (projectError || !project) {
-        // Project not found - this is OK, might be an untracked repo
-        return {
-            status: 'compliant',
-            reason: `No Vibescope project found for ${gitUrl || projectId}. Untracked repository - exit allowed.`,
-            details: {
-                session_started: false,
-                project_id: null,
-                project_name: null,
-                git_url: gitUrl || null,
-                in_progress_tasks: 0,
-                tasks_completed_this_session: 0,
-                progress_logs_this_session: 0,
-                blockers_logged_this_session: 0,
-                session_duration_minutes: null,
-            },
-        };
-    }
-    // Check for agent session
-    const { data: session } = await supabase
-        .from('agent_sessions')
-        .select('id, last_synced_at, created_at')
-        .eq('api_key_id', auth.apiKeyId)
-        .eq('project_id', project.id)
-        .single();
-    if (!session) {
-        return {
-            status: 'non_compliant',
-            reason: 'No Vibescope session started for this project',
-            continuation_prompt: `[VIBESCOPE ENFORCEMENT] You have not started a Vibescope work session.
-
-BEFORE you can exit, you MUST call:
-  start_work_session(git_url: "${project.git_url || project.id}")
-
-This registers your session and gives you project context.`,
-            details: {
-                session_started: false,
-                project_id: project.id,
-                project_name: project.name,
-                git_url: project.git_url,
-                in_progress_tasks: 0,
-                tasks_completed_this_session: 0,
-                progress_logs_this_session: 0,
-                blockers_logged_this_session: 0,
-                session_duration_minutes: null,
-            },
-        };
-    }
-    const sessionStartTime = new Date(session.created_at);
-    const lastSyncTime = new Date(session.last_synced_at);
-    const now = new Date();
-    const sessionDurationMinutes = Math.round((now.getTime() - sessionStartTime.getTime()) / 60000);
-    // Grace period: if session is less than 1 minute, allow exit
-    if (sessionDurationMinutes < 1) {
-        return {
-            status: 'compliant',
-            reason: 'Very short session (< 1 minute) - exit allowed',
-            details: {
-                session_started: true,
-                project_id: project.id,
-                project_name: project.name,
-                git_url: project.git_url,
-                in_progress_tasks: 0,
-                tasks_completed_this_session: 0,
-                progress_logs_this_session: 0,
-                blockers_logged_this_session: 0,
-                session_duration_minutes: sessionDurationMinutes,
-            },
-        };
-    }
-    // Check for in-progress tasks
-    const { data: inProgressTasks } = await supabase
-        .from('tasks')
-        .select('id, title, progress_percentage')
-        .eq('project_id', project.id)
-        .eq('status', 'in_progress');
-    const inProgressCount = inProgressTasks?.length || 0;
-    if (inProgressCount > 0) {
-        const taskList = inProgressTasks
-            .map((t) => `  - ${t.title} (${t.progress_percentage}% complete)`)
-            .join('\n');
-        return {
-            status: 'non_compliant',
-            reason: `You have ${inProgressCount} task(s) still in_progress`,
-            continuation_prompt: `[VIBESCOPE ENFORCEMENT] You have ${inProgressCount} task(s) still marked as in_progress:
-
-${taskList}
-
-You MUST either:
-1. Complete them: complete_task(task_id: "...", summary: "...")
-2. Log why you're stopping: log_progress(project_id: "${project.id}", summary: "Stopping because...")`,
-            details: {
-                session_started: true,
-                project_id: project.id,
-                project_name: project.name,
-                git_url: project.git_url,
-                in_progress_tasks: inProgressCount,
-                tasks_completed_this_session: 0,
-                progress_logs_this_session: 0,
-                blockers_logged_this_session: 0,
-                session_duration_minutes: sessionDurationMinutes,
+    try {
+        const response = await fetch(`${getApiUrl()}/api/mcp/verify`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
             },
-        };
-    }
-    // Check for activity this session
-    const sessionStartIso = sessionStartTime.toISOString();
-    const [completedResult, progressResult, blockerResult] = await Promise.all([
-        // Tasks completed after session start
-        supabase
-            .from('tasks')
-            .select('id', { count: 'exact' })
-            .eq('project_id', project.id)
-            .eq('status', 'completed')
-            .gte('completed_at', sessionStartIso),
-        // Progress logs by agent after session start
-        supabase
-            .from('progress_logs')
-            .select('id', { count: 'exact' })
-            .eq('project_id', project.id)
-            .eq('created_by', 'agent')
-            .gte('created_at', sessionStartIso),
-        // Blockers logged by agent after session start
-        supabase
-            .from('blockers')
-            .select('id', { count: 'exact' })
-            .eq('project_id', project.id)
-            .eq('created_by', 'agent')
-            .gte('created_at', sessionStartIso),
-    ]);
-    const tasksCompleted = completedResult.count || 0;
-    const progressLogsCount = progressResult.count || 0;
-    const blockersLogged = blockerResult.count || 0;
-    // Check if any tracked work was done
-    const anyWorkTracked = tasksCompleted > 0 || progressLogsCount > 0 || blockersLogged > 0;
-    if (!anyWorkTracked && sessionDurationMinutes >= 5) {
+            body: JSON.stringify({
+                api_key: apiKey,
+                git_url: gitUrl,
+                project_id: projectId,
+            }),
+        });
+        const result = await response.json();
+        return result;
+    }
+    catch (err) {
         return {
-            status: 'non_compliant',
-            reason: `Session active for ${sessionDurationMinutes} minutes but no work was tracked`,
-            continuation_prompt: `[VIBESCOPE ENFORCEMENT] Your session has been active for ${sessionDurationMinutes} minutes but no work was tracked.
-
-The human is watching the dashboard and will see an empty session.
-
-You MUST either:
-1. Pick a task and work on it: get_next_task(project_id: "${project.id}")
-2. Log why you did nothing: log_progress(project_id: "${project.id}", summary: "No work done because...")`,
-            details: {
-                session_started: true,
-                project_id: project.id,
-                project_name: project.name,
-                git_url: project.git_url,
-                in_progress_tasks: 0,
-                tasks_completed_this_session: tasksCompleted,
-                progress_logs_this_session: progressLogsCount,
-                blockers_logged_this_session: blockersLogged,
-                session_duration_minutes: sessionDurationMinutes,
-            },
+            status: 'error',
+            reason: err instanceof Error ? err.message : 'Network error',
         };
     }
-    // All checks passed - compliant!
-    return {
-        status: 'compliant',
-        reason: 'All tracked work completed properly',
-        details: {
-            session_started: true,
-            project_id: project.id,
-            project_name: project.name,
-            git_url: project.git_url,
-            in_progress_tasks: 0,
-            tasks_completed_this_session: tasksCompleted,
-            progress_logs_this_session: progressLogsCount,
-            blockers_logged_this_session: blockersLogged,
-            session_duration_minutes: sessionDurationMinutes,
-        },
-    };
 }
 // ============================================================================
 // CLI Entry Point
@@ -332,8 +132,7 @@ Exit Codes:
 
 Environment Variables:
   VIBESCOPE_API_KEY       Required - Your Vibescope API key
-  SUPABASE_URL            Required - Supabase project URL
-  SUPABASE_SERVICE_KEY    Required - Supabase service role key
+  VIBESCOPE_API_URL       Optional - API URL (default: https://vibescope.dev)
 `);
         process.exit(0);
     }

package/dist/config/tool-categories.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Tool Categories Configuration
+ *
+ * Defines the categorization of MCP tools for discovery.
+ * Moved to separate config for lazy-loading optimization.
+ */
+export interface ToolEntry {
+    name: string;
+    brief: string;
+}
+export interface CategoryEntry {
+    description: string;
+    tools: ToolEntry[];
+}
+export declare const TOOL_CATEGORIES: Record<string, CategoryEntry>;
+/**
+ * Get list of category names
+ */
+export declare function getCategoryNames(): string[];
+/**
+ * Get category summary (without full tool list)
+ */
+export declare function getCategorySummary(): Array<{
+    name: string;
+    description: string;
+    tool_count: number;
+}>;
+/**
+ * Get tools in a specific category
+ */
+export declare function getCategoryTools(category: string): CategoryEntry | undefined;

package/dist/config/tool-categories.js

@@ -0,0 +1,253 @@
+/**
+ * Tool Categories Configuration
+ *
+ * Defines the categorization of MCP tools for discovery.
+ * Moved to separate config for lazy-loading optimization.
+ */
+export const TOOL_CATEGORIES = {
+    session: {
+        description: 'Session lifecycle and monitoring',
+        tools: [
+            { name: 'start_work_session', brief: 'Initialize session, get next task' },
+            { name: 'get_help', brief: 'Get workflow guidance' },
+            { name: 'get_token_usage', brief: 'View token stats' },
+            { name: 'heartbeat', brief: 'Maintain active status' },
+            { name: 'end_work_session', brief: 'End session, release tasks' },
+        ],
+    },
+    project: {
+        description: 'Project CRUD and configuration',
+        tools: [
+            { name: 'get_project_context', brief: 'Full project info' },
+            { name: 'get_git_workflow', brief: 'Git branching config' },
+            { name: 'create_project', brief: 'Create new project' },
+            { name: 'update_project', brief: 'Modify project settings' },
+            { name: 'update_project_readme', brief: 'Sync README to dashboard' },
+        ],
+    },
+    tasks: {
+        description: 'Task management and tracking',
+        tools: [
+            { name: 'get_tasks', brief: 'List project tasks' },
+            { name: 'get_next_task', brief: 'Get highest priority task' },
+            { name: 'add_task', brief: 'Create new task' },
+            { name: 'update_task', brief: 'Update task status/progress' },
+            { name: 'complete_task', brief: 'Mark task done' },
+            { name: 'delete_task', brief: 'Remove a task' },
+            { name: 'batch_update_tasks', brief: 'Update multiple tasks' },
+            { name: 'batch_complete_tasks', brief: 'Complete multiple tasks' },
+            { name: 'add_task_reference', brief: 'Add URL to task' },
+            { name: 'remove_task_reference', brief: 'Remove URL from task' },
+        ],
+    },
+    milestones: {
+        description: 'Task breakdown into steps',
+        tools: [
+            { name: 'add_milestone', brief: 'Add step to task' },
+            { name: 'update_milestone', brief: 'Update milestone' },
+            { name: 'complete_milestone', brief: 'Mark step done' },
+            { name: 'delete_milestone', brief: 'Remove milestone' },
+            { name: 'get_milestones', brief: 'List task milestones' },
+        ],
+    },
+    progress: {
+        description: 'Progress logging and activity',
+        tools: [
+            { name: 'log_progress', brief: 'Record progress update' },
+            { name: 'get_activity_feed', brief: 'Combined activity feed' },
+        ],
+    },
+    blockers: {
+        description: 'Blocker management',
+        tools: [
+            { name: 'add_blocker', brief: 'Record a blocker' },
+            { name: 'resolve_blocker', brief: 'Mark resolved' },
+            { name: 'get_blockers', brief: 'List blockers' },
+            { name: 'delete_blocker', brief: 'Remove blocker' },
+        ],
+    },
+    decisions: {
+        description: 'Architectural decisions',
+        tools: [
+            { name: 'log_decision', brief: 'Record decision' },
+            { name: 'get_decisions', brief: 'List decisions' },
+            { name: 'delete_decision', brief: 'Remove decision' },
+        ],
+    },
+    ideas: {
+        description: 'Feature ideas tracking',
+        tools: [
+            { name: 'add_idea', brief: 'Record an idea' },
+            { name: 'update_idea', brief: 'Update idea status' },
+            { name: 'get_ideas', brief: 'List ideas' },
+            { name: 'delete_idea', brief: 'Remove idea' },
+            { name: 'convert_idea_to_task', brief: 'Convert idea to task' },
+        ],
+    },
+    findings: {
+        description: 'Audit findings/knowledge base',
+        tools: [
+            { name: 'add_finding', brief: 'Record audit finding' },
+            { name: 'get_findings', brief: 'List findings' },
+            { name: 'update_finding', brief: 'Update finding status' },
+            { name: 'delete_finding', brief: 'Remove finding' },
+        ],
+    },
+    validation: {
+        description: 'Cross-agent task validation',
+        tools: [
+            { name: 'get_tasks_awaiting_validation', brief: 'Unvalidated tasks' },
+            { name: 'claim_validation', brief: 'Claim task for review' },
+            { name: 'validate_task', brief: 'Approve/reject task' },
+        ],
+    },
+    deployment: {
+        description: 'Deployment coordination',
+        tools: [
+            { name: 'request_deployment', brief: 'Request deploy' },
+            { name: 'claim_deployment_validation', brief: 'Claim for validation' },
+            { name: 'report_validation', brief: 'Report build/test results' },
+            { name: 'check_deployment_status', brief: 'Get deploy status' },
+            { name: 'start_deployment', brief: 'Begin deployment' },
+            { name: 'complete_deployment', brief: 'Mark deploy done' },
+            { name: 'cancel_deployment', brief: 'Cancel deployment' },
+            { name: 'add_deployment_requirement', brief: 'Add pre-deploy step' },
+            { name: 'complete_deployment_requirement', brief: 'Mark step done' },
+            { name: 'get_deployment_requirements', brief: 'List pre-deploy steps' },
+            { name: 'schedule_deployment', brief: 'Schedule future deployment' },
+            { name: 'get_scheduled_deployments', brief: 'List scheduled deployments' },
+            { name: 'update_scheduled_deployment', brief: 'Update schedule config' },
+            { name: 'delete_scheduled_deployment', brief: 'Delete schedule' },
+            { name: 'trigger_scheduled_deployment', brief: 'Manual trigger' },
+            { name: 'check_due_deployments', brief: 'Check due schedules' },
+        ],
+    },
+    fallback: {
+        description: 'Background activities when idle',
+        tools: [
+            { name: 'start_fallback_activity', brief: 'Start background work' },
+            { name: 'stop_fallback_activity', brief: 'Stop background work' },
+            { name: 'get_activity_history', brief: 'Activity history' },
+            { name: 'get_activity_schedules', brief: 'Activity schedules' },
+        ],
+    },
+    bodies_of_work: {
+        description: 'Group tasks into bodies of work',
+        tools: [
+            { name: 'create_body_of_work', brief: 'Create task group' },
+            { name: 'update_body_of_work', brief: 'Update settings' },
+            { name: 'get_body_of_work', brief: 'Get with tasks' },
+            { name: 'get_bodies_of_work', brief: 'List bodies of work' },
+            { name: 'delete_body_of_work', brief: 'Remove body of work' },
+            { name: 'add_task_to_body_of_work', brief: 'Add task to group' },
+            { name: 'remove_task_from_body_of_work', brief: 'Remove from group' },
+            { name: 'activate_body_of_work', brief: 'Activate for work' },
+        ],
+    },
+    requests: {
+        description: 'User request handling',
+        tools: [
+            { name: 'get_pending_requests', brief: 'Unhandled requests' },
+            { name: 'acknowledge_request', brief: 'Mark handled' },
+            { name: 'answer_question', brief: 'Answer user question' },
+        ],
+    },
+    organizations: {
+        description: 'Organization and team management',
+        tools: [
+            { name: 'list_organizations', brief: 'List user orgs' },
+            { name: 'create_organization', brief: 'Create new org' },
+            { name: 'update_organization', brief: 'Update org settings' },
+            { name: 'delete_organization', brief: 'Delete org' },
+            { name: 'list_org_members', brief: 'List org members' },
+            { name: 'invite_member', brief: 'Invite by email' },
+            { name: 'update_member_role', brief: 'Change member role' },
+            { name: 'remove_member', brief: 'Remove from org' },
+            { name: 'leave_organization', brief: 'Leave an org' },
+            { name: 'share_project_with_org', brief: 'Share project' },
+            { name: 'update_project_share', brief: 'Update share perms' },
+            { name: 'unshare_project', brief: 'Remove share' },
+            { name: 'list_project_shares', brief: 'List project shares' },
+        ],
+    },
+    cost: {
+        description: 'Cost monitoring and alerts',
+        tools: [
+            { name: 'get_cost_summary', brief: 'Cost by period' },
+            { name: 'get_cost_alerts', brief: 'List cost alerts' },
+            { name: 'add_cost_alert', brief: 'Add threshold alert' },
+            { name: 'update_cost_alert', brief: 'Update alert config' },
+            { name: 'delete_cost_alert', brief: 'Remove alert' },
+            { name: 'get_task_costs', brief: 'Cost per task' },
+        ],
+    },
+    knowledge: {
+        description: 'Queryable knowledge base from project data',
+        tools: [
+            { name: 'query_knowledge_base', brief: 'Aggregated project knowledge in one call' },
+        ],
+    },
+    subtasks: {
+        description: 'Subtask management',
+        tools: [
+            { name: 'add_subtask', brief: 'Add subtask to parent' },
+            { name: 'get_subtasks', brief: 'List subtasks' },
+        ],
+    },
+    sprints: {
+        description: 'Sprint planning and tracking',
+        tools: [
+            { name: 'create_sprint', brief: 'Create new sprint' },
+            { name: 'update_sprint', brief: 'Update sprint' },
+            { name: 'get_sprint', brief: 'Get sprint details' },
+            { name: 'get_sprints', brief: 'List sprints' },
+            { name: 'delete_sprint', brief: 'Remove sprint' },
+            { name: 'start_sprint', brief: 'Start sprint' },
+            { name: 'complete_sprint', brief: 'End sprint' },
+            { name: 'add_task_to_sprint', brief: 'Add task' },
+            { name: 'remove_task_from_sprint', brief: 'Remove task' },
+            { name: 'get_sprint_backlog', brief: 'Available tasks' },
+            { name: 'get_sprint_velocity', brief: 'Velocity metrics' },
+        ],
+    },
+    git_issues: {
+        description: 'Git issue tracking',
+        tools: [
+            { name: 'add_git_issue', brief: 'Record git issue' },
+            { name: 'resolve_git_issue', brief: 'Mark resolved' },
+            { name: 'get_git_issues', brief: 'List git issues' },
+            { name: 'delete_git_issue', brief: 'Remove issue' },
+        ],
+    },
+    dependencies: {
+        description: 'Task dependencies',
+        tools: [
+            { name: 'add_task_dependency', brief: 'Add dependency' },
+            { name: 'remove_task_dependency', brief: 'Remove dependency' },
+            { name: 'get_task_dependencies', brief: 'List dependencies' },
+            { name: 'get_next_body_of_work_task', brief: 'Next available task' },
+        ],
+    },
+};
+/**
+ * Get list of category names
+ */
+export function getCategoryNames() {
+    return Object.keys(TOOL_CATEGORIES);
+}
+/**
+ * Get category summary (without full tool list)
+ */
+export function getCategorySummary() {
+    return Object.entries(TOOL_CATEGORIES).map(([name, cat]) => ({
+        name,
+        description: cat.description,
+        tool_count: cat.tools.length,
+    }));
+}
+/**
+ * Get tools in a specific category
+ */
+export function getCategoryTools(category) {
+    return TOOL_CATEGORIES[category];
+}