@vibescope/mcp-server 0.5.0 → 0.5.2

package/src/api-client/index.ts

@@ -1,592 +1,592 @@
-/**
- * Vibescope API Client
- *
- * HTTP client for communicating with the Vibescope API.
- * All database operations are handled server-side through these endpoints.
- *
- * This module composes domain-specific API methods into a unified client.
- */
-
-import type { ApiClientConfig, ApiResponse, RetryConfig, RequestFn, ProxyFn } from './types.js';
-import { createSessionMethods, type SessionMethods } from './session.js';
-import { createProjectMethods, type ProjectMethods } from './project.js';
-import { createBlockersMethods, type BlockersMethods } from './blockers.js';
-import { createCostMethods, type CostMethods } from './cost.js';
-import { createWorktreesMethods, type WorktreesMethods } from './worktrees.js';
-import { createDiscoveryMethods, type DiscoveryMethods } from './discovery.js';
-import { createDecisionsMethods, type DecisionsMethods } from './decisions.js';
-import { createIdeasMethods, type IdeasMethods } from './ideas.js';
-import { createTasksMethods, type TasksMethods } from './tasks.js';
-import { createFindingsMethods, type FindingsMethods } from './findings.js';
-import { createMilestonesMethods, type MilestonesMethods } from './milestones.js';
-import { createValidationMethods, type ValidationMethods } from './validation.js';
-import { createFallbackMethods, type FallbackMethods } from './fallback.js';
-import { createRequestsMethods, type RequestsMethods } from './requests.js';
-import { createDeploymentMethods, type DeploymentMethods } from './deployment.js';
-import { createOrganizationsMethods, type OrganizationsMethods } from './organizations.js';
-import { createBodiesOfWorkMethods, type BodiesOfWorkMethods } from './bodies-of-work.js';
-import { createGitIssuesMethods, type GitIssuesMethods } from './git-issues.js';
-import { createFileCheckoutsMethods, type FileCheckoutsMethods } from './file-checkouts.js';
-import { createConnectorsMethods, type ConnectorsMethods } from './connectors.js';
-import { createSprintsMethods, type SprintsMethods } from './sprints.js';
-import { createSubtasksMethods, type SubtasksMethods } from './subtasks.js';
-import { createProgressMethods, type ProgressMethods } from './progress.js';
-import { createChatMethods, type ChatMethods } from './chat.js';
-
-// Re-export types
-export type { ApiClientConfig, ApiResponse, RetryConfig, RequestFn, ProxyFn } from './types.js';
-export type { SessionMethods } from './session.js';
-export type { ProjectMethods } from './project.js';
-export type { BlockersMethods } from './blockers.js';
-export type { CostMethods } from './cost.js';
-export type { WorktreesMethods } from './worktrees.js';
-export type { DiscoveryMethods } from './discovery.js';
-export type { DecisionsMethods } from './decisions.js';
-export type { IdeasMethods } from './ideas.js';
-export type { TasksMethods } from './tasks.js';
-export type { FindingsMethods } from './findings.js';
-export type { MilestonesMethods } from './milestones.js';
-export type { ValidationMethods } from './validation.js';
-export type { FallbackMethods } from './fallback.js';
-export type { RequestsMethods } from './requests.js';
-export type { DeploymentMethods } from './deployment.js';
-export type { OrganizationsMethods } from './organizations.js';
-export type { BodiesOfWorkMethods } from './bodies-of-work.js';
-export type { GitIssuesMethods } from './git-issues.js';
-export type { FileCheckoutsMethods } from './file-checkouts.js';
-export type { ConnectorsMethods } from './connectors.js';
-export type { SprintsMethods } from './sprints.js';
-export type { SubtasksMethods } from './subtasks.js';
-export type { ProgressMethods } from './progress.js';
-export type { ChatMethods } from './chat.js';
-
-const DEFAULT_API_URL = 'https://vibescope.dev';
-
-// Retry configuration defaults
-const DEFAULT_RETRY_STATUS_CODES = [429, 503, 504];
-const DEFAULT_MAX_RETRIES = 3;
-const DEFAULT_BASE_DELAY_MS = 1000;
-const DEFAULT_MAX_DELAY_MS = 30000;
-
-/**
- * Calculate delay for exponential backoff with jitter
- */
-function calculateBackoffDelay(
-	attempt: number,
-	baseDelayMs: number,
-	maxDelayMs: number,
-	retryAfter?: number
-): number {
-	if (retryAfter !== undefined && retryAfter > 0) {
-		return Math.min(retryAfter * 1000, maxDelayMs);
-	}
-	const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
-	const jitter = Math.random() * 0.3 * exponentialDelay;
-	return Math.min(exponentialDelay + jitter, maxDelayMs);
-}
-
-/**
- * Sleep for a specified duration
- */
-function sleep(ms: number): Promise<void> {
-	return new Promise(resolve => setTimeout(resolve, ms));
-}
-
-/**
- * Combined interface for all API methods
- */
-export interface VibescopeApiClientMethods
-	extends SessionMethods,
-		ProjectMethods,
-		BlockersMethods,
-		CostMethods,
-		WorktreesMethods,
-		DiscoveryMethods,
-		DecisionsMethods,
-		IdeasMethods,
-		TasksMethods,
-		FindingsMethods,
-		MilestonesMethods,
-		ValidationMethods,
-		FallbackMethods,
-		RequestsMethods,
-		DeploymentMethods,
-		OrganizationsMethods,
-		BodiesOfWorkMethods,
-		GitIssuesMethods,
-		FileCheckoutsMethods,
-		ConnectorsMethods,
-		SprintsMethods,
-		SubtasksMethods,
-		ProgressMethods,
-		ChatMethods {}
-
-export class VibescopeApiClient implements VibescopeApiClientMethods {
-	private apiKey: string;
-	private baseUrl: string;
-	private retryConfig: Required<RetryConfig>;
-
-	// Domain method implementations
-	private sessionMethods: SessionMethods;
-	private projectMethods: ProjectMethods;
-	private blockersMethods: BlockersMethods;
-	private costMethods: CostMethods;
-	private worktreesMethods: WorktreesMethods;
-	private discoveryMethods: DiscoveryMethods;
-	private decisionsMethods: DecisionsMethods;
-	private ideasMethods: IdeasMethods;
-	private tasksMethods: TasksMethods;
-	private findingsMethods: FindingsMethods;
-	private milestonesMethods: MilestonesMethods;
-	private validationMethods: ValidationMethods;
-	private fallbackMethods: FallbackMethods;
-	private requestsMethods: RequestsMethods;
-	private deploymentMethods: DeploymentMethods;
-	private organizationsMethods: OrganizationsMethods;
-	private bodiesOfWorkMethods: BodiesOfWorkMethods;
-	private gitIssuesMethods: GitIssuesMethods;
-	private fileCheckoutsMethods: FileCheckoutsMethods;
-	private connectorsMethods: ConnectorsMethods;
-	private sprintsMethods: SprintsMethods;
-	private subtasksMethods: SubtasksMethods;
-	private progressMethods: ProgressMethods;
-	private chatMethods: ChatMethods;
-
-	constructor(config: ApiClientConfig) {
-		this.apiKey = config.apiKey;
-		this.baseUrl = config.baseUrl || process.env.VIBESCOPE_API_URL || DEFAULT_API_URL;
-		this.retryConfig = {
-			maxRetries: config.retry?.maxRetries ?? DEFAULT_MAX_RETRIES,
-			baseDelayMs: config.retry?.baseDelayMs ?? DEFAULT_BASE_DELAY_MS,
-			maxDelayMs: config.retry?.maxDelayMs ?? DEFAULT_MAX_DELAY_MS,
-			retryStatusCodes: config.retry?.retryStatusCodes ?? DEFAULT_RETRY_STATUS_CODES,
-		};
-
-		// Create bound request and proxy functions for domain modules
-		const request: RequestFn = this.request.bind(this);
-		const proxy: ProxyFn = this.proxy.bind(this);
-		const getApiKey = () => this.apiKey;
-
-		// Initialize domain methods
-		this.sessionMethods = createSessionMethods(request, getApiKey);
-		this.projectMethods = createProjectMethods(request);
-		this.blockersMethods = createBlockersMethods(request);
-		this.costMethods = createCostMethods(request);
-		this.worktreesMethods = createWorktreesMethods(request);
-		this.discoveryMethods = createDiscoveryMethods(request);
-		this.decisionsMethods = createDecisionsMethods(proxy);
-		this.ideasMethods = createIdeasMethods(proxy);
-		this.tasksMethods = createTasksMethods(request, proxy);
-		this.findingsMethods = createFindingsMethods(proxy);
-		this.milestonesMethods = createMilestonesMethods(proxy);
-		this.validationMethods = createValidationMethods(proxy);
-		this.fallbackMethods = createFallbackMethods(proxy);
-		this.requestsMethods = createRequestsMethods(proxy);
-		this.deploymentMethods = createDeploymentMethods(proxy);
-		this.organizationsMethods = createOrganizationsMethods(proxy);
-		this.bodiesOfWorkMethods = createBodiesOfWorkMethods(proxy);
-		this.gitIssuesMethods = createGitIssuesMethods(proxy);
-		this.fileCheckoutsMethods = createFileCheckoutsMethods(proxy);
-		this.connectorsMethods = createConnectorsMethods(proxy);
-		this.sprintsMethods = createSprintsMethods(proxy);
-		this.subtasksMethods = createSubtasksMethods(proxy);
-		this.progressMethods = createProgressMethods(request, proxy);
-		this.chatMethods = createChatMethods(proxy);
-	}
-
-	private async request<T>(method: string, path: string, body?: unknown): Promise<ApiResponse<T>> {
-		const url = `${this.baseUrl}${path}`;
-		const { maxRetries, baseDelayMs, maxDelayMs, retryStatusCodes } = this.retryConfig;
-		let lastError: Error | null = null;
-		let lastResponse: Response | null = null;
-
-		for (let attempt = 0; attempt <= maxRetries; attempt++) {
-			try {
-				const response = await fetch(url, {
-					method,
-					headers: {
-						'Content-Type': 'application/json',
-						'X-API-Key': this.apiKey
-					},
-					body: body ? JSON.stringify(body) : undefined
-				});
-
-				if (retryStatusCodes.includes(response.status) && attempt < maxRetries) {
-					lastResponse = response;
-					const retryAfterHeader = response.headers.get('Retry-After');
-					let retryAfter: number | undefined;
-					if (retryAfterHeader) {
-						const parsed = parseInt(retryAfterHeader, 10);
-						if (!isNaN(parsed)) {
-							retryAfter = parsed;
-						}
-					}
-					const delay = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs, retryAfter);
-					await sleep(delay);
-					continue;
-				}
-
-				if (!response.ok) {
-					const errorData = await response.json().catch(() => ({}));
-					return {
-						ok: false,
-						status: response.status,
-						error: errorData.error || errorData.message || `HTTP ${response.status}`
-					};
-				}
-
-				const data = await response.json();
-				return {
-					ok: true,
-					status: response.status,
-					data
-				};
-			} catch (error) {
-				lastError = error as Error;
-				if (attempt < maxRetries) {
-					const delay = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs);
-					await sleep(delay);
-					continue;
-				}
-			}
-		}
-
-		if (lastResponse && !lastResponse.ok) {
-			return {
-				ok: false,
-				status: lastResponse.status,
-				error: `Request failed after ${maxRetries + 1} attempts with status ${lastResponse.status}`
-			};
-		}
-
-		return {
-			ok: false,
-			status: 0,
-			error: lastError?.message || 'Request failed after all retries'
-		};
-	}
-
-	/**
-	 * Generic proxy method for operations that go through the MCP proxy endpoint
-	 */
-	async proxy<T>(operation: string, args: Record<string, unknown>, sessionContext?: {
-		session_id?: string;
-		project_id?: string;
-	}): Promise<ApiResponse<T>> {
-		return this.request('POST', '/api/mcp/proxy', {
-			operation,
-			args,
-			...sessionContext
-		});
-	}
-
-	// ============================================================================
-	// Session methods (delegated)
-	// ============================================================================
-	validateAuth = () => this.sessionMethods.validateAuth();
-	startSession = (params: Parameters<SessionMethods['startSession']>[0]) => this.sessionMethods.startSession(params);
-	heartbeat = (sessionId: string, options?: Parameters<SessionMethods['heartbeat']>[1]) => this.sessionMethods.heartbeat(sessionId, options);
-	endSession = (sessionId: string) => this.sessionMethods.endSession(sessionId);
-	signalIdle = (sessionId: string) => this.sessionMethods.signalIdle(sessionId);
-	syncSession = (sessionId: string, params?: Parameters<SessionMethods['syncSession']>[1]) => this.sessionMethods.syncSession(sessionId, params);
-	confirmAgentSetup = (projectId: string, agentType: string) => this.sessionMethods.confirmAgentSetup(projectId, agentType);
-
-	// ============================================================================
-	// Project methods (delegated)
-	// ============================================================================
-	listProjects = () => this.projectMethods.listProjects();
-	createProject = (params: Parameters<ProjectMethods['createProject']>[0]) => this.projectMethods.createProject(params);
-	getProject = (projectId: string, gitUrl?: string) => this.projectMethods.getProject(projectId, gitUrl);
-	updateProject = (projectId: string, updates: Parameters<ProjectMethods['updateProject']>[1]) => this.projectMethods.updateProject(projectId, updates);
-	getGitWorkflow = (projectId: string, taskId?: string) => this.projectMethods.getGitWorkflow(projectId, taskId);
-	updateProjectReadme = (projectId: string, readmeContent: string) => this.projectMethods.updateProjectReadme(projectId, readmeContent);
-	getProjectSummary = (projectId: string) => this.projectMethods.getProjectSummary(projectId);
-
-	// ============================================================================
-	// Blockers methods (delegated)
-	// ============================================================================
-	getBlockers = (projectId: string, params?: Parameters<BlockersMethods['getBlockers']>[1]) => this.blockersMethods.getBlockers(projectId, params);
-	addBlocker = (projectId: string, description: string, sessionId?: string) => this.blockersMethods.addBlocker(projectId, description, sessionId);
-	resolveBlocker = (blockerId: string, resolutionNote?: string) => this.blockersMethods.resolveBlocker(blockerId, resolutionNote);
-	deleteBlocker = (blockerId: string) => this.blockersMethods.deleteBlocker(blockerId);
-	getBlockersStats = (projectId: string) => this.blockersMethods.getBlockersStats(projectId);
-
-	// ============================================================================
-	// Cost methods (delegated)
-	// ============================================================================
-	getCostSummary = (projectId: string, params?: Parameters<CostMethods['getCostSummary']>[1]) => this.costMethods.getCostSummary(projectId, params);
-	getCostAlerts = () => this.costMethods.getCostAlerts();
-	addCostAlert = (params: Parameters<CostMethods['addCostAlert']>[0]) => this.costMethods.addCostAlert(params);
-	updateCostAlert = (alertId: string, updates: Parameters<CostMethods['updateCostAlert']>[1]) => this.costMethods.updateCostAlert(alertId, updates);
-	deleteCostAlert = (alertId: string) => this.costMethods.deleteCostAlert(alertId);
-	getTaskCosts = (projectId: string, limit?: number) => this.costMethods.getTaskCosts(projectId, limit);
-	getBodyOfWorkCosts = (params: Parameters<CostMethods['getBodyOfWorkCosts']>[0]) => this.costMethods.getBodyOfWorkCosts(params);
-	getSprintCosts = (params: Parameters<CostMethods['getSprintCosts']>[0]) => this.costMethods.getSprintCosts(params);
-	getTokenUsage = () => this.costMethods.getTokenUsage();
-	reportTokenUsage = (sessionId: string, params: Parameters<CostMethods['reportTokenUsage']>[1]) => this.costMethods.reportTokenUsage(sessionId, params);
-
-	// ============================================================================
-	// Worktrees methods (delegated)
-	// ============================================================================
-	getStaleWorktrees = (projectId: string, params?: Parameters<WorktreesMethods['getStaleWorktrees']>[1]) => this.worktreesMethods.getStaleWorktrees(projectId, params);
-	clearWorktreePath = (taskId: string) => this.worktreesMethods.clearWorktreePath(taskId);
-
-	// ============================================================================
-	// Discovery methods (delegated)
-	// ============================================================================
-	queryKnowledgeBase = (projectId: string, params?: Parameters<DiscoveryMethods['queryKnowledgeBase']>[1]) => this.discoveryMethods.queryKnowledgeBase(projectId, params);
-	getHelpTopic = (slug: string) => this.discoveryMethods.getHelpTopic(slug);
-	getHelpTopics = () => this.discoveryMethods.getHelpTopics();
-
-	// ============================================================================
-	// Decisions methods (delegated)
-	// ============================================================================
-	getDecisions = (projectId: string, options?: Parameters<DecisionsMethods['getDecisions']>[1]) => this.decisionsMethods.getDecisions(projectId, options);
-	getDecision = (decisionId: string) => this.decisionsMethods.getDecision(decisionId);
-	logDecision = (projectId: string, params: Parameters<DecisionsMethods['logDecision']>[1], sessionId?: string) => this.decisionsMethods.logDecision(projectId, params, sessionId);
-	deleteDecision = (decisionId: string) => this.decisionsMethods.deleteDecision(decisionId);
-	getDecisionsStats = (projectId: string) => this.decisionsMethods.getDecisionsStats(projectId);
-
-	// ============================================================================
-	// Ideas methods (delegated)
-	// ============================================================================
-	getIdeas = (projectId: string, params?: Parameters<IdeasMethods['getIdeas']>[1]) => this.ideasMethods.getIdeas(projectId, params);
-	getIdea = (ideaId: string) => this.ideasMethods.getIdea(ideaId);
-	addIdea = (projectId: string, params: Parameters<IdeasMethods['addIdea']>[1], sessionId?: string) => this.ideasMethods.addIdea(projectId, params, sessionId);
-	updateIdea = (ideaId: string, updates: Parameters<IdeasMethods['updateIdea']>[1]) => this.ideasMethods.updateIdea(ideaId, updates);
-	deleteIdea = (ideaId: string) => this.ideasMethods.deleteIdea(ideaId);
-	convertIdeaToTask = (ideaId: string, params?: Parameters<IdeasMethods['convertIdeaToTask']>[1]) => this.ideasMethods.convertIdeaToTask(ideaId, params);
-
-	// ============================================================================
-	// Tasks methods (delegated)
-	// ============================================================================
-	getTasks = (projectId: string, params?: Parameters<TasksMethods['getTasks']>[1]) => this.tasksMethods.getTasks(projectId, params);
-	createTask = (projectId: string, params: Parameters<TasksMethods['createTask']>[1]) => this.tasksMethods.createTask(projectId, params);
-	getNextTask = (projectId: string, sessionId?: string) => this.tasksMethods.getNextTask(projectId, sessionId);
-	getTask = (taskId: string) => this.tasksMethods.getTask(taskId);
-	getTaskById = (taskId: string, params?: Parameters<TasksMethods['getTaskById']>[1]) => this.tasksMethods.getTaskById(taskId, params);
-	searchTasks = (projectId: string, params: Parameters<TasksMethods['searchTasks']>[1]) => this.tasksMethods.searchTasks(projectId, params);
-	getTasksByPriority = (projectId: string, params?: Parameters<TasksMethods['getTasksByPriority']>[1]) => this.tasksMethods.getTasksByPriority(projectId, params);
-	getRecentTasks = (projectId: string, params?: Parameters<TasksMethods['getRecentTasks']>[1]) => this.tasksMethods.getRecentTasks(projectId, params);
-	getTaskStats = (projectId: string) => this.tasksMethods.getTaskStats(projectId);
-	updateTask = (taskId: string, updates: Parameters<TasksMethods['updateTask']>[1]) => this.tasksMethods.updateTask(taskId, updates);
-	completeTask = (taskId: string, params: Parameters<TasksMethods['completeTask']>[1]) => this.tasksMethods.completeTask(taskId, params);
-	deleteTask = (taskId: string) => this.tasksMethods.deleteTask(taskId);
-	releaseTask = (taskId: string, params?: Parameters<TasksMethods['releaseTask']>[1]) => this.tasksMethods.releaseTask(taskId, params);
-	cancelTask = (taskId: string, params?: Parameters<TasksMethods['cancelTask']>[1]) => this.tasksMethods.cancelTask(taskId, params);
-	addTaskReference = (taskId: string, url: string, label?: string) => this.tasksMethods.addTaskReference(taskId, url, label);
-	removeTaskReference = (taskId: string, url: string) => this.tasksMethods.removeTaskReference(taskId, url);
-	batchUpdateTasks = (updates: Parameters<TasksMethods['batchUpdateTasks']>[0]) => this.tasksMethods.batchUpdateTasks(updates);
-	batchCompleteTasks = (completions: Parameters<TasksMethods['batchCompleteTasks']>[0]) => this.tasksMethods.batchCompleteTasks(completions);
-
-	// ============================================================================
-	// Findings methods (delegated)
-	// ============================================================================
-	getFindings = (projectId: string, params?: Parameters<FindingsMethods['getFindings']>[1]) => this.findingsMethods.getFindings(projectId, params);
-	getFinding = (findingId: string) => this.findingsMethods.getFinding(findingId);
-	getFindingsStats = (projectId: string) => this.findingsMethods.getFindingsStats(projectId);
-	addFinding = (projectId: string, params: Parameters<FindingsMethods['addFinding']>[1], sessionId?: string) => this.findingsMethods.addFinding(projectId, params, sessionId);
-	updateFinding = (findingId: string, updates: Parameters<FindingsMethods['updateFinding']>[1]) => this.findingsMethods.updateFinding(findingId, updates);
-	deleteFinding = (findingId: string) => this.findingsMethods.deleteFinding(findingId);
-
-	// ============================================================================
-	// Milestones methods (delegated)
-	// ============================================================================
-	getMilestones = (taskId: string) => this.milestonesMethods.getMilestones(taskId);
-	addMilestone = (taskId: string, params: Parameters<MilestonesMethods['addMilestone']>[1], sessionId?: string) => this.milestonesMethods.addMilestone(taskId, params, sessionId);
-	updateMilestone = (milestoneId: string, updates: Parameters<MilestonesMethods['updateMilestone']>[1]) => this.milestonesMethods.updateMilestone(milestoneId, updates);
-	completeMilestone = (milestoneId: string) => this.milestonesMethods.completeMilestone(milestoneId);
-	deleteMilestone = (milestoneId: string) => this.milestonesMethods.deleteMilestone(milestoneId);
-
-	// ============================================================================
-	// Validation methods (delegated)
-	// ============================================================================
-	getTasksAwaitingValidation = (projectId: string) => this.validationMethods.getTasksAwaitingValidation(projectId);
-	claimValidation = (taskId: string, sessionId?: string) => this.validationMethods.claimValidation(taskId, sessionId);
-	validateTask = (taskId: string, params: Parameters<ValidationMethods['validateTask']>[1], sessionId?: string) => this.validationMethods.validateTask(taskId, params, sessionId);
-
-	// ============================================================================
-	// Fallback activity methods (delegated)
-	// ============================================================================
-	startFallbackActivity = (projectId: string, activity: string, sessionId?: string) => this.fallbackMethods.startFallbackActivity(projectId, activity, sessionId);
-	stopFallbackActivity = (projectId: string, summary?: string, sessionId?: string) => this.fallbackMethods.stopFallbackActivity(projectId, summary, sessionId);
-
-	// ============================================================================
-	// Requests methods (delegated)
-	// ============================================================================
-	getPendingRequests = (projectId: string, sessionId?: string, limit?: number, offset?: number) => this.requestsMethods.getPendingRequests(projectId, sessionId, limit, offset);
-	acknowledgeRequest = (requestId: string, sessionId?: string) => this.requestsMethods.acknowledgeRequest(requestId, sessionId);
-	answerQuestion = (requestId: string, answer: string, sessionId?: string) => this.requestsMethods.answerQuestion(requestId, answer, sessionId);
-
-	// ============================================================================
-	// Deployment methods (delegated)
-	// ============================================================================
-	requestDeployment = (projectId: string, params?: Parameters<DeploymentMethods['requestDeployment']>[1], sessionId?: string) => this.deploymentMethods.requestDeployment(projectId, params, sessionId);
-	checkDeploymentStatus = (projectId: string) => this.deploymentMethods.checkDeploymentStatus(projectId);
-	claimDeploymentValidation = (projectId: string, sessionId?: string) => this.deploymentMethods.claimDeploymentValidation(projectId, sessionId);
-	reportValidation = (projectId: string, params: Parameters<DeploymentMethods['reportValidation']>[1]) => this.deploymentMethods.reportValidation(projectId, params);
-	startDeployment = (projectId: string, sessionId?: string) => this.deploymentMethods.startDeployment(projectId, sessionId);
-	completeDeployment = (projectId: string, params: Parameters<DeploymentMethods['completeDeployment']>[1]) => this.deploymentMethods.completeDeployment(projectId, params);
-	cancelDeployment = (projectId: string, reason?: string) => this.deploymentMethods.cancelDeployment(projectId, reason);
-	addDeploymentRequirement = (projectId: string, params: Parameters<DeploymentMethods['addDeploymentRequirement']>[1]) => this.deploymentMethods.addDeploymentRequirement(projectId, params);
-	getDeploymentRequirements = (projectId: string, params?: Parameters<DeploymentMethods['getDeploymentRequirements']>[1]) => this.deploymentMethods.getDeploymentRequirements(projectId, params);
-	getDeploymentRequirementsStats = (projectId: string) => this.deploymentMethods.getDeploymentRequirementsStats(projectId);
-	completeDeploymentRequirement = (requirementId: string) => this.deploymentMethods.completeDeploymentRequirement(requirementId);
-	reorderDeploymentRequirements = (projectId: string, params: Parameters<DeploymentMethods['reorderDeploymentRequirements']>[1]) => this.deploymentMethods.reorderDeploymentRequirements(projectId, params);
-	scheduleDeployment = (projectId: string, params: Parameters<DeploymentMethods['scheduleDeployment']>[1]) => this.deploymentMethods.scheduleDeployment(projectId, params);
-	getScheduledDeployments = (projectId: string, params?: Parameters<DeploymentMethods['getScheduledDeployments']>[1]) => this.deploymentMethods.getScheduledDeployments(projectId, params);
-	updateScheduledDeployment = (scheduleId: string, updates: Parameters<DeploymentMethods['updateScheduledDeployment']>[1]) => this.deploymentMethods.updateScheduledDeployment(scheduleId, updates);
-	deleteScheduledDeployment = (scheduleId: string) => this.deploymentMethods.deleteScheduledDeployment(scheduleId);
-	triggerScheduledDeployment = (scheduleId: string, sessionId?: string) => this.deploymentMethods.triggerScheduledDeployment(scheduleId, sessionId);
-	checkDueDeployments = (projectId: string) => this.deploymentMethods.checkDueDeployments(projectId);
-
-	// ============================================================================
-	// Organizations methods (delegated)
-	// ============================================================================
-	listOrganizations = () => this.organizationsMethods.listOrganizations();
-	createOrganization = (params: Parameters<OrganizationsMethods['createOrganization']>[0]) => this.organizationsMethods.createOrganization(params);
-	updateOrganization = (organizationId: string, updates: Parameters<OrganizationsMethods['updateOrganization']>[1]) => this.organizationsMethods.updateOrganization(organizationId, updates);
-	deleteOrganization = (organizationId: string) => this.organizationsMethods.deleteOrganization(organizationId);
-	listOrgMembers = (organizationId: string) => this.organizationsMethods.listOrgMembers(organizationId);
-	inviteMember = (organizationId: string, email: string, role?: string) => this.organizationsMethods.inviteMember(organizationId, email, role);
-	updateMemberRole = (organizationId: string, userId: string, role: string) => this.organizationsMethods.updateMemberRole(organizationId, userId, role);
-	removeMember = (organizationId: string, userId: string) => this.organizationsMethods.removeMember(organizationId, userId);
-	leaveOrganization = (organizationId: string) => this.organizationsMethods.leaveOrganization(organizationId);
-	shareProjectWithOrg = (projectId: string, organizationId: string, permission?: string) => this.organizationsMethods.shareProjectWithOrg(projectId, organizationId, permission);
-	unshareProject = (projectId: string, organizationId: string) => this.organizationsMethods.unshareProject(projectId, organizationId);
-	updateProjectShare = (projectId: string, organizationId: string, permission: string) => this.organizationsMethods.updateProjectShare(projectId, organizationId, permission);
-	listProjectShares = (projectId: string) => this.organizationsMethods.listProjectShares(projectId);
-
-	// ============================================================================
-	// Bodies of work methods (delegated)
-	// ============================================================================
-	createBodyOfWork = (projectId: string, params: Parameters<BodiesOfWorkMethods['createBodyOfWork']>[1]) => this.bodiesOfWorkMethods.createBodyOfWork(projectId, params);
-	getBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.getBodyOfWork(bodyOfWorkId);
-	getBodiesOfWork = (projectId: string, params?: Parameters<BodiesOfWorkMethods['getBodiesOfWork']>[1]) => this.bodiesOfWorkMethods.getBodiesOfWork(projectId, params);
-	updateBodyOfWork = (bodyOfWorkId: string, updates: Parameters<BodiesOfWorkMethods['updateBodyOfWork']>[1]) => this.bodiesOfWorkMethods.updateBodyOfWork(bodyOfWorkId, updates);
-	deleteBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.deleteBodyOfWork(bodyOfWorkId);
-	addTaskToBodyOfWork = (bodyOfWorkId: string, taskId: string, phase?: string, orderIndex?: number) => this.bodiesOfWorkMethods.addTaskToBodyOfWork(bodyOfWorkId, taskId, phase, orderIndex);
-	removeTaskFromBodyOfWork = (taskId: string) => this.bodiesOfWorkMethods.removeTaskFromBodyOfWork(taskId);
-	activateBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.activateBodyOfWork(bodyOfWorkId);
-	addTaskDependency = (bodyOfWorkId: string, taskId: string, dependsOnTaskId: string) => this.bodiesOfWorkMethods.addTaskDependency(bodyOfWorkId, taskId, dependsOnTaskId);
-	removeTaskDependency = (taskId: string, dependsOnTaskId: string) => this.bodiesOfWorkMethods.removeTaskDependency(taskId, dependsOnTaskId);
-	getTaskDependencies = (params: Parameters<BodiesOfWorkMethods['getTaskDependencies']>[0]) => this.bodiesOfWorkMethods.getTaskDependencies(params);
-	getNextBodyOfWorkTask = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.getNextBodyOfWorkTask(bodyOfWorkId);
-
-	// ============================================================================
-	// Git issues methods (delegated)
-	// ============================================================================
-	addGitIssue = (projectId: string, params: Parameters<GitIssuesMethods['addGitIssue']>[1], sessionId?: string) => this.gitIssuesMethods.addGitIssue(projectId, params, sessionId);
-	resolveGitIssue = (gitIssueId: string, params?: Parameters<GitIssuesMethods['resolveGitIssue']>[1], sessionId?: string) => this.gitIssuesMethods.resolveGitIssue(gitIssueId, params, sessionId);
-	getGitIssues = (projectId: string, params?: Parameters<GitIssuesMethods['getGitIssues']>[1]) => this.gitIssuesMethods.getGitIssues(projectId, params);
-	deleteGitIssue = (gitIssueId: string) => this.gitIssuesMethods.deleteGitIssue(gitIssueId);
-
-	// ============================================================================
-	// File checkouts methods (delegated)
-	// ============================================================================
-	checkoutFile = (projectId: string, filePath: string, reason?: string, sessionId?: string) => this.fileCheckoutsMethods.checkoutFile(projectId, filePath, reason, sessionId);
-	checkinFile = (params: Parameters<FileCheckoutsMethods['checkinFile']>[0], sessionId?: string) => this.fileCheckoutsMethods.checkinFile(params, sessionId);
-	getFileCheckouts = (projectId: string, options?: Parameters<FileCheckoutsMethods['getFileCheckouts']>[1]) => this.fileCheckoutsMethods.getFileCheckouts(projectId, options);
-	abandonCheckout = (params: Parameters<FileCheckoutsMethods['abandonCheckout']>[0]) => this.fileCheckoutsMethods.abandonCheckout(params);
-	getFileCheckoutsStats = (projectId: string) => this.fileCheckoutsMethods.getFileCheckoutsStats(projectId);
-	isFileAvailable = (projectId: string, filePath: string) => this.fileCheckoutsMethods.isFileAvailable(projectId, filePath);
-
-	// ============================================================================
-	// Connectors methods (delegated)
-	// ============================================================================
-	getConnectors = (projectId: string, params?: Parameters<ConnectorsMethods['getConnectors']>[1]) => this.connectorsMethods.getConnectors(projectId, params);
-	getConnector = (connectorId: string) => this.connectorsMethods.getConnector(connectorId);
-	addConnector = (projectId: string, params: Parameters<ConnectorsMethods['addConnector']>[1]) => this.connectorsMethods.addConnector(projectId, params);
-	updateConnector = (connectorId: string, updates: Parameters<ConnectorsMethods['updateConnector']>[1]) => this.connectorsMethods.updateConnector(connectorId, updates);
-	deleteConnector = (connectorId: string) => this.connectorsMethods.deleteConnector(connectorId);
-	testConnector = (connectorId: string) => this.connectorsMethods.testConnector(connectorId);
-	getConnectorEvents = (params: Parameters<ConnectorsMethods['getConnectorEvents']>[0]) => this.connectorsMethods.getConnectorEvents(params);
-
-	// ============================================================================
-	// Sprints methods (delegated)
-	// ============================================================================
-	createSprint = (projectId: string, params: Parameters<SprintsMethods['createSprint']>[1]) => this.sprintsMethods.createSprint(projectId, params);
-	updateSprint = (sprintId: string, updates: Parameters<SprintsMethods['updateSprint']>[1]) => this.sprintsMethods.updateSprint(sprintId, updates);
-	getSprint = (sprintId: string, summaryOnly?: boolean) => this.sprintsMethods.getSprint(sprintId, summaryOnly);
-	getSprints = (projectId: string, params?: Parameters<SprintsMethods['getSprints']>[1]) => this.sprintsMethods.getSprints(projectId, params);
-	deleteSprint = (sprintId: string) => this.sprintsMethods.deleteSprint(sprintId);
-	startSprint = (sprintId: string) => this.sprintsMethods.startSprint(sprintId);
-	completeSprint = (sprintId: string, params?: Parameters<SprintsMethods['completeSprint']>[1]) => this.sprintsMethods.completeSprint(sprintId, params);
-	addTaskToSprint = (sprintId: string, taskId: string, params?: Parameters<SprintsMethods['addTaskToSprint']>[2]) => this.sprintsMethods.addTaskToSprint(sprintId, taskId, params);
-	removeTaskFromSprint = (sprintId: string, taskId: string) => this.sprintsMethods.removeTaskFromSprint(sprintId, taskId);
-	getSprintBacklog = (projectId: string, sprintId?: string, params?: Parameters<SprintsMethods['getSprintBacklog']>[2]) => this.sprintsMethods.getSprintBacklog(projectId, sprintId, params);
-	getSprintVelocity = (projectId: string, limit?: number) => this.sprintsMethods.getSprintVelocity(projectId, limit);
-
-	// ============================================================================
-	// Subtasks methods (delegated)
-	// ============================================================================
-	addSubtask = (parentTaskId: string, params: Parameters<SubtasksMethods['addSubtask']>[1], sessionId?: string) => this.subtasksMethods.addSubtask(parentTaskId, params, sessionId);
-	getSubtasks = (parentTaskId: string, status?: string) => this.subtasksMethods.getSubtasks(parentTaskId, status);
-
-	// ============================================================================
-	// Progress methods (delegated)
-	// ============================================================================
-	logProgress = (projectId: string, params: Parameters<ProgressMethods['logProgress']>[1]) => this.progressMethods.logProgress(projectId, params);
-	getActivityFeed = (projectId: string, params?: Parameters<ProgressMethods['getActivityFeed']>[1]) => this.progressMethods.getActivityFeed(projectId, params);
-	getActivityHistory = (projectId: string, params?: Parameters<ProgressMethods['getActivityHistory']>[1]) => this.progressMethods.getActivityHistory(projectId, params);
-	getActivitySchedules = (projectId: string, params?: Parameters<ProgressMethods['getActivitySchedules']>[1]) => this.progressMethods.getActivitySchedules(projectId, params);
-
-	// ============================================================================
-	// Chat methods (delegated)
-	// ============================================================================
-	sendProjectMessage = (projectId: string, message: string, sessionId?: string) => this.chatMethods.sendProjectMessage(projectId, message, sessionId);
-	getProjectMessages = (projectId: string, limit?: number) => this.chatMethods.getProjectMessages(projectId, limit);
-}
-
-// Singleton instance
-let apiClient: VibescopeApiClient | null = null;
-
-export function getApiClient(): VibescopeApiClient {
-	if (!apiClient) {
-		const apiKey = resolveApiKeyFromSources();
-		apiClient = new VibescopeApiClient({ apiKey });
-	}
-	return apiClient;
-}
-
-/**
- * Resolve API key from multiple sources in priority order:
- * 1. VIBESCOPE_API_KEY env var (CI/cloud agents)
- * 2. ~/.vibescope/credentials.json (local dev)
- * 3. Error with helpful message
- */
-function resolveApiKeyFromSources(): string {
-	// 1. Environment variable
-	if (process.env.VIBESCOPE_API_KEY) {
-		return process.env.VIBESCOPE_API_KEY;
-	}
-
-	// 2. Credentials file
-	try {
-		const { existsSync, readFileSync } = require('node:fs');
-		const { homedir } = require('node:os');
-		const { join } = require('node:path');
-		const credPath = join(homedir(), '.vibescope', 'credentials.json');
-		if (existsSync(credPath)) {
-			const data = JSON.parse(readFileSync(credPath, 'utf-8'));
-			if (data.apiKey) {
-				return data.apiKey;
-			}
-		}
-	} catch {
-		// ignore read errors
-	}
-
-	// 3. Not found
-	throw new Error(
-		'Vibescope API key not found.\n\n' +
-		'Set it up with:\n' +
-		'  npx vibescope init\n\n' +
-		'Or set the VIBESCOPE_API_KEY environment variable.'
-	);
-}
-
-export function initApiClient(config: ApiClientConfig): VibescopeApiClient {
-	apiClient = new VibescopeApiClient(config);
-	return apiClient;
-}
+/**
+ * Vibescope API Client
+ *
+ * HTTP client for communicating with the Vibescope API.
+ * All database operations are handled server-side through these endpoints.
+ *
+ * This module composes domain-specific API methods into a unified client.
+ */
+
+import type { ApiClientConfig, ApiResponse, RetryConfig, RequestFn, ProxyFn } from './types.js';
+import { createSessionMethods, type SessionMethods } from './session.js';
+import { createProjectMethods, type ProjectMethods } from './project.js';
+import { createBlockersMethods, type BlockersMethods } from './blockers.js';
+import { createCostMethods, type CostMethods } from './cost.js';
+import { createWorktreesMethods, type WorktreesMethods } from './worktrees.js';
+import { createDiscoveryMethods, type DiscoveryMethods } from './discovery.js';
+import { createDecisionsMethods, type DecisionsMethods } from './decisions.js';
+import { createIdeasMethods, type IdeasMethods } from './ideas.js';
+import { createTasksMethods, type TasksMethods } from './tasks.js';
+import { createFindingsMethods, type FindingsMethods } from './findings.js';
+import { createMilestonesMethods, type MilestonesMethods } from './milestones.js';
+import { createValidationMethods, type ValidationMethods } from './validation.js';
+import { createFallbackMethods, type FallbackMethods } from './fallback.js';
+import { createRequestsMethods, type RequestsMethods } from './requests.js';
+import { createDeploymentMethods, type DeploymentMethods } from './deployment.js';
+import { createOrganizationsMethods, type OrganizationsMethods } from './organizations.js';
+import { createBodiesOfWorkMethods, type BodiesOfWorkMethods } from './bodies-of-work.js';
+import { createGitIssuesMethods, type GitIssuesMethods } from './git-issues.js';
+import { createFileCheckoutsMethods, type FileCheckoutsMethods } from './file-checkouts.js';
+import { createConnectorsMethods, type ConnectorsMethods } from './connectors.js';
+import { createSprintsMethods, type SprintsMethods } from './sprints.js';
+import { createSubtasksMethods, type SubtasksMethods } from './subtasks.js';
+import { createProgressMethods, type ProgressMethods } from './progress.js';
+import { createChatMethods, type ChatMethods } from './chat.js';
+
+// Re-export types
+export type { ApiClientConfig, ApiResponse, RetryConfig, RequestFn, ProxyFn } from './types.js';
+export type { SessionMethods } from './session.js';
+export type { ProjectMethods } from './project.js';
+export type { BlockersMethods } from './blockers.js';
+export type { CostMethods } from './cost.js';
+export type { WorktreesMethods } from './worktrees.js';
+export type { DiscoveryMethods } from './discovery.js';
+export type { DecisionsMethods } from './decisions.js';
+export type { IdeasMethods } from './ideas.js';
+export type { TasksMethods } from './tasks.js';
+export type { FindingsMethods } from './findings.js';
+export type { MilestonesMethods } from './milestones.js';
+export type { ValidationMethods } from './validation.js';
+export type { FallbackMethods } from './fallback.js';
+export type { RequestsMethods } from './requests.js';
+export type { DeploymentMethods } from './deployment.js';
+export type { OrganizationsMethods } from './organizations.js';
+export type { BodiesOfWorkMethods } from './bodies-of-work.js';
+export type { GitIssuesMethods } from './git-issues.js';
+export type { FileCheckoutsMethods } from './file-checkouts.js';
+export type { ConnectorsMethods } from './connectors.js';
+export type { SprintsMethods } from './sprints.js';
+export type { SubtasksMethods } from './subtasks.js';
+export type { ProgressMethods } from './progress.js';
+export type { ChatMethods } from './chat.js';
+
+const DEFAULT_API_URL = 'https://vibescope.dev';
+
+// Retry configuration defaults
+const DEFAULT_RETRY_STATUS_CODES = [429, 503, 504];
+const DEFAULT_MAX_RETRIES = 3;
+const DEFAULT_BASE_DELAY_MS = 1000;
+const DEFAULT_MAX_DELAY_MS = 30000;
+
+/**
+ * Calculate delay for exponential backoff with jitter
+ */
+function calculateBackoffDelay(
+	attempt: number,
+	baseDelayMs: number,
+	maxDelayMs: number,
+	retryAfter?: number
+): number {
+	if (retryAfter !== undefined && retryAfter > 0) {
+		return Math.min(retryAfter * 1000, maxDelayMs);
+	}
+	const exponentialDelay = baseDelayMs * Math.pow(2, attempt);
+	const jitter = Math.random() * 0.3 * exponentialDelay;
+	return Math.min(exponentialDelay + jitter, maxDelayMs);
+}
+
+/**
+ * Sleep for a specified duration
+ */
+function sleep(ms: number): Promise<void> {
+	return new Promise(resolve => setTimeout(resolve, ms));
+}
+
+/**
+ * Combined interface for all API methods
+ */
+export interface VibescopeApiClientMethods
+	extends SessionMethods,
+		ProjectMethods,
+		BlockersMethods,
+		CostMethods,
+		WorktreesMethods,
+		DiscoveryMethods,
+		DecisionsMethods,
+		IdeasMethods,
+		TasksMethods,
+		FindingsMethods,
+		MilestonesMethods,
+		ValidationMethods,
+		FallbackMethods,
+		RequestsMethods,
+		DeploymentMethods,
+		OrganizationsMethods,
+		BodiesOfWorkMethods,
+		GitIssuesMethods,
+		FileCheckoutsMethods,
+		ConnectorsMethods,
+		SprintsMethods,
+		SubtasksMethods,
+		ProgressMethods,
+		ChatMethods {}
+
+export class VibescopeApiClient implements VibescopeApiClientMethods {
+	private apiKey: string;
+	private baseUrl: string;
+	private retryConfig: Required<RetryConfig>;
+
+	// Domain method implementations
+	private sessionMethods: SessionMethods;
+	private projectMethods: ProjectMethods;
+	private blockersMethods: BlockersMethods;
+	private costMethods: CostMethods;
+	private worktreesMethods: WorktreesMethods;
+	private discoveryMethods: DiscoveryMethods;
+	private decisionsMethods: DecisionsMethods;
+	private ideasMethods: IdeasMethods;
+	private tasksMethods: TasksMethods;
+	private findingsMethods: FindingsMethods;
+	private milestonesMethods: MilestonesMethods;
+	private validationMethods: ValidationMethods;
+	private fallbackMethods: FallbackMethods;
+	private requestsMethods: RequestsMethods;
+	private deploymentMethods: DeploymentMethods;
+	private organizationsMethods: OrganizationsMethods;
+	private bodiesOfWorkMethods: BodiesOfWorkMethods;
+	private gitIssuesMethods: GitIssuesMethods;
+	private fileCheckoutsMethods: FileCheckoutsMethods;
+	private connectorsMethods: ConnectorsMethods;
+	private sprintsMethods: SprintsMethods;
+	private subtasksMethods: SubtasksMethods;
+	private progressMethods: ProgressMethods;
+	private chatMethods: ChatMethods;
+
+	constructor(config: ApiClientConfig) {
+		this.apiKey = config.apiKey;
+		this.baseUrl = config.baseUrl || process.env.VIBESCOPE_API_URL || DEFAULT_API_URL;
+		this.retryConfig = {
+			maxRetries: config.retry?.maxRetries ?? DEFAULT_MAX_RETRIES,
+			baseDelayMs: config.retry?.baseDelayMs ?? DEFAULT_BASE_DELAY_MS,
+			maxDelayMs: config.retry?.maxDelayMs ?? DEFAULT_MAX_DELAY_MS,
+			retryStatusCodes: config.retry?.retryStatusCodes ?? DEFAULT_RETRY_STATUS_CODES,
+		};
+
+		// Create bound request and proxy functions for domain modules
+		const request: RequestFn = this.request.bind(this);
+		const proxy: ProxyFn = this.proxy.bind(this);
+		const getApiKey = () => this.apiKey;
+
+		// Initialize domain methods
+		this.sessionMethods = createSessionMethods(request, getApiKey);
+		this.projectMethods = createProjectMethods(request);
+		this.blockersMethods = createBlockersMethods(request);
+		this.costMethods = createCostMethods(request);
+		this.worktreesMethods = createWorktreesMethods(request);
+		this.discoveryMethods = createDiscoveryMethods(request);
+		this.decisionsMethods = createDecisionsMethods(proxy);
+		this.ideasMethods = createIdeasMethods(proxy);
+		this.tasksMethods = createTasksMethods(request, proxy);
+		this.findingsMethods = createFindingsMethods(proxy);
+		this.milestonesMethods = createMilestonesMethods(proxy);
+		this.validationMethods = createValidationMethods(proxy);
+		this.fallbackMethods = createFallbackMethods(proxy);
+		this.requestsMethods = createRequestsMethods(proxy);
+		this.deploymentMethods = createDeploymentMethods(proxy);
+		this.organizationsMethods = createOrganizationsMethods(proxy);
+		this.bodiesOfWorkMethods = createBodiesOfWorkMethods(proxy);
+		this.gitIssuesMethods = createGitIssuesMethods(proxy);
+		this.fileCheckoutsMethods = createFileCheckoutsMethods(proxy);
+		this.connectorsMethods = createConnectorsMethods(proxy);
+		this.sprintsMethods = createSprintsMethods(proxy);
+		this.subtasksMethods = createSubtasksMethods(proxy);
+		this.progressMethods = createProgressMethods(request, proxy);
+		this.chatMethods = createChatMethods(proxy);
+	}
+
+	private async request<T>(method: string, path: string, body?: unknown): Promise<ApiResponse<T>> {
+		const url = `${this.baseUrl}${path}`;
+		const { maxRetries, baseDelayMs, maxDelayMs, retryStatusCodes } = this.retryConfig;
+		let lastError: Error | null = null;
+		let lastResponse: Response | null = null;
+
+		for (let attempt = 0; attempt <= maxRetries; attempt++) {
+			try {
+				const response = await fetch(url, {
+					method,
+					headers: {
+						'Content-Type': 'application/json',
+						'X-API-Key': this.apiKey
+					},
+					body: body ? JSON.stringify(body) : undefined
+				});
+
+				if (retryStatusCodes.includes(response.status) && attempt < maxRetries) {
+					lastResponse = response;
+					const retryAfterHeader = response.headers.get('Retry-After');
+					let retryAfter: number | undefined;
+					if (retryAfterHeader) {
+						const parsed = parseInt(retryAfterHeader, 10);
+						if (!isNaN(parsed)) {
+							retryAfter = parsed;
+						}
+					}
+					const delay = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs, retryAfter);
+					await sleep(delay);
+					continue;
+				}
+
+				if (!response.ok) {
+					const errorData = await response.json().catch(() => ({}));
+					return {
+						ok: false,
+						status: response.status,
+						error: errorData.error || errorData.message || `HTTP ${response.status}`
+					};
+				}
+
+				const data = await response.json();
+				return {
+					ok: true,
+					status: response.status,
+					data
+				};
+			} catch (error) {
+				lastError = error as Error;
+				if (attempt < maxRetries) {
+					const delay = calculateBackoffDelay(attempt, baseDelayMs, maxDelayMs);
+					await sleep(delay);
+					continue;
+				}
+			}
+		}
+
+		if (lastResponse && !lastResponse.ok) {
+			return {
+				ok: false,
+				status: lastResponse.status,
+				error: `Request failed after ${maxRetries + 1} attempts with status ${lastResponse.status}`
+			};
+		}
+
+		return {
+			ok: false,
+			status: 0,
+			error: lastError?.message || 'Request failed after all retries'
+		};
+	}
+
+	/**
+	 * Generic proxy method for operations that go through the MCP proxy endpoint
+	 */
+	async proxy<T>(operation: string, args: Record<string, unknown>, sessionContext?: {
+		session_id?: string;
+		project_id?: string;
+	}): Promise<ApiResponse<T>> {
+		return this.request('POST', '/api/mcp/proxy', {
+			operation,
+			args,
+			...sessionContext
+		});
+	}
+
+	// ============================================================================
+	// Session methods (delegated)
+	// ============================================================================
+	validateAuth = () => this.sessionMethods.validateAuth();
+	startSession = (params: Parameters<SessionMethods['startSession']>[0]) => this.sessionMethods.startSession(params);
+	heartbeat = (sessionId: string, options?: Parameters<SessionMethods['heartbeat']>[1]) => this.sessionMethods.heartbeat(sessionId, options);
+	endSession = (sessionId: string) => this.sessionMethods.endSession(sessionId);
+	signalIdle = (sessionId: string) => this.sessionMethods.signalIdle(sessionId);
+	syncSession = (sessionId: string, params?: Parameters<SessionMethods['syncSession']>[1]) => this.sessionMethods.syncSession(sessionId, params);
+	confirmAgentSetup = (projectId: string, agentType: string) => this.sessionMethods.confirmAgentSetup(projectId, agentType);
+
+	// ============================================================================
+	// Project methods (delegated)
+	// ============================================================================
+	listProjects = () => this.projectMethods.listProjects();
+	createProject = (params: Parameters<ProjectMethods['createProject']>[0]) => this.projectMethods.createProject(params);
+	getProject = (projectId: string, gitUrl?: string) => this.projectMethods.getProject(projectId, gitUrl);
+	updateProject = (projectId: string, updates: Parameters<ProjectMethods['updateProject']>[1]) => this.projectMethods.updateProject(projectId, updates);
+	getGitWorkflow = (projectId: string, taskId?: string) => this.projectMethods.getGitWorkflow(projectId, taskId);
+	updateProjectReadme = (projectId: string, readmeContent: string) => this.projectMethods.updateProjectReadme(projectId, readmeContent);
+	getProjectSummary = (projectId: string) => this.projectMethods.getProjectSummary(projectId);
+
+	// ============================================================================
+	// Blockers methods (delegated)
+	// ============================================================================
+	getBlockers = (projectId: string, params?: Parameters<BlockersMethods['getBlockers']>[1]) => this.blockersMethods.getBlockers(projectId, params);
+	addBlocker = (projectId: string, description: string, sessionId?: string) => this.blockersMethods.addBlocker(projectId, description, sessionId);
+	resolveBlocker = (blockerId: string, resolutionNote?: string) => this.blockersMethods.resolveBlocker(blockerId, resolutionNote);
+	deleteBlocker = (blockerId: string) => this.blockersMethods.deleteBlocker(blockerId);
+	getBlockersStats = (projectId: string) => this.blockersMethods.getBlockersStats(projectId);
+
+	// ============================================================================
+	// Cost methods (delegated)
+	// ============================================================================
+	getCostSummary = (projectId: string, params?: Parameters<CostMethods['getCostSummary']>[1]) => this.costMethods.getCostSummary(projectId, params);
+	getCostAlerts = () => this.costMethods.getCostAlerts();
+	addCostAlert = (params: Parameters<CostMethods['addCostAlert']>[0]) => this.costMethods.addCostAlert(params);
+	updateCostAlert = (alertId: string, updates: Parameters<CostMethods['updateCostAlert']>[1]) => this.costMethods.updateCostAlert(alertId, updates);
+	deleteCostAlert = (alertId: string) => this.costMethods.deleteCostAlert(alertId);
+	getTaskCosts = (projectId: string, limit?: number) => this.costMethods.getTaskCosts(projectId, limit);
+	getBodyOfWorkCosts = (params: Parameters<CostMethods['getBodyOfWorkCosts']>[0]) => this.costMethods.getBodyOfWorkCosts(params);
+	getSprintCosts = (params: Parameters<CostMethods['getSprintCosts']>[0]) => this.costMethods.getSprintCosts(params);
+	getTokenUsage = () => this.costMethods.getTokenUsage();
+	reportTokenUsage = (sessionId: string, params: Parameters<CostMethods['reportTokenUsage']>[1]) => this.costMethods.reportTokenUsage(sessionId, params);
+
+	// ============================================================================
+	// Worktrees methods (delegated)
+	// ============================================================================
+	getStaleWorktrees = (projectId: string, params?: Parameters<WorktreesMethods['getStaleWorktrees']>[1]) => this.worktreesMethods.getStaleWorktrees(projectId, params);
+	clearWorktreePath = (taskId: string) => this.worktreesMethods.clearWorktreePath(taskId);
+
+	// ============================================================================
+	// Discovery methods (delegated)
+	// ============================================================================
+	queryKnowledgeBase = (projectId: string, params?: Parameters<DiscoveryMethods['queryKnowledgeBase']>[1]) => this.discoveryMethods.queryKnowledgeBase(projectId, params);
+	getHelpTopic = (slug: string) => this.discoveryMethods.getHelpTopic(slug);
+	getHelpTopics = () => this.discoveryMethods.getHelpTopics();
+
+	// ============================================================================
+	// Decisions methods (delegated)
+	// ============================================================================
+	getDecisions = (projectId: string, options?: Parameters<DecisionsMethods['getDecisions']>[1]) => this.decisionsMethods.getDecisions(projectId, options);
+	getDecision = (decisionId: string) => this.decisionsMethods.getDecision(decisionId);
+	logDecision = (projectId: string, params: Parameters<DecisionsMethods['logDecision']>[1], sessionId?: string) => this.decisionsMethods.logDecision(projectId, params, sessionId);
+	deleteDecision = (decisionId: string) => this.decisionsMethods.deleteDecision(decisionId);
+	getDecisionsStats = (projectId: string) => this.decisionsMethods.getDecisionsStats(projectId);
+
+	// ============================================================================
+	// Ideas methods (delegated)
+	// ============================================================================
+	getIdeas = (projectId: string, params?: Parameters<IdeasMethods['getIdeas']>[1]) => this.ideasMethods.getIdeas(projectId, params);
+	getIdea = (ideaId: string) => this.ideasMethods.getIdea(ideaId);
+	addIdea = (projectId: string, params: Parameters<IdeasMethods['addIdea']>[1], sessionId?: string) => this.ideasMethods.addIdea(projectId, params, sessionId);
+	updateIdea = (ideaId: string, updates: Parameters<IdeasMethods['updateIdea']>[1]) => this.ideasMethods.updateIdea(ideaId, updates);
+	deleteIdea = (ideaId: string) => this.ideasMethods.deleteIdea(ideaId);
+	convertIdeaToTask = (ideaId: string, params?: Parameters<IdeasMethods['convertIdeaToTask']>[1]) => this.ideasMethods.convertIdeaToTask(ideaId, params);
+
+	// ============================================================================
+	// Tasks methods (delegated)
+	// ============================================================================
+	getTasks = (projectId: string, params?: Parameters<TasksMethods['getTasks']>[1]) => this.tasksMethods.getTasks(projectId, params);
+	createTask = (projectId: string, params: Parameters<TasksMethods['createTask']>[1]) => this.tasksMethods.createTask(projectId, params);
+	getNextTask = (projectId: string, sessionId?: string) => this.tasksMethods.getNextTask(projectId, sessionId);
+	getTask = (taskId: string) => this.tasksMethods.getTask(taskId);
+	getTaskById = (taskId: string, params?: Parameters<TasksMethods['getTaskById']>[1]) => this.tasksMethods.getTaskById(taskId, params);
+	searchTasks = (projectId: string, params: Parameters<TasksMethods['searchTasks']>[1]) => this.tasksMethods.searchTasks(projectId, params);
+	getTasksByPriority = (projectId: string, params?: Parameters<TasksMethods['getTasksByPriority']>[1]) => this.tasksMethods.getTasksByPriority(projectId, params);
+	getRecentTasks = (projectId: string, params?: Parameters<TasksMethods['getRecentTasks']>[1]) => this.tasksMethods.getRecentTasks(projectId, params);
+	getTaskStats = (projectId: string) => this.tasksMethods.getTaskStats(projectId);
+	updateTask = (taskId: string, updates: Parameters<TasksMethods['updateTask']>[1]) => this.tasksMethods.updateTask(taskId, updates);
+	completeTask = (taskId: string, params: Parameters<TasksMethods['completeTask']>[1]) => this.tasksMethods.completeTask(taskId, params);
+	deleteTask = (taskId: string) => this.tasksMethods.deleteTask(taskId);
+	releaseTask = (taskId: string, params?: Parameters<TasksMethods['releaseTask']>[1]) => this.tasksMethods.releaseTask(taskId, params);
+	cancelTask = (taskId: string, params?: Parameters<TasksMethods['cancelTask']>[1]) => this.tasksMethods.cancelTask(taskId, params);
+	addTaskReference = (taskId: string, url: string, label?: string) => this.tasksMethods.addTaskReference(taskId, url, label);
+	removeTaskReference = (taskId: string, url: string) => this.tasksMethods.removeTaskReference(taskId, url);
+	batchUpdateTasks = (updates: Parameters<TasksMethods['batchUpdateTasks']>[0]) => this.tasksMethods.batchUpdateTasks(updates);
+	batchCompleteTasks = (completions: Parameters<TasksMethods['batchCompleteTasks']>[0]) => this.tasksMethods.batchCompleteTasks(completions);
+
+	// ============================================================================
+	// Findings methods (delegated)
+	// ============================================================================
+	getFindings = (projectId: string, params?: Parameters<FindingsMethods['getFindings']>[1]) => this.findingsMethods.getFindings(projectId, params);
+	getFinding = (findingId: string) => this.findingsMethods.getFinding(findingId);
+	getFindingsStats = (projectId: string) => this.findingsMethods.getFindingsStats(projectId);
+	addFinding = (projectId: string, params: Parameters<FindingsMethods['addFinding']>[1], sessionId?: string) => this.findingsMethods.addFinding(projectId, params, sessionId);
+	updateFinding = (findingId: string, updates: Parameters<FindingsMethods['updateFinding']>[1]) => this.findingsMethods.updateFinding(findingId, updates);
+	deleteFinding = (findingId: string) => this.findingsMethods.deleteFinding(findingId);
+
+	// ============================================================================
+	// Milestones methods (delegated)
+	// ============================================================================
+	getMilestones = (taskId: string) => this.milestonesMethods.getMilestones(taskId);
+	addMilestone = (taskId: string, params: Parameters<MilestonesMethods['addMilestone']>[1], sessionId?: string) => this.milestonesMethods.addMilestone(taskId, params, sessionId);
+	updateMilestone = (milestoneId: string, updates: Parameters<MilestonesMethods['updateMilestone']>[1]) => this.milestonesMethods.updateMilestone(milestoneId, updates);
+	completeMilestone = (milestoneId: string) => this.milestonesMethods.completeMilestone(milestoneId);
+	deleteMilestone = (milestoneId: string) => this.milestonesMethods.deleteMilestone(milestoneId);
+
+	// ============================================================================
+	// Validation methods (delegated)
+	// ============================================================================
+	getTasksAwaitingValidation = (projectId: string) => this.validationMethods.getTasksAwaitingValidation(projectId);
+	claimValidation = (taskId: string, sessionId?: string) => this.validationMethods.claimValidation(taskId, sessionId);
+	validateTask = (taskId: string, params: Parameters<ValidationMethods['validateTask']>[1], sessionId?: string) => this.validationMethods.validateTask(taskId, params, sessionId);
+
+	// ============================================================================
+	// Fallback activity methods (delegated)
+	// ============================================================================
+	startFallbackActivity = (projectId: string, activity: string, sessionId?: string) => this.fallbackMethods.startFallbackActivity(projectId, activity, sessionId);
+	stopFallbackActivity = (projectId: string, summary?: string, sessionId?: string) => this.fallbackMethods.stopFallbackActivity(projectId, summary, sessionId);
+
+	// ============================================================================
+	// Requests methods (delegated)
+	// ============================================================================
+	getPendingRequests = (projectId: string, sessionId?: string, limit?: number, offset?: number) => this.requestsMethods.getPendingRequests(projectId, sessionId, limit, offset);
+	acknowledgeRequest = (requestId: string, sessionId?: string) => this.requestsMethods.acknowledgeRequest(requestId, sessionId);
+	answerQuestion = (requestId: string, answer: string, sessionId?: string) => this.requestsMethods.answerQuestion(requestId, answer, sessionId);
+
+	// ============================================================================
+	// Deployment methods (delegated)
+	// ============================================================================
+	requestDeployment = (projectId: string, params?: Parameters<DeploymentMethods['requestDeployment']>[1], sessionId?: string) => this.deploymentMethods.requestDeployment(projectId, params, sessionId);
+	checkDeploymentStatus = (projectId: string) => this.deploymentMethods.checkDeploymentStatus(projectId);
+	claimDeploymentValidation = (projectId: string, sessionId?: string) => this.deploymentMethods.claimDeploymentValidation(projectId, sessionId);
+	reportValidation = (projectId: string, params: Parameters<DeploymentMethods['reportValidation']>[1]) => this.deploymentMethods.reportValidation(projectId, params);
+	startDeployment = (projectId: string, sessionId?: string) => this.deploymentMethods.startDeployment(projectId, sessionId);
+	completeDeployment = (projectId: string, params: Parameters<DeploymentMethods['completeDeployment']>[1]) => this.deploymentMethods.completeDeployment(projectId, params);
+	cancelDeployment = (projectId: string, reason?: string) => this.deploymentMethods.cancelDeployment(projectId, reason);
+	addDeploymentRequirement = (projectId: string, params: Parameters<DeploymentMethods['addDeploymentRequirement']>[1]) => this.deploymentMethods.addDeploymentRequirement(projectId, params);
+	getDeploymentRequirements = (projectId: string, params?: Parameters<DeploymentMethods['getDeploymentRequirements']>[1]) => this.deploymentMethods.getDeploymentRequirements(projectId, params);
+	getDeploymentRequirementsStats = (projectId: string) => this.deploymentMethods.getDeploymentRequirementsStats(projectId);
+	completeDeploymentRequirement = (requirementId: string) => this.deploymentMethods.completeDeploymentRequirement(requirementId);
+	reorderDeploymentRequirements = (projectId: string, params: Parameters<DeploymentMethods['reorderDeploymentRequirements']>[1]) => this.deploymentMethods.reorderDeploymentRequirements(projectId, params);
+	scheduleDeployment = (projectId: string, params: Parameters<DeploymentMethods['scheduleDeployment']>[1]) => this.deploymentMethods.scheduleDeployment(projectId, params);
+	getScheduledDeployments = (projectId: string, params?: Parameters<DeploymentMethods['getScheduledDeployments']>[1]) => this.deploymentMethods.getScheduledDeployments(projectId, params);
+	updateScheduledDeployment = (scheduleId: string, updates: Parameters<DeploymentMethods['updateScheduledDeployment']>[1]) => this.deploymentMethods.updateScheduledDeployment(scheduleId, updates);
+	deleteScheduledDeployment = (scheduleId: string) => this.deploymentMethods.deleteScheduledDeployment(scheduleId);
+	triggerScheduledDeployment = (scheduleId: string, sessionId?: string) => this.deploymentMethods.triggerScheduledDeployment(scheduleId, sessionId);
+	checkDueDeployments = (projectId: string) => this.deploymentMethods.checkDueDeployments(projectId);
+
+	// ============================================================================
+	// Organizations methods (delegated)
+	// ============================================================================
+	listOrganizations = () => this.organizationsMethods.listOrganizations();
+	createOrganization = (params: Parameters<OrganizationsMethods['createOrganization']>[0]) => this.organizationsMethods.createOrganization(params);
+	updateOrganization = (organizationId: string, updates: Parameters<OrganizationsMethods['updateOrganization']>[1]) => this.organizationsMethods.updateOrganization(organizationId, updates);
+	deleteOrganization = (organizationId: string) => this.organizationsMethods.deleteOrganization(organizationId);
+	listOrgMembers = (organizationId: string) => this.organizationsMethods.listOrgMembers(organizationId);
+	inviteMember = (organizationId: string, email: string, role?: string) => this.organizationsMethods.inviteMember(organizationId, email, role);
+	updateMemberRole = (organizationId: string, userId: string, role: string) => this.organizationsMethods.updateMemberRole(organizationId, userId, role);
+	removeMember = (organizationId: string, userId: string) => this.organizationsMethods.removeMember(organizationId, userId);
+	leaveOrganization = (organizationId: string) => this.organizationsMethods.leaveOrganization(organizationId);
+	shareProjectWithOrg = (projectId: string, organizationId: string, permission?: string) => this.organizationsMethods.shareProjectWithOrg(projectId, organizationId, permission);
+	unshareProject = (projectId: string, organizationId: string) => this.organizationsMethods.unshareProject(projectId, organizationId);
+	updateProjectShare = (projectId: string, organizationId: string, permission: string) => this.organizationsMethods.updateProjectShare(projectId, organizationId, permission);
+	listProjectShares = (projectId: string) => this.organizationsMethods.listProjectShares(projectId);
+
+	// ============================================================================
+	// Bodies of work methods (delegated)
+	// ============================================================================
+	createBodyOfWork = (projectId: string, params: Parameters<BodiesOfWorkMethods['createBodyOfWork']>[1]) => this.bodiesOfWorkMethods.createBodyOfWork(projectId, params);
+	getBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.getBodyOfWork(bodyOfWorkId);
+	getBodiesOfWork = (projectId: string, params?: Parameters<BodiesOfWorkMethods['getBodiesOfWork']>[1]) => this.bodiesOfWorkMethods.getBodiesOfWork(projectId, params);
+	updateBodyOfWork = (bodyOfWorkId: string, updates: Parameters<BodiesOfWorkMethods['updateBodyOfWork']>[1]) => this.bodiesOfWorkMethods.updateBodyOfWork(bodyOfWorkId, updates);
+	deleteBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.deleteBodyOfWork(bodyOfWorkId);
+	addTaskToBodyOfWork = (bodyOfWorkId: string, taskId: string, phase?: string, orderIndex?: number) => this.bodiesOfWorkMethods.addTaskToBodyOfWork(bodyOfWorkId, taskId, phase, orderIndex);
+	removeTaskFromBodyOfWork = (taskId: string) => this.bodiesOfWorkMethods.removeTaskFromBodyOfWork(taskId);
+	activateBodyOfWork = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.activateBodyOfWork(bodyOfWorkId);
+	addTaskDependency = (bodyOfWorkId: string, taskId: string, dependsOnTaskId: string) => this.bodiesOfWorkMethods.addTaskDependency(bodyOfWorkId, taskId, dependsOnTaskId);
+	removeTaskDependency = (taskId: string, dependsOnTaskId: string) => this.bodiesOfWorkMethods.removeTaskDependency(taskId, dependsOnTaskId);
+	getTaskDependencies = (params: Parameters<BodiesOfWorkMethods['getTaskDependencies']>[0]) => this.bodiesOfWorkMethods.getTaskDependencies(params);
+	getNextBodyOfWorkTask = (bodyOfWorkId: string) => this.bodiesOfWorkMethods.getNextBodyOfWorkTask(bodyOfWorkId);
+
+	// ============================================================================
+	// Git issues methods (delegated)
+	// ============================================================================
+	addGitIssue = (projectId: string, params: Parameters<GitIssuesMethods['addGitIssue']>[1], sessionId?: string) => this.gitIssuesMethods.addGitIssue(projectId, params, sessionId);
+	resolveGitIssue = (gitIssueId: string, params?: Parameters<GitIssuesMethods['resolveGitIssue']>[1], sessionId?: string) => this.gitIssuesMethods.resolveGitIssue(gitIssueId, params, sessionId);
+	getGitIssues = (projectId: string, params?: Parameters<GitIssuesMethods['getGitIssues']>[1]) => this.gitIssuesMethods.getGitIssues(projectId, params);
+	deleteGitIssue = (gitIssueId: string) => this.gitIssuesMethods.deleteGitIssue(gitIssueId);
+
+	// ============================================================================
+	// File checkouts methods (delegated)
+	// ============================================================================
+	checkoutFile = (projectId: string, filePath: string, reason?: string, sessionId?: string) => this.fileCheckoutsMethods.checkoutFile(projectId, filePath, reason, sessionId);
+	checkinFile = (params: Parameters<FileCheckoutsMethods['checkinFile']>[0], sessionId?: string) => this.fileCheckoutsMethods.checkinFile(params, sessionId);
+	getFileCheckouts = (projectId: string, options?: Parameters<FileCheckoutsMethods['getFileCheckouts']>[1]) => this.fileCheckoutsMethods.getFileCheckouts(projectId, options);
+	abandonCheckout = (params: Parameters<FileCheckoutsMethods['abandonCheckout']>[0]) => this.fileCheckoutsMethods.abandonCheckout(params);
+	getFileCheckoutsStats = (projectId: string) => this.fileCheckoutsMethods.getFileCheckoutsStats(projectId);
+	isFileAvailable = (projectId: string, filePath: string) => this.fileCheckoutsMethods.isFileAvailable(projectId, filePath);
+
+	// ============================================================================
+	// Connectors methods (delegated)
+	// ============================================================================
+	getConnectors = (projectId: string, params?: Parameters<ConnectorsMethods['getConnectors']>[1]) => this.connectorsMethods.getConnectors(projectId, params);
+	getConnector = (connectorId: string) => this.connectorsMethods.getConnector(connectorId);
+	addConnector = (projectId: string, params: Parameters<ConnectorsMethods['addConnector']>[1]) => this.connectorsMethods.addConnector(projectId, params);
+	updateConnector = (connectorId: string, updates: Parameters<ConnectorsMethods['updateConnector']>[1]) => this.connectorsMethods.updateConnector(connectorId, updates);
+	deleteConnector = (connectorId: string) => this.connectorsMethods.deleteConnector(connectorId);
+	testConnector = (connectorId: string) => this.connectorsMethods.testConnector(connectorId);
+	getConnectorEvents = (params: Parameters<ConnectorsMethods['getConnectorEvents']>[0]) => this.connectorsMethods.getConnectorEvents(params);
+
+	// ============================================================================
+	// Sprints methods (delegated)
+	// ============================================================================
+	createSprint = (projectId: string, params: Parameters<SprintsMethods['createSprint']>[1]) => this.sprintsMethods.createSprint(projectId, params);
+	updateSprint = (sprintId: string, updates: Parameters<SprintsMethods['updateSprint']>[1]) => this.sprintsMethods.updateSprint(sprintId, updates);
+	getSprint = (sprintId: string, summaryOnly?: boolean) => this.sprintsMethods.getSprint(sprintId, summaryOnly);
+	getSprints = (projectId: string, params?: Parameters<SprintsMethods['getSprints']>[1]) => this.sprintsMethods.getSprints(projectId, params);
+	deleteSprint = (sprintId: string) => this.sprintsMethods.deleteSprint(sprintId);
+	startSprint = (sprintId: string) => this.sprintsMethods.startSprint(sprintId);
+	completeSprint = (sprintId: string, params?: Parameters<SprintsMethods['completeSprint']>[1]) => this.sprintsMethods.completeSprint(sprintId, params);
+	addTaskToSprint = (sprintId: string, taskId: string, params?: Parameters<SprintsMethods['addTaskToSprint']>[2]) => this.sprintsMethods.addTaskToSprint(sprintId, taskId, params);
+	removeTaskFromSprint = (sprintId: string, taskId: string) => this.sprintsMethods.removeTaskFromSprint(sprintId, taskId);
+	getSprintBacklog = (projectId: string, sprintId?: string, params?: Parameters<SprintsMethods['getSprintBacklog']>[2]) => this.sprintsMethods.getSprintBacklog(projectId, sprintId, params);
+	getSprintVelocity = (projectId: string, limit?: number) => this.sprintsMethods.getSprintVelocity(projectId, limit);
+
+	// ============================================================================
+	// Subtasks methods (delegated)
+	// ============================================================================
+	addSubtask = (parentTaskId: string, params: Parameters<SubtasksMethods['addSubtask']>[1], sessionId?: string) => this.subtasksMethods.addSubtask(parentTaskId, params, sessionId);
+	getSubtasks = (parentTaskId: string, status?: string) => this.subtasksMethods.getSubtasks(parentTaskId, status);
+
+	// ============================================================================
+	// Progress methods (delegated)
+	// ============================================================================
+	logProgress = (projectId: string, params: Parameters<ProgressMethods['logProgress']>[1]) => this.progressMethods.logProgress(projectId, params);
+	getActivityFeed = (projectId: string, params?: Parameters<ProgressMethods['getActivityFeed']>[1]) => this.progressMethods.getActivityFeed(projectId, params);
+	getActivityHistory = (projectId: string, params?: Parameters<ProgressMethods['getActivityHistory']>[1]) => this.progressMethods.getActivityHistory(projectId, params);
+	getActivitySchedules = (projectId: string, params?: Parameters<ProgressMethods['getActivitySchedules']>[1]) => this.progressMethods.getActivitySchedules(projectId, params);
+
+	// ============================================================================
+	// Chat methods (delegated)
+	// ============================================================================
+	sendProjectMessage = (projectId: string, message: string, sessionId?: string) => this.chatMethods.sendProjectMessage(projectId, message, sessionId);
+	getProjectMessages = (projectId: string, limit?: number) => this.chatMethods.getProjectMessages(projectId, limit);
+}
+
+// Singleton instance
+let apiClient: VibescopeApiClient | null = null;
+
+export function getApiClient(): VibescopeApiClient {
+	if (!apiClient) {
+		const apiKey = resolveApiKeyFromSources();
+		apiClient = new VibescopeApiClient({ apiKey });
+	}
+	return apiClient;
+}
+
+/**
+ * Resolve API key from multiple sources in priority order:
+ * 1. VIBESCOPE_API_KEY env var (CI/cloud agents)
+ * 2. ~/.vibescope/credentials.json (local dev)
+ * 3. Error with helpful message
+ */
+function resolveApiKeyFromSources(): string {
+	// 1. Environment variable
+	if (process.env.VIBESCOPE_API_KEY) {
+		return process.env.VIBESCOPE_API_KEY;
+	}
+
+	// 2. Credentials file
+	try {
+		const { existsSync, readFileSync } = require('node:fs');
+		const { homedir } = require('node:os');
+		const { join } = require('node:path');
+		const credPath = join(homedir(), '.vibescope', 'credentials.json');
+		if (existsSync(credPath)) {
+			const data = JSON.parse(readFileSync(credPath, 'utf-8'));
+			if (data.apiKey) {
+				return data.apiKey;
+			}
+		}
+	} catch {
+		// ignore read errors
+	}
+
+	// 3. Not found
+	throw new Error(
+		'Vibescope API key not found.\n\n' +
+		'Set it up with:\n' +
+		'  npx vibescope init\n\n' +
+		'Or set the VIBESCOPE_API_KEY environment variable.'
+	);
+}
+
+export function initApiClient(config: ApiClientConfig): VibescopeApiClient {
+	apiClient = new VibescopeApiClient(config);
+	return apiClient;
+}