feat: add debugger_set_logpoint and debugger_remove_logpoint tools with documentation and tests.

Author: natorion

scripts/post-build.ts

@@ -41,7 +41,7 @@ export const DEFAULT_LOCALE = 'en-US';
 export const REMOTE_FETCH_PATTERN = '@HOST@/remote/serve_file/@VERSION@/core/i18n/locales/@LOCALE@.json';
 
 export const LOCAL_FETCH_PATTERN = './locales/@LOCALE@.json';`;
-  fs.mkdirSync(i18nDir, { recursive: true });
+  fs.mkdirSync(i18nDir, {recursive: true});
   writeFile(localesFile, localesContent);
 
   // Create codemirror.next mock.

skills/breakpoint-debugging/SKILL.md

@@ -9,66 +9,92 @@ This skill allows you to perform in-depth Root Cause Analysis (RCA) by controlli
 
 ## Tools
 
--   `debugger_enable`: Enable the debugger for the page. **Must be called first.**
--   `debugger_set_breakpoint`: Set a breakpoint at a specific URL and line number.
--   `debugger_get_paused_state`: Check if the debugger is paused and get the call stack.
--   `debugger_get_scope_variables`: Inspect variables in a specific scope when paused.
--   `debugger_step_over` / `debugger_step_into` / `debugger_step_out`: Control execution.
--   `debugger_resume`: Resume execution.
--   `debugger_evaluate_on_call_frame`: Evaluate expressions in the current context.
--   `debugger_get_code_lines`: Read code around a specific line.
+- `debugger_enable`: Enable the debugger for the page. **Must be called first.**
+- `debugger_set_breakpoint`: Set a breakpoint at a specific URL and line number.
+- `debugger_set_logpoint`: Set a logpoint that logs a message to the console without pausing.
+- `debugger_remove_breakpoint` / `debugger_remove_logpoint`: Remove a breakpoint or logpoint.
+- `debugger_get_paused_state`: Check if the debugger is paused and get the call stack.
+- `debugger_get_scope_variables`: Inspect variables in a specific scope when paused.
+- `debugger_step_over` / `debugger_step_into` / `debugger_step_out`: Control execution.
+- `debugger_resume`: Resume execution.
+- `debugger_evaluate_on_call_frame`: Evaluate expressions in the current context.
+- `debugger_get_code_lines`: Read code around a specific line.
+- `list_console_messages`: View console output (useful for logpoints).
 
 ## Root Cause Analysis Workflow
 
 Your objective is to find the **root cause** of an error or bug. Do not stop at the surface level.
 
 1.  **Enable Debugger**: Always start by ensuring the debugger is enabled.
+
     ```javascript
     // Example
-    debugger_enable({})
+    debugger_enable({});
     ```
 
 2.  **Hypothesize & Set Trap**:
-    -   Read the code using `debugger_get_code_lines` (or `read_file` if local) to understand the logic.
-    -   Identify the critical line where state corruption likely occurred.
-    -   Set a breakpoint on that line.
+    - Read the code using `debugger_get_code_lines` (or `read_file` if local) to understand the logic.
+    - Identify the critical line where state corruption likely occurred.
+    - Set a breakpoint on that line.
+
     ```javascript
