| `.rb` (in Chef cookbooks) | Chef | `[iac]` (enricher on Ruby parser) |
42
43
Ansible files are not matched by extension — navegador detects them by directory structure (`roles/`, `playbooks/`, `group_vars/`, `host_vars/`) or content (`hosts:` + `tasks:` keys). Chef uses the existing Ruby parser; the Chef enricher promotes nodes with Chef-specific semantic types.
44
45
Install language and IaC support:
46
47
```bash
48
pip install "navegador[languages]"
49
pip install "navegador[iac]"
50
```
51
52
The following directories are always skipped: `.git`, `.venv`, `venv`, `node_modules`, `__pycache__`, `dist`, `build`, `.next`, `target` (Rust/Java builds), `vendor` (Go modules), `.gradle`.
53
54
### What gets extracted
55
56
| What | Graph nodes / edges created |
57
|---|---|
58
| Files | `File` node; `CONTAINS` edge from `Repository` |
| `--json` | Output a JSON summary of nodes and edges created |
100
| `--db <path>` | Use a specific database file |
101
102
### Re-ingesting
103
104
Re-run `navegador ingest` anytime to pick up changes. Nodes are upserted by identity (file path + name), so repeated ingestion is idempotent for unchanged nodes. Use `--incremental` for large repos to skip unchanged files. Use `--clear` when you need a clean slate (e.g., after a large rename refactor).
105
106
### Incremental ingestion
107
108
`--incremental` uses SHA-256 content hashing to skip files that haven't changed since the last ingest. The hash is stored on each `File` node. On large repos this can reduce ingest time by 90%+ after the initial run.
109
110
```bash
111
navegador ingest ./repo --incremental
112
```
113
114
### Watch mode
115
116
`--watch` starts a file-system watcher and automatically re-ingests any file that changes:
117
118
```bash
119
navegador ingest ./repo --watch
120
```
121
122
Press `Ctrl-C` to stop. Watch mode uses `--incremental` automatically.
123
124
### Sensitive content redaction
125
126
`--redact` scans string literals for patterns that look like API keys, tokens, and passwords, and replaces their values with `[REDACTED]` in the graph. Source files are never modified.
127
128
```bash
129
navegador ingest ./repo --redact
130
```
131
132
### Monorepo support
133
134
`--monorepo` detects the workspace type and traverses all sub-packages:
This creates `ANNOTATES` edges between the knowledge nodes and the code node. The code node then appears in results for `navegador concept Idempotency` and `navegador explain process_payment`.
220
221
---
222
223
## Wiki ingestion
224
225
Pull a GitHub wiki into the graph as `WikiPage` nodes.
226
227
```bash
228
# ingest from GitHub API
229
navegador wiki ingest --repo myorg/myrepo --token $GITHUB_TOKEN
230
231
# ingest from a locally cloned wiki directory
232
navegador wiki ingest --dir ./myrepo.wiki
233
234
# force API mode (bypass auto-detection)
235
navegador wiki ingest --repo myorg/myrepo --api
236
```
237
238
Each wiki page becomes a `WikiPage` node with `title`, `content`, `url`, and `updated_at` properties. Pages are linked to relevant `Concept`, `Domain`, or `Function` nodes with `DOCUMENTS` edges where names match.
239
240
Set `GITHUB_TOKEN` in your environment to avoid rate limits and to access private wikis.
241
242
---
243
244
## Planopticon ingestion
245
246
[Planopticon](planopticon.md) is a video/meeting knowledge extraction tool. It produces structured knowledge graph output that navegador can ingest directly.
247
248
```bash
249
navegador planopticon ingest ./meeting-output/ --type auto
250
```
251
252
See the [Planopticon guide](planopticon.md) for the full input format reference and entity mapping details.