get_file_map
Get a quick structural overview of a source file by retrieving all symbols grouped by kind like functions, classes, and enums.
Instructions
Return all symbols in a file grouped by kind — fast structural overview.
Like a table of contents before reading a chapter. Pass a path relative
to the project root (src/main.cpp) or just the filename (main.cpp).
Returns symbols keyed by kind (function, method, class, struct, enum, ...).
Each kind has count (total) and items (first N, default 30).
Set max_per_kind=0 for unlimited, signatures=true for full sigs.
Read-only: yes. No side effects. Use before reading a large file to orient yourself — see what functions, classes, and enums it defines.
Args: file_path: Path relative to project root, or just the filename. project_root: Project directory. Auto-detected if omitted. signatures: Include full function signatures. Default: False. max_per_kind: Max items per kind group (default 30, 0 = unlimited).
Returns: dict: {file, total_symbols, symbols: {kind: {count, items[]}}}
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Path to source file — relative to project root or just filename. | |
| project_root | No | Project root. Auto-detected if omitted. | |
| signatures | No | Include full function signatures in output. | |
| max_per_kind | No | Max items per symbol kind group (default 30, 0 = unlimited). |