Method execute

src/tools/diagnostics/diagnostics-tool.ts:37–92

(args: z.infer<typeof DiagnosticsArgs>, ctx: ToolContext)

  argsSchema = DiagnosticsArgs;

  async execute(args: z.infer<typeof DiagnosticsArgs>, ctx: ToolContext): Promise<ToolResult> {
    const root = args.path ? path.resolve(ctx.cwd, args.path) : ctx.cwd;
    const maxResults = args.max_results ?? 50;
    const timeoutMs = args.timeout_ms ?? 120_000;
    const want = args.checker ?? 'auto';

    const files = await detectProjectFiles(root);

    let spec: CheckerSpec | undefined;
    if (want !== 'auto') {
      spec = CHECKERS.find(c => c.id === want);
    } else {
      spec = pickChecker(files);
    }

    if (!spec) {
      return {
        content: `[DIAGNOSTICS_NO_CHECKER] No supported checker detected in ${root}. ` +
          `Looked for: tsconfig.json (tsc), pyproject.toml/requirements.txt (ruff/pyright), ` +
          `go.mod (go vet), Cargo.toml (cargo), eslint config (eslint). ` +
          `Pass checker="tsc" (or another) explicitly if the project uses one without a standard config file.`,
        isError: true,
      };
    }

    const res = await runChecker(spec.argv, root, timeoutMs, ctx.signal);

    if (res.spawnError || res.code === 127) {
      const bin = spec.argv[0] === 'npx' ? spec.argv[2] : spec.argv[0];
      return {
        content: `[DIAGNOSTICS_TOOL_MISSING] Could not run '${spec.id}': ${res.spawnError ?? 'command not found'}. ` +
          `Install it (e.g. \`${bin}\`) or choose a different checker. ` +
          `tsc/eslint come from your project's devDependencies (\`npm i\`); ruff/pyright via pip; go/cargo with their toolchains.`,
        isError: true,
      };
    }

    const text = checkerText(spec, res);

    let diags: Diagnostic[];
    try {
      diags = spec.parse(text);
    } catch (e: any) {
      const raw = (text || res.stderr || res.stdout || '').slice(0, 4000);
      return {
        content: `[DIAGNOSTICS_PARSE_NOTE] Ran ${spec.id} (exit ${res.code}) but couldn't parse structured output: ${e?.message}. Raw output:\n\n${raw}`,
        isError: res.code !== 0,
      };
    }

    return {
      content: formatDiagnostics(diags, { checker: spec.id, maxResults }),
      isError: false,
      metadata: { checker: spec.id, total: diags.length, errors: diags.filter(d => d.severity === 'error').length, exitCode: res.code },
    };
  }
}