Navegador
docs: update ingestion guide and architecture overview for 7-language support ingestion.md: extend language table to Python/TypeScript/JavaScript/Go/Rust/Java, add skip-dir list, update extraction table to match actual node types produced. overview.md: update ingestion pipeline diagram to list all supported languages.
Commit
8fe142010912296066bd0365f6cc8301529d45386331ccac436a2d5312f744dc
Parent
2e964587f650db8…
2 files changed
+2
-2
+21
-8
+2
-2
| --- docs/architecture/overview.md | ||
| +++ docs/architecture/overview.md | ||
| @@ -73,14 +73,14 @@ | ||
| 73 | 73 | --- |
| 74 | 74 | |
| 75 | 75 | ## Ingestion pipeline |
| 76 | 76 | |
| 77 | 77 | ``` |
| 78 | -Source code (Python, TypeScript) | |
| 78 | +Source code (Python · TypeScript · JavaScript · Go · Rust · Java) | |
| 79 | 79 | │ |
| 80 | 80 | ▼ |
| 81 | - tree-sitter parser | |
| 81 | + tree-sitter parser (per-language grammar) | |
| 82 | 82 | │ |
| 83 | 83 | ▼ |
| 84 | 84 | AST visitor (extract nodes + relationships) |
| 85 | 85 | │ |
| 86 | 86 | ▼ |
| 87 | 87 |
| --- docs/architecture/overview.md | |
| +++ docs/architecture/overview.md | |
| @@ -73,14 +73,14 @@ | |
| 73 | --- |
| 74 | |
| 75 | ## Ingestion pipeline |
| 76 | |
| 77 | ``` |
| 78 | Source code (Python, TypeScript) |
| 79 | │ |
| 80 | ▼ |
| 81 | tree-sitter parser |
| 82 | │ |
| 83 | ▼ |
| 84 | AST visitor (extract nodes + relationships) |
| 85 | │ |
| 86 | ▼ |
| 87 |
| --- docs/architecture/overview.md | |
| +++ docs/architecture/overview.md | |
| @@ -73,14 +73,14 @@ | |
| 73 | --- |
| 74 | |
| 75 | ## Ingestion pipeline |
| 76 | |
| 77 | ``` |
| 78 | Source code (Python · TypeScript · JavaScript · Go · Rust · Java) |
| 79 | │ |
| 80 | ▼ |
| 81 | tree-sitter parser (per-language grammar) |
| 82 | │ |
| 83 | ▼ |
| 84 | AST visitor (extract nodes + relationships) |
| 85 | │ |
| 86 | ▼ |
| 87 |
+21
-8
| --- docs/guide/ingestion.md | ||
| +++ docs/guide/ingestion.md | ||
| @@ -10,22 +10,35 @@ | ||
| 10 | 10 | navegador ingest ./repo |
| 11 | 11 | ``` |
| 12 | 12 | |
| 13 | 13 | ### What gets extracted |
| 14 | 14 | |
| 15 | -Navegador walks every `.py` and `.ts` / `.tsx` file and uses tree-sitter to extract: | |
| 15 | +Navegador walks all source files in the repo and uses tree-sitter to extract structure. Supported languages: | |
| 16 | + | |
| 17 | +| Extension(s) | Language | | |
| 18 | +|---|---| | |
| 19 | +| `.py` | Python | | |
| 20 | +| `.ts`, `.tsx` | TypeScript | | |
| 21 | +| `.js`, `.jsx` | JavaScript | | |
| 22 | +| `.go` | Go | | |
| 23 | +| `.rs` | Rust | | |
| 24 | +| `.java` | Java | | |
| 25 | + | |
| 26 | +The following directories are always skipped: `.git`, `.venv`, `venv`, `node_modules`, `__pycache__`, `dist`, `build`, `.next`, `target` (Rust/Java builds), `vendor` (Go modules), `.gradle`. | |
| 27 | + | |
| 28 | +### What gets extracted | |
| 16 | 29 | |
| 17 | 30 | | What | Graph nodes / edges created | |
| 18 | 31 | |---|---| |
| 19 | -| Files and modules | `File`, `Module` nodes; `CONTAINS` edges from `Repository` | | |
| 20 | -| Classes | `Class` node with `name`, `file`, `line`, `docstring` | | |
| 21 | -| Functions and methods | `Function` / `Method` nodes with `name`, `signature`, `docstring`, `line` | | |
| 22 | -| Decorators | `Decorator` node; `DECORATES` edge to the decorated function/class | | |
| 23 | -| Imports | `Import` node; `IMPORTS` edge from the importing file | | |
| 32 | +| Files | `File` node; `CONTAINS` edge from `Repository` | | |
| 33 | +| Classes, structs, interfaces | `Class` node with `name`, `file`, `line`, `docstring` | | |
| 34 | +| Functions and methods | `Function` / `Method` nodes with `name`, `docstring`, `line` | | |
| 35 | +| Imports / use declarations | `Import` node; `IMPORTS` edge from the importing file | | |
| 24 | 36 | | Call relationships | `CALLS` edges between functions based on static call analysis | |
| 25 | -| Inheritance | `INHERITS` edges from subclass to parent; `IMPLEMENTS` for interfaces | | |
| 26 | -| Variables (module-level) | `Variable` nodes | | |
| 37 | +| Inheritance | `INHERITS` edges from subclass to parent | | |
| 38 | + | |
| 39 | +Doc comment formats supported per language: Python docstrings, JSDoc (`/** */`), Rust `///`, Java Javadoc. | |
| 27 | 40 | |
| 28 | 41 | ### Options |
| 29 | 42 | |
| 30 | 43 | | Flag | Effect | |
| 31 | 44 | |---|---| |
| 32 | 45 |
| --- docs/guide/ingestion.md | |
| +++ docs/guide/ingestion.md | |
| @@ -10,22 +10,35 @@ | |
| 10 | navegador ingest ./repo |
| 11 | ``` |
| 12 | |
| 13 | ### What gets extracted |
| 14 | |
| 15 | Navegador walks every `.py` and `.ts` / `.tsx` file and uses tree-sitter to extract: |
| 16 | |
| 17 | | What | Graph nodes / edges created | |
| 18 | |---|---| |
| 19 | | Files and modules | `File`, `Module` nodes; `CONTAINS` edges from `Repository` | |
| 20 | | Classes | `Class` node with `name`, `file`, `line`, `docstring` | |
| 21 | | Functions and methods | `Function` / `Method` nodes with `name`, `signature`, `docstring`, `line` | |
| 22 | | Decorators | `Decorator` node; `DECORATES` edge to the decorated function/class | |
| 23 | | Imports | `Import` node; `IMPORTS` edge from the importing file | |
| 24 | | Call relationships | `CALLS` edges between functions based on static call analysis | |
| 25 | | Inheritance | `INHERITS` edges from subclass to parent; `IMPLEMENTS` for interfaces | |
| 26 | | Variables (module-level) | `Variable` nodes | |
| 27 | |
| 28 | ### Options |
| 29 | |
| 30 | | Flag | Effect | |
| 31 | |---|---| |
| 32 |
| --- docs/guide/ingestion.md | |
| +++ docs/guide/ingestion.md | |
| @@ -10,22 +10,35 @@ | |
| 10 | navegador ingest ./repo |
| 11 | ``` |
| 12 | |
| 13 | ### What gets extracted |
| 14 | |
| 15 | Navegador walks all source files in the repo and uses tree-sitter to extract structure. Supported languages: |
| 16 | |
| 17 | | Extension(s) | Language | |
| 18 | |---|---| |
| 19 | | `.py` | Python | |
| 20 | | `.ts`, `.tsx` | TypeScript | |
| 21 | | `.js`, `.jsx` | JavaScript | |
| 22 | | `.go` | Go | |
| 23 | | `.rs` | Rust | |
| 24 | | `.java` | Java | |
| 25 | |
| 26 | The following directories are always skipped: `.git`, `.venv`, `venv`, `node_modules`, `__pycache__`, `dist`, `build`, `.next`, `target` (Rust/Java builds), `vendor` (Go modules), `.gradle`. |
| 27 | |
| 28 | ### What gets extracted |
| 29 | |
| 30 | | What | Graph nodes / edges created | |
| 31 | |---|---| |
| 32 | | Files | `File` node; `CONTAINS` edge from `Repository` | |
| 33 | | Classes, structs, interfaces | `Class` node with `name`, `file`, `line`, `docstring` | |
| 34 | | Functions and methods | `Function` / `Method` nodes with `name`, `docstring`, `line` | |
| 35 | | Imports / use declarations | `Import` node; `IMPORTS` edge from the importing file | |
| 36 | | Call relationships | `CALLS` edges between functions based on static call analysis | |
| 37 | | Inheritance | `INHERITS` edges from subclass to parent | |
| 38 | |
| 39 | Doc comment formats supported per language: Python docstrings, JSDoc (`/** */`), Rust `///`, Java Javadoc. |
| 40 | |
| 41 | ### Options |
| 42 | |
| 43 | | Flag | Effect | |
| 44 | |---|---| |
| 45 |