dap-mcp-server 0.1.12 → 0.1.17

package/build/adapters/recipes.js

@@ -0,0 +1,128 @@
+/**
+ * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { execFile } from "node:child_process";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { promisify } from "node:util";
+const execFileAsync = promisify(execFile);
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+let rustSysroot;
+function findRustSysroot() {
+    rustSysroot ??= execFileAsync("rustc", ["--print", "sysroot"])
+        .then(({ stdout }) => stdout.trim() || undefined)
+        .catch(() => undefined);
+    return rustSysroot;
+}
+/**
+ * The LLDB commands `rust-lldb` runs before loading a binary. Without them
+ * lldb-dap shows `String`, `&str`, `Vec` and `HashMap` as raw structs.
+ */
+async function rustFormatterCommands(sysroot) {
+    if (!sysroot)
+        return [];
+    const etc = path.join(sysroot, "lib", "rustlib", "etc");
+    const lookup = path.join(etc, "lldb_lookup.py");
+    if (!(await exists(lookup)))
+        return [];
+    const commands = [`command script import "${lookup}"`];
+    // Older toolchains register the type summaries from a separate command file.
+    const legacyCommands = path.join(etc, "lldb_commands");
+    if (await exists(legacyCommands))
+        commands.push(`command source -s 0 "${legacyCommands}"`);
+    return commands;
+}
+/**
+ * Build the DAP launch arguments shared by debug_launch, debug_inspect/debug_at
+ * and debug_run. Merge order: adapter launchDefaults < launchConfig < explicit
+ * common fields, then per-adapter recipes that a caller would otherwise have
+ * to know by heart.
+ */
+export async function buildLaunchArgs(config, opts, resolveRustSysroot = findRustSysroot) {
+    const launchArgs = {
+        ...config.launchDefaults,
+        ...opts.launchConfig,
+        stopOnEntry: opts.stopOnEntry,
+    };
+    if (opts.program !== undefined)
+        launchArgs.program = opts.program;
+    if (opts.args !== undefined)
+        launchArgs.args = opts.args;
+    if (opts.cwd !== undefined)
+        launchArgs.cwd = opts.cwd;
+    if (opts.env !== undefined)
+        launchArgs.env = opts.env;
+    // delve's `cwd` is the debuggee's working directory; the *build* (go build)
+    // runs from delve's own process cwd, controlled by `dlvCwd`. Mirror
+    // cwd → dlvCwd so a user-supplied cwd is found by `go build` looking for go.mod.
+    if (config.type === "go" && opts.cwd !== undefined && launchArgs.dlvCwd === undefined) {
+        launchArgs.dlvCwd = opts.cwd;
+    }
+    const involvesRust = (opts.sourceFiles ?? []).some((file) => path.extname(file).toLowerCase() === ".rs");
+    if (config.type === "cppdbg" && involvesRust) {
+        const existing = Array.isArray(launchArgs.initCommands)
+            ? launchArgs.initCommands.map(String)
+            : [];
+        if (!existing.some((command) => command.includes("lldb_lookup"))) {
+            const formatters = await rustFormatterCommands(await resolveRustSysroot());
+            if (formatters.length > 0)
+                launchArgs.initCommands = [...existing, ...formatters];
+        }
+    }
+    return launchArgs;
+}
+/** `target/debug/<package name>` of the Cargo project in cwd, once it has been built. */
+export async function defaultCargoProgram(cwd) {
+    const manifest = await fs.readFile(path.join(cwd, "Cargo.toml"), "utf8").catch(() => undefined);
+    const name = manifest?.match(/^\s*\[package\][^[]*?^\s*name\s*=\s*"([^"]+)"/ms)?.[1];
+    if (!name)
+        return undefined;
+    const binary = path.join(cwd, "target", "debug", process.platform === "win32" ? `${name}.exe` : name);
+    return (await exists(binary)) ? binary : undefined;
+}
+const LAUNCH_FAILURE_HINTS = {
+    php: "PHP ran without xdebug connecting to the adapter. Check that xdebug 3 is loaded in the CLI (php -m | grep -i xdebug) " +
+        "and that launchConfig.runtimeArgs still enables it (-dxdebug.mode=debug -dxdebug.start_with_request=yes).",
+};
+/** Why a program may have run to completion without the debugger ever binding a breakpoint. */
+export function launchFailureHint(adapterType) {
+    return LAUNCH_FAILURE_HINTS[adapterType];
+}
+const ADAPTER_USAGE_NOTES = {
+    cppdbg: "Compile with debug info (-g -O0) and pass the executable as program.",
+    rust: "Build with `cargo build`; debug_at defaults program to target/debug/<package name> and loads the Rust LLDB formatters.",
+    php: "Needs xdebug 3 in the PHP CLI; the xdebug runtimeArgs are supplied by the adapter's launchDefaults.",
+    java: "Start the JVM with -agentlib:jdwp=transport=dt_socket,server=y,suspend=y,address=127.0.0.1:5005, " +
+        "then call debug_attach with port and breakpoints so they bind before the VM resumes.",
+};
+/** How to get a first stop with this language/adapter; surfaced by debug_doctor. */
+export function adapterUsageNote(languageOrAdapter) {
+    return ADAPTER_USAGE_NOTES[languageOrAdapter];
+}
+//# sourceMappingURL=recipes.js.map

package/build/adapters/recipes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recipes.js","sourceRoot":"","sources":["../../src/adapters/recipes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAGtC,MAAM,aAAa,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;AAc1C,KAAK,UAAU,MAAM,CAAC,QAAgB;IACpC,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,WAAoD,CAAC;AAEzD,SAAS,eAAe;IACtB,WAAW,KAAK,aAAa,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;SAC3D,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;SAChD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAC1B,OAAO,WAAW,CAAC;AACrB,CAAC;AAED;;;GAGG;AACH,KAAK,UAAU,qBAAqB,CAAC,OAA2B;IAC9D,IAAI,CAAC,OAAO;QAAE,OAAO,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,gBAAgB,CAAC,CAAC;IAChD,IAAI,CAAC,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IACvC,MAAM,QAAQ,GAAG,CAAC,0BAA0B,MAAM,GAAG,CAAC,CAAC;IACvD,6EAA6E;IAC7E,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;IACvD,IAAI,MAAM,MAAM,CAAC,cAAc,CAAC;QAAE,QAAQ,CAAC,IAAI,CAAC,wBAAwB,cAAc,GAAG,CAAC,CAAC;IAC3F,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAqB,EACrB,IAAsB,EACtB,qBAAwD,eAAe;IAEvE,MAAM,UAAU,GAA4B;QAC1C,GAAG,MAAM,CAAC,cAAc;QACxB,GAAG,IAAI,CAAC,YAAY;QACpB,WAAW,EAAE,IAAI,CAAC,WAAW;KAC9B,CAAC;IACF,IAAI,IAAI,CAAC,OAAO,KAAK,SAAS;QAAE,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;IAClE,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS;QAAE,UAAU,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;IACzD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACtD,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS;QAAE,UAAU,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAEtD,4EAA4E;IAC5E,oEAAoE;IACpE,iFAAiF;IACjF,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,UAAU,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACtF,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC;IAC/B,CAAC;IAED,MAAM,YAAY,GAAG,CAAC,IAAI,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAChD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CACrD,CAAC;IACF,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,YAAY,EAAE,CAAC;QAC7C,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC;YACrD,CAAC,CAAE,UAAU,CAAC,YAA0B,CAAC,GAAG,CAAC,MAAM,CAAC;YACpD,CAAC,CAAC,EAAE,CAAC;QACP,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC;YACjE,MAAM,UAAU,GAAG,MAAM,qBAAqB,CAAC,MAAM,kBAAkB,EAAE,CAAC,CAAC;YAC3E,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC;gBAAE,UAAU,CAAC,YAAY,GAAG,CAAC,GAAG,QAAQ,EAAE,GAAG,UAAU,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,GAAW;IACnD,MAAM,QAAQ,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;IAChG,MAAM,IAAI,GAAG,QAAQ,EAAE,KAAK,CAAC,iDAAiD,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACrF,IAAI,CAAC,IAAI;QAAE,OAAO,SAAS,CAAC;IAC5B,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IACtG,OAAO,CAAC,MAAM,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AACrD,CAAC;AAED,MAAM,oBAAoB,GAA2B;IACnD,GAAG,EACD,uHAAuH;QACvH,2GAA2G;CAC9G,CAAC;AAEF,+FAA+F;AAC/F,MAAM,UAAU,iBAAiB,CAAC,WAAmB;IACnD,OAAO,oBAAoB,CAAC,WAAW,CAAC,CAAC;AAC3C,CAAC;AAED,MAAM,mBAAmB,GAA2B;IAClD,MAAM,EAAE,sEAAsE;IAC9E,IAAI,EAAE,wHAAwH;IAC9H,GAAG,EAAE,qGAAqG;IAC1G,IAAI,EACF,mGAAmG;QACnG,sFAAsF;CACzF,CAAC;AAEF,oFAAoF;AACpF,MAAM,UAAU,gBAAgB,CAAC,iBAAyB;IACxD,OAAO,mBAAmB,CAAC,iBAAiB,CAAC,CAAC;AAChD,CAAC"}

