log-focus-debug

The log-focus-debug skill is a specialized engineering utility designed for developers working on the DashPlayer Electron codebase. Its primary purpose is to solve the problem of log noise during the debugging of specific features, allowing developers to isolate and trace entire log chains across the Main and Renderer processes without interference from unrelated system logs. This skill enforces a structured lifecycle for temporary diagnostic markers, ensuring that codebases remain clean and professional.

• Enables targeted log filtering by configuring environment variables like DP_LOG_LEVEL and DP_LOG_FOCUS_TOKEN.

• Standardizes the use of the withFocus() method for both Main and Renderer loggers to pin specific debugging sessions.

• Supports the injection of temporary focus markers (e.g., [FOCUS:token]) to make relevant events instantly searchable in dense log files.

• Includes a rigorous cleanup protocol to prevent debug artifacts from entering production or long-term codebase maintenance.

• Provides a validation step using static analysis tools like ripgrep (rg) and linting checks to ensure zero accidental log leakage.

• Target Audience: Software engineers and contributors working on DashPlayer modules such as PlaybackService or UI components.

• Operational Constraints: Requires adherence to the naming convention <feature>-<yyyymmdd> to prevent token collisions.

• Typical Usage: When investigating complex playback sync issues or UI state flickering, activate the focus token, reproduce the error, analyze the output, and immediately trigger the cleanup process to remove all injected markers.

• Expected Inputs/Outputs: Input involves defining a unique focus token; Output ensures a clean, isolated log environment during development and a verified, clean codebase upon task completion.