@vibescope/mcp-server 0.2.4 → 0.2.5

package/src/handlers/deployment.test.ts

@@ -1,551 +1,551 @@
-import { describe, it, expect, vi, beforeEach } from 'vitest';
-import {
-	claimDeploymentValidation,
-	reportValidation,
-	checkDeploymentStatus,
-	startDeployment,
-	completeDeployment,
-	cancelDeployment,
-	addDeploymentRequirement,
-	getDeploymentRequirements,
-	getDeploymentRequirementsStats,
-} from './deployment.js';
-import { ValidationError } from '../validators.js';
-import { createMockContext } from './__test-utils__.js';
-import { mockApiClient } from './__test-setup__.js';
-
-// ============================================================================
-// Test Utilities
-// ============================================================================
-
-const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
-
-// ============================================================================
-// claimDeploymentValidation Tests
-// ============================================================================
-
-describe('claimDeploymentValidation', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(claimDeploymentValidation({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for invalid project_id UUID', async () => {
-		const ctx = createMockContext();
-		await expect(
-			claimDeploymentValidation({ project_id: 'invalid' }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should return error when no pending deployment', async () => {
-		mockApiClient.claimDeploymentValidation.mockResolvedValue({
-			ok: true,
-			data: { success: false, error: 'No pending deployment found' },
-		});
-		const ctx = createMockContext();
-
-		const result = await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			success: false,
-			error: 'No pending deployment found',
-		});
-	});
-
-	it('should claim deployment successfully', async () => {
-		mockApiClient.claimDeploymentValidation.mockResolvedValue({
-			ok: true,
-			data: { success: true, deployment_id: 'deploy-1' },
-		});
-		const ctx = createMockContext();
-
-		const result = await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			deployment_id: 'deploy-1',
-		});
-	});
-
-	it('should pass session_id to API client', async () => {
-		mockApiClient.claimDeploymentValidation.mockResolvedValue({
-			ok: true,
-			data: { success: true },
-		});
-		const ctx = createMockContext({ sessionId: 'my-session' });
-
-		await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
-
-		expect(mockApiClient.claimDeploymentValidation).toHaveBeenCalledWith(VALID_UUID, 'my-session');
-	});
-});
-
-// ============================================================================
-// reportValidation Tests
-// ============================================================================
-
-describe('reportValidation', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(
-			reportValidation({ build_passed: true }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for missing build_passed', async () => {
-		const ctx = createMockContext();
-		await expect(
-			reportValidation({ project_id: VALID_UUID }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should return error when no deployment being validated', async () => {
-		mockApiClient.reportValidation.mockResolvedValue({
-			ok: true,
-			data: { success: false, error: 'No deployment being validated. Use claim_deployment_validation first.' },
-		});
-		const ctx = createMockContext();
-
-		const result = await reportValidation(
-			{ project_id: VALID_UUID, build_passed: true },
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: false,
-			error: 'No deployment being validated. Use claim_deployment_validation first.',
-		});
-	});
-
-	it('should report validation successfully', async () => {
-		mockApiClient.reportValidation.mockResolvedValue({
-			ok: true,
-			data: { success: true, status: 'ready' },
-		});
-		const ctx = createMockContext();
-
-		const result = await reportValidation(
-			{ project_id: VALID_UUID, build_passed: true, tests_passed: true },
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			status: 'ready',
-		});
-	});
-});
-
-// ============================================================================
-// checkDeploymentStatus Tests
-// ============================================================================
-
-describe('checkDeploymentStatus', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(checkDeploymentStatus({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should return no deployment when none found', async () => {
-		mockApiClient.checkDeploymentStatus.mockResolvedValue({
-			ok: true,
-			data: { has_deployment: false, message: 'No deployments found for this project' },
-		});
-		const ctx = createMockContext();
-
-		const result = await checkDeploymentStatus({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			has_deployment: false,
-			message: 'No deployments found for this project',
-		});
-	});
-
-	it('should return deployment details when found', async () => {
-		const mockDeployment = {
-			id: 'deploy-1',
-			status: 'deployed',
-			environment: 'production',
-		};
-		mockApiClient.checkDeploymentStatus.mockResolvedValue({
-			ok: true,
-			data: { has_deployment: true, deployment: mockDeployment },
-		});
-		const ctx = createMockContext();
-
-		const result = await checkDeploymentStatus({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			has_deployment: true,
-		});
-		expect((result.result as { deployment: { id: string } }).deployment.id).toBe('deploy-1');
-	});
-});
-
-// ============================================================================
-// startDeployment Tests
-// ============================================================================
-
-describe('startDeployment', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(startDeployment({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should return error when no deployment ready', async () => {
-		mockApiClient.startDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: false, error: 'No deployment ready. Must pass validation first.' },
-		});
-		const ctx = createMockContext();
-
-		const result = await startDeployment({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			success: false,
-			error: 'No deployment ready. Must pass validation first.',
-		});
-	});
-
-	it('should start deployment successfully', async () => {
-		mockApiClient.startDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: true, status: 'deploying' },
-		});
-		const ctx = createMockContext();
-
-		const result = await startDeployment({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			status: 'deploying',
-		});
-	});
-});
-
-// ============================================================================
-// completeDeployment Tests
-// ============================================================================
-
-describe('completeDeployment', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(
-			completeDeployment({ success: true }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for missing success', async () => {
-		const ctx = createMockContext();
-		await expect(
-			completeDeployment({ project_id: VALID_UUID }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should return error when no deployment in progress', async () => {
-		mockApiClient.completeDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: false, error: 'No deployment in progress. Use start_deployment first.' },
-		});
-		const ctx = createMockContext();
-
-		const result = await completeDeployment(
-			{ project_id: VALID_UUID, success: true },
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: false,
-			error: 'No deployment in progress. Use start_deployment first.',
-		});
-	});
-
-	it('should complete deployment successfully', async () => {
-		mockApiClient.completeDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: true, status: 'deployed' },
-		});
-		const ctx = createMockContext();
-
-		const result = await completeDeployment(
-			{ project_id: VALID_UUID, success: true, summary: 'Deployed v1.2.0' },
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			status: 'deployed',
-		});
-	});
-});
-
-// ============================================================================
-// cancelDeployment Tests
-// ============================================================================
-
-describe('cancelDeployment', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(cancelDeployment({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should return error when no active deployment', async () => {
-		mockApiClient.cancelDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: false, error: 'No active deployment' },
-		});
-		const ctx = createMockContext();
-
-		const result = await cancelDeployment({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			success: false,
-			error: 'No active deployment',
-		});
-	});
-
-	it('should cancel deployment successfully', async () => {
-		mockApiClient.cancelDeployment.mockResolvedValue({
-			ok: true,
-			data: { success: true, status: 'failed' },
-		});
-		const ctx = createMockContext();
-
-		const result = await cancelDeployment(
-			{ project_id: VALID_UUID, reason: 'Found critical bug' },
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			status: 'failed',
-		});
-	});
-});
-
-// ============================================================================
-// addDeploymentRequirement Tests
-// ============================================================================
-
-describe('addDeploymentRequirement', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(
-			addDeploymentRequirement({ type: 'migration', title: 'Test' }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for missing type', async () => {
-		const ctx = createMockContext();
-		await expect(
-			addDeploymentRequirement({ project_id: VALID_UUID, title: 'Test' }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for missing title', async () => {
-		const ctx = createMockContext();
-		await expect(
-			addDeploymentRequirement({ project_id: VALID_UUID, type: 'migration' }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for invalid type', async () => {
-		const ctx = createMockContext();
-		await expect(
-			addDeploymentRequirement({
-				project_id: VALID_UUID,
-				type: 'invalid_type',
-				title: 'Test',
-			}, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for invalid stage', async () => {
-		const ctx = createMockContext();
-		await expect(
-			addDeploymentRequirement({
-				project_id: VALID_UUID,
-				type: 'migration',
-				title: 'Test',
-				stage: 'invalid_stage',
-			}, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should add requirement successfully', async () => {
-		mockApiClient.addDeploymentRequirement.mockResolvedValue({
-			ok: true,
-			data: { success: true, requirement_id: 'req-1', stage: 'preparation' },
-		});
-		const ctx = createMockContext();
-
-		const result = await addDeploymentRequirement(
-			{
-				project_id: VALID_UUID,
-				type: 'migration',
-				title: 'Test Migration',
-			},
-			ctx
-		);
-
-		expect(result.result).toMatchObject({
-			success: true,
-			requirement_id: 'req-1',
-			stage: 'preparation',
-		});
-	});
-});
-
-// ============================================================================
-// getDeploymentRequirements Tests
-// ============================================================================
-
-describe('getDeploymentRequirements', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(getDeploymentRequirements({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should return empty list when no requirements', async () => {
-		mockApiClient.getDeploymentRequirements.mockResolvedValue({
-			ok: true,
-			data: { requirements: [], deployment_blocked: false },
-		});
-		const ctx = createMockContext();
-
-		const result = await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject({
-			requirements: [],
-			deployment_blocked: false,
-		});
-	});
-
-	it('should query with correct project_id', async () => {
-		mockApiClient.getDeploymentRequirements.mockResolvedValue({
-			ok: true,
-			data: { requirements: [], deployment_blocked: false },
-		});
-		const ctx = createMockContext();
-
-		await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
-
-		expect(mockApiClient.getDeploymentRequirements).toHaveBeenCalledWith(
-			VALID_UUID,
-			expect.any(Object)
-		);
-	});
-
-	it('should return requirements list', async () => {
-		const mockReqs = [
-			{ id: 'req-1', type: 'migration', title: 'Run migrations' },
-			{ id: 'req-2', type: 'env_var', title: 'Set API_KEY' },
-		];
-		mockApiClient.getDeploymentRequirements.mockResolvedValue({
-			ok: true,
-			data: { requirements: mockReqs, deployment_blocked: true },
-		});
-		const ctx = createMockContext();
-
-		const result = await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
-
-		expect((result.result as { requirements: unknown[] }).requirements).toHaveLength(2);
-		expect(result.result).toHaveProperty('deployment_blocked', true);
-	});
-
-	it('should pass pagination params to API client', async () => {
-		mockApiClient.getDeploymentRequirements.mockResolvedValue({
-			ok: true,
-			data: { requirements: [], deployment_blocked: false },
-		});
-		const ctx = createMockContext();
-
-		await getDeploymentRequirements(
-			{ project_id: VALID_UUID, limit: 10, offset: 5 },
-			ctx
-		);
-
-		expect(mockApiClient.getDeploymentRequirements).toHaveBeenCalledWith(
-			VALID_UUID,
-			expect.objectContaining({ limit: 10, offset: 5 })
-		);
-	});
-});
-
-// ============================================================================
-// getDeploymentRequirementsStats Tests
-// ============================================================================
-
-describe('getDeploymentRequirementsStats', () => {
-	beforeEach(() => vi.clearAllMocks());
-
-	it('should throw error for missing project_id', async () => {
-		const ctx = createMockContext();
-		await expect(getDeploymentRequirementsStats({}, ctx)).rejects.toThrow(ValidationError);
-	});
-
-	it('should throw error for invalid project_id UUID', async () => {
-		const ctx = createMockContext();
-		await expect(
-			getDeploymentRequirementsStats({ project_id: 'invalid' }, ctx)
-		).rejects.toThrow(ValidationError);
-	});
-
-	it('should return stats from API client', async () => {
-		const mockStats = {
-			total: 5,
-			by_status: { pending: 3, completed: 2 },
-			by_stage: { preparation: 2, deployment: 2, verification: 1 },
-			by_type: { migration: 2, env_var: 2, manual: 1 },
-		};
-		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
-			ok: true,
-			data: mockStats,
-		});
-		const ctx = createMockContext();
-
-		const result = await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toMatchObject(mockStats);
-	});
-
-	it('should call API client with correct project_id', async () => {
-		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
-			ok: true,
-			data: { total: 0, by_status: {}, by_stage: {}, by_type: {} },
-		});
-		const ctx = createMockContext();
-
-		await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
-
-		expect(mockApiClient.getDeploymentRequirementsStats).toHaveBeenCalledWith(VALID_UUID);
-	});
-
-	it('should handle API error', async () => {
-		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
-			ok: false,
-			error: 'Database error',
-		});
-		const ctx = createMockContext();
-
-		const result = await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
-
-		expect(result.result).toHaveProperty('error');
-	});
-});
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import {
+	claimDeploymentValidation,
+	reportValidation,
+	checkDeploymentStatus,
+	startDeployment,
+	completeDeployment,
+	cancelDeployment,
+	addDeploymentRequirement,
+	getDeploymentRequirements,
+	getDeploymentRequirementsStats,
+} from './deployment.js';
+import { ValidationError } from '../validators.js';
+import { createMockContext } from './__test-utils__.js';
+import { mockApiClient } from './__test-setup__.js';
+
+// ============================================================================
+// Test Utilities
+// ============================================================================
+
+const VALID_UUID = '123e4567-e89b-12d3-a456-426614174000';
+
+// ============================================================================
+// claimDeploymentValidation Tests
+// ============================================================================
+
+describe('claimDeploymentValidation', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(claimDeploymentValidation({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for invalid project_id UUID', async () => {
+		const ctx = createMockContext();
+		await expect(
+			claimDeploymentValidation({ project_id: 'invalid' }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should return error when no pending deployment', async () => {
+		mockApiClient.claimDeploymentValidation.mockResolvedValue({
+			ok: true,
+			data: { success: false, error: 'No pending deployment found' },
+		});
+		const ctx = createMockContext();
+
+		const result = await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			success: false,
+			error: 'No pending deployment found',
+		});
+	});
+
+	it('should claim deployment successfully', async () => {
+		mockApiClient.claimDeploymentValidation.mockResolvedValue({
+			ok: true,
+			data: { success: true, deployment_id: 'deploy-1' },
+		});
+		const ctx = createMockContext();
+
+		const result = await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			deployment_id: 'deploy-1',
+		});
+	});
+
+	it('should pass session_id to API client', async () => {
+		mockApiClient.claimDeploymentValidation.mockResolvedValue({
+			ok: true,
+			data: { success: true },
+		});
+		const ctx = createMockContext({ sessionId: 'my-session' });
+
+		await claimDeploymentValidation({ project_id: VALID_UUID }, ctx);
+
+		expect(mockApiClient.claimDeploymentValidation).toHaveBeenCalledWith(VALID_UUID, 'my-session');
+	});
+});
+
+// ============================================================================
+// reportValidation Tests
+// ============================================================================
+
+describe('reportValidation', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(
+			reportValidation({ build_passed: true }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for missing build_passed', async () => {
+		const ctx = createMockContext();
+		await expect(
+			reportValidation({ project_id: VALID_UUID }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should return error when no deployment being validated', async () => {
+		mockApiClient.reportValidation.mockResolvedValue({
+			ok: true,
+			data: { success: false, error: 'No deployment being validated. Use claim_deployment_validation first.' },
+		});
+		const ctx = createMockContext();
+
+		const result = await reportValidation(
+			{ project_id: VALID_UUID, build_passed: true },
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: false,
+			error: 'No deployment being validated. Use claim_deployment_validation first.',
+		});
+	});
+
+	it('should report validation successfully', async () => {
+		mockApiClient.reportValidation.mockResolvedValue({
+			ok: true,
+			data: { success: true, status: 'ready' },
+		});
+		const ctx = createMockContext();
+
+		const result = await reportValidation(
+			{ project_id: VALID_UUID, build_passed: true, tests_passed: true },
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			status: 'ready',
+		});
+	});
+});
+
+// ============================================================================
+// checkDeploymentStatus Tests
+// ============================================================================
+
+describe('checkDeploymentStatus', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(checkDeploymentStatus({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should return no deployment when none found', async () => {
+		mockApiClient.checkDeploymentStatus.mockResolvedValue({
+			ok: true,
+			data: { has_deployment: false, message: 'No deployments found for this project' },
+		});
+		const ctx = createMockContext();
+
+		const result = await checkDeploymentStatus({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			has_deployment: false,
+			message: 'No deployments found for this project',
+		});
+	});
+
+	it('should return deployment details when found', async () => {
+		const mockDeployment = {
+			id: 'deploy-1',
+			status: 'deployed',
+			environment: 'production',
+		};
+		mockApiClient.checkDeploymentStatus.mockResolvedValue({
+			ok: true,
+			data: { has_deployment: true, deployment: mockDeployment },
+		});
+		const ctx = createMockContext();
+
+		const result = await checkDeploymentStatus({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			has_deployment: true,
+		});
+		expect((result.result as { deployment: { id: string } }).deployment.id).toBe('deploy-1');
+	});
+});
+
+// ============================================================================
+// startDeployment Tests
+// ============================================================================
+
+describe('startDeployment', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(startDeployment({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should return error when no deployment ready', async () => {
+		mockApiClient.startDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: false, error: 'No deployment ready. Must pass validation first.' },
+		});
+		const ctx = createMockContext();
+
+		const result = await startDeployment({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			success: false,
+			error: 'No deployment ready. Must pass validation first.',
+		});
+	});
+
+	it('should start deployment successfully', async () => {
+		mockApiClient.startDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: true, status: 'deploying' },
+		});
+		const ctx = createMockContext();
+
+		const result = await startDeployment({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			status: 'deploying',
+		});
+	});
+});
+
+// ============================================================================
+// completeDeployment Tests
+// ============================================================================
+
+describe('completeDeployment', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(
+			completeDeployment({ success: true }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for missing success', async () => {
+		const ctx = createMockContext();
+		await expect(
+			completeDeployment({ project_id: VALID_UUID }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should return error when no deployment in progress', async () => {
+		mockApiClient.completeDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: false, error: 'No deployment in progress. Use start_deployment first.' },
+		});
+		const ctx = createMockContext();
+
+		const result = await completeDeployment(
+			{ project_id: VALID_UUID, success: true },
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: false,
+			error: 'No deployment in progress. Use start_deployment first.',
+		});
+	});
+
+	it('should complete deployment successfully', async () => {
+		mockApiClient.completeDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: true, status: 'deployed' },
+		});
+		const ctx = createMockContext();
+
+		const result = await completeDeployment(
+			{ project_id: VALID_UUID, success: true, summary: 'Deployed v1.2.0' },
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			status: 'deployed',
+		});
+	});
+});
+
+// ============================================================================
+// cancelDeployment Tests
+// ============================================================================
+
+describe('cancelDeployment', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(cancelDeployment({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should return error when no active deployment', async () => {
+		mockApiClient.cancelDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: false, error: 'No active deployment' },
+		});
+		const ctx = createMockContext();
+
+		const result = await cancelDeployment({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			success: false,
+			error: 'No active deployment',
+		});
+	});
+
+	it('should cancel deployment successfully', async () => {
+		mockApiClient.cancelDeployment.mockResolvedValue({
+			ok: true,
+			data: { success: true, status: 'failed' },
+		});
+		const ctx = createMockContext();
+
+		const result = await cancelDeployment(
+			{ project_id: VALID_UUID, reason: 'Found critical bug' },
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			status: 'failed',
+		});
+	});
+});
+
+// ============================================================================
+// addDeploymentRequirement Tests
+// ============================================================================
+
+describe('addDeploymentRequirement', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(
+			addDeploymentRequirement({ type: 'migration', title: 'Test' }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for missing type', async () => {
+		const ctx = createMockContext();
+		await expect(
+			addDeploymentRequirement({ project_id: VALID_UUID, title: 'Test' }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for missing title', async () => {
+		const ctx = createMockContext();
+		await expect(
+			addDeploymentRequirement({ project_id: VALID_UUID, type: 'migration' }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for invalid type', async () => {
+		const ctx = createMockContext();
+		await expect(
+			addDeploymentRequirement({
+				project_id: VALID_UUID,
+				type: 'invalid_type',
+				title: 'Test',
+			}, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for invalid stage', async () => {
+		const ctx = createMockContext();
+		await expect(
+			addDeploymentRequirement({
+				project_id: VALID_UUID,
+				type: 'migration',
+				title: 'Test',
+				stage: 'invalid_stage',
+			}, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should add requirement successfully', async () => {
+		mockApiClient.addDeploymentRequirement.mockResolvedValue({
+			ok: true,
+			data: { success: true, requirement_id: 'req-1', stage: 'preparation' },
+		});
+		const ctx = createMockContext();
+
+		const result = await addDeploymentRequirement(
+			{
+				project_id: VALID_UUID,
+				type: 'migration',
+				title: 'Test Migration',
+			},
+			ctx
+		);
+
+		expect(result.result).toMatchObject({
+			success: true,
+			requirement_id: 'req-1',
+			stage: 'preparation',
+		});
+	});
+});
+
+// ============================================================================
+// getDeploymentRequirements Tests
+// ============================================================================
+
+describe('getDeploymentRequirements', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(getDeploymentRequirements({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should return empty list when no requirements', async () => {
+		mockApiClient.getDeploymentRequirements.mockResolvedValue({
+			ok: true,
+			data: { requirements: [], deployment_blocked: false },
+		});
+		const ctx = createMockContext();
+
+		const result = await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject({
+			requirements: [],
+			deployment_blocked: false,
+		});
+	});
+
+	it('should query with correct project_id', async () => {
+		mockApiClient.getDeploymentRequirements.mockResolvedValue({
+			ok: true,
+			data: { requirements: [], deployment_blocked: false },
+		});
+		const ctx = createMockContext();
+
+		await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
+
+		expect(mockApiClient.getDeploymentRequirements).toHaveBeenCalledWith(
+			VALID_UUID,
+			expect.any(Object)
+		);
+	});
+
+	it('should return requirements list', async () => {
+		const mockReqs = [
+			{ id: 'req-1', type: 'migration', title: 'Run migrations' },
+			{ id: 'req-2', type: 'env_var', title: 'Set API_KEY' },
+		];
+		mockApiClient.getDeploymentRequirements.mockResolvedValue({
+			ok: true,
+			data: { requirements: mockReqs, deployment_blocked: true },
+		});
+		const ctx = createMockContext();
+
+		const result = await getDeploymentRequirements({ project_id: VALID_UUID }, ctx);
+
+		expect((result.result as { requirements: unknown[] }).requirements).toHaveLength(2);
+		expect(result.result).toHaveProperty('deployment_blocked', true);
+	});
+
+	it('should pass pagination params to API client', async () => {
+		mockApiClient.getDeploymentRequirements.mockResolvedValue({
+			ok: true,
+			data: { requirements: [], deployment_blocked: false },
+		});
+		const ctx = createMockContext();
+
+		await getDeploymentRequirements(
+			{ project_id: VALID_UUID, limit: 10, offset: 5 },
+			ctx
+		);
+
+		expect(mockApiClient.getDeploymentRequirements).toHaveBeenCalledWith(
+			VALID_UUID,
+			expect.objectContaining({ limit: 10, offset: 5 })
+		);
+	});
+});
+
+// ============================================================================
+// getDeploymentRequirementsStats Tests
+// ============================================================================
+
+describe('getDeploymentRequirementsStats', () => {
+	beforeEach(() => vi.clearAllMocks());
+
+	it('should throw error for missing project_id', async () => {
+		const ctx = createMockContext();
+		await expect(getDeploymentRequirementsStats({}, ctx)).rejects.toThrow(ValidationError);
+	});
+
+	it('should throw error for invalid project_id UUID', async () => {
+		const ctx = createMockContext();
+		await expect(
+			getDeploymentRequirementsStats({ project_id: 'invalid' }, ctx)
+		).rejects.toThrow(ValidationError);
+	});
+
+	it('should return stats from API client', async () => {
+		const mockStats = {
+			total: 5,
+			by_status: { pending: 3, completed: 2 },
+			by_stage: { preparation: 2, deployment: 2, verification: 1 },
+			by_type: { migration: 2, env_var: 2, manual: 1 },
+		};
+		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
+			ok: true,
+			data: mockStats,
+		});
+		const ctx = createMockContext();
+
+		const result = await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toMatchObject(mockStats);
+	});
+
+	it('should call API client with correct project_id', async () => {
+		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
+			ok: true,
+			data: { total: 0, by_status: {}, by_stage: {}, by_type: {} },
+		});
+		const ctx = createMockContext();
+
+		await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
+
+		expect(mockApiClient.getDeploymentRequirementsStats).toHaveBeenCalledWith(VALID_UUID);
+	});
+
+	it('should handle API error', async () => {
+		mockApiClient.getDeploymentRequirementsStats.mockResolvedValue({
+			ok: false,
+			error: 'Database error',
+		});
+		const ctx = createMockContext();
+
+		const result = await getDeploymentRequirementsStats({ project_id: VALID_UUID }, ctx);
+
+		expect(result.result).toHaveProperty('error');
+	});
+});