feat: add environment-aware debugging to diagnostic tools

Enhanced health check and diagnostic tools with environment-specific
troubleshooting guidance based on telemetry analysis of 632K events
from 5,308 users.

Key improvements:
- Environment-aware debugging suggestions for http/stdio modes
- Docker-specific troubleshooting when IS_DOCKER=true
- Cloud platform detection (Railway, Render, Fly, Heroku, AWS, K8s, GCP, Azure)
- Platform-specific configuration paths (macOS, Windows, Linux)
- MCP_MODE and platform tracking in telemetry events
- Comprehensive integration tests for environment detection

Addresses 59% session abandonment by providing actionable, context-specific
next steps based on user's deployment environment.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
czlonkowski
2025-10-10 12:34:20 +02:00
parent 4016ac42ef
commit 275e4f8cef
8 changed files with 882 additions and 85 deletions

View File

@@ -138,6 +138,9 @@ export class TelemetryEventTracker {
context: this.sanitizeContext(context),
tool: toolName ? toolName.replace(/[^a-zA-Z0-9_-]/g, '_') : undefined,
error: errorMessage ? this.sanitizeErrorMessage(errorMessage) : undefined,
// Add environment context for better error analysis
mcpMode: process.env.MCP_MODE || 'stdio',
platform: process.platform
}, false); // Skip rate limiting for errors
}
@@ -183,6 +186,7 @@ export class TelemetryEventTracker {
nodeVersion: process.version,
isDocker: process.env.IS_DOCKER === 'true',
cloudPlatform: this.detectCloudPlatform(),
mcpMode: process.env.MCP_MODE || 'stdio',
// NEW: Startup tracking fields (v2.18.2)
startupDurationMs: startupData?.durationMs,
checkpointsPassed: startupData?.checkpoints,