@vibescope/mcp-server 0.0.1

package/src/validators.ts

@@ -0,0 +1,122 @@
+// ============================================================================
+// Validation Helpers
+// ============================================================================
+
+export const VALID_TASK_STATUSES = ['backlog', 'pending', 'in_progress', 'completed', 'cancelled'] as const;
+export const VALID_PROJECT_STATUSES = ['active', 'paused', 'completed', 'archived'] as const;
+export const VALID_BLOCKER_STATUSES = ['open', 'resolved'] as const;
+export const VALID_DEPLOYMENT_STATUSES = ['pending', 'validating', 'ready', 'deploying', 'deployed', 'failed'] as const;
+export const VALID_ENVIRONMENTS = ['development', 'staging', 'production'] as const;
+
+export type TaskStatus = typeof VALID_TASK_STATUSES[number];
+export type ProjectStatus = typeof VALID_PROJECT_STATUSES[number];
+export type BlockerStatus = typeof VALID_BLOCKER_STATUSES[number];
+export type DeploymentStatus = typeof VALID_DEPLOYMENT_STATUSES[number];
+export type Environment = typeof VALID_ENVIRONMENTS[number];
+
+export class ValidationError extends Error {
+	field?: string;
+	hint?: string;
+	validValues?: readonly string[];
+
+	constructor(message: string, options?: { field?: string; hint?: string; validValues?: readonly string[] }) {
+		super(message);
+		this.name = 'ValidationError';
+		this.field = options?.field;
+		this.hint = options?.hint;
+		this.validValues = options?.validValues;
+	}
+
+	toJSON() {
+		return {
+			error: 'validation_error',
+			message: this.message,
+			field: this.field,
+			hint: this.hint,
+			valid_values: this.validValues,
+		};
+	}
+}
+
+export function validateRequired(value: unknown, fieldName: string): void {
+	if (value === undefined || value === null || value === '') {
+		throw new ValidationError(`Missing required field: ${fieldName}`, {
+			field: fieldName,
+			hint: `Please provide a value for "${fieldName}"`,
+		});
+	}
+}
+
+export function validateUUID(value: string | undefined, fieldName: string): void {
+	if (!value) return;
+	const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+	if (!uuidRegex.test(value)) {
+		throw new ValidationError(`Invalid UUID format for ${fieldName}: "${value}"`, {
+			field: fieldName,
+			hint: 'UUIDs should be in format: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx',
+		});
+	}
+}
+
+export function validateTaskStatus(status: string | undefined): void {
+	if (!status) return;
+	if (!VALID_TASK_STATUSES.includes(status as TaskStatus)) {
+		throw new ValidationError(`Invalid task status: "${status}"`, {
+			field: 'status',
+			validValues: VALID_TASK_STATUSES,
+			hint: `Status must be one of: ${VALID_TASK_STATUSES.join(', ')}`,
+		});
+	}
+}
+
+export function validateProjectStatus(status: string | undefined): void {
+	if (!status) return;
+	if (!VALID_PROJECT_STATUSES.includes(status as ProjectStatus)) {
+		throw new ValidationError(`Invalid project status: "${status}"`, {
+			field: 'status',
+			validValues: VALID_PROJECT_STATUSES,
+			hint: `Status must be one of: ${VALID_PROJECT_STATUSES.join(', ')}`,
+		});
+	}
+}
+
+export function validatePriority(priority: number | undefined): void {
+	if (priority === undefined) return;
+	if (!Number.isInteger(priority) || priority < 1 || priority > 5) {
+		throw new ValidationError(`Invalid priority: ${priority}. Must be an integer between 1 and 5`, {
+			field: 'priority',
+			hint: 'Priority 1 is highest, 5 is lowest',
+		});
+	}
+}
+
+export function validateProgressPercentage(percentage: number | undefined): void {
+	if (percentage === undefined) return;
+	if (!Number.isFinite(percentage) || percentage < 0 || percentage > 100) {
+		throw new ValidationError(`Invalid progress_percentage: ${percentage}. Must be between 0 and 100`, {
+			field: 'progress_percentage',
+			hint: 'Use 0 for not started, 100 for complete',
+		});
+	}
+}
+
+export function validateEstimatedMinutes(minutes: number | undefined): void {
+	if (minutes === undefined) return;
+	if (!Number.isInteger(minutes) || minutes < 1) {
+		throw new ValidationError(`Invalid estimated_minutes: ${minutes}. Must be a positive integer`, {
+			field: 'estimated_minutes',
+			hint: 'Estimate the task duration in minutes (e.g., 30 for half an hour)',
+		});
+	}
+}
+
+export function validateEnvironment(environment: string | undefined): void {
+	if (!environment) return;
+	if (!VALID_ENVIRONMENTS.includes(environment as Environment)) {
+		throw new ValidationError(`Invalid environment: "${environment}"`, {
+			field: 'environment',
+			validValues: VALID_ENVIRONMENTS,
+			hint: `Environment must be one of: ${VALID_ENVIRONMENTS.join(', ')}`,
+		});
+	}
+}

package/tmpclaude-0439-cwd

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

package/tmpclaude-132f-cwd

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

package/tmpclaude-15bb-cwd

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

package/tmpclaude-165a-cwd

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

package/tmpclaude-1ba9-cwd

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

package/tmpclaude-21a3-cwd

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

package/tmpclaude-2a38-cwd

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

package/tmpclaude-2adf-cwd

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

package/tmpclaude-2f56-cwd

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

package/tmpclaude-3626-cwd

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

package/tmpclaude-3727-cwd

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

package/tmpclaude-40bc-cwd

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

package/tmpclaude-436f-cwd

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

package/tmpclaude-4783-cwd

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

package/tmpclaude-4b6d-cwd

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

package/tmpclaude-4ba4-cwd

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

package/tmpclaude-51e6-cwd

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

package/tmpclaude-5ecf-cwd

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

package/tmpclaude-6f97-cwd

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

package/tmpclaude-7fb2-cwd

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

package/tmpclaude-825c-cwd

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

package/tmpclaude-8baf-cwd

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

package/tmpclaude-8d9f-cwd

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

package/tmpclaude-975c-cwd

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

package/tmpclaude-9983-cwd

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

package/tmpclaude-a045-cwd

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

package/tmpclaude-ac4a-cwd

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

package/tmpclaude-b593-cwd

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

package/tmpclaude-b891-cwd

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

package/tmpclaude-c032-cwd

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

package/tmpclaude-cf43-cwd

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

package/tmpclaude-d040-cwd

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

package/tmpclaude-dcdd-cwd

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

package/tmpclaude-dcee-cwd

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

package/tmpclaude-e16b-cwd

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

package/tmpclaude-ecd2-cwd

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

package/tmpclaude-f48d-cwd

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

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "NodeNext",
+    "moduleResolution": "NodeNext",
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"]
+}

package/vitest.config.ts

@@ -0,0 +1,13 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+	test: {
+		globals: true,
+		environment: 'node',
+		include: ['src/**/*.test.ts'],
+		coverage: {
+			provider: 'v8',
+			reporter: ['text', 'json', 'html'],
+		},
+	},
+});