oh-my-opencode 5.0.0-beta.23 → 5.0.0-beta.25
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/cli/index.js +141 -184
- package/dist/cli-node/index.js +141 -184
- package/dist/index.js +1508 -1567
- package/dist/skills/debugging/SKILL.md +0 -2
- package/dist/skills/debugging/references/methodology/00-setup.md +0 -12
- package/dist/skills/debugging/references/methodology/02-investigate.md +0 -21
- package/dist/skills/debugging/references/runtimes/go.md +1 -15
- package/dist/skills/debugging/references/runtimes/native-binary.md +0 -38
- package/dist/skills/debugging/references/runtimes/node.md +0 -25
- package/dist/skills/debugging/references/runtimes/python.md +0 -13
- package/dist/skills/debugging/references/runtimes/rust.md +0 -41
- package/dist/tools/delegate-task/types.d.ts +0 -3
- package/dist/tui.js +0 -25
- package/package.json +15 -18
- package/packages/lsp-core/src/index.ts +0 -1
- package/packages/lsp-core/src/lsp/client-wrapper.ts +5 -25
- package/packages/lsp-core/src/lsp/client.ts +0 -26
- package/packages/lsp-core/src/lsp/connection.ts +0 -16
- package/packages/lsp-core/src/lsp/constants.ts +0 -1
- package/packages/lsp-core/src/lsp/manager.ts +1 -34
- package/packages/lsp-core/src/lsp/server-definitions.ts +0 -29
- package/packages/lsp-core/src/lsp/server-installation.ts +27 -200
- package/packages/lsp-core/src/lsp/server-resolution.ts +5 -18
- package/packages/lsp-core/src/lsp/transport.ts +0 -9
- package/packages/lsp-core/src/lsp/types.ts +0 -8
- package/packages/lsp-core/src/tool-surface.test.ts +1 -13
- package/packages/lsp-core/src/tools/definitions.ts +0 -14
- package/packages/lsp-core/src/tools/index.ts +0 -1
- package/packages/lsp-core/src/tools/types.ts +0 -10
- package/packages/lsp-daemon/dist/cli.js +144 -432
- package/packages/lsp-daemon/dist/client.d.ts +0 -10
- package/packages/lsp-daemon/dist/client.js +107 -401
- package/packages/lsp-daemon/dist/daemon-client.d.ts +0 -1
- package/packages/lsp-daemon/dist/daemon-client.js +0 -3
- package/packages/lsp-daemon/dist/index.js +107 -395
- package/packages/lsp-tools-mcp/dist/cli.js +99 -384
- package/packages/lsp-tools-mcp/dist/lsp/manager.js +0 -53
- package/packages/lsp-tools-mcp/dist/mcp.js +99 -384
- package/packages/lsp-tools-mcp/dist/tools.js +99 -385
- package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
- package/packages/omo-codex/plugin/components/bootstrap/dist/cli.js +2 -2
- package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
- package/packages/omo-codex/plugin/components/codegraph/dist/cli.js +35 -69
- package/packages/omo-codex/plugin/components/codegraph/dist/serve.js +2 -21
- package/packages/omo-codex/plugin/components/codegraph/package.json +1 -1
- package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
- package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
- package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
- package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
- package/packages/omo-codex/plugin/components/lsp/dist/.omo-runtime-manifest.json +3 -3
- package/packages/omo-codex/plugin/components/lsp/dist/cli.js +121 -404
- package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
- package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
- package/packages/omo-codex/plugin/components/rules/dist/cli.js +3 -3
- package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
- package/packages/omo-codex/plugin/components/rules/package.json +1 -1
- package/packages/omo-codex/plugin/components/rules/src/post-compact-budget.ts +3 -3
- package/packages/omo-codex/plugin/components/rules/test/post-compact-budget.test.ts +4 -4
- package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
- package/packages/omo-codex/plugin/components/telemetry/dist/cli.js +15 -30
- package/packages/omo-codex/plugin/components/telemetry/dist/posthog.js +15 -30
- package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
- package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
- package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
- package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json +2 -2
- package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json +1 -1
- package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +4 -4
- package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-tool-use-checking-codegraph-init-guidance.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
- package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
- package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
- package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json +1 -1
- package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
- package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
- package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
- package/packages/omo-codex/plugin/hooks/session-start-checking-codegraph-bootstrap.json +1 -1
- package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
- package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
- package/packages/omo-codex/plugin/hooks/stop-checking-ulw-execute-continuation.json +1 -1
- package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json +1 -1
- package/packages/omo-codex/plugin/hooks/subagent-stop-checking-ulw-execute-continuation.json +1 -1
- package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
- package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
- package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
- package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
- package/packages/omo-codex/plugin/model-catalog.json +3 -3
- package/packages/omo-codex/plugin/package-lock.json +13 -13
- package/packages/omo-codex/plugin/package.json +1 -1
- package/packages/omo-codex/plugin/scripts/migrate-codex-config/catalog.mjs +3 -3
- package/packages/omo-codex/plugin/skills/debugging/SKILL.md +0 -2
- package/packages/omo-codex/plugin/skills/debugging/references/methodology/00-setup.md +0 -12
- package/packages/omo-codex/plugin/skills/debugging/references/methodology/02-investigate.md +0 -21
- package/packages/omo-codex/plugin/skills/debugging/references/runtimes/go.md +1 -15
- package/packages/omo-codex/plugin/skills/debugging/references/runtimes/native-binary.md +0 -38
- package/packages/omo-codex/plugin/skills/debugging/references/runtimes/node.md +0 -25
- package/packages/omo-codex/plugin/skills/debugging/references/runtimes/python.md +0 -13
- package/packages/omo-codex/plugin/skills/debugging/references/runtimes/rust.md +0 -41
- package/packages/omo-codex/plugin/test/aggregate-model-catalog.test.mjs +1 -1
- package/packages/omo-codex/plugin/test/auto-update.test.mjs +2 -2
- package/packages/omo-codex/plugin/test/migrate-codex-config.test.mjs +8 -8
- package/packages/omo-codex/scripts/install-config-reasoning.test.mjs +2 -2
- package/packages/omo-codex/scripts/install-dist/install-local.mjs +23 -38
- package/packages/shared-skills/skills/debugging/SKILL.md +0 -2
- package/packages/shared-skills/skills/debugging/references/methodology/00-setup.md +0 -12
- package/packages/shared-skills/skills/debugging/references/methodology/02-investigate.md +0 -21
- package/packages/shared-skills/skills/debugging/references/runtimes/go.md +1 -15
- package/packages/shared-skills/skills/debugging/references/runtimes/native-binary.md +0 -38
- package/packages/shared-skills/skills/debugging/references/runtimes/node.md +0 -25
- package/packages/shared-skills/skills/debugging/references/runtimes/python.md +0 -13
- package/packages/shared-skills/skills/debugging/references/runtimes/rust.md +0 -41
- package/dist/skills/debugging/references/scripts/dap.mjs +0 -267
- package/dist/skills/debugging/references/scripts/dap.test.ts +0 -86
- package/dist/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
- package/dist/skills/debugging/references/tools/dap.md +0 -103
- package/dist/skills/debugging/references/tools/frida.md +0 -193
- package/packages/lsp-core/src/lsp/format-document.test.ts +0 -143
- package/packages/lsp-core/src/lsp/format-document.ts +0 -90
- package/packages/lsp-core/src/lsp/manager-max-clients.test.ts +0 -151
- package/packages/lsp-core/src/lsp/server-installation.test.ts +0 -376
- package/packages/lsp-core/src/lsp/server-resolution-local-binary.test.ts +0 -170
- package/packages/lsp-core/src/tools/format.test.ts +0 -56
- package/packages/lsp-core/src/tools/format.ts +0 -56
- package/packages/omo-codex/plugin/skills/debugging/references/scripts/dap.mjs +0 -267
- package/packages/omo-codex/plugin/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
- package/packages/omo-codex/plugin/skills/debugging/references/tools/dap.md +0 -103
- package/packages/omo-codex/plugin/skills/debugging/references/tools/frida.md +0 -193
- package/packages/shared-skills/skills/debugging/references/scripts/dap.mjs +0 -267
- package/packages/shared-skills/skills/debugging/references/scripts/dap.test.ts +0 -86
- package/packages/shared-skills/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
- package/packages/shared-skills/skills/debugging/references/tools/dap.md +0 -103
- package/packages/shared-skills/skills/debugging/references/tools/frida.md +0 -193
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
|
-
// omo-codex-install:
|
|
2
|
+
// omo-codex-install:475155d5e39ca774e5cf86194fee97439fd9c4f3624a85e946a994d5493e4629:77281d767f7f06db3f25f6c9b5685a2d533f87e9ea3542728c7d67df91c74dad
|
|
3
3
|
var __defProp = Object.defineProperty;
|
|
4
4
|
var __returnValue = (v) => v;
|
|
5
5
|
function __exportSetter(name, newValue) {
|
|
@@ -47,12 +47,9 @@ import {
|
|
|
47
47
|
fsyncSync,
|
|
48
48
|
openSync,
|
|
49
49
|
renameSync,
|
|
50
|
-
rmSync,
|
|
51
50
|
unlinkSync,
|
|
52
51
|
writeFileSync
|
|
53
52
|
} from "node:fs";
|
|
54
|
-
import { randomUUID } from "node:crypto";
|
|
55
|
-
import { dirname as dirname10 } from "node:path";
|
|
56
53
|
function isToleratedFsyncError(error) {
|
|
57
54
|
if (!(error instanceof Error))
|
|
58
55
|
return false;
|
|
@@ -68,36 +65,24 @@ function tolerantFsyncSync(fileDescriptor, fsyncImpl) {
|
|
|
68
65
|
}
|
|
69
66
|
}
|
|
70
67
|
function writeFileAtomically(filePath, content, options = {}) {
|
|
71
|
-
const
|
|
72
|
-
|
|
73
|
-
const
|
|
68
|
+
const tempPath = `${filePath}.tmp`;
|
|
69
|
+
writeFileSync(tempPath, content, "utf-8");
|
|
70
|
+
const tempFileDescriptor = openSync(tempPath, "r+");
|
|
74
71
|
try {
|
|
75
|
-
|
|
76
|
-
|
|
77
|
-
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
} catch (error) {
|
|
85
|
-
const isPermissionError = error instanceof Error && (error.message.includes("EPERM") || error.message.includes("EACCES"));
|
|
86
|
-
if (platform !== "win32" || !isPermissionError)
|
|
87
|
-
throw error;
|
|
72
|
+
tolerantFsyncSync(tempFileDescriptor, options.fsyncSync ?? fsyncSync);
|
|
73
|
+
} finally {
|
|
74
|
+
closeSync(tempFileDescriptor);
|
|
75
|
+
}
|
|
76
|
+
try {
|
|
77
|
+
renameSync(tempPath, filePath);
|
|
78
|
+
} catch (error) {
|
|
79
|
+
const isPermissionError = error instanceof Error && (error.message.includes("EPERM") || error.message.includes("EACCES"));
|
|
80
|
+
if ((options.platform ?? process.platform) === "win32" && isPermissionError) {
|
|
88
81
|
unlinkSync(filePath);
|
|
89
82
|
renameSync(tempPath, filePath);
|
|
90
|
-
}
|
|
91
|
-
if (platform === "win32")
|
|
92
83
|
return;
|
|
93
|
-
const directoryFileDescriptor = openSync(dirname10(filePath), "r");
|
|
94
|
-
try {
|
|
95
|
-
tolerantFsyncSync(directoryFileDescriptor, fsyncImpl);
|
|
96
|
-
} finally {
|
|
97
|
-
closeSync(directoryFileDescriptor);
|
|
98
84
|
}
|
|
99
|
-
|
|
100
|
-
rmSync(tempPath, { force: true });
|
|
85
|
+
throw error;
|
|
101
86
|
}
|
|
102
87
|
}
|
|
103
88
|
var TOLERATED_FSYNC_CODES;
|
|
@@ -363,7 +348,7 @@ var init_env = __esm(() => {
|
|
|
363
348
|
});
|
|
364
349
|
|
|
365
350
|
// node_modules/.bun/posthog-node@5.51.1/node_modules/posthog-node/dist/extensions/error-tracking/modifiers/module.node.mjs
|
|
366
|
-
import { dirname as
|
|
351
|
+
import { dirname as dirname10, posix as posix2, sep as sep7 } from "node:path";
|
|
367
352
|
function createModulerModifier() {
|
|
368
353
|
const getModuleFromFileName = createGetModuleFromFilename();
|
|
369
354
|
return async (frames) => {
|
|
@@ -372,7 +357,7 @@ function createModulerModifier() {
|
|
|
372
357
|
return frames;
|
|
373
358
|
};
|
|
374
359
|
}
|
|
375
|
-
function createGetModuleFromFilename(basePath = process.argv[1] ?
|
|
360
|
+
function createGetModuleFromFilename(basePath = process.argv[1] ? dirname10(process.argv[1]) : process.cwd(), isWindows = sep7 === "\\") {
|
|
376
361
|
const normalizedBase = isWindows ? normalizeWindowsPath(basePath) : basePath;
|
|
377
362
|
return (filename) => {
|
|
378
363
|
if (!filename)
|
|
@@ -7977,7 +7962,7 @@ var package_default;
|
|
|
7977
7962
|
var init_package = __esm(() => {
|
|
7978
7963
|
package_default = {
|
|
7979
7964
|
name: "@oh-my-opencode/omo-codex",
|
|
7980
|
-
version: "5.0.0-beta.
|
|
7965
|
+
version: "5.0.0-beta.25",
|
|
7981
7966
|
type: "module",
|
|
7982
7967
|
private: true,
|
|
7983
7968
|
description: "Codex harness adapter for oh-my-openagent. Vendored Codex plugin namespace (omo) + TypeScript installer + telemetry.",
|
|
@@ -8197,7 +8182,7 @@ var init_telemetry = __esm(() => {
|
|
|
8197
8182
|
|
|
8198
8183
|
// packages/omo-codex/src/install/install-local-cli.ts
|
|
8199
8184
|
import { readFile as readFile23 } from "node:fs/promises";
|
|
8200
|
-
import { dirname as
|
|
8185
|
+
import { dirname as dirname12, join as join40, resolve as resolve10 } from "node:path";
|
|
8201
8186
|
import { fileURLToPath as fileURLToPath2 } from "node:url";
|
|
8202
8187
|
|
|
8203
8188
|
// packages/utils/src/runtime/spawn.ts
|
|
@@ -11044,14 +11029,14 @@ import { join as join17 } from "node:path";
|
|
|
11044
11029
|
var FALLBACK_CODEX_MODEL_CATALOG = {
|
|
11045
11030
|
current: {
|
|
11046
11031
|
model: "gpt-5.6-sol",
|
|
11047
|
-
modelContextWindow:
|
|
11032
|
+
modelContextWindow: 372000,
|
|
11048
11033
|
modelReasoningEffort: "high",
|
|
11049
11034
|
planModeReasoningEffort: "xhigh"
|
|
11050
11035
|
},
|
|
11051
11036
|
managedProfiles: [
|
|
11052
11037
|
{
|
|
11053
11038
|
model: "gpt-5.5",
|
|
11054
|
-
modelContextWindow:
|
|
11039
|
+
modelContextWindow: 400000,
|
|
11055
11040
|
modelReasoningEffort: "high",
|
|
11056
11041
|
planModeReasoningEffort: "xhigh"
|
|
11057
11042
|
},
|
|
@@ -13555,7 +13540,7 @@ function shellQuote(value) {
|
|
|
13555
13540
|
// packages/omo-codex/src/install/lazycodex-manual-update.ts
|
|
13556
13541
|
import { spawn as spawn3, spawnSync as spawnSync3 } from "node:child_process";
|
|
13557
13542
|
import { readFileSync as readFileSync4 } from "node:fs";
|
|
13558
|
-
import { dirname as
|
|
13543
|
+
import { dirname as dirname11, join as join38 } from "node:path";
|
|
13559
13544
|
import { createInterface as createInterface2 } from "node:readline/promises";
|
|
13560
13545
|
import { fileURLToPath } from "node:url";
|
|
13561
13546
|
|
|
@@ -13664,7 +13649,7 @@ function resolveArgs(env2) {
|
|
|
13664
13649
|
function resolveCurrentVersion(env2) {
|
|
13665
13650
|
if (env2.LAZYCODEX_CURRENT_VERSION?.trim())
|
|
13666
13651
|
return env2.LAZYCODEX_CURRENT_VERSION.trim();
|
|
13667
|
-
const pluginRoot =
|
|
13652
|
+
const pluginRoot = dirname11(dirname11(fileURLToPath(import.meta.url)));
|
|
13668
13653
|
return readVersionManifest(resolveInstalledVersionPath(env2, pluginRoot)) ?? readVersionManifest(join38(pluginRoot, "..", "..", "..", "package.json")) ?? readVersionManifest(join38(pluginRoot, ".codex-plugin", "plugin.json"));
|
|
13669
13654
|
}
|
|
13670
13655
|
function resolveLatestVersion(env2) {
|
|
@@ -13844,7 +13829,7 @@ async function installMarketplaceLocally(options = {}) {
|
|
|
13844
13829
|
return runCodexInstaller(options);
|
|
13845
13830
|
}
|
|
13846
13831
|
function resolveDefaultRepoRootForEntrypoint(entrypointPath) {
|
|
13847
|
-
return resolve10(
|
|
13832
|
+
return resolve10(dirname12(entrypointPath), "..", "..", "..");
|
|
13848
13833
|
}
|
|
13849
13834
|
function resolveDefaultRepoRoot() {
|
|
13850
13835
|
return resolveDefaultRepoRootForEntrypoint(fileURLToPath2(import.meta.url));
|
|
@@ -53,8 +53,6 @@ These are not "optional extras". They are the correct tool in their domain, and
|
|
|
53
53
|
| **Ghidra** | Any binary without trustworthy source — third-party closed libs, malware, vendored binaries whose behavior contradicts docs, CTF, firmware. **Use Ghidra's decompiler before `strings`/`objdump` guessing. It turns machine code into readable C.** | 📖 **[references/tools/ghidra.md](references/tools/ghidra.md)** |
|
|
54
54
|
| **pwndbg** | Any native binary debugging session. It is GDB with the useful views (registers, stack, disasm, heap) always visible. **If you'd reach for plain `gdb`, reach for `pwndbg` instead — it is strictly a superset.** | 📖 **[references/tools/pwndbg.md](references/tools/pwndbg.md)** |
|
|
55
55
|
| **pwntools** | Any time you need a reproducible interaction with a binary or network service — crafted payloads, exploit automation, fuzz harness, CTF scripting. | 📖 **[references/tools/pwntools.md](references/tools/pwntools.md)** |
|
|
56
|
-
| **Frida** | Any running process you must instrument live without source or symbols — hook a function and print real argument values, trace calls, stub a return. Complements Ghidra: Ghidra reads the bytes, Frida watches them execute. **If Ghidra's static decompile has hit its limit, reach for Frida.** | 📖 **[references/tools/frida.md](references/tools/frida.md)** |
|
|
57
|
-
| **DAP client (`dap.mjs`)** | Any time you would drive a debugger through a PTY and screen-scrape its text. Debuggers already speak the machine-readable Debug Adapter Protocol (debugpy, `dlv dap`, lldb-dap, js-debug); this bundled script drives it with bounded, monitorable output. **Prefer it over scraping `gdb`/`pdb` whenever the debugger speaks DAP.** Design modeled on oh-my-pi's `debug` tool (github.com/can1357/oh-my-pi). | 📖 **[references/tools/dap.md](references/tools/dap.md)** |
|
|
58
56
|
|
|
59
57
|
**Failing to use these tools in their domain is a process failure, not a stylistic choice.** If the bug is in a browser and you did Phase 8 without Playwright, you are doing it wrong. If the bug is in a stripped binary and you read hex with `xxd`, you are doing it wrong. The references tell you how. Read them.
|
|
60
58
|
|
|
@@ -35,18 +35,6 @@ The shape of the answers you need (commands in the runtime reference):
|
|
|
35
35
|
| Is there an existing failing test or known repro? | Prefer amplifying an existing repro over inventing one. |
|
|
36
36
|
| Are watchers (file watchers, hot reloaders, supervisors) going to restart the process mid-session? | If yes, turn them off before attaching. Restarts drop inspector connections and invalidate breakpoints. |
|
|
37
37
|
|
|
38
|
-
### Output budget
|
|
39
|
-
|
|
40
|
-
**Bound every inspection before you run it; unbounded output destroys the investigation's working context.**
|
|
41
|
-
- Set a frame count, element count, or byte range for every query.
|
|
42
|
-
- Prefer one targeted query over one broad dump: ask for the value that distinguishes hypotheses.
|
|
43
|
-
- Page through more data only when the first bounded result says it is necessary; do not re-dump the whole object.
|
|
44
|
-
- Treat any command whose output size you cannot predict as a command that needs a limit.
|
|
45
|
-
- Before: GDB `bt` — After: GDB `bt 10` to inspect only the top ten frames.
|
|
46
|
-
- Before: LLDB `memory read 0x1000` — After: `memory read 0x1000 -c 32` for a bounded byte range.
|
|
47
|
-
- Before: LLDB `frame variable` — After: `frame variable --children-count 10 user` for one variable's children.
|
|
48
|
-
- This is not presentation etiquette: a flooded context hides the decisive observation and can end the investigation.
|
|
49
|
-
|
|
50
38
|
### 4. Gate check
|
|
51
39
|
|
|
52
40
|
If any answer is "I'm not sure", you are not ready for Phase 1. Investigate until certain. Guessing here cascades into false-positive hypotheses in Phase 2.
|
|
@@ -39,27 +39,6 @@ If two hypotheses have identical distinguishing evidence, they aren't actually d
|
|
|
39
39
|
|
|
40
40
|
## Phase 3 — Parallel Investigation
|
|
41
41
|
|
|
42
|
-
### State freshness invariant
|
|
43
|
-
|
|
44
|
-
**A debug session's state is a snapshot with a lifetime, not a fact you can carry forward indefinitely.**
|
|
45
|
-
- Before any action that mutates the debuggee, re-observe the session's current state.
|
|
46
|
-
- This includes continue, step, side-effecting evaluation, setting or removing breakpoints, and termination.
|
|
47
|
-
- Record the current thread state and stop reason; those are the concrete tells for whether the old plan still applies.
|
|
48
|
-
- An observation from an earlier turn may already be stale when the next action is issued.
|
|
49
|
-
- Turns can be minutes apart while the debuggee runs at full speed, so this failure mode is normal, not exceptional.
|
|
50
|
-
- If the thread state or stop reason has moved, re-observe the new state and do not replay the old plan.
|
|
51
|
-
- Treat every mutation as conditional on the state you just observed, not on a remembered stop.
|
|
52
|
-
|
|
53
|
-
### Failure-to-recovery taxonomy
|
|
54
|
-
|
|
55
|
-
| Failure signature | Most likely cause | Next move |
|
|
56
|
-
|---|---|---|
|
|
57
|
-
| Adapter or debugger process failed to start | Wrong binary or missing installation | Verify the tool exists, then re-launch; do not retry blindly. |
|
|
58
|
-
| Breakpoint accepted but never bound or verified | Source path mismatch, optimized-out code, or missing debug symbols | Check the binary was built with symbols and that the debugger-resolved path matches your file. |
|
|
59
|
-
| Attach refused | Permissions, ptrace scope, SIP, or wrong PID | Fix the environment or target identity; a retry will not change it. |
|
|
60
|
-
| No stop event within the expected window | Process is running, the breakpoint is unreachable, or the wait was too short | Pause and inspect threads rather than waiting longer. |
|
|
61
|
-
| Session terminated unexpectedly | The debuggee crashed or exited | Capture the exit and crash evidence before restarting. |
|
|
62
|
-
|
|
63
42
|
Branch depending on what's available.
|
|
64
43
|
|
|
65
44
|
### Path A: Team mode ENABLED
|
|
@@ -42,24 +42,10 @@ dlv exec ./bin/myserver
|
|
|
42
42
|
# Attach to a running process
|
|
43
43
|
dlv attach $(pgrep myserver)
|
|
44
44
|
|
|
45
|
-
#
|
|
45
|
+
# Headless mode (IDE / remote attach) — default port 2345
|
|
46
46
|
dlv debug --headless --listen=:2345 --api-version=2 ./cmd/server
|
|
47
47
|
```
|
|
48
48
|
|
|
49
|
-
Delve exposes two distinct machine-readable interfaces:
|
|
50
|
-
|
|
51
|
-
```bash
|
|
52
|
-
# Debug Adapter Protocol: use this for editors and DAP-aware automation
|
|
53
|
-
dlv dap --listen=127.0.0.1:2345
|
|
54
|
-
|
|
55
|
-
# Delve's JSON-RPC API: use this for clients built directly against Delve's API
|
|
56
|
-
dlv debug --headless --listen=127.0.0.1:2345 --api-version=2 ./cmd/server
|
|
57
|
-
```
|
|
58
|
-
|
|
59
|
-
Pick `dlv dap` when the client speaks DAP; pick headless JSON-RPC when you need Delve's
|
|
60
|
-
native API or an existing JSON-RPC client. Both expose structured state, unlike scraping
|
|
61
|
-
an interactive `(dlv)` session.
|
|
62
|
-
|
|
63
49
|
### Building a debuggable binary
|
|
64
50
|
|
|
65
51
|
The compiler inlines and optimizes aggressively in normal builds, which makes stepping confusing. For serious debugging:
|
|
@@ -107,24 +107,6 @@ print(repr(data[max(0,pos-100):pos+200]))
|
|
|
107
107
|
|
|
108
108
|
If you must keep using `strings`, lower the threshold: `strings -n 1 -t x ./target | rg ...`. The signal-to-noise drops sharply but short content is preserved.
|
|
109
109
|
|
|
110
|
-
### Sanitizer build for a crashing C/C++ binary
|
|
111
|
-
|
|
112
|
-
If the binary can be rebuilt from C/C++ sources, reproduce the crash with sanitizers before
|
|
113
|
-
trying to infer the fault from stripped machine code. AddressSanitizer catches out-of-bounds
|
|
114
|
-
accesses and use-after-free; UndefinedBehaviorSanitizer reports undefined operations.
|
|
115
|
-
|
|
116
|
-
```bash
|
|
117
|
-
# Rebuild with source locations and runtime checks enabled
|
|
118
|
-
CFLAGS='-g -O1 -fsanitize=address,undefined' \
|
|
119
|
-
CXXFLAGS='-g -O1 -fsanitize=address,undefined' \
|
|
120
|
-
make clean all
|
|
121
|
-
./target
|
|
122
|
-
```
|
|
123
|
-
|
|
124
|
-
The sanitizer report identifies the invalid access and its allocation/free or undefined
|
|
125
|
-
operation stack, often making the root cause clear before dynamic analysis. For a binary
|
|
126
|
-
that cannot be rebuilt, continue with the native tracing and debugger workflow below.
|
|
127
|
-
|
|
128
110
|
Write the triage summary to the journal:
|
|
129
111
|
|
|
130
112
|
```markdown
|
|
@@ -247,26 +229,6 @@ lldb ./target
|
|
|
247
229
|
(lldb) image dump symtab ./target
|
|
248
230
|
```
|
|
249
231
|
|
|
250
|
-
### Data watchpoints — catch the corruption, not just the crash
|
|
251
|
-
|
|
252
|
-
When a value is already wrong by the time execution reaches the crash, watch the memory
|
|
253
|
-
address for writes and stop at the instruction that corrupts it. Use the address of the
|
|
254
|
-
field or buffer identified from the static/dynamic hypothesis; see [tools/pwndbg.md](../tools/pwndbg.md)
|
|
255
|
-
for the richer pwndbg watchpoint workflow rather than duplicating it here.
|
|
256
|
-
|
|
257
|
-
```text
|
|
258
|
-
# lldb: watch writes to an address (replace with a valid expression/address)
|
|
259
|
-
(lldb) watchpoint set expression -- <addr>
|
|
260
|
-
|
|
261
|
-
# gdb: stop on writes, or on reads when a read is the first observable symptom
|
|
262
|
-
(gdb) watch *(<type> *)<addr>
|
|
263
|
-
(gdb) rwatch *(<type> *)<addr>
|
|
264
|
-
```
|
|
265
|
-
|
|
266
|
-
A watchpoint is most useful after narrowing the suspect object: continue from its
|
|
267
|
-
allocation or initialization, and inspect the backtrace and writer when it triggers.
|
|
268
|
-
Hardware watchpoint slots are limited, so remove broad watchpoints before adding more.
|
|
269
|
-
|
|
270
232
|
**Function interception via `DYLD_INSERT_LIBRARIES`** (macOS equivalent of `LD_PRELOAD`):
|
|
271
233
|
|
|
272
234
|
```bash
|
|
@@ -98,31 +98,6 @@ bun test --inspect-brk # debug test runner
|
|
|
98
98
|
|
|
99
99
|
**Critical**: Bun uses WebKit Inspector Protocol, not V8. `chrome://inspect` cannot connect directly. Use `debug.bun.sh` or the (currently buggy, per Bun docs) VS Code extension.
|
|
100
100
|
|
|
101
|
-
### Scripted V8 inspector / CDP attach
|
|
102
|
-
|
|
103
|
-
The inspector port also serves machine-readable HTTP discovery endpoints. `/json` lists
|
|
104
|
-
inspectable targets; `/json/version` includes the WebSocket debugger URL. Connect that
|
|
105
|
-
URL with the Chrome DevTools Protocol (CDP), rather than scraping `node inspect` text.
|
|
106
|
-
`chrome-remote-interface` is the canonical scriptable npm client. When browser automation
|
|
107
|
-
is already in play, use Playwright's `CDPSession` instead.
|
|
108
|
-
|
|
109
|
-
```bash
|
|
110
|
-
curl -s http://127.0.0.1:9229/json/version
|
|
111
|
-
```
|
|
112
|
-
|
|
113
|
-
```js
|
|
114
|
-
const CDP = require('chrome-remote-interface');
|
|
115
|
-
const version = await fetch('http://127.0.0.1:9229/json/version').then(r => r.json());
|
|
116
|
-
const client = await CDP({ target: version.webSocketDebuggerUrl });
|
|
117
|
-
await client.Runtime.enable();
|
|
118
|
-
await client.Debugger.pause();
|
|
119
|
-
```
|
|
120
|
-
|
|
121
|
-
The same CDP commands can be sent through `chrome-remote-interface`; with Playwright,
|
|
122
|
-
create a session with `await context.newCDPSession(page)` and call
|
|
123
|
-
`await session.send('Runtime.enable')`. These V8/CDP examples do not apply to Bun's
|
|
124
|
-
WebKit inspector protocol.
|
|
125
|
-
|
|
126
101
|
### Deno (native V8, Chrome DevTools / VS Code compatible)
|
|
127
102
|
|
|
128
103
|
```bash
|
|
@@ -41,19 +41,6 @@ python -c 'import asyncio; print(asyncio.__version__)'
|
|
|
41
41
|
| **post-mortem `pdb.pm()`** | Exception already happened, you want to inspect state | In an exception-caught REPL: `import pdb; pdb.pm()` after the exception propagates |
|
|
42
42
|
| **debugpy (remote / IDE)** | IDE attach, remote host, containerized process | `python -m debugpy --listen 5678 --wait-for-client script.py` then attach from VS Code / PyCharm |
|
|
43
43
|
|
|
44
|
-
`debugpy` is a Debug Adapter Protocol (DAP) adapter, not merely an IDE convenience.
|
|
45
|
-
Its listener exposes a machine-readable protocol that an agent or other client can drive
|
|
46
|
-
programmatically; it is a better boundary for automation than the human-oriented pdb REPL.
|
|
47
|
-
|
|
48
|
-
```bash
|
|
49
|
-
# Listen on the requested interface and wait before executing the script
|
|
50
|
-
python -m debugpy --listen <host:port> --wait-for-client <script>
|
|
51
|
-
```
|
|
52
|
-
|
|
53
|
-
Use a DAP client to send structured requests and receive structured stopped/continued
|
|
54
|
-
and stack/variable events. By contrast, `pdb` exposes prompt-oriented text: an agent
|
|
55
|
-
using it must screen-scrape output and parse a human-facing REPL.
|
|
56
|
-
|
|
57
44
|
### Prefer `ipdb` or `pudb` over plain `pdb` when available
|
|
58
45
|
|
|
59
46
|
- **ipdb** — drop-in replacement with tab completion, syntax highlighting. `pip install ipdb`, then `PYTHONBREAKPOINT=ipdb.set_trace` or use `import ipdb; ipdb.set_trace()`.
|
|
@@ -144,47 +144,6 @@ Rust symbols are mangled. Use either:
|
|
|
144
144
|
|
|
145
145
|
---
|
|
146
146
|
|
|
147
|
-
## Sanitizers — memory and race bugs
|
|
148
|
-
|
|
149
|
-
Nightly Rust exposes LLVM sanitizers through `-Z sanitizer`. Use them when a crash,
|
|
150
|
-
data race, or leak is otherwise too timing- or state-dependent to explain from a
|
|
151
|
-
backtrace; they replace guesswork with a report at the invalid operation.
|
|
152
|
-
|
|
153
|
-
```bash
|
|
154
|
-
# AddressSanitizer: out-of-bounds accesses and use-after-free
|
|
155
|
-
cargo +nightly run -Z sanitizer=address
|
|
156
|
-
|
|
157
|
-
# ThreadSanitizer: data races between threads
|
|
158
|
-
cargo +nightly test -Z sanitizer=thread
|
|
159
|
-
|
|
160
|
-
# LeakSanitizer: allocations that remain reachable at process exit
|
|
161
|
-
cargo +nightly run -Z sanitizer=leak
|
|
162
|
-
```
|
|
163
|
-
|
|
164
|
-
`address` catches invalid memory access and use-after-free, `thread` catches unsynchronized
|
|
165
|
-
concurrent accesses, and `leak` reports memory that was allocated but not released. Run
|
|
166
|
-
the invocation that matches the suspected class; sanitizer diagnostics are especially
|
|
167
|
-
useful before attaching a debugger to optimized or timing-sensitive code.
|
|
168
|
-
|
|
169
|
-
---
|
|
170
|
-
|
|
171
|
-
## rr — time-travel debugging
|
|
172
|
-
|
|
173
|
-
On supported Linux systems, record the failure once, then replay it deterministically and
|
|
174
|
-
run backwards from the failure with `reverse-continue` or `reverse-step`:
|
|
175
|
-
|
|
176
|
-
```bash
|
|
177
|
-
rr record ./target/debug/my_binary
|
|
178
|
-
rr replay
|
|
179
|
-
# (rr) reverse-continue
|
|
180
|
-
# (rr) reverse-step
|
|
181
|
-
```
|
|
182
|
-
|
|
183
|
-
`rr` is Linux/x86-64 only. It does not apply on Apple Silicon, including arm64 macOS;
|
|
184
|
-
use `rust-lldb` or a sanitizer there instead.
|
|
185
|
-
|
|
186
|
-
---
|
|
187
|
-
|
|
188
147
|
## tokio-console — async task debugging
|
|
189
148
|
|
|
190
149
|
For tokio-based async apps, this is essential when tasks are stuck or leaking.
|
|
@@ -1,267 +0,0 @@
|
|
|
1
|
-
#!/usr/bin/env node
|
|
2
|
-
// Zero-dependency DAP REPL, modeled on oh-my-pi's debug tool. DAP framing is UTF-8 byte based.
|
|
3
|
-
import { spawn } from "node:child_process";
|
|
4
|
-
import { createConnection } from "node:net";
|
|
5
|
-
import { createInterface } from "node:readline";
|
|
6
|
-
import { stdin, stdout, stderr, env } from "node:process";
|
|
7
|
-
|
|
8
|
-
export const MAX_ROWS = 100;
|
|
9
|
-
export const MAX_OUTPUT_BYTES = 32 * 1024;
|
|
10
|
-
|
|
11
|
-
export function isTcpAdapterSpec(spec) {
|
|
12
|
-
const separator = spec.lastIndexOf(":");
|
|
13
|
-
return separator > 0 &&
|
|
14
|
-
!spec.includes("/") &&
|
|
15
|
-
!spec.includes("\\") &&
|
|
16
|
-
/^\d+$/.test(spec.slice(separator + 1));
|
|
17
|
-
}
|
|
18
|
-
|
|
19
|
-
export class DapFrameParser {
|
|
20
|
-
constructor() { this.buffer = Buffer.alloc(0); }
|
|
21
|
-
push(chunk) {
|
|
22
|
-
this.buffer = Buffer.concat([this.buffer, Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk)]);
|
|
23
|
-
const messages = [];
|
|
24
|
-
while (true) {
|
|
25
|
-
const marker = this.buffer.indexOf(Buffer.from("\r\n\r\n"));
|
|
26
|
-
if (marker < 0) break;
|
|
27
|
-
const header = this.buffer.subarray(0, marker).toString("ascii");
|
|
28
|
-
const match = header.match(/(?:^|\r\n)Content-Length:\s*(\d+)/i);
|
|
29
|
-
if (!match) { this.buffer = this.buffer.subarray(marker + 4); continue; }
|
|
30
|
-
const length = Number(match[1]);
|
|
31
|
-
const start = marker + 4;
|
|
32
|
-
if (this.buffer.length < start + length) break;
|
|
33
|
-
const body = this.buffer.subarray(start, start + length);
|
|
34
|
-
this.buffer = this.buffer.subarray(start + length);
|
|
35
|
-
try { messages.push(JSON.parse(body.toString("utf8"))); } catch { /* malformed frames are ignored */ }
|
|
36
|
-
}
|
|
37
|
-
return messages;
|
|
38
|
-
}
|
|
39
|
-
}
|
|
40
|
-
|
|
41
|
-
const timeoutMs = Number(env.DAP_TIMEOUT_MS || 15000);
|
|
42
|
-
let transport = null;
|
|
43
|
-
let parser = null;
|
|
44
|
-
let nextSeq = 1;
|
|
45
|
-
let initialized = false;
|
|
46
|
-
let terminated = false;
|
|
47
|
-
let currentStop = null;
|
|
48
|
-
let topFrame = null;
|
|
49
|
-
const pending = new Map();
|
|
50
|
-
const breakpoints = new Map();
|
|
51
|
-
// Event-driven waits. A tight `await setImmediate` busy-loop starves Bun's socket
|
|
52
|
-
// data callbacks (the `initialized` event then never processes and launch deadlocks),
|
|
53
|
-
// so every wait subscribes to the actual DAP event instead of polling state.
|
|
54
|
-
const eventWaiters = new Map();
|
|
55
|
-
function onEvent(name) {
|
|
56
|
-
return new Promise(resolve => {
|
|
57
|
-
const list = eventWaiters.get(name) || [];
|
|
58
|
-
list.push(resolve);
|
|
59
|
-
eventWaiters.set(name, list);
|
|
60
|
-
});
|
|
61
|
-
}
|
|
62
|
-
function emitEvent(name, value) {
|
|
63
|
-
const list = eventWaiters.get(name) || [];
|
|
64
|
-
eventWaiters.delete(name);
|
|
65
|
-
for (const resolve of list) resolve(value);
|
|
66
|
-
}
|
|
67
|
-
function sleep(ms) { return new Promise(resolve => setTimeout(resolve, ms)); }
|
|
68
|
-
|
|
69
|
-
const debugTraffic = Boolean(env.DAP_DEBUG);
|
|
70
|
-
function trace(direction, message) { if (debugTraffic) stderr.write(`DAP ${direction} ${JSON.stringify(message).slice(0, 300)}\n`); }
|
|
71
|
-
function line(text) { stdout.write(`${text}\n`); }
|
|
72
|
-
function error(kind, detail = "") { line(`ERR: ${kind}${detail ? ` ${detail}` : ""}`); }
|
|
73
|
-
function send(message) {
|
|
74
|
-
trace(">", message);
|
|
75
|
-
const body = Buffer.from(JSON.stringify(message));
|
|
76
|
-
transport.write(Buffer.concat([Buffer.from(`Content-Length: ${body.length}\r\n\r\n`), body]));
|
|
77
|
-
}
|
|
78
|
-
function request(command, args = {}) {
|
|
79
|
-
if (!transport || terminated) return Promise.reject(new Error("no-session"));
|
|
80
|
-
const seq = nextSeq++;
|
|
81
|
-
send({ type: "request", seq, command, arguments: args });
|
|
82
|
-
return new Promise((resolve, reject) => {
|
|
83
|
-
const timer = setTimeout(() => { pending.delete(seq); reject(new Error("timeout")); }, timeoutMs);
|
|
84
|
-
pending.set(seq, { resolve: value => { clearTimeout(timer); resolve(value); }, reject: value => { clearTimeout(timer); reject(value); } });
|
|
85
|
-
});
|
|
86
|
-
}
|
|
87
|
-
function onMessage(message) {
|
|
88
|
-
trace("<", message);
|
|
89
|
-
if (message.type === "response") {
|
|
90
|
-
const wait = pending.get(message.request_seq);
|
|
91
|
-
if (!wait) return;
|
|
92
|
-
pending.delete(message.request_seq);
|
|
93
|
-
if (message.success === false) wait.reject(new Error("adapter-error")); else wait.resolve(message);
|
|
94
|
-
} else if (message.type === "event") {
|
|
95
|
-
if (message.event === "initialized") { initialized = true; emitEvent("initialized"); }
|
|
96
|
-
if (message.event === "stopped") { currentStop = message.body || {}; emitEvent("stopped", currentStop); }
|
|
97
|
-
if (message.event === "terminated" || message.event === "exited") { terminated = true; emitEvent("terminated"); }
|
|
98
|
-
}
|
|
99
|
-
}
|
|
100
|
-
function connectTransport(write, read, close = read) {
|
|
101
|
-
transport = { write: chunk => write.write(chunk), destroy: () => close.destroy?.() };
|
|
102
|
-
parser = new DapFrameParser();
|
|
103
|
-
read.on("data", chunk => { for (const message of parser.push(chunk)) onMessage(message); });
|
|
104
|
-
read.on("error", () => { if (!terminated) error("adapter-failed"); });
|
|
105
|
-
read.on("close", () => { if (!terminated) error("adapter-failed"); });
|
|
106
|
-
}
|
|
107
|
-
function connectSocket(socket) { connectTransport(socket, socket, socket); }
|
|
108
|
-
async function startAdapter(spec) {
|
|
109
|
-
if (isTcpAdapterSpec(spec)) {
|
|
110
|
-
const separator = spec.lastIndexOf(":");
|
|
111
|
-
const socket = createConnection(Number(spec.slice(separator + 1)), spec.slice(0, separator));
|
|
112
|
-
connectSocket(socket);
|
|
113
|
-
await new Promise((resolve, reject) => { socket.once("connect", resolve); socket.once("error", reject); });
|
|
114
|
-
} else {
|
|
115
|
-
// A .mjs/.cjs/.ts adapter spec runs under the current Bun/Node runtime (e.g. the
|
|
116
|
-
// fixture adapter); any other spec is an adapter executable (lldb-dap, debugpy, dlv)
|
|
117
|
-
// spawned directly with its own argv.
|
|
118
|
-
const isScript = /\.(mjs|cjs|ts)$/.test(spec);
|
|
119
|
-
const [cmd, argv] = isScript ? [process.execPath, [spec]] : [spec, []];
|
|
120
|
-
const child = spawn(cmd, argv, { stdio: ["pipe", "pipe", "inherit"] });
|
|
121
|
-
connectTransport(child.stdin, child.stdout, child);
|
|
122
|
-
child.on("error", () => error("adapter-failed"));
|
|
123
|
-
}
|
|
124
|
-
}
|
|
125
|
-
// Waits for a stopped event. When `required` is false this is a best-effort grace
|
|
126
|
-
// window (e.g. an optional stop-on-entry); it returns on the first stop OR on timeout
|
|
127
|
-
// without failing, so adapters that run straight to a breakpoint are not broken.
|
|
128
|
-
async function waitForStop(required = true, graceMs) {
|
|
129
|
-
if (currentStop || terminated) return Boolean(currentStop);
|
|
130
|
-
const budget = graceMs ?? timeoutMs;
|
|
131
|
-
await Promise.race([onEvent("stopped"), onEvent("terminated"), sleep(budget)]);
|
|
132
|
-
return Boolean(currentStop);
|
|
133
|
-
}
|
|
134
|
-
// Waits for the adapter's `initialized` event, event-driven (never a busy-loop).
|
|
135
|
-
async function waitInitialized() {
|
|
136
|
-
if (initialized) return;
|
|
137
|
-
await Promise.race([onEvent("initialized"), sleep(timeoutMs)]);
|
|
138
|
-
if (!initialized) throw new Error("timeout");
|
|
139
|
-
}
|
|
140
|
-
// Adapters gate the `initialized` event on a recognized adapterID (debugpy withholds
|
|
141
|
-
// it for unknown IDs, hanging the handshake). Infer a known ID from the adapter spec.
|
|
142
|
-
function adapterIdFor(spec) {
|
|
143
|
-
const base = String(spec).split("/").pop().toLowerCase();
|
|
144
|
-
if (base.includes("debugpy") || base.includes("python")) return "debugpy";
|
|
145
|
-
if (base.includes("lldb")) return "lldb-dap";
|
|
146
|
-
if (base.includes("dlv") || base.includes("delve")) return "dlv";
|
|
147
|
-
if (base.includes("js-debug")) return "js-debug";
|
|
148
|
-
if (base.includes("gdb")) return "gdb";
|
|
149
|
-
return "omo";
|
|
150
|
-
}
|
|
151
|
-
async function launch(adapter, program, args) {
|
|
152
|
-
if (transport) return error("adapter-error", "session already exists");
|
|
153
|
-
try {
|
|
154
|
-
await startAdapter(adapter);
|
|
155
|
-
await request("initialize", { clientID: "omo-dap", adapterID: adapterIdFor(adapter), linesStartAt1: true, columnsStartAt1: true, pathFormat: "path" });
|
|
156
|
-
// Send launch BEFORE awaiting `initialized`: debugpy's adapter defers/flushes the
|
|
157
|
-
// initialized event until further client activity, so waiting for it first
|
|
158
|
-
// deadlocks the handshake. DAP allows launch any time after the initialize
|
|
159
|
-
// response; `initialized` is only required before configurationDone.
|
|
160
|
-
// stopOnEntry yields an initial stopped event with a real threadId, so the client
|
|
161
|
-
// can set breakpoints and inspect from a valid stopped state before continuing.
|
|
162
|
-
// `console: "internalConsole"` is REQUIRED by debugpy (without it the launch never
|
|
163
|
-
// spawns the debug server -> "Server is not available"); lldb-dap ignores it.
|
|
164
|
-
// lldb-dap reports the launch response success unreliably (false even when the
|
|
165
|
-
// process started and stopped); the process/stopped EVENTS are the real signal,
|
|
166
|
-
// so a non-success launch response is tolerated, not fatal.
|
|
167
|
-
await request("launch", { program, args, console: "internalConsole", justMyCode: false, stopOnEntry: true }).catch(() => null);
|
|
168
|
-
await waitInitialized();
|
|
169
|
-
await request("configurationDone").catch(() => null);
|
|
170
|
-
// Best-effort: lldb-dap stops at entry, other adapters run to the first breakpoint.
|
|
171
|
-
await waitForStop(false, 2000);
|
|
172
|
-
line("READY: launch");
|
|
173
|
-
} catch (e) { error(e.message === "timeout" ? "timeout" : e.message === "adapter-error" ? "adapter-error" : "adapter-failed"); }
|
|
174
|
-
}
|
|
175
|
-
async function snapshot() {
|
|
176
|
-
if (terminated) { line("EXIT: terminated"); return; }
|
|
177
|
-
try {
|
|
178
|
-
const response = await request("stackTrace", { threadId: currentStop?.threadId || 1, levels: 1 });
|
|
179
|
-
topFrame = response.body?.stackFrames?.[0];
|
|
180
|
-
const f = topFrame;
|
|
181
|
-
if (f) line(`STOP: stopped reason=${currentStop?.reason || "unknown"} threadId=${currentStop?.threadId || ""} ${f.name} at ${f.source?.path || "?"}:${f.line || 0}:${f.column || 0}`);
|
|
182
|
-
else line(`STOP: stopped reason=${currentStop?.reason || "unknown"} threadId=${currentStop?.threadId || ""} ? at ?:0:0`);
|
|
183
|
-
} catch (e) { error(e.message === "timeout" ? "timeout" : "adapter-error"); }
|
|
184
|
-
}
|
|
185
|
-
function boundedTable(header, rows) {
|
|
186
|
-
const all = rows.map(row => row.join("\t"));
|
|
187
|
-
const chosen = all.slice(0, MAX_ROWS);
|
|
188
|
-
const prefix = `${header.join("\t")}\n`;
|
|
189
|
-
let output = prefix;
|
|
190
|
-
let count = 0;
|
|
191
|
-
for (const row of chosen) {
|
|
192
|
-
const candidate = `${row}\n`;
|
|
193
|
-
if (Buffer.byteLength(output + candidate) > MAX_OUTPUT_BYTES) break;
|
|
194
|
-
output += candidate; count++;
|
|
195
|
-
}
|
|
196
|
-
stdout.write(output);
|
|
197
|
-
const rowDropped = all.length - count;
|
|
198
|
-
const byteDropped = Buffer.byteLength(all.slice(count).join("\n") + (all.length > count ? "\n" : ""));
|
|
199
|
-
if (rowDropped > 0 || byteDropped > 0) line(`TRUNCATED: rows dropped=${rowDropped} bytes dropped=${byteDropped}`);
|
|
200
|
-
}
|
|
201
|
-
async function command(input) {
|
|
202
|
-
const parts = input.trim().split(/\s+/);
|
|
203
|
-
const cmd = parts.shift();
|
|
204
|
-
if (!cmd) return;
|
|
205
|
-
if (cmd === "quit") { transport?.destroy?.(); process.exit(0); }
|
|
206
|
-
if (cmd === "launch") return launch(parts.shift(), parts.shift(), parts);
|
|
207
|
-
if (cmd === "attach") {
|
|
208
|
-
const [host, port] = (parts.shift() || "").split(":");
|
|
209
|
-
try {
|
|
210
|
-
await startAdapter(`${host}:${port}`);
|
|
211
|
-
await request("initialize", { clientID: "omo-dap", adapterID: "debugpy", linesStartAt1: true, columnsStartAt1: true, pathFormat: "path" });
|
|
212
|
-
await waitInitialized();
|
|
213
|
-
await request("attach", { justMyCode: false });
|
|
214
|
-
await request("configurationDone");
|
|
215
|
-
line("READY: attach");
|
|
216
|
-
} catch (e) { error(e.message === "timeout" ? "timeout" : "adapter-failed"); }
|
|
217
|
-
return;
|
|
218
|
-
}
|
|
219
|
-
if (!transport) return error("no-session");
|
|
220
|
-
try {
|
|
221
|
-
if (cmd === "break" || cmd === "rmbreak") {
|
|
222
|
-
const [file, lineNo] = (parts[0] || "").split(":");
|
|
223
|
-
if (!file || !lineNo) return error("invalid-args");
|
|
224
|
-
const set = breakpoints.get(file) || [];
|
|
225
|
-
const next = cmd === "break" ? [...set.filter(x => x.line !== Number(lineNo)), { line: Number(lineNo) }] : set.filter(x => x.line !== Number(lineNo));
|
|
226
|
-
const response = await request("setBreakpoints", { source: { path: file }, breakpoints: next });
|
|
227
|
-
breakpoints.set(file, next);
|
|
228
|
-
if (response.body?.breakpoints?.some(bp => bp.verified === false)) error("unverified-breakpoint"); else line(`BREAK: ${file}:${lineNo}`);
|
|
229
|
-
} else if (["continue", "step", "next", "stepin", "stepout", "pause"].includes(cmd)) {
|
|
230
|
-
const dapCmd = { step: "next", stepin: "stepIn", stepout: "stepOut" }[cmd] || cmd;
|
|
231
|
-
const threadId = currentStop?.threadId || 1;
|
|
232
|
-
currentStop = null;
|
|
233
|
-
await request(dapCmd, { threadId });
|
|
234
|
-
// Wait for the resulting stopped event (breakpoint hit / step completed) before
|
|
235
|
-
// snapshotting; without this the stack is read while the debuggee is still running.
|
|
236
|
-
await waitForStop();
|
|
237
|
-
await snapshot();
|
|
238
|
-
} else if (cmd === "stack") {
|
|
239
|
-
const r = await request("stackTrace", { threadId: currentStop?.threadId || 1, levels: Number(parts[0]) || 100 });
|
|
240
|
-
boundedTable(["FRAME", "NAME", "FILE", "LINE", "COLUMN"], (r.body?.stackFrames || []).map(f => [String(f.id), f.name, f.source?.path || "", String(f.line || ""), String(f.column || "")]));
|
|
241
|
-
} else if (cmd === "scopes") {
|
|
242
|
-
const r = await request("scopes", { frameId: topFrame?.id || 42 });
|
|
243
|
-
boundedTable(["NAME", "VARIABLES_REFERENCE"], (r.body?.scopes || []).map(s => [s.name, String(s.variablesReference)]));
|
|
244
|
-
} else if (cmd === "vars") {
|
|
245
|
-
if (!parts[0]) return error("invalid-args");
|
|
246
|
-
const r = await request("variables", { variablesReference: Number(parts[0]) });
|
|
247
|
-
boundedTable(["NAME", "VALUE"], (r.body?.variables || []).map(v => [v.name, v.value ?? ""]));
|
|
248
|
-
} else if (cmd === "eval") {
|
|
249
|
-
if (!parts.length) return error("invalid-args");
|
|
250
|
-
const r = await request("evaluate", { expression: parts.join(" "), frameId: topFrame?.id || 42 });
|
|
251
|
-
line(`EVAL\t${r.body?.result || ""}`);
|
|
252
|
-
} else if (cmd === "threads") {
|
|
253
|
-
const r = await request("threads"); boundedTable(["ID", "NAME"], (r.body?.threads || []).map(t => [String(t.id), t.name]));
|
|
254
|
-
} else if (cmd === "sessions") line("SESSION\tSTATE\n1\tactive");
|
|
255
|
-
else if (cmd === "terminate") { await request("terminate", { restart: false }); line("EXIT: terminated"); terminated = true; }
|
|
256
|
-
else error("invalid-args");
|
|
257
|
-
} catch (e) { error(e.message === "timeout" ? "timeout" : e.message === "adapter-error" ? "adapter-error" : "adapter-failed"); }
|
|
258
|
-
}
|
|
259
|
-
|
|
260
|
-
if (import.meta.main) {
|
|
261
|
-
// Serialize stdin commands: fire-and-forget (`void command(...)`) lets a `continue`
|
|
262
|
-
// race ahead of the launch handshake's configurationDone, and the adapter then
|
|
263
|
-
// drops or rejects the out-of-order request. Each line awaits the previous command.
|
|
264
|
-
let chain = Promise.resolve();
|
|
265
|
-
const rl = createInterface({ input: stdin, crlfDelay: Infinity });
|
|
266
|
-
rl.on("line", value => { chain = chain.then(() => command(value)).catch(() => {}); });
|
|
267
|
-
}
|