cache-overflow-mcp 0.3.4 → 0.3.6

package/.env.example

@@ -1,3 +1,3 @@
-CACHE_OVERFLOW_API_URL=https://api.cache-overflow.dev
-CACHE_OVERFLOW_TOKEN=
-CACHE_OVERFLOW_TIMEOUT=30000
+CACHE_OVERFLOW_API_URL=https://api.cache-overflow.dev
+CACHE_OVERFLOW_TOKEN=
+CACHE_OVERFLOW_TIMEOUT=30000

package/AGENTS.md

@@ -47,7 +47,8 @@ cache-overflow-mcp/
 │   ├── index.ts            # Public exports for library usage
 │   ├── server.ts           # MCP server setup, tool/prompt registration
 │   ├── client.ts           # HTTP client for backend API
-│   ├── config.ts           # Environment config (API URL, auth token)
+│   ├── config.ts           # Environment config (API URL, auth token, log dir)
+│   ├── logger.ts           # Error logging system with automatic sanitization
 │   ├── types.ts            # TypeScript type definitions
 │   ├── tools/
 │   │   ├── index.ts        # Tool registry and ToolDefinition interface
@@ -88,9 +89,17 @@ cache-overflow-mcp/
   - `submitFeedback(solutionId, isUseful)` - POST /solutions/:id/feedback
 
 - **`src/config.ts`**: Reads environment variables:
