debug-run 0.1.0 → 0.5.1

package/.prettierignore

@@ -0,0 +1,4 @@
+dist/
+node_modules/
+samples/
+*.md

package/dist/index.cjs

@@ -961,7 +961,7 @@ var require_command = __commonJS({
     var EventEmitter5 = require("node:events").EventEmitter;
     var childProcess = require("node:child_process");
     var path12 = require("node:path");
-    var fs2 = require("node:fs");
+    var fs3 = require("node:fs");
     var process2 = require("node:process");
     var { Argument: Argument2, humanReadableArgName } = require_argument();
     var { CommanderError: CommanderError2 } = require_error();
@@ -1894,10 +1894,10 @@ Expecting one of '${allowedValues.join("', '")}'`);
         const sourceExt = [".js", ".ts", ".tsx", ".mjs", ".cjs"];
         function findFile(baseDir, baseName) {
           const localBin = path12.resolve(baseDir, baseName);
-          if (fs2.existsSync(localBin)) return localBin;
+          if (fs3.existsSync(localBin)) return localBin;
           if (sourceExt.includes(path12.extname(baseName))) return void 0;
           const foundExt = sourceExt.find(
-            (ext) => fs2.existsSync(`${localBin}${ext}`)
+            (ext) => fs3.existsSync(`${localBin}${ext}`)
           );
           if (foundExt) return `${localBin}${foundExt}`;
           return void 0;
@@ -1909,7 +1909,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
         if (this._scriptPath) {
           let resolvedScriptPath;
           try {
-            resolvedScriptPath = fs2.realpathSync(this._scriptPath);
+            resolvedScriptPath = fs3.realpathSync(this._scriptPath);
           } catch (err) {
             resolvedScriptPath = this._scriptPath;
           }
@@ -3021,7 +3021,7 @@ var require_commander = __commonJS({
 });
 
 // src/cli.ts
-var fs = __toESM(require("node:fs"), 1);
+var fs2 = __toESM(require("node:fs"), 1);
 
 // node_modules/commander/esm.mjs
 var import_index = __toESM(require_commander(), 1);
@@ -3315,9 +3315,7 @@ function findVsdbg() {
         path3.join(csharpExt, ".debugger", vsdbgDir, "vsdbg.exe")
       );
     }
-    possiblePaths.push(
-      path3.join(csharpExt, "debugAdapters", "vsdbg", "vsdbg")
-    );
+    possiblePaths.push(path3.join(csharpExt, "debugAdapters", "vsdbg", "vsdbg"));
     for (const p of possiblePaths) {
       if ((0, import_node_fs2.existsSync)(p)) {
         return p;
@@ -3471,10 +3469,7 @@ Or install the C# Dev Kit extension for additional features.
     // (testhost runs in optimized mode, breakpoints won't hit otherwise)
     justMyCode: false
   }),
-  exceptionFilters: [
-    "all",
-    "user-unhandled"
-  ]
+  exceptionFilters: ["all", "user-unhandled"]
 };
 
 // src/adapters/debugpy.ts
@@ -3690,6 +3685,24 @@ Alternative options:
 
 // src/adapters/lldb.ts
 var path7 = __toESM(require("node:path"), 1);
+var fs = __toESM(require("node:fs"), 1);
+function findHomebrewLLDB() {
+  if (process.platform !== "darwin") {
+    return null;
+  }
+  const homebrewPaths = [
+    "/opt/homebrew/opt/llvm/bin/lldb-dap",
+    // Apple Silicon
+    "/usr/local/opt/llvm/bin/lldb-dap"
+    // Intel Mac
+  ];
+  for (const p of homebrewPaths) {
+    if (fs.existsSync(p)) {
+      return p;
+    }
+  }
+  return null;
+}
 var cachedPath4 = null;
 var cachedType2 = null;
 var lldbAdapter = {
@@ -3717,6 +3730,12 @@ var lldbAdapter = {
       cachedType2 = "lldb-dap";
       return lldbVscode;
     }
+    const homebrewLldb = findHomebrewLLDB();
+    if (homebrewLldb) {
+      cachedPath4 = homebrewLldb;
+      cachedType2 = "lldb-dap";
+      return homebrewLldb;
+    }
     const codeLldbPath = findCodeLLDB();
     if (codeLldbPath) {
       cachedPath4 = codeLldbPath;
@@ -3730,18 +3749,21 @@ LLDB debugger not found.
 
 Options:
 
-  1. Install LLVM/LLDB (includes lldb-dap):
-     - macOS: xcode-select --install (or brew install llvm)
-     - Ubuntu/Debian: apt install lldb
-     - Fedora: dnf install lldb
-     - The lldb-dap binary should be in your PATH
+  1. Install LLVM via Homebrew (macOS, recommended):
+     brew install llvm
+     (debug-run auto-detects Homebrew LLVM, no PATH changes needed)
 
   2. Install CodeLLDB VS Code extension:
      - Open VS Code
      - Install "CodeLLDB" extension (vadimcn.vscode-lldb)
      - debug-run will use the bundled adapter
 
-  3. Build from source:
+  3. Install LLVM system-wide:
+     - Ubuntu/Debian: apt install lldb llvm
+     - Fedora: dnf install lldb llvm
+     - Ensure lldb-dap is in your PATH
+
+  4. Build from source:
      - Download LLVM from https://releases.llvm.org
      - Build with -DLLDB_ENABLE_DAP=ON
 `.trim(),
@@ -3849,10 +3871,7 @@ var dotnetAdapter = {
     request: "attach",
     processId: options.pid
   }),
-  exceptionFilters: [
-    "all",
-    "user-unhandled"
-  ]
+  exceptionFilters: ["all", "user-unhandled"]
 };
 var adapters = /* @__PURE__ */ new Map([
   // Smart .NET adapter (tries vsdbg, then netcoredbg)
@@ -3915,9 +3934,7 @@ var DapTransport = class extends import_node_events.EventEmitter {
     });
     process2.on("exit", (code, signal) => {
       this.closed = true;
-      this.rejectAllPending(
-        new Error(`Debug adapter exited with code ${code}, signal ${signal}`)
-      );
+      this.rejectAllPending(new Error(`Debug adapter exited with code ${code}, signal ${signal}`));
       this.emit("exit", code, signal);
     });
     process2.on("error", (error) => {
@@ -4081,8 +4098,29 @@ var VSDA_PATHS = [
   "/usr/share/code/resources/app/node_modules.asar.unpacked/vsda/build/Release/vsda.node",
   "/usr/share/code-insiders/resources/app/node_modules.asar.unpacked/vsda/build/Release/vsda.node",
   // Windows (common install locations)
-  path9.join(process.env.LOCALAPPDATA || "", "Programs", "Microsoft VS Code", "resources", "app", "node_modules.asar.unpacked", "vsda", "build", "Release", "vsda.node"),
-  path9.join(process.env.PROGRAMFILES || "", "Microsoft VS Code", "resources", "app", "node_modules.asar.unpacked", "vsda", "build", "Release", "vsda.node")
+  path9.join(
+    process.env.LOCALAPPDATA || "",
+    "Programs",
+    "Microsoft VS Code",
+    "resources",
+    "app",
+    "node_modules.asar.unpacked",
+    "vsda",
+    "build",
+    "Release",
+    "vsda.node"
+  ),
+  path9.join(
+    process.env.PROGRAMFILES || "",
+    "Microsoft VS Code",
+    "resources",
+    "app",
+    "node_modules.asar.unpacked",
+    "vsda",
+    "build",
+    "Release",
+    "vsda.node"
+  )
 ];
 var vsdaModule = null;
 var vsdaLoadAttempted = false;
@@ -4096,7 +4134,17 @@ function loadVsda() {
     // Cursor (VS Code fork) on macOS
     "/Applications/Cursor.app/Contents/Resources/app/node_modules.asar.unpacked/vsda/build/Release/vsda.node",
     // User-installed VS Code on Linux
-    path9.join(home, ".vscode-server", "bin", "*", "node_modules.asar.unpacked", "vsda", "build", "Release", "vsda.node")
+    path9.join(
+      home,
+      ".vscode-server",
+      "bin",
+      "*",
+      "node_modules.asar.unpacked",
+      "vsda",
+      "build",
+      "Release",
+      "vsda.node"
+    )
   ];
   const allPaths = [...VSDA_PATHS, ...additionalPaths];
   for (const vsdaPath of allPaths) {
@@ -4485,9 +4533,7 @@ var SocketDapTransport = class extends import_node_events3.EventEmitter {
     return new Promise((resolve10, reject) => {
       const timeout = setTimeout(() => {
         this.pendingRequests.delete(seq);
-        reject(
-          new Error(`Request '${command}' timed out after ${this.requestTimeout}ms`)
-        );
+        reject(new Error(`Request '${command}' timed out after ${this.requestTimeout}ms`));
       }, this.requestTimeout);
       this.pendingRequests.set(seq, {
         resolve: (response) => {
@@ -4604,7 +4650,10 @@ var SocketDapTransport = class extends import_node_events3.EventEmitter {
         break;
       case "request":
         if (process.env.DEBUG_DAP) {
-          console.error(`[DAP reverse request] ${message.command}:`, JSON.stringify(message.arguments, null, 2));
+          console.error(
+            `[DAP reverse request] ${message.command}:`,
+            JSON.stringify(message.arguments, null, 2)
+          );
         }
         this.emit("reverseRequest", message);
         this.emit(`reverseRequest:${message.command}`, message);
@@ -4700,25 +4749,34 @@ var SocketDapClient = class extends import_node_events4.EventEmitter {
     this.transport.on("event", (event) => {
       this.emit("event", event);
     });
-    this.transport.on("reverseRequest:startDebugging", async (request) => {
-      const childConfig = request.arguments?.configuration || {};
-      if (process.env.DEBUG_DAP) {
-        console.error("[DAP] Creating child session for js-debug");
-        console.error("[DAP] Child config:", JSON.stringify(childConfig));
-      }
-      try {
-        await this.createChildSession(childConfig);
-        this.transport.sendResponse(request.seq, "startDebugging", true);
+    this.transport.on(
+      "reverseRequest:startDebugging",
+      async (request) => {
+        const childConfig = request.arguments?.configuration || {};
         if (process.env.DEBUG_DAP) {
-          console.error("[DAP] Child session created successfully");
+          console.error("[DAP] Creating child session for js-debug");
+          console.error("[DAP] Child config:", JSON.stringify(childConfig));
         }
-      } catch (error) {
-        if (process.env.DEBUG_DAP) {
-          console.error("[DAP] Child session creation failed:", error);
+        try {
+          await this.createChildSession(childConfig);
+          this.transport.sendResponse(request.seq, "startDebugging", true);
+          if (process.env.DEBUG_DAP) {
+            console.error("[DAP] Child session created successfully");
+          }
+        } catch (error) {
+          if (process.env.DEBUG_DAP) {
+            console.error("[DAP] Child session creation failed:", error);
+          }
+          this.transport.sendResponse(
+            request.seq,
+            "startDebugging",
+            false,
+            void 0,
+            String(error)
+          );
         }
-        this.transport.sendResponse(request.seq, "startDebugging", false, void 0, String(error));
       }
-    });
+    );
     this.on("serverOutput", (data) => {
       if (process.env.DEBUG) {
         console.error("[js-debug server]", data);
@@ -4733,7 +4791,7 @@ var SocketDapClient = class extends import_node_events4.EventEmitter {
   }
   /**
    * Initialize the debug session
-   * 
+   *
    * Note: Unlike stdio-based adapters, js-debug sends the 'initialized' event
    * after the launch request, not after initialize response. So we don't wait
    * for it here.
@@ -5025,7 +5083,10 @@ var SocketDapClient = class extends import_node_events4.EventEmitter {
       if (process.env.DEBUG_DAP) {
         console.error("[DAP child] Setting breakpoints for:", bp.source?.path);
       }
-      const response = await this.childTransport.sendRequest("setBreakpoints", bp);
+      const response = await this.childTransport.sendRequest(
+        "setBreakpoints",
+        bp
+      );
       if (process.env.DEBUG_DAP) {
         console.error("[DAP child] Breakpoint response:", JSON.stringify(response, null, 2));
       }
@@ -5178,9 +5239,7 @@ function parseBreakpointSpec(spec) {
 function parseLogpointSpec(spec) {
   const match = spec.match(/^(.+):(\d+)\|(.+)$/);
   if (!match) {
-    throw new Error(
-      `Invalid logpoint format: "${spec}". Expected "file:line|log message"`
-    );
+    throw new Error(`Invalid logpoint format: "${spec}". Expected "file:line|log message"`);
   }
   const [, file, lineStr, logMessage] = match;
   const line = parseInt(lineStr, 10);
@@ -5274,14 +5333,7 @@ var BreakpointManager = class {
         spec.id = this.nextId++;
         spec.verified = false;
         spec.message = error instanceof Error ? error.message : "Failed to set breakpoint";
-        this.formatter.breakpointSet(
-          spec.id,
-          file,
-          spec.line,
-          false,
-          spec.condition,
-          spec.message
-        );
+        this.formatter.breakpointSet(spec.id, file, spec.line, false, spec.condition, spec.message);
       }
     }
   }
@@ -5404,7 +5456,13 @@ var VariableInspector = class {
             count: this.options.maxCollectionItems
           });
           for (const v of vars.variables) {
-            result[v.name] = await this.expandVariable(v, this.options.maxDepth, visited, contentHashes, v.name);
+            result[v.name] = await this.expandVariable(
+              v,
+              this.options.maxDepth,
+              visited,
+              contentHashes,
+              v.name
+            );
           }
         }
       }
@@ -5455,21 +5513,31 @@ var VariableInspector = class {
           (child) => !this.isBlockedProperty(child.name)
         );
         if (this.options.omitNullProperties) {
-          filteredChildren = filteredChildren.filter(
-            (child) => !this.isNullValue(child.value)
-          );
+          filteredChildren = filteredChildren.filter((child) => !this.isNullValue(child.value));
         }
         if (this.isCollection(v.type, filteredChildren)) {
           variable.value = {
             type: v.type || "collection",
             count: this.getCollectionCount(v, filteredChildren.length),
-            items: await this.expandCollection(filteredChildren, depth - 1, visited, contentHashes, currentPath)
+            items: await this.expandCollection(
+              filteredChildren,
+              depth - 1,
+              visited,
+              contentHashes,
+              currentPath
+            )
           };
         } else {
           const obj = {};
           for (const child of filteredChildren) {
             const childPath = currentPath ? `${currentPath}.${child.name}` : child.name;
-            obj[child.name] = await this.expandVariable(child, depth - 1, visited, contentHashes, childPath);
+            obj[child.name] = await this.expandVariable(
+              child,
+              depth - 1,
+              visited,
+              contentHashes,
+              childPath
+            );
           }
           if (this.options.deduplicateByContent && Object.keys(obj).length > 0) {
             const contentHash = this.computeContentHash(v.type, obj);
@@ -5734,24 +5802,24 @@ var ACTIONABLE_HINTS = {
   "PostgresException:3D000": "PostgreSQL database does not exist - verify database name",
   "PostgresException:42P01": "PostgreSQL table does not exist - run migrations or check table name",
   // File system
-  "FileNotFoundException": "File not found - verify the file path exists and is accessible",
-  "DirectoryNotFoundException": "Directory not found - verify the directory path exists",
-  "UnauthorizedAccessException": "Access denied - check file/directory permissions or run with elevated privileges",
-  "IOException": "I/O error - check disk space, file locks, or permissions",
+  FileNotFoundException: "File not found - verify the file path exists and is accessible",
+  DirectoryNotFoundException: "Directory not found - verify the directory path exists",
+  UnauthorizedAccessException: "Access denied - check file/directory permissions or run with elevated privileges",
+  IOException: "I/O error - check disk space, file locks, or permissions",
   // Null reference
-  "NullReferenceException": "Null reference - an object was not initialized before use. Check for null values in the call chain",
+  NullReferenceException: "Null reference - an object was not initialized before use. Check for null values in the call chain",
   // Validation
-  "ArgumentNullException": "A required argument was null - check that all required parameters are provided",
-  "ArgumentException": "Invalid argument - check the parameter values being passed",
-  "ArgumentOutOfRangeException": "Argument out of range - check that values are within expected bounds",
-  "ValidationException": "Validation failed - check the input data against validation rules",
+  ArgumentNullException: "A required argument was null - check that all required parameters are provided",
+  ArgumentException: "Invalid argument - check the parameter values being passed",
+  ArgumentOutOfRangeException: "Argument out of range - check that values are within expected bounds",
+  ValidationException: "Validation failed - check the input data against validation rules",
   // Timeout
-  "TimeoutException": "Operation timed out - increase timeout or check for performance issues",
-  "TaskCanceledException": "Task was cancelled - may indicate timeout or explicit cancellation",
-  "OperationCanceledException": "Operation was cancelled - check CancellationToken usage",
+  TimeoutException: "Operation timed out - increase timeout or check for performance issues",
+  TaskCanceledException: "Task was cancelled - may indicate timeout or explicit cancellation",
+  OperationCanceledException: "Operation was cancelled - check CancellationToken usage",
   // Configuration
-  "ConfigurationException": "Configuration error - check app settings and configuration files",
-  "OptionsValidationException": "Options validation failed - check configuration values match expected schema",
+  ConfigurationException: "Configuration error - check app settings and configuration files",
+  OptionsValidationException: "Options validation failed - check configuration values match expected schema",
   // HTTP
   "HttpRequestException:404": "HTTP 404 Not Found - verify the URL is correct",
   "HttpRequestException:401": "HTTP 401 Unauthorized - check authentication credentials",
@@ -5838,11 +5906,13 @@ function extractExceptionEntryFromVariable(variable, depth) {
       if (val["SocketErrorCode"]) data.socketErrorCode = extractStringValue(val["SocketErrorCode"]);
       if (val["NativeErrorCode"]) data.nativeErrorCode = extractNumberValue(val["NativeErrorCode"]);
       if (val["ErrorCode"]) data.errorCode = extractNumberValue(val["ErrorCode"]);
-      if (val["<ErrorCode>k__BackingField"]) data.errorCode = extractNumberValue(val["<ErrorCode>k__BackingField"]);
+      if (val["<ErrorCode>k__BackingField"])
+        data.errorCode = extractNumberValue(val["<ErrorCode>k__BackingField"]);
     }
     if (type.includes("HttpException") || type.includes("HttpRequestException")) {
       if (val["StatusCode"]) data.httpStatusCode = extractNumberValue(val["StatusCode"]);
-      if (val["<StatusCode>k__BackingField"]) data.httpStatusCode = extractNumberValue(val["<StatusCode>k__BackingField"]);
+      if (val["<StatusCode>k__BackingField"])
+        data.httpStatusCode = extractNumberValue(val["<StatusCode>k__BackingField"]);
     }
     if (type.includes("ArgumentException") || type.includes("ArgumentNullException")) {
       if (val["ParamName"]) data.paramName = extractStringValue(val["ParamName"]);
@@ -5850,7 +5920,8 @@ function extractExceptionEntryFromVariable(variable, depth) {
     if (type.includes("FileNotFoundException") || type.includes("FileAccessException")) {
       if (val["FileName"]) data.fileName = extractStringValue(val["FileName"]);
       if (val["FilePath"]) data.filePath = extractStringValue(val["FilePath"]);
-      if (val["<FilePath>k__BackingField"]) data.filePath = extractStringValue(val["<FilePath>k__BackingField"]);
+      if (val["<FilePath>k__BackingField"])
+        data.filePath = extractStringValue(val["<FilePath>k__BackingField"]);
     }
   }
   return {
@@ -6022,10 +6093,7 @@ var DebugSession = class {
   async run() {
     this.startTime = Date.now();
     if (this.config.attach && this.config.pid) {
-      this.formatter.sessionStartAttach(
-        this.config.adapter.name,
-        this.config.pid
-      );
+      this.formatter.sessionStartAttach(this.config.adapter.name, this.config.pid);
     } else {
       this.formatter.sessionStart(
         this.config.adapter.name,
@@ -6147,9 +6215,7 @@ var DebugSession = class {
         await this.client.configurationDone();
       }
       this.state = "running";
-      this.formatter.emit(
-        this.formatter.createEvent("process_launched", {})
-      );
+      this.formatter.emit(this.formatter.createEvent("process_launched", {}));
     }
   }
   /**
@@ -6516,10 +6582,7 @@ var DebugSession = class {
     };
     if (this.config.diffVars && frameId) {
       const currentLocals = await this.variableInspector.getLocals(frameId);
-      const changes = this.variableInspector.diffVariables(
-        this.previousLocals,
-        currentLocals
-      );
+      const changes = this.variableInspector.diffVariables(this.previousLocals, currentLocals);
       if (changes.length > 0) {
         stepEvent.changes = changes;
       }
@@ -6543,10 +6606,7 @@ var DebugSession = class {
         return;
       }
     }
-    const stopReason = await this.checkTraceStopConditions(
-      stackDepth,
-      frameId
-    );
+    const stopReason = await this.checkTraceStopConditions(stackDepth, frameId);
     if (stopReason) {
       await this.endTrace(threadId, stopReason, stackFrames, frameId);
       return;
@@ -6742,9 +6802,11 @@ async function launchTestRunner(config) {
     testProcess.on("exit", (code, signal) => {
       if (!foundPid) {
         exitedEarly = true;
-        reject(new Error(
-          `Test process exited before testhost started. Exit code: ${code}, signal: ${signal}. Make sure the test project builds successfully and has tests.`
-        ));
+        reject(
+          new Error(
+            `Test process exited before testhost started. Exit code: ${code}, signal: ${signal}. Make sure the test project builds successfully and has tests.`
+          )
+        );
       }
     });
     testProcess.on("error", (err) => {
@@ -6755,9 +6817,11 @@ async function launchTestRunner(config) {
     setTimeout(() => {
       if (!foundPid && !exitedEarly) {
         testProcess.kill();
-        reject(new Error(
-          "Timeout waiting for testhost to start. The VSTEST_HOST_DEBUG output was not detected within 60 seconds."
-        ));
+        reject(
+          new Error(
+            "Timeout waiting for testhost to start. The VSTEST_HOST_DEBUG output was not detected within 60 seconds."
+          )
+        );
       }
     }, 6e4);
   });
@@ -6793,18 +6857,11 @@ function parseTimeout(value) {
 function createCli() {
   const program2 = new Command();
   program2.name("debug-run").description("CLI tool enabling AI agents to programmatically debug code via DAP").version("0.1.0");
-  program2.argument("[program]", "Program to debug").option(
-    "-a, --adapter <name>",
-    `Debug adapter to use (${getAdapterNames().join(", ")})`
-  ).option("--args <args...>", "Arguments to pass to the program").option("--cwd <path>", "Working directory for the program").option(
+  program2.argument("[program]", "Program to debug").option("-a, --adapter <name>", `Debug adapter to use (${getAdapterNames().join(", ")})`).option("--args <args...>", "Arguments to pass to the program").option("--cwd <path>", "Working directory for the program").option(
     "-b, --breakpoint <spec...>",
     'Breakpoint specifications (e.g., "file.ts:45" or "file.ts:45?condition")',
     []
-  ).option(
-    "-e, --eval <expr...>",
-    "Expressions to evaluate when breakpoints are hit",
-    []
-  ).option(
+  ).option("-e, --eval <expr...>", "Expressions to evaluate when breakpoints are hit", []).option(
     "--assert <expr...>",
     "Invariant expressions that must remain truthy; stops on first violation",
     []
@@ -6815,23 +6872,11 @@ function createCli() {
   ).option(
     "--break-on-exception <filter...>",
     'Break on exceptions (e.g., "all", "user-unhandled", "uncaught")'
-  ).option(
-    "-t, --timeout <duration>",
-    "Session timeout (e.g., 30s, 5000ms, 2m)",
-    "60s"
-  ).option("--capture-locals", "Capture local variables at breakpoints", true).option("--no-capture-locals", "Disable capturing local variables").option("--pretty", "Pretty print JSON output", false).option(
+  ).option("-t, --timeout <duration>", "Session timeout (e.g., 30s, 5000ms, 2m)", "60s").option("--capture-locals", "Capture local variables at breakpoints", true).option("--no-capture-locals", "Disable capturing local variables").option("--pretty", "Pretty print JSON output", false).option(
     "-s, --steps <count>",
     "Number of steps to execute after hitting a breakpoint (step over)",
     (val) => parseInt(val, 10)
-  ).option(
-    "--capture-each-step",
-    "Capture variables and location at each step",
-    false
-  ).option(
-    "--trace",
-    "Enable trace mode - step through code after breakpoint hit",
-    false
-  ).option(
+  ).option("--capture-each-step", "Capture variables and location at each step", false).option("--trace", "Enable trace mode - step through code after breakpoint hit", false).option(
     "--trace-into",
     "Use stepIn instead of stepOver in trace mode (follow into function calls)",
     false
@@ -6840,39 +6885,21 @@ function createCli() {
     "Maximum steps in trace mode before stopping (default: 500)",
     (val) => parseInt(val, 10),
     500
-  ).option(
-    "--trace-until <expr>",
-    "Stop trace when expression evaluates to truthy"
-  ).option(
+  ).option("--trace-until <expr>", "Stop trace when expression evaluates to truthy").option(
     "--diff-vars",
     "Show only changed variables in trace steps instead of full dumps",
     false
-  ).option(
-    "-o, --output <file>",
-    "Write events to file instead of stdout"
-  ).option(
-    "--include <types...>",
-    "Only emit these event types (e.g., breakpoint_hit error)"
-  ).option(
+  ).option("-o, --output <file>", "Write events to file instead of stdout").option("--include <types...>", "Only emit these event types (e.g., breakpoint_hit error)").option(
     "--exclude <types...>",
     "Suppress these event types (e.g., program_output exception_thrown)"
-  ).addOption(
-    new Option("--env <key=value...>", "Environment variables for the program")
-  ).option(
-    "--attach",
-    "Attach to a running process instead of launching",
-    false
-  ).option(
+  ).addOption(new Option("--env <key=value...>", "Environment variables for the program")).option("--attach", "Attach to a running process instead of launching", false).option(
     "--pid <processId>",
     "Process ID to attach to (requires --attach)",
     (val) => parseInt(val, 10)
   ).option(
     "--test-project <path>",
     "Run dotnet test with VSTEST_HOST_DEBUG=1 and auto-attach (for NUnit/xUnit/MSTest)"
-  ).option(
-    "--test-filter <filter>",
-    "Filter which tests to run (passed to dotnet test --filter)"
-  ).option(
+  ).option("--test-filter <filter>", "Filter which tests to run (passed to dotnet test --filter)").option(
     "--expand-services",
     "Fully expand service-like types (Logger, Repository, etc.) instead of showing compact form",
     false
@@ -6880,11 +6907,7 @@ function createCli() {
     "--show-null-props",
     "Include null/undefined properties in output (normally omitted for token efficiency)",
     false
-  ).option(
-    "--no-dedupe",
-    "Disable content-based deduplication of repeated objects",
-    false
-  ).option(
+  ).option("--no-dedupe", "Disable content-based deduplication of repeated objects", false).option(
     "--flatten-exceptions",
     "Enable exception chain flattening and root cause classification (default: true)",
     true
@@ -6896,34 +6919,40 @@ function createCli() {
     "Maximum depth to traverse exception chain (default: 10)",
     (val) => parseInt(val, 10),
     10
-  ).action(async (programPath, options) => {
-    if (options.testProject) {
-      if (!options.adapter) {
-        options.adapter = "vsdbg";
+  ).action(
+    async (programPath, options) => {
+      if (options.testProject) {
+        if (!options.adapter) {
+          options.adapter = "vsdbg";
+        }
+        await runTestDebugSession({ ...options, program: programPath, adapter: options.adapter });
+        return;
       }
-      await runTestDebugSession({ ...options, program: programPath, adapter: options.adapter });
-      return;
-    }
-    if (options.attach) {
-      if (!options.pid) {
-        console.error("Error: --pid is required when using --attach");
-        console.error("Usage: debug-run --attach --pid <processId> -a <adapter> -b <breakpoint>");
-        process.exit(1);
+      if (options.attach) {
+        if (!options.pid) {
+          console.error("Error: --pid is required when using --attach");
+          console.error(
+            "Usage: debug-run --attach --pid <processId> -a <adapter> -b <breakpoint>"
+          );
+          process.exit(1);
+        }
+      } else {
+        if (!programPath) {
+          console.error(
+            "Error: <program> argument is required (or use --attach --pid, or --test-project)"
+          );
+          console.error("Usage: debug-run <program> -a <adapter> -b <breakpoint>");
+          process.exit(1);
+        }
       }
-    } else {
-      if (!programPath) {
-        console.error("Error: <program> argument is required (or use --attach --pid, or --test-project)");
-        console.error("Usage: debug-run <program> -a <adapter> -b <breakpoint>");
+      if (!options.adapter) {
+        console.error("Error: --adapter is required");
+        console.error(`Available adapters: ${getAdapterNames().join(", ")}`);
         process.exit(1);
       }
+      await runDebugSession({ ...options, program: programPath, adapter: options.adapter });
     }
-    if (!options.adapter) {
-      console.error("Error: --adapter is required");
-      console.error(`Available adapters: ${getAdapterNames().join(", ")}`);
-      process.exit(1);
-    }
-    await runDebugSession({ ...options, program: programPath, adapter: options.adapter });
-  });
+  );
   program2.command("list-adapters").description("List available debug adapters and their installation status").action(async () => {
     await listAdapters();
   });
@@ -6992,13 +7021,17 @@ async function runDebugSession(options) {
   const hasBreakpoints = options.breakpoint.length > 0 || options.logpoint && options.logpoint.length > 0;
   const hasExceptionBreakpoints = options.breakOnException && options.breakOnException.length > 0;
   if (!hasBreakpoints && !hasExceptionBreakpoints && !options.attach) {
-    console.error("Error: At least one --breakpoint, --logpoint, or --break-on-exception is required");
+    console.error(
+      "Error: At least one --breakpoint, --logpoint, or --break-on-exception is required"
+    );
     process.exit(1);
   }
   if (hasExceptionBreakpoints && adapter.exceptionFilters) {
     for (const filter of options.breakOnException) {
       if (!adapter.exceptionFilters.includes(filter)) {
-        console.error(`Error: Adapter "${adapter.name}" does not support exception filter "${filter}"`);
+        console.error(
+          `Error: Adapter "${adapter.name}" does not support exception filter "${filter}"`
+        );
         console.error(`Supported filters: ${adapter.exceptionFilters.join(", ")}`);
         process.exit(1);
       }
@@ -7017,7 +7050,7 @@ async function runDebugSession(options) {
   let outputStream = process.stdout;
   let fileStream;
   if (options.output) {
-    fileStream = fs.createWriteStream(options.output);
+    fileStream = fs2.createWriteStream(options.output);
     outputStream = fileStream;
   }
   const formatter = new OutputFormatter({
@@ -7095,7 +7128,9 @@ async function installAdapter(name) {
 Successfully installed netcoredbg!`);
       console.log(`Path: ${installedPath}`);
     } catch (error) {
-      console.error(`Failed to install netcoredbg: ${error instanceof Error ? error.message : error}`);
+      console.error(
+        `Failed to install netcoredbg: ${error instanceof Error ? error.message : error}`
+      );
       process.exit(1);
     }
   } else if (normalizedName === "node" || normalizedName === "nodejs" || normalizedName === "js" || normalizedName === "javascript" || normalizedName === "typescript") {
@@ -7109,7 +7144,9 @@ Successfully installed netcoredbg!`);
 Successfully installed js-debug!`);
       console.log(`Path: ${installedPath}`);
     } catch (error) {
-      console.error(`Failed to install js-debug: ${error instanceof Error ? error.message : error}`);
+      console.error(
+        `Failed to install js-debug: ${error instanceof Error ? error.message : error}`
+      );
       process.exit(1);
     }
   } else if (normalizedName === "debugpy" || normalizedName === "python") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "debug-run",
-  "version": "0.1.0",
+  "version": "0.5.1",
   "description": "CLI tool enabling AI agents to programmatically debug code via DAP",
   "type": "module",
   "main": "dist/index.cjs",
@@ -8,12 +8,19 @@
     "debug-run": "dist/index.cjs"
   },
   "scripts": {
-    "prepare": "npm run build",
+    "prepare": "husky",
     "build": "node scripts/build.mjs",
     "dev": "tsx ./src/index.ts",
     "test": "vitest",
     "test:run": "vitest run",
-    "typecheck": "tsc --noEmit"
+    "typecheck": "tsc --noEmit",
+    "format": "prettier --write src/",
+    "format:check": "prettier --check src/"
+  },
+  "lint-staged": {
+    "src/**/*.{ts,js}": [
+      "prettier --write"
+    ]
   },
   "dependencies": {
     "@vscode/debugprotocol": "^1.65.0",
@@ -25,6 +32,9 @@
     "@types/node": "^20.0.0",
     "bun-types": "^1.0.0",
     "esbuild": "^0.27.2",
+    "husky": "^9.1.7",
+    "lint-staged": "^16.2.7",
+    "prettier": "^3.8.0",
     "tsx": "^4.21.0",
     "typescript": "^5.3.0",
     "vitest": "^1.0.0"