package/build/adapters/registry.js

@@ -34,24 +34,47 @@ export class AdapterRegistry {
         this.builtins = new Map(BUILTIN_ADAPTERS.map((a) => [a.type, a]));
     }
     get(type) {
-        return this.project.get(type) ?? this.global.get(type) ?? this.builtins.get(type);
+        const builtin = this.builtins.get(type);
+        const global = this.global.get(type);
+        const project = this.project.get(type);
+        if (!builtin && !global && !project)
+            return undefined;
+        const merged = {};
+        for (const layer of [builtin, global, project]) {
+            if (!layer)
+                continue;
+            for (const [key, value] of Object.entries(layer)) {
+                if (value !== undefined && key !== "launchDefaults") {
+                    merged[key] = value;
+                }
+            }
+        }
+        merged.launchDefaults = {
+            ...builtin?.launchDefaults,
+            ...global?.launchDefaults,
+            ...project?.launchDefaults,
+        };
+        return merged;
     }
     register(config, scope = "project") {
         const map = scope === "global" ? this.global : this.project;
         map.set(config.type, config);
     }
     listAll() {
-        const result = new Map();
-        for (const [type, config] of this.builtins) {
-            result.set(type, { ...config, source: "builtin" });
-        }
-        for (const [type, config] of this.global) {
-            result.set(type, { ...config, source: "global" });
-        }
-        for (const [type, config] of this.project) {
-            result.set(type, { ...config, source: "project" });
-        }
-        return Array.from(result.values());
+        const types = new Set([
+            ...this.builtins.keys(),
+            ...this.global.keys(),
+            ...this.project.keys(),
+        ]);
+        return Array.from(types, (type) => {
+            const config = this.get(type);
+            const source = this.project.has(type)
+                ? "project"
+                : this.global.has(type)
+                    ? "global"
+                    : "builtin";
+            return { ...config, source };
+        });
     }
     async load() {
         this.global = await this.loadFile(path.join(this.globalDir, "adapters.json"));

package/build/adapters/registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"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"}

package/build/dap/types.d.ts

@@ -54,7 +54,27 @@ export interface StoppedState {
         name: string;
         variables: Variable[];
     }>;
+    /** Scopes the adapter offers but that were not fetched (e.g. CPU registers). */
+    omittedScopes?: string[];
+    /** Present when `reason` is "exception". */
+    exception?: ExceptionDetails;
+    /** Output not yet reported by an earlier state, newest entries last. */
     output?: string[];
