@saptools/cf-inspector 0.3.9 → 0.3.12

package/README.md

@@ -46,20 +46,6 @@ pnpm add @saptools/cf-inspector
 
 ## 🚀 Quick Start
 
-### Local Node process
-
-```bash
-# Terminal 1 — run any Node app with the inspector enabled
-node --inspect=9229 my-app.js
-
-# Terminal 2 — capture a snapshot when handler.ts:42 hits
-cf-inspector snapshot \
-  --port 9229 \
-  --bp src/handler.ts:42 \
-  --capture 'this.user, req.body' \
-  --timeout 30
-```
-
 ### Cloud Foundry app (auto-tunnel)
 
 ```bash
@@ -72,7 +58,7 @@ cf-inspector snapshot \
   --remote-root 'regex:^/(home/vcap/app|example-root-.*)$'
 ```
 
-The first form connects directly to `localhost:9229`. The second internally calls `@saptools/cf-debugger` to open the SSH tunnel, runs the snapshot through it, and tears the tunnel down on exit.
+This command internally calls `@saptools/cf-debugger` to open the SSH tunnel, runs the snapshot through it, and tears the tunnel down on exit.
 
 ---
 
@@ -83,13 +69,6 @@ The first form connects directly to `localhost:9229`. The second internally call
 Set one or more breakpoints, wait for any of them to hit, capture frame metadata and requested expressions, auto-resume, exit.
 
 ```bash
-# Simple snapshot
-cf-inspector snapshot \
-  --port 9229 \
-  --bp src/handler.ts:42 \
-  --capture 'this.user, req.body' \
-  --timeout 30
-
 # Conditional snapshot — only pauses for the user we care about
 cf-inspector snapshot --port 9229 \
   --bp src/handler.ts:42 \
@@ -115,21 +94,17 @@ cf-inspector snapshot --port 9229 \
 | `--remote-root <value>` | Optional path-mapping anchor: literal path or `regex:<pattern>` / `/pattern/flags` |
 | `--include-scopes` | Include expanded paused-frame scopes under `topFrame.scopes`. Omitted by default to keep targeted captures concise |
 | `--no-json` | Print a human-readable summary instead of JSON |
-| `--keep-paused` | Skip `Debugger.resume` after capture; Node may resume when the CLI disconnects |
+| `--keep-paused` | Skip `Debugger.resume` after capture |
 | `--fail-on-unmatched-pause` | Fail immediately if the target pauses somewhere else instead of waiting cooperatively |
 
-JSON output includes frame metadata and `captures` by default. `topFrame.scopes`
-is only present with `--include-scopes`, because Cloud Foundry Node apps often
-carry large local/closure/module objects that drown out targeted captures. The
-output contains raw debugger values; use it only against trusted targets and be
-careful when sharing logs. The output also includes `pausedDurationMs`, the
-client-observed time from receiving
-the matching pause event until `Debugger.resume` completes. It does not include
-the time spent waiting for the breakpoint to hit. When `--keep-paused` is used,
-`pausedDurationMs` is `null` because `cf-inspector` intentionally skips
-`Debugger.resume`. Node may resume execution when this one-shot CLI disconnects,
-so treat `--keep-paused` as a low-level diagnostic escape hatch, not a durable
-paused-session mode.
+Snapshot JSON includes frame metadata and `captures` by default. `topFrame.scopes`
+is only present with `--include-scopes` because scope objects can be large and
+drown out targeted captures. Values are raw debugger values, so be careful when
+sharing logs.
+
+`pausedDurationMs` measures the client-observed time from receiving the matching
+pause event until `Debugger.resume` completes. With `--keep-paused`, it is `null`
+because resume is intentionally skipped.
 
 If the target pauses somewhere else first, for example another debugger's
 breakpoint or a `debugger;` statement, `snapshot` does not resume it by default.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@saptools/cf-inspector",
-  "version": "0.3.9",
+  "version": "0.3.12",
   "description": "Set breakpoints, capture variable snapshots, and evaluate expressions on a SAP BTP Cloud Foundry Node.js app via the Chrome DevTools Protocol — agent-friendly, no IDE required.",
   "type": "module",
   "publishConfig": {