Function readJsonOrNull

src/tools/codegraph/project-overview.ts:142–152

* Reads + parses a JSON config. Returns null when the file is simply absent * (ENOENT), but on a real parse failure logs a warning and records the path in * `unparseable` so the caller can surface the corruption instead of silently * misreporting the tech stack as "config absent".

(filePath: string, unparseable?: string[])

 * misreporting the tech stack as "config absent".
 */
async function readJsonOrNull(filePath: string, unparseable?: string[]): Promise<any> {
  try {
    return JSON.parse(await fs.readFile(filePath, 'utf-8'));
  } catch (err: any) {
    if (err?.code !== 'ENOENT') {
      logger.warn(`Failed to parse ${filePath}: ${err?.message ?? err}`);
      unparseable?.push(filePath);
    }
    return null;
  }
}

export class ProjectOverviewTool extends Tool<z.infer<typeof ProjectOverviewArgs>> {
  name = 'project_overview';