+    /** Number of older unreported entries dropped from `output`; get_output has them. */
+    outputOmitted?: number;
+}
+export interface ExceptionDetails {
+    id?: string;
+    description?: string;
+    breakMode?: string;
+}
+export interface CollectStateOptions {
+    /** Scope names to fetch (case-insensitive). Default: every scope except CPU registers. */
+    scopes?: string[];
+    /** Also skip global/static/expensive scopes; used by compact responses. */
+    localsOnly?: boolean;
+    /** Mark the returned output as reported, so the next state only carries newer output. */
+    consumeOutput?: boolean;
 }
 export interface RunningState {
     status: "running";

package/build/diagnostics/doctor.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import { AdapterRegistry } from "../adapters/registry.js";
+import { AdapterConfig } from "../dap/types.js";
+export interface ProjectSignals {
+    languages: string[];
+    testFrameworks: string[];
+    packageManager?: string;
+    pythonPath?: string;
+    launchJson?: string;
+}
+export interface DoctorAdapter {
+    type: string;
+    source: "builtin" | "global" | "project";
+    selected: boolean;
+    available: boolean;
+    command: string;
+    reason?: string;
+    installHint?: string;
+    runtime?: string;
+    program: string;
+    transport: "stdio" | "tcp";
+}
+export interface DoctorResult {
+    cwd: string;
+    ready: boolean;
+    recommendedAdapter?: string;
+    detected: ProjectSignals;
+    /** The selected adapter only, unless the caller asked for a verbose report. */
+    adapters: DoctorAdapter[];
+    /** Compact roster of the adapters left out of `adapters`, e.g. "go (missing)". */
+    otherAdapters?: string[];
+    nextSteps: string[];
+}
+export interface ResolvedProjectAdapter {
+    result: DoctorResult;
+    config?: AdapterConfig;
+}
+export declare function detectProjectSignals(cwd: string, sourceFile?: string): Promise<ProjectSignals>;
+export declare function resolveProjectAdapter(registry: AdapterRegistry, options?: {
+    cwd?: string;
+    adapter?: string;
+    sourceFile?: string;
+}): Promise<ResolvedProjectAdapter>;
+/** Drop the per-adapter detail an agent rarely needs, keeping a one-line roster. */
+export declare function conciseDoctorResult(result: DoctorResult): DoctorResult;
+export declare function runDebugDoctor(registry: AdapterRegistry, options?: {
+    cwd?: string;
+    adapter?: string;
+    verbose?: boolean;
+}): Promise<DoctorResult>;

package/build/diagnostics/doctor.js

@@ -0,0 +1,268 @@
+/**
+ * Copyright (c) 2026 Ivan Iraci <ivan.iraci@professioneit.com>
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining a copy
+ * of this software and associated documentation files (the "Software"), to deal
+ * in the Software without restriction, including without limitation the rights
+ * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+ * copies of the Software, and to permit persons to whom the Software is
+ * furnished to do so, subject to the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be included in
+ * all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+ * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+ * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+ * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+ * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+ * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+ * SOFTWARE.
+ */
+import fs from "node:fs/promises";
+import path from "node:path";
+import { inspectAdapterAvailability } from "../adapters/detect.js";
+import { adapterUsageNote } from "../adapters/recipes.js";
+async function exists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function firstExisting(paths) {
+    for (const candidate of paths) {
+        if (await exists(candidate))
+            return candidate;
+    }
+    return undefined;
+}
+async function readPackageJson(cwd) {
+    try {
+        return JSON.parse(await fs.readFile(path.join(cwd, "package.json"), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+}
+function packageNames(pkg) {
+    const names = new Set();
+    for (const key of ["dependencies", "devDependencies", "peerDependencies"]) {
+        const deps = pkg?.[key];
+        if (deps && typeof deps === "object") {
+            for (const name of Object.keys(deps))
+                names.add(name);
+        }
+    }
+    return names;
+}
+const EXTENSION_LANGUAGES = {
+    ".py": "python",
+    ".js": "node",
+    ".jsx": "node",
+    ".mjs": "node",
+    ".cjs": "node",
+    ".ts": "node",
+    ".tsx": "node",
+    ".go": "go",
+    ".c": "cppdbg",
+    ".cc": "cppdbg",
+    ".cpp": "cppdbg",
+    ".cxx": "cppdbg",
+    ".h": "cppdbg",
+    ".hpp": "cppdbg",
+    ".rs": "rust",
+    ".php": "php",
+    ".java": "java",
+};
+const MANIFEST_LANGUAGES = [
+    ["pyproject.toml", "python"],
+    ["requirements.txt", "python"],
+    ["setup.py", "python"],
+    ["go.mod", "go"],
+    ["Cargo.toml", "rust"],
+    ["composer.json", "php"],
+    ["pom.xml", "java"],
+    ["build.gradle", "java"],
+    ["build.gradle.kts", "java"],
+    ["CMakeLists.txt", "cppdbg"],
+];
+/** Languages debugged through an adapter whose type differs from the language name. */
+const LANGUAGE_ADAPTERS = {
+    rust: "cppdbg",
+};
+function languageOf(filePath) {
+    return EXTENSION_LANGUAGES[path.extname(filePath).toLowerCase()];
+}
+/**
+ * Fallback for manifest-less projects (scripts, pet projects): rank languages
+ * by how many source files sit in cwd and cwd/src.
+ */
+async function looseSourceLanguages(cwd) {
+    const counts = new Map();
+    for (const dir of [cwd, path.join(cwd, "src")]) {
+        const entries = await fs.readdir(dir, { withFileTypes: true }).catch(() => []);
+        for (const entry of entries) {
+            const language = entry.isFile() ? languageOf(entry.name) : undefined;
+            if (language)
+                counts.set(language, (counts.get(language) ?? 0) + 1);
+        }
+    }
+    return Array.from(counts.entries())
+        .sort((a, b) => b[1] - a[1])
+        .map(([language]) => language);
+}
+export async function detectProjectSignals(cwd, sourceFile) {
+    const languages = new Set();
+    const testFrameworks = new Set();
+    const sourceLanguage = sourceFile ? languageOf(sourceFile) : undefined;
+    if (sourceLanguage)
+        languages.add(sourceLanguage);
+    for (const [manifest, language] of MANIFEST_LANGUAGES) {
+        if (await exists(path.join(cwd, manifest)))
+            languages.add(language);
+    }
+    const pkg = await readPackageJson(cwd);
+    const deps = packageNames(pkg);
+    if (pkg)
+        languages.add("node");
+    if (languages.size === 0) {
+        for (const language of await looseSourceLanguages(cwd))
+            languages.add(language);
+    }
+    if (deps.has("vitest"))
+        testFrameworks.add("vitest");
+    if (deps.has("jest") || deps.has("@jest/core"))
+        testFrameworks.add("jest");
+    if (deps.has("mocha"))
+        testFrameworks.add("mocha");
+    if (languages.has("python"))
+        testFrameworks.add("pytest-compatible");
+    if (languages.has("go"))
+        testFrameworks.add("go-test");
+    let packageManager;
+    if (await exists(path.join(cwd, "pnpm-lock.yaml")))
+        packageManager = "pnpm";
+    else if (await exists(path.join(cwd, "yarn.lock")))
+        packageManager = "yarn";
+    else if (await exists(path.join(cwd, "bun.lockb")))
+        packageManager = "bun";
+    else if (await exists(path.join(cwd, "package-lock.json")))
+        packageManager = "npm";
+    const pythonPath = await firstExisting(process.platform === "win32"
+        ? [path.join(cwd, ".venv", "Scripts", "python.exe"), path.join(cwd, "venv", "Scripts", "python.exe")]
+        : [path.join(cwd, ".venv", "bin", "python"), path.join(cwd, "venv", "bin", "python")]);
+    const launchJsonPath = path.join(cwd, ".vscode", "launch.json");
+    const launchJson = (await exists(launchJsonPath)) ? launchJsonPath : undefined;
+    return {
+        languages: Array.from(languages),
+        testFrameworks: Array.from(testFrameworks),
+        packageManager,
+        pythonPath,
+        launchJson,
+    };
+}
+async function resolveNodeProgram(cwd) {
+    return firstExisting([
+        path.join(cwd, "node_modules", "@vscode", "js-debug", "src", "dapDebugServer.js"),
+        path.join(cwd, "node_modules", "@vscode", "js-debug", "dist", "src", "dapDebugServer.js"),
+        path.join(cwd, "node_modules", "vscode-js-debug", "src", "dapDebugServer.js"),
+    ]);
+}
+function preferredAdapter(signals, sourceFile) {
+    const language = (sourceFile ? languageOf(sourceFile) : undefined) ?? signals.languages[0];
+    return language ? LANGUAGE_ADAPTERS[language] ?? language : undefined;
+}
+export async function resolveProjectAdapter(registry, options = {}) {
+    const cwd = path.resolve(options.cwd ?? process.cwd());
+    const stat = await fs.stat(cwd).catch(() => undefined);
+    if (!stat?.isDirectory())
+        throw new Error(`Working directory '${cwd}' does not exist.`);
+    const detected = await detectProjectSignals(cwd, options.sourceFile);
+    const recommendedAdapter = options.adapter ?? preferredAdapter(detected, options.sourceFile);
+    const adapters = [];
+    const configs = new Map();
+    for (const adapter of registry.listAll()) {
+        const { source: _source, ...baseConfig } = adapter;
+        let config = baseConfig;
+        if (adapter.type === "python" && detected.pythonPath) {
+            config = { ...config, runtime: detected.pythonPath };
+        }
+        if (adapter.type === "node") {
+            const configured = await inspectAdapterAvailability(config);
+            if (!configured.available) {
+                const nodeProgram = await resolveNodeProgram(cwd);
+                if (nodeProgram)
+                    config = { ...config, program: nodeProgram };
+            }
+        }
+        configs.set(adapter.type, config);
+        const availability = await inspectAdapterAvailability(config);
+        adapters.push({
+            type: adapter.type,
+            source: adapter.source,
+            selected: adapter.type === recommendedAdapter,
+            available: availability.available,
+            command: availability.command,
+            reason: availability.reason,
+            installHint: adapter.installHint,
+            runtime: config.runtime,
+            program: config.program,
+            transport: config.transport ?? "stdio",
+        });
+    }
+    const selected = adapters.find((adapter) => adapter.selected);
+    const nextSteps = [];
+    if (!recommendedAdapter) {
+        nextSteps.push("Specify an adapter explicitly; no supported project language was detected.");
+    }
+    else if (!selected) {
+        nextSteps.push(`Configure adapter '${recommendedAdapter}' with configure_adapter.`);
+    }
+    else if (!selected.available) {
+        if (selected.reason)
+            nextSteps.push(selected.reason);
+        if (selected.installHint)
+            nextSteps.push(selected.installHint);
+        if (recommendedAdapter === "python" && detected.pythonPath) {
+            nextSteps.push(`Install debugpy in the project environment: ${detected.pythonPath} -m pip install debugpy`);
+        }
+    }
+    if (selected?.available) {
+        // Rust rides on cppdbg, so look the note up by language before adapter.
+        const language = detected.languages.find((name) => (LANGUAGE_ADAPTERS[name] ?? name) === selected.type && adapterUsageNote(name));
+        const note = adapterUsageNote(language ?? selected.type);
+        if (note)
+            nextSteps.push(note);
+    }
+    if (detected.launchJson) {
+        nextSteps.push(`A launch configuration is available at ${detected.launchJson}; pass its adapter-specific fields through launchConfig when needed.`);
+    }
+    return {
+        result: {
+            cwd,
+            ready: selected?.available ?? false,
+            recommendedAdapter,
+            detected,
+            adapters,
+            nextSteps,
+        },
+        config: recommendedAdapter ? configs.get(recommendedAdapter) : undefined,
+    };
+}
+/** Drop the per-adapter detail an agent rarely needs, keeping a one-line roster. */
+export function conciseDoctorResult(result) {
+    const others = result.adapters.filter((adapter) => !adapter.selected);
+    return {
+        ...result,
+        adapters: result.adapters.filter((adapter) => adapter.selected),
+        otherAdapters: others.map((adapter) => adapter.available ? adapter.type : `${adapter.type} (missing)`),
+    };
+}
+export async function runDebugDoctor(registry, options = {}) {
+    const { result } = await resolveProjectAdapter(registry, options);
+    return options.verbose ? result : conciseDoctorResult(result);
+}
+//# sourceMappingURL=doctor.js.map

package/build/diagnostics/doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.js","sourceRoot":"","sources":["../../src/diagnostics/doctor.ts"],"names":[],"mappings":"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"}