@vibescope/mcp-server 0.5.0 → 0.5.2

package/src/handlers/file-checkouts.ts

@@ -1,185 +1,185 @@
-/**
- * File Checkouts Handlers
- *
- * Handles file checkout/checkin for multi-agent coordination:
- * - checkout_file: Check out a file before editing
- * - checkin_file: Check in a file after editing
- * - get_file_checkouts: Get active checkouts for a project
- * - abandon_checkout: Force release a checkout
- * - is_file_available: Check if a file is available for checkout
- */
-
-import type { Handler, HandlerRegistry } from './types.js';
-import { parseArgs, uuidValidator, createEnumValidator } from '../validators.js';
-import { getApiClient } from '../api-client.js';
-
-const VALID_CHECKOUT_STATUSES = ['checked_out', 'checked_in', 'abandoned'] as const;
-
-// Argument schemas for type-safe parsing
-const checkoutFileSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	file_path: { type: 'string' as const, required: true as const },
-	reason: { type: 'string' as const },
-};
-
-const checkinFileSchema = {
-	checkout_id: { type: 'string' as const, validate: uuidValidator },
-	project_id: { type: 'string' as const, validate: uuidValidator },
-	file_path: { type: 'string' as const },
-	summary: { type: 'string' as const },
-};
-
-const getFileCheckoutsSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	status: { type: 'string' as const, validate: createEnumValidator(VALID_CHECKOUT_STATUSES) },
-	file_path: { type: 'string' as const },
-	limit: { type: 'number' as const, default: 50 },
-	offset: { type: 'number' as const, default: 0 },
-};
-
-const abandonCheckoutSchema = {
-	checkout_id: { type: 'string' as const, validate: uuidValidator },
-	project_id: { type: 'string' as const, validate: uuidValidator },
-	file_path: { type: 'string' as const },
-};
-
-const isFileAvailableSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	file_path: { type: 'string' as const, required: true as const },
-};
-
-const getFileCheckoutsStatsSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-export const checkoutFile: Handler = async (args, ctx) => {
-	const { project_id, file_path, reason } = parseArgs(args, checkoutFileSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.checkoutFile(project_id, file_path, reason, ctx.session.currentSessionId || undefined);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to checkout file' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const checkinFile: Handler = async (args, ctx) => {
-	const { checkout_id, project_id, file_path, summary } = parseArgs(args, checkinFileSchema);
-
-	// Validate that either checkout_id or both project_id and file_path are provided
-	if (!checkout_id && (!project_id || !file_path)) {
-		return { result: { error: 'Either checkout_id or both project_id and file_path are required' }, isError: true };
-	}
-
-	const apiClient = getApiClient();
-	const response = await apiClient.checkinFile({
-		checkout_id,
-		project_id,
-		file_path,
-		summary
-	}, ctx.session.currentSessionId || undefined);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to checkin file' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const getFileCheckouts: Handler = async (args, _ctx) => {
-	const { project_id, status, file_path, limit, offset } = parseArgs(args, getFileCheckoutsSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getFileCheckouts(project_id, {
-		status,
-		file_path,
-		limit: Math.min(limit ?? 50, 50),
-		offset
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to get file checkouts' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const abandonCheckout: Handler = async (args, _ctx) => {
-	const { checkout_id, project_id, file_path } = parseArgs(args, abandonCheckoutSchema);
-
-	// Validate that either checkout_id or both project_id and file_path are provided
-	if (!checkout_id && (!project_id || !file_path)) {
-		return { result: { error: 'Either checkout_id or both project_id and file_path are required' }, isError: true };
-	}
-
-	const apiClient = getApiClient();
-	const response = await apiClient.abandonCheckout({
-		checkout_id,
-		project_id,
-		file_path
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to abandon checkout' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-export const isFileAvailable: Handler = async (args, _ctx) => {
-	const { project_id, file_path } = parseArgs(args, isFileAvailableSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getFileCheckouts(project_id, {
-		status: 'checked_out',
-		file_path,
-		limit: 1
-	});
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to check file availability' }, isError: true };
-	}
-
-	const checkouts = response.data?.checkouts || [];
-	const activeCheckout = checkouts.length > 0 ? checkouts[0] : null;
-
-	return {
-		result: {
-			available: !activeCheckout,
-			file_path,
-			checked_out_by: activeCheckout ? {
-				checkout_id: activeCheckout.id,
-				checked_out_by: activeCheckout.checked_out_by,
-				checked_out_at: activeCheckout.checked_out_at,
-				reason: activeCheckout.checkout_reason
-			} : null
-		}
-	};
-};
-
-export const getFileCheckoutsStats: Handler = async (args, _ctx) => {
-	const { project_id } = parseArgs(args, getFileCheckoutsStatsSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getFileCheckoutsStats(project_id);
-
-	if (!response.ok) {
-		return { result: { error: response.error || 'Failed to get file checkouts stats' }, isError: true };
-	}
-
-	return { result: response.data };
-};
-
-/**
- * File Checkouts handlers registry
- */
-export const fileCheckoutHandlers: HandlerRegistry = {
-	checkout_file: checkoutFile,
-	checkin_file: checkinFile,
-	get_file_checkouts: getFileCheckouts,
-	get_file_checkouts_stats: getFileCheckoutsStats,
-	abandon_checkout: abandonCheckout,
-	is_file_available: isFileAvailable,
-};
+/**
+ * File Checkouts Handlers
+ *
+ * Handles file checkout/checkin for multi-agent coordination:
+ * - checkout_file: Check out a file before editing
+ * - checkin_file: Check in a file after editing
+ * - get_file_checkouts: Get active checkouts for a project
+ * - abandon_checkout: Force release a checkout
+ * - is_file_available: Check if a file is available for checkout
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { parseArgs, uuidValidator, createEnumValidator } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+const VALID_CHECKOUT_STATUSES = ['checked_out', 'checked_in', 'abandoned'] as const;
+
+// Argument schemas for type-safe parsing
+const checkoutFileSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	file_path: { type: 'string' as const, required: true as const },
+	reason: { type: 'string' as const },
+};
+
+const checkinFileSchema = {
+	checkout_id: { type: 'string' as const, validate: uuidValidator },
+	project_id: { type: 'string' as const, validate: uuidValidator },
+	file_path: { type: 'string' as const },
+	summary: { type: 'string' as const },
+};
+
+const getFileCheckoutsSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	status: { type: 'string' as const, validate: createEnumValidator(VALID_CHECKOUT_STATUSES) },
+	file_path: { type: 'string' as const },
+	limit: { type: 'number' as const, default: 50 },
+	offset: { type: 'number' as const, default: 0 },
+};
+
+const abandonCheckoutSchema = {
+	checkout_id: { type: 'string' as const, validate: uuidValidator },
+	project_id: { type: 'string' as const, validate: uuidValidator },
+	file_path: { type: 'string' as const },
+};
+
+const isFileAvailableSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	file_path: { type: 'string' as const, required: true as const },
+};
+
+const getFileCheckoutsStatsSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+export const checkoutFile: Handler = async (args, ctx) => {
+	const { project_id, file_path, reason } = parseArgs(args, checkoutFileSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.checkoutFile(project_id, file_path, reason, ctx.session.currentSessionId || undefined);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to checkout file' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const checkinFile: Handler = async (args, ctx) => {
+	const { checkout_id, project_id, file_path, summary } = parseArgs(args, checkinFileSchema);
+
+	// Validate that either checkout_id or both project_id and file_path are provided
+	if (!checkout_id && (!project_id || !file_path)) {
+		return { result: { error: 'Either checkout_id or both project_id and file_path are required' }, isError: true };
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.checkinFile({
+		checkout_id,
+		project_id,
+		file_path,
+		summary
+	}, ctx.session.currentSessionId || undefined);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to checkin file' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const getFileCheckouts: Handler = async (args, _ctx) => {
+	const { project_id, status, file_path, limit, offset } = parseArgs(args, getFileCheckoutsSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getFileCheckouts(project_id, {
+		status,
+		file_path,
+		limit: Math.min(limit ?? 50, 50),
+		offset
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to get file checkouts' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const abandonCheckout: Handler = async (args, _ctx) => {
+	const { checkout_id, project_id, file_path } = parseArgs(args, abandonCheckoutSchema);
+
+	// Validate that either checkout_id or both project_id and file_path are provided
+	if (!checkout_id && (!project_id || !file_path)) {
+		return { result: { error: 'Either checkout_id or both project_id and file_path are required' }, isError: true };
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.abandonCheckout({
+		checkout_id,
+		project_id,
+		file_path
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to abandon checkout' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+export const isFileAvailable: Handler = async (args, _ctx) => {
+	const { project_id, file_path } = parseArgs(args, isFileAvailableSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getFileCheckouts(project_id, {
+		status: 'checked_out',
+		file_path,
+		limit: 1
+	});
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to check file availability' }, isError: true };
+	}
+
+	const checkouts = response.data?.checkouts || [];
+	const activeCheckout = checkouts.length > 0 ? checkouts[0] : null;
+
+	return {
+		result: {
+			available: !activeCheckout,
+			file_path,
+			checked_out_by: activeCheckout ? {
+				checkout_id: activeCheckout.id,
+				checked_out_by: activeCheckout.checked_out_by,
+				checked_out_at: activeCheckout.checked_out_at,
+				reason: activeCheckout.checkout_reason
+			} : null
+		}
+	};
+};
+
+export const getFileCheckoutsStats: Handler = async (args, _ctx) => {
+	const { project_id } = parseArgs(args, getFileCheckoutsStatsSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getFileCheckoutsStats(project_id);
+
+	if (!response.ok) {
+		return { result: { error: response.error || 'Failed to get file checkouts stats' }, isError: true };
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * File Checkouts handlers registry
+ */
+export const fileCheckoutHandlers: HandlerRegistry = {
+	checkout_file: checkoutFile,
+	checkin_file: checkinFile,
+	get_file_checkouts: getFileCheckouts,
+	get_file_checkouts_stats: getFileCheckoutsStats,
+	abandon_checkout: abandonCheckout,
+	is_file_available: isFileAvailable,
+};