clickup-performance-tuning

# ClickUp Performance Tuning ## Overview Optimize ClickUp API v2 throughput and latency. Key strategies: cache hierarchy data, paginate efficiently, pool connections, and batch where possible. ## Baseline Latency (ClickUp API v2) | Endpoint | Typical P50 | Typical P95 | |----------|-------------|-------------| | `GET /user` | 80ms | 200ms | | `GET /team` | 100ms | 300ms | | `GET /list/{id}/task` | 150ms | 500ms | | `POST /list/{id}/task` | 200ms | 600ms | | `PUT /task/{id}` | 150ms | 400ms | | `GET /task/{id}` (with custom fields) | 200ms | 700ms | ## 1. Cache Hierarchy Data Workspaces, spaces, folders, and lists change infrequently. Cache them. ```typescript import { LRUCache } from 'lru-cache'; const clickupCache = new LRUCache<string, any>({ max: 1000, ttl: 300_000, // 5 min for structural data }); async function cachedRequest<T>(path: string, ttl?: number): Promise<T> { const cached = clickupCache.get(path); if (cached) return cached as T; const data = await clickupRequest(path); clickupCache.set(path, data, ttl ? { ttl } : undefined); return data as T; } // Hierarchy data: 5 min cache (default) const spaces = await cachedRequest(`/team/${teamId}/space?archived=false`); // Task data: 30 sec cache (changes more often) const task = await cachedRequest(`/task/${taskId}`, 30_000); ``` ## 2. Efficient Pagination Get Tasks returns max 100 tasks per page. Use async generators for memory efficiency. ```typescript async function* paginateTasks(listId: ...