-  - `CACHE_OVERFLOW_API_URL` (default: https://api.cache-overflow.dev)
+  - `CACHE_OVERFLOW_URL` (default: https://cache-overflow.onrender.com/api)
   - `CACHE_OVERFLOW_TOKEN` (required for auth)
   - `CACHE_OVERFLOW_TIMEOUT` (default: 30000ms)
+  - `CACHE_OVERFLOW_LOG_DIR` (default: ~/.cache-overflow or temp directory)
+
+- **`src/logger.ts`**: Comprehensive logging system that:
+  - Writes errors and events to `cache-overflow-mcp.log`
+  - Automatically sanitizes sensitive data (tokens, passwords)
+  - Rotates log file when it exceeds 5MB
+  - Includes timestamps, error stacks, and context
+  - Logs startup info, tool execution, API errors, network failures
 
 - **`src/types.ts`**: Core types:
   - `Solution` - Full solution with body, price, verification state, votes
@@ -230,6 +239,18 @@ npm run lint     # Run ESLint (needs eslint.config.js - not configured)
 - ESLint not configured (package.json has eslint but no config file for v9)
 - No integration tests for the MCP server itself (only client unit tests)
 
+## Error Logging
+
+All errors and important events are logged to `~/.cache-overflow/cache-overflow-mcp.log` by default. The logger:
+
+- Automatically sanitizes sensitive data (tokens, passwords, secrets)
+- Rotates when file exceeds 5MB (keeps last 1000 entries)
+- Logs JSON lines for easy parsing
+- Captures: startup info, tool execution, API errors, network failures, verification dialog events
+- Falls back to temp directory if home directory is not writable
+
+Customers can send this log file when reporting issues for debugging.
+
 ## Version
 
-Current version: **0.3.0** (see package.json and server.ts)
+Current version: **0.3.4** (see package.json)

package/README.md

@@ -59,6 +59,65 @@ Add to `.cursor/mcp.json` in your project:
 
 The API key is only shown once at creation, so save it securely.
 
+## Error Logging & Debugging
+
+cache.overflow MCP server automatically logs errors and important events to help with debugging. When you encounter issues, the log file contains detailed diagnostic information.
+
+### Log File Location
+
+By default, logs are written to:
+- **macOS/Linux**: `~/.cache-overflow/cache-overflow-mcp.log`
+- **Windows**: `%USERPROFILE%\.cache-overflow\cache-overflow-mcp.log`
+
+If the home directory is not writable, logs fallback to:
+- **All platforms**: `[temp-directory]/cache-overflow/cache-overflow-mcp.log`
+
+### Custom Log Location
+
+You can customize the log directory by setting the `CACHE_OVERFLOW_LOG_DIR` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "cache-overflow": {
+      "command": "cache-overflow-mcp",
+      "env": {
+        "CACHE_OVERFLOW_TOKEN": "your-api-key-here",
+        "CACHE_OVERFLOW_LOG_DIR": "/custom/path/to/logs"
+      }
+    }
+  }
+}
+```
+
+### What Gets Logged
+
+The log file includes:
+- Server startup information (version, Node.js version, platform, API URL)
+- Tool execution events (find_solution, unlock_solution, etc.)
+- API request errors with status codes and error messages
+- Network errors (connection failures, timeouts)
+- Verification dialog events
+- Full error stack traces for debugging
+
+### Log Privacy
+
+**Sensitive data is automatically redacted:**
+- Authentication tokens are replaced with `[REDACTED]`
+- Passwords, secrets, and other sensitive fields are sanitized
+- Solution content and user queries are NOT logged to protect privacy
+
+### Reporting Issues
+
+When reporting bugs or requesting support:
+
+1. Reproduce the error
+2. Locate your log file (see locations above)
+3. Share the relevant portion of the log file with support
+4. The log file is structured as JSON lines for easy parsing
+
+The log file is automatically rotated when it exceeds 5MB, keeping the last 1000 log entries.
+
 ## Links
 
 - Dashboard: [app.cache-overflow.dev](https://app.cache-overflow.dev)

package/TROUBLESHOOTING.md

@@ -0,0 +1,219 @@
+# Troubleshooting cache.overflow MCP Server
+
+This guide helps you troubleshoot issues with the cache.overflow MCP server and explains how to use the error logs for debugging.
+
+## Quick Diagnostics
+
+### 1. Check if the server is running
+
+If the MCP server isn't working, check your MCP client's logs:
+
+**Claude Desktop:**
+- macOS: `~/Library/Logs/Claude/mcp*.log`
+- Windows: `%APPDATA%\Claude\logs\mcp*.log`
+
+**Cursor:**
+- Check the Output panel in Cursor (View → Output → MCP)
+
+### 2. Locate the cache.overflow log file
+
+The cache.overflow server maintains its own detailed log file:
+
+**Default locations:**
+- macOS/Linux: `~/.cache-overflow/cache-overflow-mcp.log`
+- Windows: `%USERPROFILE%\.cache-overflow\cache-overflow-mcp.log`
+
+**Fallback location (if home directory is not writable):**
+- All platforms: `[temp-directory]/cache-overflow/cache-overflow-mcp.log`
+  - macOS/Linux: `/tmp/cache-overflow/cache-overflow-mcp.log`
+  - Windows: `%TEMP%\cache-overflow\cache-overflow-mcp.log`
+
+### 3. View the log file
+
+**macOS/Linux:**
+```bash
+# View the entire log
+cat ~/.cache-overflow/cache-overflow-mcp.log
+
+# View the last 50 lines
+tail -n 50 ~/.cache-overflow/cache-overflow-mcp.log
+
+# Follow the log in real-time
+tail -f ~/.cache-overflow/cache-overflow-mcp.log
+```
+
+**Windows (PowerShell):**
+```powershell
+# View the entire log
+Get-Content $env:USERPROFILE\.cache-overflow\cache-overflow-mcp.log
+
+# View the last 50 lines
+Get-Content $env:USERPROFILE\.cache-overflow\cache-overflow-mcp.log -Tail 50
+
+# Follow the log in real-time
+Get-Content $env:USERPROFILE\.cache-overflow\cache-overflow-mcp.log -Wait
+```
+
+**Windows (Command Prompt):**
+```cmd
+# View the entire log
+type %USERPROFILE%\.cache-overflow\cache-overflow-mcp.log
+
+# View the last few lines
+more %USERPROFILE%\.cache-overflow\cache-overflow-mcp.log
+```
+
+## Understanding the Log File
+
+The log file is structured as JSON lines (one JSON object per line). Each log entry includes:
+
+```json
+{
+  "timestamp": "2026-02-01T10:30:45.123Z",
+  "level": "ERROR",
+  "message": "API request failed",
+  "context": {
+    "method": "GET",
+    "path": "/solutions/search",
+    "statusCode": 401,
+    "errorMessage": "Invalid token",
+    "errorType": "API_ERROR"
+  },
+  "error": {
+    "name": "Error",
+    "message": "Unauthorized",
+    "stack": "Error: Unauthorized\n    at ..."
+  }
+}
+```
+
+### Log Levels
+
+- **ERROR**: Critical errors that prevent operations from completing
+- **WARN**: Warnings about unexpected but non-fatal situations
+- **INFO**: Informational messages about normal operations
+
+### Error Types
+
+Common `errorType` values and what they mean:
+
+| Error Type | Description | Common Causes |
+|------------|-------------|---------------|
+| `STARTUP_FAILURE` | Server failed to start | Missing dependencies, port conflicts |
+| `CONNECTION_FAILURE` | MCP transport connection failed | Communication issues with MCP client |
+| `API_ERROR` | Backend API returned an error | Invalid token, rate limiting, server issues |
+| `NETWORK_ERROR` | Network request failed | No internet, firewall, DNS issues |
+| `TOOL_EXECUTION_FAILURE` | A tool failed to execute | Invalid parameters, API errors |
+| `VERIFICATION_DIALOG_ERROR` | Verification UI failed | Port conflicts, browser issues |
+| `BROWSER_OPEN_FAILURE` | Could not open browser for verification | No default browser, permissions |
+
+## Common Issues
+
+### Issue: "Invalid token" or 401 errors
+
+**Symptoms:**
+- Log shows `API_ERROR` with `statusCode: 401`
+- Error message: "Invalid token" or "Unauthorized"
+
+**Solution:**
+1. Verify your API token is correct in the MCP configuration
+2. Ensure the token starts with `co_`
+3. Check if the token has expired (tokens don't expire, but can be revoked)
+4. Generate a new token at [app.cache-overflow.dev](https://app.cache-overflow.dev)
+
+### Issue: "Network error" or timeout
+
+**Symptoms:**
+- Log shows `NETWORK_ERROR`
+- Fetch or connection failures
+
+**Solution:**
+1. Check your internet connection
+2. Verify you can access https://cache-overflow.onrender.com/api
+3. Check firewall settings
+4. Try increasing the timeout:
+   ```json
+   "env": {
+     "CACHE_OVERFLOW_TOKEN": "your-token",
+     "CACHE_OVERFLOW_TIMEOUT": "60000"
+   }
+   ```
+
+### Issue: Verification dialog doesn't open
+
+**Symptoms:**
+- Log shows `BROWSER_OPEN_FAILURE`
+- Browser window doesn't appear
+
+**Solution:**
+1. Check if your system has a default browser set
+2. Ensure no firewall is blocking localhost connections
+3. Try manually opening the URL from the log (looks like `http://localhost:XXXXX`)
+
+### Issue: Server not starting
+
+**Symptoms:**
+- Log shows `STARTUP_FAILURE`
+- MCP client reports server crashed
+
+**Solution:**
+1. Check Node.js version: `node --version` (requires >= 18.0.0)
+2. Reinstall the package: `npm install -g cache-overflow-mcp`
+3. Clear npm cache: `npm cache clean --force`
+4. Check for conflicting global packages
+
+## Reporting Bugs
+
+When reporting issues to support, please include:
+
+1. **Your configuration** (with token redacted):
+   ```json
+   {
+     "mcpServers": {
+       "cache-overflow": {
+         "command": "cache-overflow-mcp",
+         "env": {
+           "CACHE_OVERFLOW_TOKEN": "[REDACTED]"
+         }
+       }
+     }
+   }
+   ```
+
+2. **Relevant log entries**: Copy the last 20-50 lines from your log file showing the error
+
+3. **Environment information** (from the startup log entry):
+   - cache.overflow version
+   - Node.js version
+   - Platform and architecture
+
+4. **Steps to reproduce**: What were you doing when the error occurred?
+
+## Privacy & Security
+
+The log file automatically sanitizes sensitive information:
+
+- ✅ **Logged**: Error types, stack traces, API endpoints, tool names
+- ❌ **Not logged**: API tokens, passwords, secrets, solution content, user queries
+
+You can safely share your log file with support without exposing credentials.
+
+## Custom Log Location
+
+To store logs in a custom directory, set the `CACHE_OVERFLOW_LOG_DIR` environment variable:
+
+```json
+{
+  "mcpServers": {
+    "cache-overflow": {
+      "command": "cache-overflow-mcp",
+      "env": {
+        "CACHE_OVERFLOW_TOKEN": "your-token",
+        "CACHE_OVERFLOW_LOG_DIR": "/custom/path/to/logs"
+      }
+    }
+  }
+}
+```
+
+The directory will be created automatically if it doesn't exist.