-    debugger_set_breakpoint({ url: 'http://localhost:8080/app.js', lineNumber: 42 })
+    debugger_set_breakpoint({
+      url: 'http://localhost:8080/app.js',
+      lineNumber: 42,
+    });
     ```
 
 3.  **Trigger & Wait**:
-    -   Perform the action that triggers the bug (e.g., clicking a button using `click`).
-    -   Check if the debugger is paused using `debugger_get_paused_state`.
-    -   **Note**: If `debugger_get_paused_state` returns "Debugger is not paused", wait a moment and try again, or ask the user to trigger the action if you cannot.
+    - Perform the action that triggers the bug (e.g., clicking a button using `click`).
+    - Check if the debugger is paused using `debugger_get_paused_state`.
+    - **Note**: If `debugger_get_paused_state` returns "Debugger is not paused", wait a moment and try again, or ask the user to trigger the action if you cannot.
 
 4.  **Inspect State (Runtime Mode)**:
-    -   Once paused, examine the `callStack` returned by `debugger_get_paused_state`.
-    -   Use `debugger_get_scope_variables` to see values of local variables.
-    -   Use `debugger_evaluate_on_call_frame` to check specific expressions or deep objects.
+    - Once paused, examine the `callStack` returned by `debugger_get_paused_state`.
+    - Use `debugger_get_scope_variables` to see values of local variables.
+    - Use `debugger_evaluate_on_call_frame` to check specific expressions or deep objects.
+
     ```javascript
     // Check local variables (scopeIndex 0 is usually Local)
-    debugger_get_scope_variables({ callFrameId: '...', scopeIndex: 0 })
+    debugger_get_scope_variables({callFrameId: '...', scopeIndex: 0});
     ```
 
 5.  **Step & Trace**:
-    -   Use `debugger_step_into` to enter function calls.
-    -   Use `debugger_step_over` to advance line-by-line.
-    -   Use `debugger_step_out` to return to the caller.
-    -   **Always** check `debugger_get_paused_state` and variable values after stepping to see how state changed.
+    - Use `debugger_step_into` to enter function calls.
+    - Use `debugger_step_over` to advance line-by-line.
+    - Use `debugger_step_out` to return to the caller.
+    - **Always** check `debugger_get_paused_state` and variable values after stepping to see how state changed.
 
 6.  **Verify Root Cause**:
-    -   Explain exactly how the runtime state contradicts the expected logic.
-    -   Point to the specific line of code that is the root cause.
+    - Explain exactly how the runtime state contradicts the expected logic.
+    - Point to the specific line of code that is the root cause.
 
 7.  **Apply Fix & Verify**:
-    -   Once the issue is found, you can try to fix it (e.g., by editing the file).
-    -   Remove breakpoints using `debugger_remove_breakpoint` or `debugger_remove_all_breakpoints`.
-    -   Resume execution with `debugger_resume`.
-    -   Verify the fix by reproducing the steps.
+    - Once the issue is found, you can try to fix it (e.g., by editing the file).
+    - Remove breakpoints using `debugger_remove_breakpoint` or `debugger_remove_all_breakpoints`.
+    - Resume execution with `debugger_resume`.
+    - Verify the fix by reproducing the steps.
+
+## Logpoints (Non-breaking Breakpoints)
+
+Use logpoints to trace execution without pausing. This is useful for debugging loops or high-frequency events.
+
+1.  **Set Logpoint**:
+    ```javascript
+    // Logs "Value of x is 42" to the console
+    debugger_set_logpoint({
+      url: '...',
+      lineNumber: 10,
+      message: 'Value of x is {x}',
+    });
+    ```
+2.  **View Output**:
+    - Use `list_console_messages` to see the logs.
+    - Logpoints do NOT pause execution.
 
 ## Tips
 
--   **STATIC MODE** (Reading code) vs **RUNTIME MODE** (Paused): Switch between them. If you need to see a variable, switch to Runtime Mode by setting a breakpoint.
--   **Already Paused?**: If you are already paused, start inspecting immediately.
--   **Step Into**: Essential for investigating function calls on the current line.
--   **Check Location**: Always confirm where you are with `debugger_get_paused_state` after stepping.
+- **STATIC MODE** (Reading code) vs **RUNTIME MODE** (Paused): Switch between them. If you need to see a variable, switch to Runtime Mode by setting a breakpoint.
+- **Already Paused?**: If you are already paused, start inspecting immediately.
+- **Step Into**: Essential for investigating function calls on the current line.
+- **Check Location**: Always confirm where you are with `debugger_get_paused_state` after stepping.