agent-dbg 0.1.8 → 0.2.0

package/demo/DEMO.md

@@ -1,71 +0,0 @@
-# Demo: AI Agent Debugging with agent-dbg
-
-## Overview
-
-This demo shows Claude Code autonomously debugging a buggy Node.js app using `agent-dbg` — finding root causes, inspecting variables, and hot-patching fixes **without restarting the process**.
-
-**Total demo time: ~3 minutes**
-
-## The Buggy App
-
-`order-processor.js` processes customer orders, applies discount codes, and calculates totals. It has **two bugs**:
-
-| Bug | Type | Symptom |
-|-----|------|---------|
-| **Bug 1** — `calculateSubtotal` loop uses `<=` instead of `<` | Off-by-one | Crashes with `TypeError: Cannot read properties of undefined` |
-| **Bug 2** — `applyDiscount` returns `subtotal * rate` instead of `subtotal * (1 - rate)` | Logic error | Returns the discount amount ($20) instead of the discounted price ($80) |
-
-### Expected correct output
-```
-ORD-001: subtotal $125, total $100  (125 * 0.80)
-ORD-002: subtotal $75,  total $75   (no discount)
-ORD-003: subtotal $225, total $180  (225 * 0.80)
-```
-
-## Running the Demo
-
-### Prompt to give Claude Code
-
-```
-This order processor is crashing and the totals look wrong. Debug it with agent-dbg and fix both bugs without restarting the process.
-
-The app is at demo/order-processor.js
-```
-
-### What the agent will do (key moments to narrate)
-
-1. **Launch with `--brk`** — Agent starts the app paused at the first line using `agent-dbg launch --brk demo/order-processor.js`
-
-2. **Set breakpoints** — Agent sets a breakpoint inside `calculateSubtotal` and continues execution
-
-3. **Hit the crash** — The off-by-one `<=` causes a `TypeError` on `items[2]` when `items.length` is 2. Agent inspects the error, sees `i` equals `items.length`, identifies the off-by-one
-
-4. **Hot-patch Bug 1** — Agent uses `agent-dbg hotpatch` to fix `i <= items.length` to `i < items.length` **in the running process** (no restart!)
-
-5. **Continue and inspect** — Agent restarts the frame or continues. Orders process without crashing, but the discount amounts look wrong
-
-6. **Investigate Bug 2** — Agent sets a breakpoint in `applyDiscount`, inspects `subtotal`, `rate`, and the return value. Evals `subtotal * rate` vs `subtotal * (1 - rate)` to confirm the formula is wrong
-
-7. **Hot-patch Bug 2** — Agent patches `return subtotal * rate` to `return subtotal * (1 - rate)`
-
-8. **Verify** — Agent continues execution, sees the correct totals in the output
-
-### Talking Points
-
-- **No restart needed**: Both fixes were applied to the live process via hot-patching
-- **Agent reasoning**: The agent didn't just fix a crash — it reasoned about the discount math to catch the subtle logic bug
-- **Token-efficient output**: agent-dbg's compact output format keeps the agent's context window lean
-- **@ref system**: Variables use short references (@v1, @v2...) that the agent can use in subsequent commands without copying long object IDs
-
-## Manual Verification
-
-```bash
-# Should crash (Bug 1)
-node demo/order-processor.js
-
-# After fixing Bug 1 (change <= to <), should show wrong discounts (Bug 2)
-# ORD-001 total will be 25 instead of 100
-
-# After fixing both bugs, correct output
-node demo/order-processor.js
-```

package/demo/order-processor.js

@@ -1,35 +0,0 @@
-// Order Processor — calculates totals and applies discount codes
-const orders = [
-  { id: "ORD-001", items: [{ name: "Widget", price: 25, qty: 3 }, { name: "Gadget", price: 50, qty: 1 }], discount: "SAVE20" },
-  { id: "ORD-002", items: [{ name: "Gizmo", price: 15, qty: 5 }], discount: null },
-  { id: "ORD-003", items: [{ name: "Doohickey", price: 100, qty: 2 }, { name: "Widget", price: 25, qty: 1 }], discount: "SAVE20" },
-];
-
-const discountCodes = { SAVE20: 0.20, HALF: 0.50, VIP: 0.30 };
-
-function calculateSubtotal(items) {
-  let subtotal = 0;
-  for (let i = 0; i < items.length; i++) {
-    subtotal += items[i].price * items[i].qty;
-  }
-  return subtotal;
-}
-
-function applyDiscount(subtotal, code) {
-  if (!code) return subtotal;
-  const rate = discountCodes[code];
-  return subtotal * (1 - rate);
-}
-
-function processOrders(orders) {
-  const results = [];
-  for (const order of orders) {
-    const subtotal = calculateSubtotal(order.items);
-    const total = applyDiscount(subtotal, order.discount);
-    results.push({ id: order.id, subtotal, total });
-  }
-  return results;
-}
-
-const results = processOrders(orders);
-console.log("Order Results:", JSON.stringify(results, null, 2));

package/tests/fixtures/dap/hello.dSYM/Contents/Info.plist

@@ -1,20 +0,0 @@
-<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-	<dict>
-		<key>CFBundleDevelopmentRegion</key>
-		<string>English</string>
-		<key>CFBundleIdentifier</key>
-		<string>com.apple.xcode.dsym.hello</string>
-		<key>CFBundleInfoDictionaryVersion</key>
-		<string>6.0</string>
-		<key>CFBundlePackageType</key>
-		<string>dSYM</string>
-		<key>CFBundleSignature</key>
-		<string>????</string>
-		<key>CFBundleShortVersionString</key>
-		<string>1.0</string>
-		<key>CFBundleVersion</key>
-		<string>1</string>
-	</dict>
-</plist>

package/tests/fixtures/dap/hello.dSYM/Contents/Resources/Relocations/aarch64/hello.yml

@@ -1,5 +0,0 @@
----
-triple:          'arm64-apple-darwin'
-binary-path:     '/Users/waltoss/Code/Theodo/OpenSource/agent-dbg/tests/fixtures/dap/hello'
-relocations:     []
-...