@vibescope/mcp-server 0.0.1 → 0.2.0

package/dist/validators.test.js

@@ -1,176 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { ValidationError, validateRequired, validateUUID, validateTaskStatus, validateProjectStatus, validatePriority, validateProgressPercentage, validateEstimatedMinutes, validateEnvironment, VALID_TASK_STATUSES, VALID_PROJECT_STATUSES, VALID_ENVIRONMENTS, } from './validators.js';
-describe('ValidationError', () => {
-    it('should create error with message', () => {
-        const error = new ValidationError('Test error');
-        expect(error.message).toBe('Test error');
-        expect(error.name).toBe('ValidationError');
-    });
-    it('should include optional fields', () => {
-        const error = new ValidationError('Test error', {
-            field: 'test_field',
-            hint: 'Test hint',
-            validValues: ['a', 'b'],
-        });
-        expect(error.field).toBe('test_field');
-        expect(error.hint).toBe('Test hint');
-        expect(error.validValues).toEqual(['a', 'b']);
-    });
-    it('should serialize to JSON correctly', () => {
-        const error = new ValidationError('Test error', {
-            field: 'test_field',
-            hint: 'Test hint',
-            validValues: ['a', 'b'],
-        });
-        const json = error.toJSON();
-        expect(json.error).toBe('validation_error');
-        expect(json.message).toBe('Test error');
-        expect(json.field).toBe('test_field');
-        expect(json.hint).toBe('Test hint');
-        expect(json.valid_values).toEqual(['a', 'b']);
-    });
-});
-describe('validateRequired', () => {
-    it('should pass for valid values', () => {
-        expect(() => validateRequired('value', 'field')).not.toThrow();
-        expect(() => validateRequired(0, 'field')).not.toThrow();
-        expect(() => validateRequired(false, 'field')).not.toThrow();
-        expect(() => validateRequired({}, 'field')).not.toThrow();
-    });
-    it('should throw for undefined', () => {
-        expect(() => validateRequired(undefined, 'test_field')).toThrow(ValidationError);
-        expect(() => validateRequired(undefined, 'test_field')).toThrow('Missing required field: test_field');
-    });
-    it('should throw for null', () => {
-        expect(() => validateRequired(null, 'test_field')).toThrow(ValidationError);
-    });
-    it('should throw for empty string', () => {
-        expect(() => validateRequired('', 'test_field')).toThrow(ValidationError);
-    });
-});
-describe('validateUUID', () => {
-    it('should pass for valid UUIDs', () => {
-        expect(() => validateUUID('123e4567-e89b-12d3-a456-426614174000', 'id')).not.toThrow();
-        expect(() => validateUUID('00000000-0000-0000-0000-000000000000', 'id')).not.toThrow();
-        expect(() => validateUUID('FFFFFFFF-FFFF-FFFF-FFFF-FFFFFFFFFFFF', 'id')).not.toThrow();
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateUUID(undefined, 'id')).not.toThrow();
-    });
-    it('should pass for empty string (treated as optional)', () => {
-        expect(() => validateUUID('', 'id')).not.toThrow();
-    });
-    it('should throw for invalid UUIDs', () => {
-        expect(() => validateUUID('not-a-uuid', 'id')).toThrow(ValidationError);
-        expect(() => validateUUID('123', 'id')).toThrow(ValidationError);
-        expect(() => validateUUID('123e4567-e89b-12d3-a456', 'id')).toThrow(ValidationError);
-        expect(() => validateUUID('123e4567-e89b-12d3-a456-426614174000-extra', 'id')).toThrow(ValidationError);
-    });
-});
-describe('validateTaskStatus', () => {
-    it('should pass for valid task statuses', () => {
-        for (const status of VALID_TASK_STATUSES) {
-            expect(() => validateTaskStatus(status)).not.toThrow();
-        }
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateTaskStatus(undefined)).not.toThrow();
-    });
-    it('should throw for invalid status', () => {
-        expect(() => validateTaskStatus('invalid')).toThrow(ValidationError);
-        expect(() => validateTaskStatus('PENDING')).toThrow(ValidationError);
-        expect(() => validateTaskStatus('done')).toThrow(ValidationError);
-    });
-});
-describe('validateProjectStatus', () => {
-    it('should pass for valid project statuses', () => {
-        for (const status of VALID_PROJECT_STATUSES) {
-            expect(() => validateProjectStatus(status)).not.toThrow();
-        }
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateProjectStatus(undefined)).not.toThrow();
-    });
-    it('should throw for invalid status', () => {
-        expect(() => validateProjectStatus('invalid')).toThrow(ValidationError);
-        expect(() => validateProjectStatus('ACTIVE')).toThrow(ValidationError);
-    });
-});
-describe('validatePriority', () => {
-    it('should pass for valid priorities 1-5', () => {
-        for (let i = 1; i <= 5; i++) {
-            expect(() => validatePriority(i)).not.toThrow();
-        }
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validatePriority(undefined)).not.toThrow();
-    });
-    it('should throw for out of range values', () => {
-        expect(() => validatePriority(0)).toThrow(ValidationError);
-        expect(() => validatePriority(6)).toThrow(ValidationError);
-        expect(() => validatePriority(-1)).toThrow(ValidationError);
-    });
-    it('should throw for non-integers', () => {
-        expect(() => validatePriority(1.5)).toThrow(ValidationError);
-        expect(() => validatePriority(2.7)).toThrow(ValidationError);
-    });
-});
-describe('validateProgressPercentage', () => {
-    it('should pass for valid percentages 0-100', () => {
-        expect(() => validateProgressPercentage(0)).not.toThrow();
-        expect(() => validateProgressPercentage(50)).not.toThrow();
-        expect(() => validateProgressPercentage(100)).not.toThrow();
-        expect(() => validateProgressPercentage(33.33)).not.toThrow();
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateProgressPercentage(undefined)).not.toThrow();
-    });
-    it('should throw for out of range values', () => {
-        expect(() => validateProgressPercentage(-1)).toThrow(ValidationError);
-        expect(() => validateProgressPercentage(101)).toThrow(ValidationError);
-        expect(() => validateProgressPercentage(150)).toThrow(ValidationError);
-    });
-    it('should throw for non-finite values', () => {
-        expect(() => validateProgressPercentage(Infinity)).toThrow(ValidationError);
-        expect(() => validateProgressPercentage(NaN)).toThrow(ValidationError);
-    });
-});
-describe('validateEstimatedMinutes', () => {
-    it('should pass for valid positive integers', () => {
-        expect(() => validateEstimatedMinutes(1)).not.toThrow();
-        expect(() => validateEstimatedMinutes(30)).not.toThrow();
-        expect(() => validateEstimatedMinutes(120)).not.toThrow();
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateEstimatedMinutes(undefined)).not.toThrow();
-    });
-    it('should throw for zero', () => {
-        expect(() => validateEstimatedMinutes(0)).toThrow(ValidationError);
-    });
-    it('should throw for negative values', () => {
-        expect(() => validateEstimatedMinutes(-1)).toThrow(ValidationError);
-        expect(() => validateEstimatedMinutes(-30)).toThrow(ValidationError);
-    });
-    it('should throw for non-integers', () => {
-        expect(() => validateEstimatedMinutes(1.5)).toThrow(ValidationError);
-        expect(() => validateEstimatedMinutes(30.5)).toThrow(ValidationError);
-    });
-});
-describe('validateEnvironment', () => {
-    it('should pass for valid environments', () => {
-        for (const env of VALID_ENVIRONMENTS) {
-            expect(() => validateEnvironment(env)).not.toThrow();
-        }
-    });
-    it('should pass for undefined (optional)', () => {
-        expect(() => validateEnvironment(undefined)).not.toThrow();
-    });
-    it('should pass for empty string (treated as optional)', () => {
-        expect(() => validateEnvironment('')).not.toThrow();
-    });
-    it('should throw for invalid environment', () => {
-        expect(() => validateEnvironment('invalid')).toThrow(ValidationError);
-        expect(() => validateEnvironment('PRODUCTION')).toThrow(ValidationError);
-        expect(() => validateEnvironment('prod')).toThrow(ValidationError);
-    });
-});

