@vibescope/mcp-server 0.5.0 → 0.5.1

package/src/handlers/cost.ts

@@ -1,285 +1,285 @@
-/**
- * Cost Handlers
- *
- * Handles cost monitoring and alerts:
- * - get_cost_summary
- * - get_cost_alerts
- * - add_cost_alert
- * - update_cost_alert
- * - delete_cost_alert
- * - get_task_costs
- * - get_body_of_work_costs
- * - get_sprint_costs
- */
-
-import type { Handler, HandlerRegistry } from './types.js';
-import { parseArgs, uuidValidator, createEnumValidator, ValidationError } from '../validators.js';
-import { getApiClient } from '../api-client.js';
-
-const VALID_PERIODS = ['daily', 'weekly', 'monthly'] as const;
-const VALID_ALERT_TYPES = ['warning', 'critical'] as const;
-
-type Period = typeof VALID_PERIODS[number];
-type AlertType = typeof VALID_ALERT_TYPES[number];
-
-// Argument schemas for type-safe parsing
-const getCostSummarySchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	period: { type: 'string' as const, default: 'daily', validate: createEnumValidator(VALID_PERIODS) },
-	limit: { type: 'number' as const, default: 30 },
-};
-
-const getCostAlertsSchema = {
-	project_id: { type: 'string' as const, validate: uuidValidator },
-};
-
-const addCostAlertSchema = {
-	project_id: { type: 'string' as const, validate: uuidValidator },
-	threshold_amount: { type: 'number' as const, required: true as const },
-	threshold_period: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_PERIODS) },
-	alert_type: { type: 'string' as const, default: 'warning', validate: createEnumValidator(VALID_ALERT_TYPES) },
-};
-
-const updateCostAlertSchema = {
-	alert_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	threshold_amount: { type: 'number' as const },
-	threshold_period: { type: 'string' as const, validate: createEnumValidator(VALID_PERIODS) },
-	alert_type: { type: 'string' as const, validate: createEnumValidator(VALID_ALERT_TYPES) },
-	enabled: { type: 'boolean' as const },
-};
-
-const deleteCostAlertSchema = {
-	alert_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-};
-
-const getTaskCostsSchema = {
-	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
-	limit: { type: 'number' as const, default: 20 },
-};
-
-const getBodyOfWorkCostsSchema = {
-	body_of_work_id: { type: 'string' as const, validate: uuidValidator },
-	project_id: { type: 'string' as const, validate: uuidValidator },
-};
-
-const getSprintCostsSchema = {
-	sprint_id: { type: 'string' as const, validate: uuidValidator },
-	project_id: { type: 'string' as const, validate: uuidValidator },
-};
-
-// Custom validator for positive numbers
-function validatePositiveNumber(value: number | undefined, fieldName: string): void {
-	if (value !== undefined && value <= 0) {
-		throw new ValidationError(`${fieldName} must be a positive number`, { field: fieldName });
-	}
-}
-
-/**
- * Get cost summary for a project (daily, weekly, or monthly)
- */
-export const getCostSummary: Handler = async (args, _ctx) => {
-	const { project_id, period, limit } = parseArgs(args, getCostSummarySchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getCostSummary(project_id, {
-		period: period as Period,
-		limit
-	});
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to get cost summary' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Get cost alerts for the current user
- */
-export const getCostAlerts: Handler = async (args, _ctx) => {
-	const { project_id } = parseArgs(args, getCostAlertsSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getCostAlerts();
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to get cost alerts' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Add a cost alert
- */
-export const addCostAlert: Handler = async (args, _ctx) => {
-	const { project_id, threshold_amount, threshold_period, alert_type } = parseArgs(args, addCostAlertSchema);
-
-	// Additional validation for positive amount
-	validatePositiveNumber(threshold_amount, 'threshold_amount');
-
-	const apiClient = getApiClient();
-	const response = await apiClient.addCostAlert({
-		project_id,
-		threshold_amount: threshold_amount!,
-		threshold_period: threshold_period as Period,
-		alert_type: alert_type as AlertType
-	});
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to create cost alert' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Update a cost alert
- */
-export const updateCostAlert: Handler = async (args, _ctx) => {
-	const { alert_id, threshold_amount, threshold_period, alert_type, enabled } = parseArgs(args, updateCostAlertSchema);
-
-	// Check that at least one update is provided
-	if (threshold_amount === undefined && threshold_period === undefined && alert_type === undefined && enabled === undefined) {
-		return {
-			result: { error: 'No updates provided' },
-			isError: true,
-		};
-	}
-
-	const updates: {
-		threshold_amount?: number;
-		threshold_period?: Period;
-		alert_type?: AlertType;
-		enabled?: boolean;
-	} = {};
-	if (threshold_amount !== undefined) updates.threshold_amount = threshold_amount;
-	if (threshold_period !== undefined) updates.threshold_period = threshold_period as Period;
-	if (alert_type !== undefined) updates.alert_type = alert_type as AlertType;
-	if (enabled !== undefined) updates.enabled = enabled;
-
-	const apiClient = getApiClient();
-	const response = await apiClient.updateCostAlert(alert_id, updates);
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to update cost alert' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Delete a cost alert
- */
-export const deleteCostAlert: Handler = async (args, _ctx) => {
-	const { alert_id } = parseArgs(args, deleteCostAlertSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.deleteCostAlert(alert_id);
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to delete cost alert' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Get task costs for a project
- */
-export const getTaskCosts: Handler = async (args, _ctx) => {
-	const { project_id, limit } = parseArgs(args, getTaskCostsSchema);
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getTaskCosts(project_id, limit);
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to get task costs' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Get body of work costs with phase breakdown
- */
-export const getBodyOfWorkCosts: Handler = async (args, _ctx) => {
-	const { body_of_work_id, project_id } = parseArgs(args, getBodyOfWorkCostsSchema);
-
-	if (!body_of_work_id && !project_id) {
-		return {
-			result: { error: 'Either body_of_work_id or project_id is required' },
-			isError: true,
-		};
-	}
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getBodyOfWorkCosts({ body_of_work_id, project_id });
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to get body of work costs' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Get sprint costs with velocity metrics
- */
-export const getSprintCosts: Handler = async (args, _ctx) => {
-	const { sprint_id, project_id } = parseArgs(args, getSprintCostsSchema);
-
-	if (!sprint_id && !project_id) {
-		return {
-			result: { error: 'Either sprint_id or project_id is required' },
-			isError: true,
-		};
-	}
-
-	const apiClient = getApiClient();
-	const response = await apiClient.getSprintCosts({ sprint_id, project_id });
-
-	if (!response.ok) {
-		return {
-			result: { error: response.error || 'Failed to get sprint costs' },
-			isError: true,
-		};
-	}
-
-	return { result: response.data };
-};
-
-/**
- * Cost handlers registry
- */
-export const costHandlers: HandlerRegistry = {
-	get_cost_summary: getCostSummary,
-	get_cost_alerts: getCostAlerts,
-	add_cost_alert: addCostAlert,
-	update_cost_alert: updateCostAlert,
-	delete_cost_alert: deleteCostAlert,
-	get_task_costs: getTaskCosts,
-	get_body_of_work_costs: getBodyOfWorkCosts,
-	get_sprint_costs: getSprintCosts,
-};
+/**
+ * Cost Handlers
+ *
+ * Handles cost monitoring and alerts:
+ * - get_cost_summary
+ * - get_cost_alerts
+ * - add_cost_alert
+ * - update_cost_alert
+ * - delete_cost_alert
+ * - get_task_costs
+ * - get_body_of_work_costs
+ * - get_sprint_costs
+ */
+
+import type { Handler, HandlerRegistry } from './types.js';
+import { parseArgs, uuidValidator, createEnumValidator, ValidationError } from '../validators.js';
+import { getApiClient } from '../api-client.js';
+
+const VALID_PERIODS = ['daily', 'weekly', 'monthly'] as const;
+const VALID_ALERT_TYPES = ['warning', 'critical'] as const;
+
+type Period = typeof VALID_PERIODS[number];
+type AlertType = typeof VALID_ALERT_TYPES[number];
+
+// Argument schemas for type-safe parsing
+const getCostSummarySchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	period: { type: 'string' as const, default: 'daily', validate: createEnumValidator(VALID_PERIODS) },
+	limit: { type: 'number' as const, default: 30 },
+};
+
+const getCostAlertsSchema = {
+	project_id: { type: 'string' as const, validate: uuidValidator },
+};
+
+const addCostAlertSchema = {
+	project_id: { type: 'string' as const, validate: uuidValidator },
+	threshold_amount: { type: 'number' as const, required: true as const },
+	threshold_period: { type: 'string' as const, required: true as const, validate: createEnumValidator(VALID_PERIODS) },
+	alert_type: { type: 'string' as const, default: 'warning', validate: createEnumValidator(VALID_ALERT_TYPES) },
+};
+
+const updateCostAlertSchema = {
+	alert_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	threshold_amount: { type: 'number' as const },
+	threshold_period: { type: 'string' as const, validate: createEnumValidator(VALID_PERIODS) },
+	alert_type: { type: 'string' as const, validate: createEnumValidator(VALID_ALERT_TYPES) },
+	enabled: { type: 'boolean' as const },
+};
+
+const deleteCostAlertSchema = {
+	alert_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+};
+
+const getTaskCostsSchema = {
+	project_id: { type: 'string' as const, required: true as const, validate: uuidValidator },
+	limit: { type: 'number' as const, default: 20 },
+};
+
+const getBodyOfWorkCostsSchema = {
+	body_of_work_id: { type: 'string' as const, validate: uuidValidator },
+	project_id: { type: 'string' as const, validate: uuidValidator },
+};
+
+const getSprintCostsSchema = {
+	sprint_id: { type: 'string' as const, validate: uuidValidator },
+	project_id: { type: 'string' as const, validate: uuidValidator },
+};
+
+// Custom validator for positive numbers
+function validatePositiveNumber(value: number | undefined, fieldName: string): void {
+	if (value !== undefined && value <= 0) {
+		throw new ValidationError(`${fieldName} must be a positive number`, { field: fieldName });
+	}
+}
+
+/**
+ * Get cost summary for a project (daily, weekly, or monthly)
+ */
+export const getCostSummary: Handler = async (args, _ctx) => {
+	const { project_id, period, limit } = parseArgs(args, getCostSummarySchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getCostSummary(project_id, {
+		period: period as Period,
+		limit
+	});
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to get cost summary' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Get cost alerts for the current user
+ */
+export const getCostAlerts: Handler = async (args, _ctx) => {
+	const { project_id } = parseArgs(args, getCostAlertsSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getCostAlerts();
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to get cost alerts' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Add a cost alert
+ */
+export const addCostAlert: Handler = async (args, _ctx) => {
+	const { project_id, threshold_amount, threshold_period, alert_type } = parseArgs(args, addCostAlertSchema);
+
+	// Additional validation for positive amount
+	validatePositiveNumber(threshold_amount, 'threshold_amount');
+
+	const apiClient = getApiClient();
+	const response = await apiClient.addCostAlert({
+		project_id,
+		threshold_amount: threshold_amount!,
+		threshold_period: threshold_period as Period,
+		alert_type: alert_type as AlertType
+	});
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to create cost alert' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Update a cost alert
+ */
+export const updateCostAlert: Handler = async (args, _ctx) => {
+	const { alert_id, threshold_amount, threshold_period, alert_type, enabled } = parseArgs(args, updateCostAlertSchema);
+
+	// Check that at least one update is provided
+	if (threshold_amount === undefined && threshold_period === undefined && alert_type === undefined && enabled === undefined) {
+		return {
+			result: { error: 'No updates provided' },
+			isError: true,
+		};
+	}
+
+	const updates: {
+		threshold_amount?: number;
+		threshold_period?: Period;
+		alert_type?: AlertType;
+		enabled?: boolean;
+	} = {};
+	if (threshold_amount !== undefined) updates.threshold_amount = threshold_amount;
+	if (threshold_period !== undefined) updates.threshold_period = threshold_period as Period;
+	if (alert_type !== undefined) updates.alert_type = alert_type as AlertType;
+	if (enabled !== undefined) updates.enabled = enabled;
+
+	const apiClient = getApiClient();
+	const response = await apiClient.updateCostAlert(alert_id, updates);
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to update cost alert' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Delete a cost alert
+ */
+export const deleteCostAlert: Handler = async (args, _ctx) => {
+	const { alert_id } = parseArgs(args, deleteCostAlertSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.deleteCostAlert(alert_id);
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to delete cost alert' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Get task costs for a project
+ */
+export const getTaskCosts: Handler = async (args, _ctx) => {
+	const { project_id, limit } = parseArgs(args, getTaskCostsSchema);
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getTaskCosts(project_id, limit);
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to get task costs' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Get body of work costs with phase breakdown
+ */
+export const getBodyOfWorkCosts: Handler = async (args, _ctx) => {
+	const { body_of_work_id, project_id } = parseArgs(args, getBodyOfWorkCostsSchema);
+
+	if (!body_of_work_id && !project_id) {
+		return {
+			result: { error: 'Either body_of_work_id or project_id is required' },
+			isError: true,
+		};
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getBodyOfWorkCosts({ body_of_work_id, project_id });
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to get body of work costs' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Get sprint costs with velocity metrics
+ */
+export const getSprintCosts: Handler = async (args, _ctx) => {
+	const { sprint_id, project_id } = parseArgs(args, getSprintCostsSchema);
+
+	if (!sprint_id && !project_id) {
+		return {
+			result: { error: 'Either sprint_id or project_id is required' },
+			isError: true,
+		};
+	}
+
+	const apiClient = getApiClient();
+	const response = await apiClient.getSprintCosts({ sprint_id, project_id });
+
+	if (!response.ok) {
+		return {
+			result: { error: response.error || 'Failed to get sprint costs' },
+			isError: true,
+		};
+	}
+
+	return { result: response.data };
+};
+
+/**
+ * Cost handlers registry
+ */
+export const costHandlers: HandlerRegistry = {
+	get_cost_summary: getCostSummary,
+	get_cost_alerts: getCostAlerts,
+	add_cost_alert: addCostAlert,
+	update_cost_alert: updateCostAlert,
+	delete_cost_alert: deleteCostAlert,
+	get_task_costs: getTaskCosts,
+	get_body_of_work_costs: getBodyOfWorkCosts,
+	get_sprint_costs: getSprintCosts,
+};