package/dist/cli.js

@@ -1,8 +1,20 @@
 #!/usr/bin/env node
 import { CacheOverflowServer } from './server.js';
+import { logger } from './logger.js';
 async function main() {
+    // Log startup information
+    logger.logStartup();
+    logger.info(`Log file location: ${logger.getLogFilePath()}`);
     const server = new CacheOverflowServer();
     await server.start();
 }
-main().catch(console.error);
+main().catch((error) => {
+    logger.error('Fatal error during server startup', error, {
+        errorType: 'STARTUP_FAILURE',
+    });
+    console.error('Fatal error:', error);
+    console.error(`\nError details have been logged to: ${logger.getLogFilePath()}`);
+    console.error('Please send this log file when reporting issues.');
+    process.exit(1);
+});
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAElD,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,KAAK,UAAU,IAAI;IACjB,0BAA0B;IAC1B,MAAM,CAAC,UAAU,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,sBAAsB,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAE7D,MAAM,MAAM,GAAG,IAAI,mBAAmB,EAAE,CAAC;IACzC,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE,KAAK,EAAE;QACvD,SAAS,EAAE,iBAAiB;KAC7B,CAAC,CAAC;IACH,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,KAAK,CAAC,wCAAwC,MAAM,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACjF,OAAO,CAAC,KAAK,CAAC,kDAAkD,CAAC,CAAC;IAClE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;gBAE1B,MAAM,CAAC,EAAE,MAAM;YAKb,OAAO;IA4Bf,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAIvE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAO3B,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAMvB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAK9B"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAIvE,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,SAAS,CAAqB;gBAE1B,MAAM,CAAC,EAAE,MAAM;YAKb,OAAO;IAyEf,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,kBAAkB,EAAE,CAAC,CAAC;IAoBvE,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAIlE,eAAe,CACnB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,WAAW,CAAC,QAAQ,CAAC,CAAC;IAO3B,kBAAkB,CACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAMvB,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,GAChB,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;CAK9B"}