package/src/knowledge.ts

@@ -1,132 +0,0 @@
-/**
- * Knowledge Base
- *
- * Embedded help topics for on-demand agent guidance.
- */
-
-export const KNOWLEDGE_BASE: Record<string, string> = {
-	getting_started: `# Getting Started
-1. Call start_work_session(git_url) to initialize
-2. Response includes next_task - start working on it immediately
-3. Use update_task to mark in_progress and track progress
-4. Call complete_task when done - it returns your next task
-5. Use get_help(topic) when you need guidance on specific workflows`,
-
-	tasks: `# Task Workflow
-- Mark task in_progress with update_task before starting
-- Update progress_percentage regularly (every 15-20% progress)
-- Include progress_note to auto-log milestones
-- One task at a time - complete current before starting another
-- complete_task returns next_task and context counts (validation, blockers, deployment)
-- Priority: 1=highest, 5=lowest`,
-
-	validation: `# Task Validation
-Completed tasks need validation before deployment. PRIORITIZE validation over new tasks.
-1. Check: get_tasks_awaiting_validation(project_id)
-2. Claim: claim_validation(task_id) - marks "being reviewed" on dashboard
-3. Review code changes and run tests
-4. Complete: validate_task(task_id, approved: true/false, validation_notes: "...")
-Self-validation allowed when single-agent or to unblock deployment.`,
-
-	deployment: `# Deployment Workflow
-1. Ensure all completed tasks are validated first
-2. request_deployment(project_id, environment: "production")
-3. claim_deployment_validation(project_id) - claim for validation
-4. Run: pnpm build && pnpm test
-5. report_validation(project_id, build_passed: true, tests_passed: true)
-6. start_deployment(project_id) - returns project's deployment_instructions
-7. Follow the instructions (e.g., push to main, run deploy command)
-8. complete_deployment(project_id, success: true, summary: "...")`,
-
-	git: `# Git Workflow
-
-Call get_git_workflow(project_id) for project-specific config.
-
-## Workflow Types
-- **none**: No branching strategy
-- **trunk-based**: Commit directly to main, small frequent commits
-- **github-flow**: Feature branches, merge via PR after validation
-- **git-flow**: develop/release/feature branches
-
-## Lifecycle Integration
-
-### 1. Starting a Task
-When you call update_task(status: "in_progress"), the response includes:
-- **branch_name**: Suggested branch (e.g., feature/a1b2c3d4-task-title)
-- **base_branch**: Branch to branch from
-- **steps**: Git commands to create the branch
-- **reminder**: Call to update task with git_branch
-
-### 2. Completing a Task
-When you call complete_task, the response includes:
-- **steps**: Push commands
-- **pr_suggestion**: { title, body_template } - ready-to-use PR content
-- **next_step**: Reminder that merge happens AFTER validation
-
-Add the PR link via add_task_reference(task_id, url, label: "Pull Request").
-
-### 3. Validation Approved
-When validate_task(approved: true) is called, the response includes:
-- **target_branch**: Where to merge
-- **feature_branch**: Branch being merged
-- **steps**: Merge options (UI or command line)
-- **cleanup**: Branch deletion commands
-- **note**: Confirmation it's safe to merge
-
-## Key Rules
-- Create branch when starting task (github-flow/git-flow)
-- Push and create PR when completing task
-- Wait for validation before merging
-- Clean up branch after successful merge`,
-
-	blockers: `# Working with Blockers
-When stuck and need human input:
-1. add_blocker(project_id, description: "What's blocking")
-2. Ask your question to the user
-3. resolve_blocker(blocker_id, resolution_note: "How resolved")
-Only use for genuine blockers requiring decisions - not routine questions.`,
-
-	milestones: `# Task Milestones
-For complex tasks, break into milestones:
-1. add_milestone(task_id, title: "Design schema")
-2. add_milestone(task_id, title: "Implement API")
-3. Update with complete_milestone(milestone_id) as you go
-Dashboard shows progress bar with completed/total.`,
-
-	fallback: `# Fallback Activities
-When no tasks available, get_next_task suggests activities:
-- feature_ideation, code_review, performance_audit
-- security_review, test_coverage, documentation_review
-1. start_fallback_activity(project_id, activity: "code_review")
-2. Do the work, use add_finding for issues, add_idea for improvements
-3. stop_fallback_activity(project_id, summary: "...")`,
-
-	session: `# Session Management
-- start_work_session initializes and returns next_task (lite mode default)
-- Use mode:'full' for complete context when needed
-- heartbeat every 30-60 seconds maintains active status
-- end_work_session releases claimed tasks and returns summary
-- NEVER STOP: After completing a task, immediately start the next one
-- When context grows large: /clear then start_work_session to continue fresh
-- Your progress is saved to the dashboard - nothing is lost on /clear`,
-
-	tokens: `# Token Efficiency
-Be mindful of token costs - every tool call has a cost.
-- Use mode:'lite' (default) - saves ~85% vs full mode
-- Call get_token_usage() to check consumption
-- /compact when context grows large
-- Batch related updates when possible
-- Trust lite mode; only use full mode for initial exploration`,
-
-	topics: `# Available Help Topics
-- getting_started: Basic workflow overview
-- tasks: Working on tasks, progress tracking
-- validation: Cross-agent task validation
-- deployment: Deployment coordination
-- git: Git workflow configuration
-- blockers: Handling blockers
-- milestones: Breaking down complex tasks
-- fallback: Background activities when idle
-- session: Session management
-- tokens: Token efficiency tips`,
-};

package/src/tmpclaude-0078-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-0ee1-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-2dd5-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-344c-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-3860-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-4b63-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-5c73-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-5ee3-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-6795-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-709e-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-9839-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-d829-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-e072-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/src/tmpclaude-f6ee-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server/src

package/tmpclaude-0439-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-132f-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-15bb-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-165a-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-1ba9-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-21a3-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-2a38-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-2adf-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-2f56-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-3626-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-3727-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-40bc-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-436f-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-4783-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-4b6d-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-4ba4-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-51e6-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-5ecf-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-6f97-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-7fb2-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-825c-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-8baf-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-8d9f-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-975c-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-9983-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-a045-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-ac4a-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-b593-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-b891-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-c032-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-cf43-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-d040-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-dcdd-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-dcee-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-e16b-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-ecd2-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server

package/tmpclaude-f48d-cwd

@@ -1 +0,0 @@
-/d/Repos/Nonatomic/Vibescope/Vibescope/packages/mcp-server