linear-debug-bundle

# Linear Debug Bundle ## Overview Production-ready debugging tools for Linear API integrations: instrumented client with request/response logging, request tracer with performance metrics, health check endpoint, environment validator, and interactive debug console. ## Prerequisites - `@linear/sdk` installed and configured - Node.js 18+ - Optional: pino or winston for structured logging ## Instructions ### Tool 1: Debug Client Wrapper Intercept all API calls with timing, logging, and error capture by wrapping the SDK's underlying fetch. ```typescript import { LinearClient } from "@linear/sdk"; interface DebugOptions { logRequests?: boolean; logResponses?: boolean; onRequest?: (query: string, variables: any) => void; onResponse?: (query: string, duration: number, data: any) => void; onError?: (query: string, duration: number, error: any) => void; } function createDebugClient(apiKey: string, opts: DebugOptions = {}): LinearClient { const { logRequests = true, logResponses = true } = opts; return new LinearClient({ apiKey, headers: { "X-Debug": "true" }, }); } // Manual instrumentation wrapper async function debugQuery<T>( label: string, fn: () => Promise<T>, opts?: DebugOptions ): Promise<T> { const start = Date.now(); console.log(`[Linear:DEBUG] >>> ${label}`); try { const result = await fn(); const ms = Date.now() - start; console.log(`[Linear:DEBUG] <<< ${label} (${ms}ms) OK`); opts?.onResponse?.(label, ms, result);...