smashimo/oh-my-pi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: update docs

Browse Source
This commit is contained in:
can1357
2026-06-17 04:37:39 +02:00
parent ce9db56066
commit d5b3c78132
82 changed files with 549 additions and 1450 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/tools/debug.md
+3 -3
View File
@@ -201,7 +201,7 @@ Side-channel artifacts outside the model tool result:
- Work-profile export writes `/tmp/work-profile-<timestamp>.svg`.
- Log source reads daily log files from the logs dir.
- Artifact-cache cleanup removes session artifact directories older than the cutoff.
- `resolveRawSseDebugBuffer()` may attach a non-enumerable `rawSseDebugBuffer` property to the owner object.
- `resolveRawSseDebugBuffer()` reuses an explicit `rawSseDebugBuffer` property on the owner when present, otherwise caches a buffer under a private `Symbol("debug.rawSseBuffer")` key (silently skipped when the owner is non-extensible).
- Network
- Socket-mode adapters bind/connect local sockets.
- Remote attach may connect through the adapter to a remote debug port.
@@ -209,7 +209,7 @@ Side-channel artifacts outside the model tool result:
- Spawns debugger adapters (`gdb`, `lldb-dap`, `python -m debugpy.adapter`, `dlv`, and others from `defaults.json`) detached.
- Reverse DAP `runInTerminal` requests spawn the debuggee detached via `ptree.spawn()`.
- `getWorkProfile(30)` comes from `@oh-my-pi/pi-natives`.
- CPU profiling uses `node:inspector/promises`; heap snapshots use `Bun.generateHeapSnapshot("v8")`; raw/log viewers sanitize text via `@oh-my-pi/pi-natives`.
- CPU profiling uses `node:inspector/promises`; heap snapshots use `Bun.generateHeapSnapshot("v8")`; raw/log viewers sanitize text via `sanitizeText()` from `@oh-my-pi/pi-utils`.
- `openPath()` launches the OS default file/browser handler for artifact dirs and SVGs.
- Log/raw-SSE viewers can call `copyToClipboard()`.
- Session state (transcript, memory, jobs, checkpoints, registries)
@@ -263,7 +263,7 @@ Side-channel artifacts outside the model tool result:
- `data is required for write_memory`
- `command is required for custom_request`
- Adapter selection failure throws `No debugger adapter available. Installed adapters: ...`.
- Capability-gated actions throw from `requireCapability(...)`, e.g. `Active adapter does not support memory reads.`
- Capability-gated actions throw from `requireCapability(...)`, e.g. `Current adapter does not support memory reads`.
- No-session and state errors come from `DapSessionManager`, e.g. `No active debug session. Launch or attach first.`, `No active stack frame. Run stack_trace first or supply frame_id.`, `Debugger reported no threads.`
- Launching a second live session throws `Debug session <id> is still active. Terminate it before launching another.`
- DAP transport/request failures surface as thrown errors from `DapClient`: