Method execute

src/tools/codegraph/project-overview.ts:161–283

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

  argsSchema = ProjectOverviewArgs;

  async execute(args: z.infer<typeof ProjectOverviewArgs>, ctx: ToolContext): Promise<ToolResult> {
    const root = args.path ? path.resolve(ctx.cwd, args.path) : ctx.cwd;
    const maxFiles = args.max_files ?? 10_000;
    const { files, truncated } = await walkDir(root, maxFiles);

    const lines: string[] = [];
    lines.push(`# Project Overview: ${path.basename(root)}`);
    lines.push(`Path: ${root}`);
    lines.push(`Files scanned: ${files.length}${truncated ? ' (truncated)' : ''}`);
    lines.push('');

    // Language stats
    const langs = detectLanguages(files);
    const langList = Object.entries(langs)
      .sort((a, b) => b[1].lines - a[1].lines)
      .slice(0, 10);
    lines.push('## Languages (by total lines)');
    for (const [lang, s] of langList) {
      lines.push(`  ${lang.padEnd(15)} ${s.files.toLocaleString().padStart(6)} files, ${s.lines.toLocaleString()} lines`);
    }
    lines.push('');

    // package.json info
    const unparseable: string[] = [];
    const pkg = await readJsonOrNull(path.join(root, 'package.json'), unparseable);
    if (unparseable.length > 0) {
      lines.push('## ⚠ Unparseable config files');
      lines.push('  The following config files exist but could not be parsed; tech-stack detection below may be incomplete:');
      for (const f of unparseable) lines.push(`  - ${path.relative(root, f) || path.basename(f)}`);
      lines.push('');
    }
    if (pkg) {
      lines.push('## Node.js Project (package.json)');
      lines.push(`  Name:     ${pkg.name ?? '(unnamed)'}`);
      lines.push(`  Version:  ${pkg.version ?? '?'}`);
      if (pkg.description) lines.push(`  Desc:     ${pkg.description}`);
      if (pkg.main) lines.push(`  Main:     ${pkg.main}`);
      if (pkg.bin) lines.push(`  Bin:      ${typeof pkg.bin === 'string' ? pkg.bin : Object.keys(pkg.bin).join(', ')}`);
      if (pkg.scripts) {
        lines.push(`  Scripts:`);
        for (const [n, cmd] of Object.entries(pkg.scripts)) lines.push(`    ${n}: ${cmd}`);
      }
      const depCount = Object.keys(pkg.dependencies ?? {}).length;
      const devDepCount = Object.keys(pkg.devDependencies ?? {}).length;
      const peerCount = Object.keys(pkg.peerDependencies ?? {}).length;
      const optCount = Object.keys(pkg.optionalDependencies ?? {}).length;
      lines.push(`  Deps:     ${depCount} runtime, ${devDepCount} dev${peerCount ? `, ${peerCount} peer` : ''}${optCount ? `, ${optCount} optional` : ''}`);
      if (pkg.workspaces) {
        lines.push(`  Workspaces: ${Array.isArray(pkg.workspaces) ? pkg.workspaces.join(', ') : JSON.stringify(pkg.workspaces)}`);
      }
      lines.push('');
    }

    // Other config files
    const configs = files.filter(f => {
      const base = path.basename(f.path);
      return CONFIG_PATTERNS.some(p => p.test(base));
    });