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.
Files changed (142) hide show
  1. package/dist/cli/index.js +141 -184
  2. package/dist/cli-node/index.js +141 -184
  3. package/dist/index.js +1508 -1567
  4. package/dist/skills/debugging/SKILL.md +0 -2
  5. package/dist/skills/debugging/references/methodology/00-setup.md +0 -12
  6. package/dist/skills/debugging/references/methodology/02-investigate.md +0 -21
  7. package/dist/skills/debugging/references/runtimes/go.md +1 -15
  8. package/dist/skills/debugging/references/runtimes/native-binary.md +0 -38
  9. package/dist/skills/debugging/references/runtimes/node.md +0 -25
  10. package/dist/skills/debugging/references/runtimes/python.md +0 -13
  11. package/dist/skills/debugging/references/runtimes/rust.md +0 -41
  12. package/dist/tools/delegate-task/types.d.ts +0 -3
  13. package/dist/tui.js +0 -25
  14. package/package.json +15 -18
  15. package/packages/lsp-core/src/index.ts +0 -1
  16. package/packages/lsp-core/src/lsp/client-wrapper.ts +5 -25
  17. package/packages/lsp-core/src/lsp/client.ts +0 -26
  18. package/packages/lsp-core/src/lsp/connection.ts +0 -16
  19. package/packages/lsp-core/src/lsp/constants.ts +0 -1
  20. package/packages/lsp-core/src/lsp/manager.ts +1 -34
  21. package/packages/lsp-core/src/lsp/server-definitions.ts +0 -29
  22. package/packages/lsp-core/src/lsp/server-installation.ts +27 -200
  23. package/packages/lsp-core/src/lsp/server-resolution.ts +5 -18
  24. package/packages/lsp-core/src/lsp/transport.ts +0 -9
  25. package/packages/lsp-core/src/lsp/types.ts +0 -8
  26. package/packages/lsp-core/src/tool-surface.test.ts +1 -13
  27. package/packages/lsp-core/src/tools/definitions.ts +0 -14
  28. package/packages/lsp-core/src/tools/index.ts +0 -1
  29. package/packages/lsp-core/src/tools/types.ts +0 -10
  30. package/packages/lsp-daemon/dist/cli.js +144 -432
  31. package/packages/lsp-daemon/dist/client.d.ts +0 -10
  32. package/packages/lsp-daemon/dist/client.js +107 -401
  33. package/packages/lsp-daemon/dist/daemon-client.d.ts +0 -1
  34. package/packages/lsp-daemon/dist/daemon-client.js +0 -3
  35. package/packages/lsp-daemon/dist/index.js +107 -395
  36. package/packages/lsp-tools-mcp/dist/cli.js +99 -384
  37. package/packages/lsp-tools-mcp/dist/lsp/manager.js +0 -53
  38. package/packages/lsp-tools-mcp/dist/mcp.js +99 -384
  39. package/packages/lsp-tools-mcp/dist/tools.js +99 -385
  40. package/packages/omo-codex/plugin/.codex-plugin/plugin.json +1 -1
  41. package/packages/omo-codex/plugin/components/bootstrap/dist/cli.js +2 -2
  42. package/packages/omo-codex/plugin/components/bootstrap/hooks/hooks.json +1 -1
  43. package/packages/omo-codex/plugin/components/bootstrap/package.json +1 -1
  44. package/packages/omo-codex/plugin/components/codegraph/dist/cli.js +35 -69
  45. package/packages/omo-codex/plugin/components/codegraph/dist/serve.js +2 -21
  46. package/packages/omo-codex/plugin/components/codegraph/package.json +1 -1
  47. package/packages/omo-codex/plugin/components/comment-checker/hooks/hooks.json +1 -1
  48. package/packages/omo-codex/plugin/components/comment-checker/package.json +1 -1
  49. package/packages/omo-codex/plugin/components/git-bash/hooks/hooks.json +2 -2
  50. package/packages/omo-codex/plugin/components/git-bash/package.json +1 -1
  51. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/hooks/hooks.json +1 -1
  52. package/packages/omo-codex/plugin/components/lazycodex-executor-verify/package.json +1 -1
  53. package/packages/omo-codex/plugin/components/lsp/dist/.omo-runtime-manifest.json +3 -3
  54. package/packages/omo-codex/plugin/components/lsp/dist/cli.js +121 -404
  55. package/packages/omo-codex/plugin/components/lsp/hooks/hooks.json +2 -2
  56. package/packages/omo-codex/plugin/components/lsp/package.json +1 -1
  57. package/packages/omo-codex/plugin/components/rules/dist/cli.js +3 -3
  58. package/packages/omo-codex/plugin/components/rules/hooks/hooks.json +4 -4
  59. package/packages/omo-codex/plugin/components/rules/package.json +1 -1
  60. package/packages/omo-codex/plugin/components/rules/src/post-compact-budget.ts +3 -3
  61. package/packages/omo-codex/plugin/components/rules/test/post-compact-budget.test.ts +4 -4
  62. package/packages/omo-codex/plugin/components/teammode/hooks/hooks.json +1 -1
  63. package/packages/omo-codex/plugin/components/teammode/package.json +1 -1
  64. package/packages/omo-codex/plugin/components/telemetry/dist/cli.js +15 -30
  65. package/packages/omo-codex/plugin/components/telemetry/dist/posthog.js +15 -30
  66. package/packages/omo-codex/plugin/components/telemetry/hooks/hooks.json +1 -1
  67. package/packages/omo-codex/plugin/components/telemetry/package.json +1 -1
  68. package/packages/omo-codex/plugin/components/ultrawork/hooks/hooks.json +1 -1
  69. package/packages/omo-codex/plugin/components/ultrawork/package.json +1 -1
  70. package/packages/omo-codex/plugin/components/ulw-execute-continuation/hooks/hooks.json +2 -2
  71. package/packages/omo-codex/plugin/components/ulw-execute-continuation/package.json +1 -1
  72. package/packages/omo-codex/plugin/components/ulw-loop/hooks/hooks.json +4 -4
  73. package/packages/omo-codex/plugin/components/ulw-loop/package.json +1 -1
  74. package/packages/omo-codex/plugin/hooks/post-compact-resetting-git-bash-mcp-reminder.json +1 -1
  75. package/packages/omo-codex/plugin/hooks/post-compact-resetting-lsp-diagnostics-cache.json +1 -1
  76. package/packages/omo-codex/plugin/hooks/post-compact-resetting-project-rule-cache.json +1 -1
  77. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-codegraph-init-guidance.json +1 -1
  78. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-comments.json +1 -1
  79. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-lsp-diagnostics.json +1 -1
  80. package/packages/omo-codex/plugin/hooks/post-tool-use-checking-thread-title-hygiene.json +1 -1
  81. package/packages/omo-codex/plugin/hooks/post-tool-use-matching-project-rules.json +1 -1
  82. package/packages/omo-codex/plugin/hooks/pre-tool-use-enforcing-unlimited-goal-budget.json +1 -1
  83. package/packages/omo-codex/plugin/hooks/pre-tool-use-guarding-ulw-loop-spawns.json +1 -1
  84. package/packages/omo-codex/plugin/hooks/pre-tool-use-recommending-git-bash-mcp.json +1 -1
  85. package/packages/omo-codex/plugin/hooks/session-start-checking-auto-update.json +1 -1
  86. package/packages/omo-codex/plugin/hooks/session-start-checking-bootstrap-provisioning.json +1 -1
  87. package/packages/omo-codex/plugin/hooks/session-start-checking-codegraph-bootstrap.json +1 -1
  88. package/packages/omo-codex/plugin/hooks/session-start-loading-project-rules.json +1 -1
  89. package/packages/omo-codex/plugin/hooks/session-start-recording-session-telemetry.json +1 -1
  90. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-execute-continuation.json +1 -1
  91. package/packages/omo-codex/plugin/hooks/stop-checking-ulw-loop-resume.json +1 -1
  92. package/packages/omo-codex/plugin/hooks/subagent-stop-checking-ulw-execute-continuation.json +1 -1
  93. package/packages/omo-codex/plugin/hooks/subagent-stop-verifying-lazycodex-executor-evidence.json +1 -1
  94. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ultrawork-trigger.json +1 -1
  95. package/packages/omo-codex/plugin/hooks/user-prompt-submit-checking-ulw-loop-steering.json +1 -1
  96. package/packages/omo-codex/plugin/hooks/user-prompt-submit-loading-project-rules.json +1 -1
  97. package/packages/omo-codex/plugin/model-catalog.json +3 -3
  98. package/packages/omo-codex/plugin/package-lock.json +13 -13
  99. package/packages/omo-codex/plugin/package.json +1 -1
  100. package/packages/omo-codex/plugin/scripts/migrate-codex-config/catalog.mjs +3 -3
  101. package/packages/omo-codex/plugin/skills/debugging/SKILL.md +0 -2
  102. package/packages/omo-codex/plugin/skills/debugging/references/methodology/00-setup.md +0 -12
  103. package/packages/omo-codex/plugin/skills/debugging/references/methodology/02-investigate.md +0 -21
  104. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/go.md +1 -15
  105. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/native-binary.md +0 -38
  106. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/node.md +0 -25
  107. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/python.md +0 -13
  108. package/packages/omo-codex/plugin/skills/debugging/references/runtimes/rust.md +0 -41
  109. package/packages/omo-codex/plugin/test/aggregate-model-catalog.test.mjs +1 -1
  110. package/packages/omo-codex/plugin/test/auto-update.test.mjs +2 -2
  111. package/packages/omo-codex/plugin/test/migrate-codex-config.test.mjs +8 -8
  112. package/packages/omo-codex/scripts/install-config-reasoning.test.mjs +2 -2
  113. package/packages/omo-codex/scripts/install-dist/install-local.mjs +23 -38
  114. package/packages/shared-skills/skills/debugging/SKILL.md +0 -2
  115. package/packages/shared-skills/skills/debugging/references/methodology/00-setup.md +0 -12
  116. package/packages/shared-skills/skills/debugging/references/methodology/02-investigate.md +0 -21
  117. package/packages/shared-skills/skills/debugging/references/runtimes/go.md +1 -15
  118. package/packages/shared-skills/skills/debugging/references/runtimes/native-binary.md +0 -38
  119. package/packages/shared-skills/skills/debugging/references/runtimes/node.md +0 -25
  120. package/packages/shared-skills/skills/debugging/references/runtimes/python.md +0 -13
  121. package/packages/shared-skills/skills/debugging/references/runtimes/rust.md +0 -41
  122. package/dist/skills/debugging/references/scripts/dap.mjs +0 -267
  123. package/dist/skills/debugging/references/scripts/dap.test.ts +0 -86
  124. package/dist/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
  125. package/dist/skills/debugging/references/tools/dap.md +0 -103
  126. package/dist/skills/debugging/references/tools/frida.md +0 -193
  127. package/packages/lsp-core/src/lsp/format-document.test.ts +0 -143
  128. package/packages/lsp-core/src/lsp/format-document.ts +0 -90
  129. package/packages/lsp-core/src/lsp/manager-max-clients.test.ts +0 -151
  130. package/packages/lsp-core/src/lsp/server-installation.test.ts +0 -376
  131. package/packages/lsp-core/src/lsp/server-resolution-local-binary.test.ts +0 -170
  132. package/packages/lsp-core/src/tools/format.test.ts +0 -56
  133. package/packages/lsp-core/src/tools/format.ts +0 -56
  134. package/packages/omo-codex/plugin/skills/debugging/references/scripts/dap.mjs +0 -267
  135. package/packages/omo-codex/plugin/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
  136. package/packages/omo-codex/plugin/skills/debugging/references/tools/dap.md +0 -103
  137. package/packages/omo-codex/plugin/skills/debugging/references/tools/frida.md +0 -193
  138. package/packages/shared-skills/skills/debugging/references/scripts/dap.mjs +0 -267
  139. package/packages/shared-skills/skills/debugging/references/scripts/dap.test.ts +0 -86
  140. package/packages/shared-skills/skills/debugging/references/scripts/fixture-adapter.mjs +0 -59
  141. package/packages/shared-skills/skills/debugging/references/tools/dap.md +0 -103
  142. 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:819e258f7485f9ccdcbb64a54ac0097bf81cd8e2980d7f907017f224b1f99b98:0211b93be64998d1b34d67c74053ea385a23fa560370b8d02016f46f492cfbe3
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 platform = options.platform ?? process.platform;
72
- const fsyncImpl = options.fsyncSync ?? fsyncSync;
73
- const tempPath = `${filePath}.${process.pid}.${randomUUID()}.tmp`;
68
+ const tempPath = `${filePath}.tmp`;
69
+ writeFileSync(tempPath, content, "utf-8");
70
+ const tempFileDescriptor = openSync(tempPath, "r+");
74
71
  try {
75
- writeFileSync(tempPath, content, "utf-8");
76
- const tempFileDescriptor = openSync(tempPath, "r+");
77
- try {
78
- tolerantFsyncSync(tempFileDescriptor, fsyncImpl);
79
- } finally {
80
- closeSync(tempFileDescriptor);
81
- }
82
- try {
83
- renameSync(tempPath, filePath);
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
- } finally {
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 dirname11, posix as posix2, sep as sep7 } from "node:path";
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] ? dirname11(process.argv[1]) : process.cwd(), isWindows = sep7 === "\\") {
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.23",
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 dirname13, join as join40, resolve as resolve10 } from "node:path";
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: 650000,
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: 650000,
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 dirname12, join as join38 } from "node:path";
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 = dirname12(dirname12(fileURLToPath(import.meta.url)));
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(dirname13(entrypointPath), "..", "..", "..");
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
- # Delve's JSON-RPC API (IDE / remote attach) — default port 2345
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
- }