@taazkareem/clickup-mcp-server 0.4.68 → 0.4.70

package/build/server.log

@@ -0,0 +1,265 @@
+[2025-03-18T04:13:46.822Z] [PID:60411] INFO: [SharedServices] Creating shared ClickUp services singleton
+[2025-03-18T04:13:46.823Z] [PID:60411] INFO: [ClickUpServices] Starting ClickUp services initialization
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.824Z] [PID:60411] INFO: [ClickUpServices] Initializing ClickUp Workspace service
+[2025-03-18T04:13:46.825Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Initialized WorkspaceService
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.825Z] [PID:60411] INFO: [ClickUpServices] Initializing ClickUp Task service
+[2025-03-18T04:13:46.826Z] [PID:60411] DEBUG: [ClickUp:TaskService] Initialized TaskService
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.826Z] [PID:60411] DEBUG: [ClickUp:ListService] Initialized ListService
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.826Z] [PID:60411] INFO: [ClickUpServices] Initializing ClickUp List service
+[2025-03-18T04:13:46.827Z] [PID:60411] DEBUG: [ClickUp:ListService] Initialized ListService
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.827Z] [PID:60411] INFO: [ClickUpServices] Initializing ClickUp Folder service
+[2025-03-18T04:13:46.827Z] [PID:60411] DEBUG: [ClickUp:FolderService] Initialized FolderService
+{
+  "teamId": "9014370478",
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.827Z] [PID:60411] INFO: [ClickUpServices] All ClickUp services initialized successfully
+{
+  "services": [
+    "workspace",
+    "task",
+    "list",
+    "folder"
+  ],
+  "baseUrl": "https://api.clickup.com/api/v2"
+}
+[2025-03-18T04:13:46.827Z] [PID:60411] INFO: [SharedServices] Services initialization complete
+{
+  "services": "workspace, task, list, folder",
+  "teamId": "9014370478"
+}
+[2025-03-18T04:13:46.828Z] [PID:60411] INFO: Starting ClickUp MCP Server...
+[2025-03-18T04:13:47.270Z] [PID:60411] INFO: Server environment
+{
+  "pid": 60411,
+  "node": "v23.5.0",
+  "os": "darwin",
+  "arch": "x64"
+}
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: Initializing workspace tools
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: [WorkspaceTool] Initializing workspace tool
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: [WorkspaceTool] Workspace tool initialized successfully
+{
+  "serviceType": "WorkspaceService"
+}
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: Configuring server request handlers
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: [Server] Registering server request handlers
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: [Server] Registering tool handlers
+{
+  "toolCount": 22,
+  "categories": [
+    "workspace",
+    "task",
+    "list",
+    "folder"
+  ]
+}
+[2025-03-18T04:13:47.271Z] [PID:60411] INFO: Connecting to MCP stdio transport
+[2025-03-18T04:13:47.272Z] [PID:60411] INFO: Server startup complete - ready to handle requests
+[2025-03-18T04:13:47.731Z] [PID:60411] DEBUG: [Server] Received ListTools request
+[2025-03-18T04:14:04.121Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_workspace_hierarchy
+{
+  "params": {}
+}
+[2025-03-18T04:14:04.578Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 456ms
+[2025-03-18T04:14:04.982Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 403ms
+[2025-03-18T04:14:05.440Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 458ms
+[2025-03-18T04:14:05.954Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 513ms
+[2025-03-18T04:14:05.954Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Found 2 folderless lists in space 90141365861
+[2025-03-18T04:14:05.954Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding 2 lists directly to space Talib's Space (90141365861)
+[2025-03-18T04:14:05.954Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Personal List (901403617613)
+[2025-03-18T04:14:05.954Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Work List (901403621899)
+[2025-03-18T04:14:06.318Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 364ms
+[2025-03-18T04:14:06.775Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 457ms
+[2025-03-18T04:14:07.146Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 371ms
+[2025-03-18T04:14:07.147Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Found 0 folderless lists in space 90141864154
+[2025-03-18T04:14:07.147Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding 0 lists directly to space Education (90141864154)
+[2025-03-18T04:14:07.517Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 370ms
+[2025-03-18T04:14:07.899Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 382ms
+[2025-03-18T04:14:07.899Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Found 1 folderless lists in space 90141369187
+[2025-03-18T04:14:07.899Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding 1 lists directly to space Social Media Content (90141369187)
+[2025-03-18T04:14:07.899Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: VibeCase (901403679582)
+[2025-03-18T04:14:08.412Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 512ms
+[2025-03-18T04:14:08.821Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 409ms
+[2025-03-18T04:14:09.218Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 397ms
+[2025-03-18T04:14:09.641Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 423ms
+[2025-03-18T04:14:10.363Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 722ms
+[2025-03-18T04:14:11.075Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 712ms
+[2025-03-18T04:14:11.485Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 410ms
+[2025-03-18T04:14:12.099Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 614ms
+[2025-03-18T04:14:12.562Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 463ms
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Request completed successfully in 415ms
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Found 7 folderless lists in space 90141392755
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding 7 lists directly to space Custom Space (90141392755)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Job Applications (901404823810)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Prompts | Snippets | Commands (901407112060)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Style Scraper (901408105509)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: goal-tracker (901408127809)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: cursor-rules-mcp-server (901408144363)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: Items to Sell Online (901404691843)
+[2025-03-18T04:14:12.977Z] [PID:60411] DEBUG: [ClickUp:WorkspaceService] Adding list directly to space: clickup-mcp-server (901408020907)
+[2025-03-18T04:14:15.996Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "clickup-mcp-server"
+  }
+}
+[2025-03-18T04:14:15.997Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901407953112",
+  "filters": {}
+}
+[2025-03-18T04:14:16.466Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 469ms
+[2025-03-18T04:14:19.277Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listId": "901407953112"
+  }
+}
+[2025-03-18T04:14:19.277Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901407953112",
+  "filters": {}
+}
+[2025-03-18T04:14:20.289Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 1012ms
+[2025-03-18T04:14:23.404Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "MCP Server TypeScript Template"
+  }
+}
+[2025-03-18T04:14:23.405Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901407973154",
+  "filters": {}
+}
+[2025-03-18T04:14:23.846Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 441ms
+[2025-03-18T04:14:25.784Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "style-scraper"
+  }
+}
+[2025-03-18T04:14:25.784Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901408160190",
+  "filters": {}
+}
+[2025-03-18T04:14:26.539Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 755ms
+[2025-03-18T04:14:28.915Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "Style Scraper"
+  }
+}
+[2025-03-18T04:14:28.915Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901408105509",
+  "filters": {}
+}
+[2025-03-18T04:14:30.493Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 1578ms
+[2025-03-18T04:14:32.848Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listId": "901407112060"
+  }
+}
+[2025-03-18T04:14:32.848Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901407112060",
+  "filters": {}
+}
+[2025-03-18T04:14:34.933Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 2085ms
+[2025-03-18T04:14:37.867Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "cursor-rules-mcp-server"
+  }
+}
+[2025-03-18T04:14:37.867Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901408144363",
+  "filters": {}
+}
+[2025-03-18T04:14:38.209Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 342ms
+[2025-03-18T04:14:41.460Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "goal-tracker"
+  }
+}
+[2025-03-18T04:14:41.460Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901408127809",
+  "filters": {}
+}
+[2025-03-18T04:14:41.997Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 537ms
+[2025-03-18T04:14:44.058Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_tasks
+{
+  "params": {
+    "listName": "youtube-mcp-server"
+  }
+}
+[2025-03-18T04:14:44.058Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTasks
+{
+  "listId": "901407973619",
+  "filters": {}
+}
+[2025-03-18T04:14:44.660Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 602ms
+[2025-03-18T04:14:48.562Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_task
+{
+  "params": {
+    "taskId": "86b48gaha"
+  }
+}
+[2025-03-18T04:14:48.562Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTask
+{
+  "taskId": "86b48gaha"
+}
+[2025-03-18T04:14:49.063Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 501ms
+[2025-03-18T04:14:52.146Z] [PID:60411] INFO: [Server] Received CallTool request for tool: create_task
+{
+  "params": {
+    "name": "📊 Project Setup",
+    "listName": "clickup-mcp-server",
+    "description": "Initial setup of the ClickUp MCP server project including repository configuration, environment setup, and dependency management."
+  }
+}
+[2025-03-18T04:14:52.147Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: createTask
+{
+  "listId": "901407953112",
+  "name": "📊 Project Setup",
+  "description": "Initial setup of the ClickUp MCP server project including repository configuration, environment setup, and dependency management."
+}
+[2025-03-18T04:14:52.702Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 555ms
+[2025-03-18T04:14:54.911Z] [PID:60411] INFO: [Server] Received CallTool request for tool: get_task
+{
+  "params": {
+    "taskId": "86b4a6cpf"
+  }
+}
+[2025-03-18T04:14:54.911Z] [PID:60411] INFO: [ClickUp:TaskService] Operation: getTask
+{
+  "taskId": "86b4a6cpf"
+}
+[2025-03-18T04:14:55.469Z] [PID:60411] DEBUG: [ClickUp:TaskService] Request completed successfully in 558ms

package/build/services/clickup/base.js

@@ -8,6 +8,7 @@
  * - Common request methods
  */
 import axios from 'axios';
+import { Logger, LogLevel } from '../../logger.js';
 /**
  * Error types for better error handling
  */
@@ -56,6 +57,9 @@ export class BaseClickUpService {
         this.apiKey = apiKey;
         this.teamId = teamId;
         this.requestSpacing = this.defaultRequestSpacing;
+        // Create a logger with the actual class name for better context
+        const className = this.constructor.name;
+        this.logger = new Logger(`ClickUp:${className}`);
         // Configure the Axios client with default settings
         this.client = axios.create({
             baseURL: baseUrl,
@@ -65,6 +69,7 @@ export class BaseClickUpService {
             },
             timeout: this.timeout
         });
+        this.logger.debug(`Initialized ${className}`, { teamId, baseUrl });
         // Add response interceptor for error handling
         this.client.interceptors.response.use(response => response, error => this.handleAxiosError(error));
     }
@@ -75,88 +80,89 @@ export class BaseClickUpService {
      * @returns Never - always throws an error
      */
     handleAxiosError(error) {
-        let message = 'Unknown error occurred';
-        let code = ErrorCode.UNKNOWN;
-        let details = null;
-        let status = undefined;
-        if (error.response) {
-            // Server responded with an error status code
-            status = error.response.status;
-            details = error.response.data;
-            switch (status) {
-                case 401:
-                    message = 'Unauthorized: Invalid API key';
-                    code = ErrorCode.UNAUTHORIZED;
-                    break;
-                case 403:
-                    message = 'Forbidden: Insufficient permissions';
-                    code = ErrorCode.UNAUTHORIZED;
-                    break;
-                case 404:
-                    message = 'Resource not found';
-                    code = ErrorCode.NOT_FOUND;
-                    break;
-                case 429:
-                    message = 'Rate limit exceeded';
-                    code = ErrorCode.RATE_LIMIT;
-                    break;
-                case 400:
-                    message = 'Invalid request: ' + (error.response.data?.err || 'Validation error');
-                    code = ErrorCode.VALIDATION;
-                    break;
-                case 500:
-                case 502:
-                case 503:
-                case 504:
-                    message = 'ClickUp server error';
-                    code = ErrorCode.SERVER_ERROR;
-                    break;
-                default:
-                    message = `ClickUp API error (${status}): ${error.response.data?.err || 'Unknown error'}`;
-            }
+        // Determine error details
+        const status = error.response?.status;
+        const responseData = error.response?.data;
+        const errorMsg = responseData?.err || responseData?.error || error.message || 'Unknown API error';
+        const path = error.config?.url || 'unknown path';
+        // Context object for providing more detailed log information
+        const errorContext = {
+            path,
+            status,
+            method: error.config?.method?.toUpperCase() || 'UNKNOWN',
+            requestData: error.config?.data ? JSON.parse(error.config.data) : undefined
+        };
+        // Pick the appropriate error code based on status
+        let code;
+        let logMessage;
+        if (error.code === 'ECONNABORTED' || error.message?.includes('timeout')) {
+            code = ErrorCode.NETWORK_ERROR;
+            logMessage = `Request timeout for ${path}`;
         }
-        else if (error.request) {
-            // Request was made but no response received
-            message = 'Network error: No response received from ClickUp';
+        else if (!error.response) {
             code = ErrorCode.NETWORK_ERROR;
-            details = { request: error.request };
+            logMessage = `Network error accessing ${path}: ${error.message}`;
+        }
+        else if (status === 429) {
+            code = ErrorCode.RATE_LIMIT;
+            this.handleRateLimitHeaders(error.response.headers);
+            logMessage = `Rate limit exceeded for ${path}`;
+        }
+        else if (status === 401 || status === 403) {
+            code = ErrorCode.UNAUTHORIZED;
+            logMessage = `Authorization failed for ${path}`;
+        }
+        else if (status === 404) {
+            code = ErrorCode.NOT_FOUND;
+            logMessage = `Resource not found: ${path}`;
+        }
+        else if (status >= 400 && status < 500) {
+            code = ErrorCode.VALIDATION;
+            logMessage = `Validation error for ${path}: ${errorMsg}`;
+        }
+        else if (status >= 500) {
+            code = ErrorCode.SERVER_ERROR;
+            logMessage = `ClickUp server error: ${errorMsg}`;
         }
         else {
-            // Error setting up the request
-            message = `Request setup error: ${error.message}`;
-            details = { message: error.message };
+            code = ErrorCode.UNKNOWN;
+            logMessage = `Unknown API error: ${errorMsg}`;
         }
-        throw new ClickUpServiceError(message, code, details, status);
+        // Log the error with context
+        this.logger.error(logMessage, errorContext);
+        // Throw a well-structured error
+        throw new ClickUpServiceError(errorMsg, code, responseData, status, errorContext);
     }
     /**
      * Process the request queue, respecting rate limits by spacing out requests
      * @private
      */
     async processQueue() {
-        if (this.processingQueue || this.requestQueue.length === 0) {
+        if (this.requestQueue.length === 0) {
+            this.logger.debug('Queue empty, exiting queue processing mode');
+            this.processingQueue = false;
             return;
         }
-        this.processingQueue = true;
+        this.logger.debug(`Processing request queue (${this.requestQueue.length} items)`);
+        const startTime = Date.now();
         try {
-            while (this.requestQueue.length > 0) {
-                const request = this.requestQueue.shift();
-                if (request) {
-                    try {
-                        await request();
-                    }
-                    catch (error) {
-                        console.error('Request failed:', error);
-                        // Continue processing queue even if one request fails
-                    }
-                    // Space out requests to stay within rate limit
-                    if (this.requestQueue.length > 0) {
-                        await new Promise(resolve => setTimeout(resolve, this.requestSpacing));
-                    }
-                }
+            // Take the first request from the queue
+            const request = this.requestQueue.shift();
+            if (request) {
+                // Wait for the request spacing interval
+                await new Promise(resolve => setTimeout(resolve, this.requestSpacing));
+                // Run the request
+                await request();
             }
         }
+        catch (error) {
+            this.logger.error('Error executing queued request', error);
+        }
         finally {
-            this.processingQueue = false;
+            const duration = Date.now() - startTime;
+            this.logger.trace(`Queue item processed in ${duration}ms, ${this.requestQueue.length} items remaining`);
+            // Continue processing the queue after a short delay
+            setTimeout(() => this.processQueue(), this.requestSpacing);
         }
     }
     /**
@@ -165,21 +171,38 @@ export class BaseClickUpService {
      * @param headers Response headers from ClickUp
      */
     handleRateLimitHeaders(headers) {
-        const limit = parseInt(headers['x-ratelimit-limit'], 10);
-        const remaining = parseInt(headers['x-ratelimit-remaining'], 10);
-        const reset = parseInt(headers['x-ratelimit-reset'], 10);
-        if (!isNaN(reset)) {
-            this.lastRateLimitReset = reset;
-        }
-        // If we're running low on remaining requests, increase spacing
-        if (!isNaN(remaining) && remaining < 10) {
-            const timeUntilReset = (this.lastRateLimitReset * 1000) - Date.now();
-            if (timeUntilReset > 0) {
-                this.requestSpacing = Math.max(this.defaultRequestSpacing, Math.floor(timeUntilReset / remaining));
+        try {
+            // Parse the rate limit headers
+            const limit = headers['x-ratelimit-limit'];
+            const remaining = headers['x-ratelimit-remaining'];
+            const reset = headers['x-ratelimit-reset'];
+            // Only log if we're getting close to the limit
+            if (remaining < limit * 0.2) {
+                this.logger.warn('Approaching rate limit', { remaining, limit, reset });
+            }
+            else {
+                this.logger.debug('Rate limit status', { remaining, limit, reset });
+            }
+            if (reset) {
+                this.lastRateLimitReset = reset;
+                // If reset is in the future, calculate a safe request spacing
+                const now = Date.now();
+                const resetTime = reset * 1000; // convert to milliseconds
+                const timeToReset = Math.max(0, resetTime - now);
+                if (timeToReset > 0 && remaining > 0) {
+                    // Calculate time between requests to stay under limit
+                    // Add 10% buffer to be safe
+                    const safeSpacing = Math.ceil((timeToReset / remaining) * 1.1);
+                    // Only adjust if it's greater than our current spacing
+                    if (safeSpacing > this.requestSpacing) {
+                        this.logger.debug(`Adjusting request spacing: ${this.requestSpacing}ms → ${safeSpacing}ms`);
+                        this.requestSpacing = safeSpacing;
+                    }
+                }
             }
         }
-        else {
-            this.requestSpacing = this.defaultRequestSpacing; // Reset to default spacing
+        catch (error) {
+            this.logger.warn('Failed to parse rate limit headers', error);
         }
     }
     /**
@@ -189,41 +212,59 @@ export class BaseClickUpService {
      * @returns Promise that resolves with the result of the API request
      */
     async makeRequest(fn) {
-        return new Promise((resolve, reject) => {
-            this.requestQueue.push(async () => {
-                try {
-                    const result = await fn();
-                    // Handle rate limit headers if present
-                    if (result && typeof result === 'object' && 'headers' in result) {
-                        this.handleRateLimitHeaders(result.headers);
+        // If we're being rate limited, queue the request rather than executing immediately
+        if (this.processingQueue) {
+            this.logger.debug('Queue active, adding request to queue');
+            return new Promise((resolve, reject) => {
+                this.requestQueue.push(async () => {
+                    try {
+                        const result = await fn();
+                        resolve(result);
+                    }
+                    catch (error) {
+                        reject(error);
                     }
-                    resolve(result);
+                });
+            });
+        }
+        const startTime = Date.now();
+        try {
+            // Execute the request function
+            const result = await fn();
+            // Debug log for successful requests with timing information
+            const duration = Date.now() - startTime;
+            this.logger.debug(`Request completed successfully in ${duration}ms`);
+            return result;
+        }
+        catch (error) {
+            // If we hit a rate limit, start processing the queue
+            if (error instanceof ClickUpServiceError && error.code === ErrorCode.RATE_LIMIT) {
+                this.logger.warn('Rate limit reached, switching to queue mode', {
+                    reset: this.lastRateLimitReset,
+                    queueLength: this.requestQueue.length
+                });
+                if (!this.processingQueue) {
+                    this.processingQueue = true;
+                    this.processQueue().catch(err => {
+                        this.logger.error('Error processing request queue', err);
+                    });
                 }
-                catch (error) {
-                    if (axios.isAxiosError(error) && error.response?.status === 429) {
-                        const retryAfter = parseInt(error.response.headers['retry-after'] || '60', 10);
-                        const resetTime = parseInt(error.response.headers['x-ratelimit-reset'] || '0', 10);
-                        // Use the more precise reset time if available
-                        const waitTime = resetTime > 0 ?
-                            (resetTime * 1000) - Date.now() :
-                            retryAfter * 1000;
-                        await new Promise(resolve => setTimeout(resolve, waitTime));
+                // Queue this failed request and return a promise that will resolve when it's retried
+                return new Promise((resolve, reject) => {
+                    this.requestQueue.push(async () => {
                         try {
-                            // Retry the request once after waiting
                             const result = await fn();
                             resolve(result);
                         }
                         catch (retryError) {
                             reject(retryError);
                         }
-                    }
-                    else {
-                        reject(error);
-                    }
-                }
-            });
-            this.processQueue().catch(reject);
-        });
+                    });
+                });
+            }
+            // For other errors, just throw
+            throw error;
+        }
     }
     /**
      * Gets the ClickUp team ID associated with this service instance
@@ -239,6 +280,18 @@ export class BaseClickUpService {
      * @param details - Details about the operation
      */
     logOperation(operation, details) {
-        console.log(`[${new Date().toISOString()}] ${operation}:`, details);
+        this.logger.info(`Operation: ${operation}`, details);
+    }
+    /**
+     * Log detailed information about a request (path and payload)
+     * For trace level logging only
+     */
+    traceRequest(method, url, data) {
+        if (this.logger.isLevelEnabled(LogLevel.TRACE)) {
+            this.logger.trace(`${method} ${url}`, {
+                payload: data,
+                teamId: this.teamId
+            });
+        }
     }
 }

package/build/services/clickup/index.js

@@ -18,6 +18,9 @@ import { WorkspaceService } from './workspace.js';
 import { TaskService } from './task.js';
 import { ListService } from './list.js';
 import { FolderService } from './folder.js';
+import { Logger } from '../../logger.js';
+// Singleton logger for ClickUp services
+const logger = new Logger('ClickUpServices');
 /**
  * Factory function to create instances of all ClickUp services
  * @param config Configuration for the services
@@ -25,12 +28,31 @@ import { FolderService } from './folder.js';
  */
 export function createClickUpServices(config) {
     const { apiKey, teamId, baseUrl } = config;
-    // Create the workspace service
+    // Log start of overall initialization
+    logger.info('Starting ClickUp services initialization', {
+        teamId,
+        baseUrl: baseUrl || 'https://api.clickup.com/api/v2'
+    });
+    // Create workspace service first since others depend on it
+    logger.info('Initializing ClickUp Workspace service');
     const workspaceService = new WorkspaceService(apiKey, teamId, baseUrl);
-    return {
+    // Initialize remaining services with workspace dependency
+    logger.info('Initializing ClickUp Task service');
+    const taskService = new TaskService(apiKey, teamId, baseUrl, workspaceService);
+    logger.info('Initializing ClickUp List service');
+    const listService = new ListService(apiKey, teamId, baseUrl, workspaceService);
+    logger.info('Initializing ClickUp Folder service');
+    const folderService = new FolderService(apiKey, teamId, baseUrl, workspaceService);
+    const services = {
         workspace: workspaceService,
-        task: new TaskService(apiKey, teamId, baseUrl, workspaceService),
-        list: new ListService(apiKey, teamId, baseUrl, workspaceService),
-        folder: new FolderService(apiKey, teamId, baseUrl, workspaceService)
+        task: taskService,
+        list: listService,
+        folder: folderService
     };
+    // Log successful completion
+    logger.info('All ClickUp services initialized successfully', {
+        services: Object.keys(services),
+        baseUrl: baseUrl || 'https://api.clickup.com/api/v2'
+    });
+    return services;
 }