Function explore

__tests__/explore-declaration-only.test.ts:60–73

(query: string)

  /** One explore call; returns its diagnostic report plus the response text. */
  const explore = async (query: string): Promise<{ report: ExploreDiagnosticReport; text: string }> => {
    fs.rmSync(sidecar, { force: true });
    const previous = process.env.CODEGRAPH_EXPLORE_DEBUG;
    process.env.CODEGRAPH_EXPLORE_DEBUG = sidecar;
    let text: string;
    try {
      text = (await new ToolHandler(cg).execute('codegraph_explore', { query })).content?.[0]?.text ?? '';
    } finally {
      if (previous === undefined) delete process.env.CODEGRAPH_EXPLORE_DEBUG;
      else process.env.CODEGRAPH_EXPLORE_DEBUG = previous;
    }
    const written = fs.readFileSync(sidecar, 'utf-8').trim().split('\n').filter(Boolean);
    return { report: JSON.parse(written[written.length - 1]!) as ExploreDiagnosticReport, text };
  };

  const fileOf = (report: ExploreDiagnosticReport, p: string): ExploreDiagnosticFile | undefined =>
    report.files.find((f) => f.path === p);