package/dist/client.js

@@ -1,4 +1,5 @@
 import { config } from './config.js';
+import { logger } from './logger.js';
 export class CacheOverflowClient {
     apiUrl;
     authToken;
@@ -13,19 +14,73 @@ export class CacheOverflowClient {
         if (this.authToken) {
             headers['Authorization'] = `Bearer ${this.authToken}`;
         }
-        const response = await fetch(`${this.apiUrl}${path}`, {
-            method,
-            headers,
-            body: body ? JSON.stringify(body) : undefined,
-        });
-        const data = (await response.json());
-        if (!response.ok) {
-            return { success: false, error: data.error ?? 'Unknown error' };
+        const url = `${this.apiUrl}${path}`;
+        try {
+            const response = await fetch(url, {
+                method,
+                headers,
+                body: body ? JSON.stringify(body) : undefined,
+            });
+            // Read response as text first, then try to parse as JSON
+            const textResponse = await response.text();
+            const contentType = response.headers.get('content-type');
+            let data;
+            try {
+                data = JSON.parse(textResponse);
+            }
+            catch (jsonError) {
+                // If JSON parsing fails, log and return the text as error
+                logger.error('API returned non-JSON response', jsonError, {
+                    method,
+                    path,
+                    statusCode: response.status,
+                    contentType,
+                    responseText: textResponse.substring(0, 200), // Log first 200 chars
+                    errorType: 'INVALID_JSON_RESPONSE',
+                });
+                // Return the text as an error message
+                return {
+                    success: false,
+                    error: textResponse || 'Invalid response from server'
+                };
+            }
+            if (!response.ok) {
+                const errorMessage = data.error ?? 'Unknown error';
+                logger.error('API request failed', undefined, {
+                    method,
+                    path,
+                    statusCode: response.status,
+                    errorMessage,
+                    errorType: 'API_ERROR',
+                });
+                return { success: false, error: errorMessage };
+            }
+            return { success: true, data: data };
+        }
+        catch (error) {
+            logger.error('Network or fetch error during API request', error, {
+                method,
+                path,
+                url,
+                errorType: 'NETWORK_ERROR',
+            });
+            // Re-throw network errors so they can be handled by the caller
+            throw error;
         }
-        return { success: true, data: data };
     }
     async findSolution(query) {
-        return this.request('GET', `/solutions/search?query=${encodeURIComponent(query)}`);
+        const result = await this.request('GET', `/solutions/search?query=${encodeURIComponent(query)}`);
+        // Map API response (uses 'id') to our interface (expects 'solution_id')
+        if (result.success) {
+            const mappedData = result.data.map(solution => ({
+                solution_id: solution.id,
+                query_title: solution.query_title,
+                solution_body: solution.solution_body,
+                human_verification_required: solution.human_verification_required,
+            }));
+            return { success: true, data: mappedData };
+        }
+        return result;
     }
     async unlockSolution(solutionId) {
         return this.request('POST', `/solutions/${solutionId}/unlock`);

package/dist/client.js.map

@@ -1 +1 @@
-{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,OAAO,mBAAmB;IACtB,MAAM,CAAS;IACf,SAAS,CAAqB;IAEtC,YAAY,MAAe;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC;IACrC,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAc;QAEd,MAAM,OAAO,GAA2B;YACtC,cAAc,EAAE,kBAAkB;SACnC,CAAC;QAEF,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,OAAO,CAAC,eAAe,CAAC,GAAG,UAAU,IAAI,CAAC,SAAS,EAAE,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,IAAI,EAAE,EAAE;YACpD,MAAM;YACN,OAAO;YACP,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;SAC9C,CAAC,CAAC;QAEH,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;QAEhE,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,eAAe,EAAE,CAAC;QAC9E,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAS,EAAE,CAAC;IAC5C,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,KAAa;QAC9B,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,2BAA2B,kBAAkB,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACrF,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,UAAkB;QACrC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,UAAU,SAAS,CAAC,CAAC;IACjE,CAAC;IAED,KAAK,CAAC,eAAe,CACnB,UAAkB,EAClB,YAAoB;QAEpB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE;YACxC,WAAW,EAAE,UAAU;YACvB,aAAa,EAAE,YAAY;SAC5B,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,kBAAkB,CACtB,UAAkB,EAClB,MAAe;QAEf,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,UAAU,SAAS,EAAE;YAC7D,OAAO,EAAE,MAAM;SAChB,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,cAAc,CAClB,UAAkB,EAClB,QAAiB;QAEjB,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,cAAc,UAAU,WAAW,EAAE;YAC/D,SAAS,EAAE,QAAQ;SACpB,CAAC,CAAC;IACL,CAAC;CACF"}
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -6,5 +6,8 @@ export declare const config: {
     auth: {
         token: string | undefined;
     };
+    logging: {
+        logDir: string | undefined;
+    };
 };
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;CAQlB,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,MAAM;;;;;;;;;;;CAalB,CAAC"}

package/dist/config.js

@@ -6,5 +6,10 @@ export const config = {
     auth: {
         token: process.env.CACHE_OVERFLOW_TOKEN,
     },
+    logging: {
+        // Directory where log files will be written
+        // Default: ~/.cache-overflow/ (or temp directory if home is not writable)
+        logDir: process.env.CACHE_OVERFLOW_LOG_DIR,
+    },
 };
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yCAAyC;QAChF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC;KACjE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KACxC;CACF,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,GAAG,EAAE;QACH,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,yCAAyC;QAChF,OAAO,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,sBAAsB,IAAI,OAAO,CAAC;KACjE;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,oBAAoB;KACxC;IACD,OAAO,EAAE;QACP,4CAA4C;QAC5C,0EAA0E;QAC1E,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,sBAAsB;KAC3C;CACF,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,16 @@
+declare class Logger {
+    private logFilePath;
+    private maxLogSizeBytes;
+    constructor();
+    private rotateLogIfNeeded;
+    private sanitizeContext;
+    private writeLog;
+    error(message: string, error?: Error, context?: Record<string, unknown>): void;
+    warn(message: string, context?: Record<string, unknown>): void;
+    info(message: string, context?: Record<string, unknown>): void;
+    getLogFilePath(): string;
+    logStartup(): void;
+}
+export declare const logger: Logger;
+export {};
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAgBA,cAAM,MAAM;IACV,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,eAAe,CAAmB;;IAwB1C,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,eAAe;IAoBvB,OAAO,CAAC,QAAQ;IAYhB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAmB9E,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW9D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAW9D,cAAc,IAAI,MAAM;IAIxB,UAAU,IAAI,IAAI;CAUnB;AAGD,eAAO,MAAM,MAAM,QAAe,CAAC"}

package/dist/logger.js

@@ -0,0 +1,127 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+class Logger {
+    logFilePath;
+    maxLogSizeBytes = 5 * 1024 * 1024; // 5MB max log file size
+    constructor() {
+        // Determine log file location
+        const logDir = process.env.CACHE_OVERFLOW_LOG_DIR ?? path.join(os.homedir(), '.cache-overflow');
+        // Ensure log directory exists
+        if (!fs.existsSync(logDir)) {
+            try {
+                fs.mkdirSync(logDir, { recursive: true });
+            }
+            catch (err) {
+                // Fallback to temp directory if home directory is not writable
+                const tempLogDir = path.join(os.tmpdir(), 'cache-overflow');
+                if (!fs.existsSync(tempLogDir)) {
+                    fs.mkdirSync(tempLogDir, { recursive: true });
+                }
+                this.logFilePath = path.join(tempLogDir, 'cache-overflow-mcp.log');
+                return;
+            }
+        }
+        this.logFilePath = path.join(logDir, 'cache-overflow-mcp.log');
+    }
+    rotateLogIfNeeded() {
+        try {
+            if (fs.existsSync(this.logFilePath)) {
+                const stats = fs.statSync(this.logFilePath);
+                if (stats.size >= this.maxLogSizeBytes) {
+                    // Rotate: keep the last 1MB of the file
+                    const content = fs.readFileSync(this.logFilePath, 'utf-8');
+                    const lines = content.split('\n');
+                    const keptLines = lines.slice(-1000); // Keep last 1000 lines
+                    fs.writeFileSync(this.logFilePath, keptLines.join('\n') + '\n');
+                }
+            }
+        }
+        catch (err) {
+            // Ignore rotation errors - don't want logging to break the app
+        }
+    }
+    sanitizeContext(context) {
+        if (!context)
+            return undefined;
+        const sanitized = {};
+        for (const [key, value] of Object.entries(context)) {
+            // Sanitize sensitive fields
+            if (key.toLowerCase().includes('token') ||
+                key.toLowerCase().includes('password') ||
+                key.toLowerCase().includes('secret') ||
+                key.toLowerCase().includes('auth')) {
+                sanitized[key] = '[REDACTED]';
+            }
+            else if (typeof value === 'object' && value !== null) {
+                sanitized[key] = this.sanitizeContext(value);
+            }
+            else {
+                sanitized[key] = value;
+            }
+        }
+        return sanitized;
+    }
+    writeLog(entry) {
+        try {
+            this.rotateLogIfNeeded();
+            const logLine = JSON.stringify(entry) + '\n';
+            fs.appendFileSync(this.logFilePath, logLine);
+        }
+        catch (err) {
+            // If we can't write to log file, write to stderr as fallback
+            console.error('Failed to write to log file:', err);
+            console.error('Original log entry:', entry);
+        }
+    }
+    error(message, error, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: 'ERROR',
+            message,
+            context: this.sanitizeContext(context),
+        };
+        if (error) {
+            entry.error = {
+                name: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        this.writeLog(entry);
+    }
+    warn(message, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: 'WARN',
+            message,
+            context: this.sanitizeContext(context),
+        };
+        this.writeLog(entry);
+    }
+    info(message, context) {
+        const entry = {
+            timestamp: new Date().toISOString(),
+            level: 'INFO',
+            message,
+            context: this.sanitizeContext(context),
+        };
+        this.writeLog(entry);
+    }
+    getLogFilePath() {
+        return this.logFilePath;
+    }
+    logStartup() {
+        this.info('MCP Server starting', {
+            version: '0.3.5',
+            nodeVersion: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            apiUrl: process.env.CACHE_OVERFLOW_URL ?? 'https://cache-overflow.onrender.com/api',
+            hasAuthToken: !!process.env.CACHE_OVERFLOW_TOKEN,
+        });
+    }
+}
+// Singleton instance
+export const logger = new Logger();
+//# sourceMappingURL=logger.js.map