Function debugLog

packages/core/src/debug-log/index.ts:39–60

(message: string, data?: unknown)

 * Only writes when enabled via setDebugLogEnabled(true).
 */
export function debugLog(message: string, data?: unknown): void {
	if (!debugLogEnabled) {
		return
	}
	try {
		const logDir = path.dirname(DEBUG_LOG_PATH)

		if (!fs.existsSync(logDir)) {
			fs.mkdirSync(logDir, { recursive: true })
		}

		const timestamp = new Date().toISOString()

		const entry = data
			? `[${timestamp}] ${message}: ${JSON.stringify(data, null, 2)}\n`
			: `[${timestamp}] ${message}\n`

		fs.appendFileSync(DEBUG_LOG_PATH, entry)
	} catch {
		// NO-OP - don't let logging errors break functionality
	}
}

/**
 * Debug logger with component context.