debug-run 0.5.5 → 0.5.7

package/.claude/skills/debug-run/SKILL.md

@@ -18,10 +18,14 @@ Use the `debug-run` CLI tool to programmatically debug applications via the Debu
 
 ## Prerequisites
 
-Ensure debug-run is installed in the project:
+debug-run is available via npx (no installation required) or can be installed globally:
 
 ```bash
-npm install  # in the debug-run directory
+# Run directly with npx
+npx debug-run --help
+
+# Or install globally
+npm install -g debug-run
 ```
 
 Check available adapters:

package/.gitattributes

@@ -0,0 +1,3 @@
+
+# Use bd merge for beads JSONL files
+.beads/issues.jsonl merge=beads

package/dist/index.cjs

@@ -5217,7 +5217,20 @@ var OutputFormatter = class {
 
 // src/session/breakpoints.ts
 var path10 = __toESM(require("node:path"), 1);
-function parseBreakpointSpec(spec) {
+function resolveBreakpointPath(file, options = {}) {
+  if (path10.isAbsolute(file)) {
+    return file;
+  }
+  if (options.cwd) {
+    return path10.resolve(options.cwd, file);
+  }
+  if (options.programPath) {
+    const programDir = path10.dirname(options.programPath);
+    return path10.resolve(programDir, file);
+  }
+  return path10.resolve(file);
+}
+function parseBreakpointSpec(spec, pathOptions = {}) {
   const match = spec.match(/^(.+):(\d+)(?:\?(.+)|#(\d+))?$/);
   if (!match) {
     throw new Error(
@@ -5230,13 +5243,13 @@ function parseBreakpointSpec(spec) {
     throw new Error(`Invalid line number: ${lineStr}`);
   }
   return {
-    file: path10.resolve(file),
+    file: resolveBreakpointPath(file, pathOptions),
     line,
     condition: condition || void 0,
     hitCondition: hitCount || void 0
   };
 }
-function parseLogpointSpec(spec) {
+function parseLogpointSpec(spec, pathOptions = {}) {
   const match = spec.match(/^(.+):(\d+)\|(.+)$/);
   if (!match) {
     throw new Error(`Invalid logpoint format: "${spec}". Expected "file:line|log message"`);
@@ -5247,7 +5260,7 @@ function parseLogpointSpec(spec) {
     throw new Error(`Invalid line number: ${lineStr}`);
   }
   return {
-    file: path10.resolve(file),
+    file: resolveBreakpointPath(file, pathOptions),
     line,
     logMessage: logMessage.trim()
   };
@@ -5257,15 +5270,17 @@ var BreakpointManager = class {
   formatter;
   breakpoints = /* @__PURE__ */ new Map();
   nextId = 1;
-  constructor(client, formatter) {
+  pathOptions;
+  constructor(client, formatter, pathOptions = {}) {
     this.client = client;
     this.formatter = formatter;
+    this.pathOptions = pathOptions;
   }
   /**
    * Add a breakpoint from a spec string
    */
   addBreakpoint(spec) {
-    const bp = parseBreakpointSpec(spec);
+    const bp = parseBreakpointSpec(spec, this.pathOptions);
     this.addBreakpointSpec(bp);
     return bp;
   }
@@ -5273,7 +5288,7 @@ var BreakpointManager = class {
    * Add a logpoint from a spec string
    */
   addLogpoint(spec) {
-    const lp = parseLogpointSpec(spec);
+    const lp = parseLogpointSpec(spec, this.pathOptions);
     this.addBreakpointSpec(lp);
     return lp;
   }
@@ -5437,7 +5452,8 @@ var VariableInspector = class {
       timeout: options.timeout ?? 5e3,
       deduplicateByContent: options.deduplicateByContent ?? true,
       compactServices: options.compactServices ?? true,
-      omitNullProperties: options.omitNullProperties ?? true
+      omitNullProperties: options.omitNullProperties ?? true,
+      captureClosures: options.captureClosures ?? false
     };
   }
   /**
@@ -5449,14 +5465,38 @@ var VariableInspector = class {
     const contentHashes = /* @__PURE__ */ new Map();
     try {
       const scopesResponse = await this.client.scopes({ frameId });
+      let foundPrimaryLocals = false;
       for (const scope of scopesResponse.scopes) {
-        if (scope.name === "Locals" || scope.name === "Arguments" || scope.name === "Local") {
-          const vars = await this.client.variables({
-            variablesReference: scope.variablesReference,
-            count: this.options.maxCollectionItems
-          });
-          for (const v of vars.variables) {
-            result[v.name] = await this.expandVariable(
+        const scopeLower = scope.name.toLowerCase();
+        const isPrimaryLocals = scopeLower === "locals" || scopeLower === "local" || scopeLower.startsWith("local:") || scopeLower.startsWith("local ");
+        const isArguments = scopeLower === "arguments" || scopeLower.startsWith("arg");
+        const isBlockOrClosure = scopeLower === "block" || scopeLower === "closure";
+        const shouldInclude = isPrimaryLocals || isArguments || isBlockOrClosure && (this.options.captureClosures || !foundPrimaryLocals);
+        if (!shouldInclude) continue;
+        if (isPrimaryLocals) {
+          foundPrimaryLocals = true;
+        }
+        const vars = await this.client.variables({
+          variablesReference: scope.variablesReference,
+          count: this.options.maxCollectionItems
+        });
+        for (const v of vars.variables) {
+          let varName = v.name;
+          if (varName in result) {
+            const existingValue = result[varName];
+            const newValue = await this.expandVariable(
+              v,
+              this.options.maxDepth,
+              visited,
+              contentHashes,
+              v.name
+            );
+            if (!this.valuesEqual(existingValue, newValue)) {
+              varName = `${v.name} (${scope.name})`;
+              result[varName] = newValue;
+            }
+          } else {
+            result[varName] = await this.expandVariable(
               v,
               this.options.maxDepth,
               visited,
@@ -6150,7 +6190,10 @@ var DebugSession = class {
     await this.client.initialize({
       adapterID: this.config.adapter.id
     });
-    this.breakpointManager = new BreakpointManager(this.client, this.formatter);
+    this.breakpointManager = new BreakpointManager(this.client, this.formatter, {
+      cwd: this.config.cwd,
+      programPath: this.config.program
+    });
     this.variableInspector = new VariableInspector(this.client, {
       compactServices: !this.config.expandServices,
       omitNullProperties: !this.config.showNullProps,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "debug-run",
-  "version": "0.5.5",
+  "version": "0.5.7",
   "description": "CLI tool enabling AI agents to programmatically debug code via DAP",
   "type": "module",
   "main": "dist/index.cjs",
@@ -37,7 +37,7 @@
     "prettier": "^3.8.0",
     "tsx": "^4.21.0",
     "typescript": "^5.3.0",
-    "vitest": "^1.0.0"
+    "vitest": "^4.0.17"
   },
   "engines": {
     "node": ">=18.0.0"