Navegador

navegador / guide / sdk / index.html

Source Rendered

Blame History Raw 2061 lines

1
2	`<!doctype html>`
3	`<html lang="en" class="no-js">`
4	`<head>`
5
6	`<meta charset="utf-8">`
7	`<meta name="viewport" content="width=device-width,initial-scale=1">`
8
9	`<meta name="description" content="Project knowledge graph for AI coding agents — code structure, business rules, and architectural decisions in one queryable graph">`
10
11
12	`<meta name="author" content="CONFLICT LLC">`
13
14
15	`<link rel="canonical" href="https://navegador.dev/guide/sdk/">`
16
17
18	`<link rel="prev" href="../intelligence/">`
19
20
21	`<link rel="next" href="../graph-queries/">`
22
23
24
25
26
27	`<link rel="icon" href="../../assets/images/favicon.png">`
28	`<meta name="generator" content="mkdocs-1.6.1, mkdocs-material-9.7.6">`
29
30
31
32	`<title>Python SDK - Navegador</title>`
33
34
35
36	`<link rel="stylesheet" href="../../assets/stylesheets/main.484c7ddc.min.css">`
37
38
39	`<link rel="stylesheet" href="../../assets/stylesheets/palette.ab4e12ef.min.css">`
40
41
42
43
44
45
46
47
48
49
50
51
52	`<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>`
53	`<link rel="stylesheet" href="https://fonts.googleapis.com/css?family=Roboto:300,300i,400,400i,700,700i%7CRoboto+Mono:400,400i,700,700i&display=fallback">`
54	`<style>:root{--md-text-font:"Roboto";--md-code-font:"Roboto Mono"}</style>`
55
56
57
58	`<link rel="stylesheet" href="../../assets/_mkdocstrings.css">`
59
60	`<link rel="stylesheet" href="../../assets/css/custom.css">`
61
62	`<script>__md_scope=new URL("../..",location),__md_hash=e=>[...e].reduce(((e,_)=>(e<<5)-e+_.charCodeAt(0)),0),__md_get=(e,_=localStorage,t=__md_scope)=>JSON.parse(_.getItem(t.pathname+"."+e)),__md_set=(e,_,t=localStorage,a=__md_scope)=>{try{t.setItem(a.pathname+"."+e,JSON.stringify(_))}catch(e){}}</script>`
63
64
65
66
67
68	`</head>`
69
70
71
72
73
74
75
76
77
78	`<body dir="ltr" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom">`
79
80
81	`<input class="md-toggle" data-md-toggle="drawer" type="checkbox" id="__drawer" autocomplete="off">`
82	`<input class="md-toggle" data-md-toggle="search" type="checkbox" id="__search" autocomplete="off">`
83	`<label class="md-overlay" for="__drawer"></label>`
84	`<div data-md-component="skip">`
85
86
87	`<a href="#python-sdk" class="md-skip">`
88	`Skip to content`
89	`</a>`
90
91	`</div>`
92	`<div data-md-component="announce">`
93
94	`</div>`
95
96
97
98
99	`<header class="md-header" data-md-component="header">`
100	`<nav class="md-header__inner md-grid" aria-label="Header">`
101	`<a href="../.." title="Navegador" class="md-header__button md-logo" aria-label="Navegador" data-md-component="logo">`
102
103	`<img src="../../assets/images/conflict-logo.svg" alt="logo">`
104
105	`</a>`
106	`<label class="md-header__button md-icon" for="__drawer">`
107
108	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M3 6h18v2H3zm0 5h18v2H3zm0 5h18v2H3z"/></svg>`
109	`</label>`
110	`<div class="md-header__title" data-md-component="header-title">`
111	`<div class="md-header__ellipsis">`
112	`<div class="md-header__topic">`
113	`<span class="md-ellipsis">`
114	`Navegador`
115	`</span>`
116	`</div>`
117	`<div class="md-header__topic" data-md-component="header-topic">`
118	`<span class="md-ellipsis">`
119
120	`Python SDK`
121
122	`</span>`
123	`</div>`
124	`</div>`
125	`</div>`
126
127
128	`<form class="md-header__option" data-md-component="palette">`
129
130
131
132
133	`<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">`
134
135	`<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>`
136	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
137	`</label>`
138
139
140
141
142
143	`<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">`
144
145	`<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>`
146	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
147	`</label>`
148
149
150	`</form>`
151
152
153
154	<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
155
156
157
158
159
160	`<label class="md-header__button md-icon" for="__search">`
161
162	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
163	`</label>`
164	`<div class="md-search" data-md-component="search" role="dialog">`
165	`<label class="md-search__overlay" for="__search"></label>`
166	`<div class="md-search__inner" role="search">`
167	`<form class="md-search__form" name="search">`
168	`<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>`
169	`<label class="md-search__icon md-icon" for="__search">`
170
171	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
172
173	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>`
174	`</label>`
175	`<nav class="md-search__options" aria-label="Search">`
176
177	`<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">`
178
179	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>`
180	`</button>`
181	`</nav>`
182
183	`<div class="md-search__suggest" data-md-component="search-suggest"></div>`
184
185	`</form>`
186	`<div class="md-search__output">`
187	`<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>`
188	`<div class="md-search-result" data-md-component="search-result">`
189	`<div class="md-search-result__meta">`
190	`Initializing search`
191	`</div>`
192	`<ol class="md-search-result__list" role="presentation"></ol>`
193	`</div>`
194	`</div>`
195	`</div>`
196	`</div>`
197	`</div>`
198
199
200
201	`<div class="md-header__source">`
202	`<a href="https://github.com/ConflictHQ/navegador" title="Go to repository" class="md-source" data-md-component="source">`
203	`<div class="md-source__icon md-icon">`
204
205	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
206	`</div>`
207	`<div class="md-source__repository">`
208	`ConflictHQ/navegador`
209	`</div>`
210	`</a>`
211	`</div>`
212
213	`</nav>`
214
215	`</header>`
216
217	`<div class="md-container" data-md-component="container">`
218
219
220
221
222
223	`<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">`
224	`<div class="md-grid">`
225	`<ul class="md-tabs__list">`
226
227
228
229
230
231
232	`<li class="md-tabs__item">`
233	`<a href="../.." class="md-tabs__link">`
234
235
236
237
238
239	`Home`
240
241	`</a>`
242	`</li>`
243
244
245
246
247
248
249
250
251
252
253	`<li class="md-tabs__item">`
254	`<a href="../../getting-started/installation/" class="md-tabs__link">`
255
256
257
258	`Getting Started`
259
260	`</a>`
261	`</li>`
262
263
264
265
266
267
268
269
270
271
272
273
274
275	`<li class="md-tabs__item md-tabs__item--active">`
276	`<a href="../ingestion/" class="md-tabs__link">`
277
278
279
280	`Guide`
281
282	`</a>`
283	`</li>`
284
285
286
287
288
289
290
291
292
293
294
295	`<li class="md-tabs__item">`
296	`<a href="../../architecture/overview/" class="md-tabs__link">`
297
298
299
300	`Architecture`
301
302	`</a>`
303	`</li>`
304
305
306
307
308
309
310
311
312
313
314
315	`<li class="md-tabs__item">`
316	`<a href="../../api/sdk/" class="md-tabs__link">`
317
318
319
320	`API Reference`
321
322	`</a>`
323	`</li>`
324
325
326
327
328	`</ul>`
329	`</div>`
330	`</nav>`
331
332
333
334	`<main class="md-main" data-md-component="main">`
335	`<div class="md-main__inner md-grid">`
336
337
338
339	`<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >`
340	`<div class="md-sidebar__scrollwrap">`
341	`<div class="md-sidebar__inner">`
342
343
344
345
346
347
348	`<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">`
349	`<label class="md-nav__title" for="__drawer">`
350	`<a href="../.." title="Navegador" class="md-nav__button md-logo" aria-label="Navegador" data-md-component="logo">`
351
352	`<img src="../../assets/images/conflict-logo.svg" alt="logo">`
353
354	`</a>`
355	`Navegador`
356	`</label>`
357
358	`<div class="md-nav__source">`
359	`<a href="https://github.com/ConflictHQ/navegador" title="Go to repository" class="md-source" data-md-component="source">`
360	`<div class="md-source__icon md-icon">`
361
362	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
363	`</div>`
364	`<div class="md-source__repository">`
365	`ConflictHQ/navegador`
366	`</div>`
367	`</a>`
368	`</div>`
369
370	`<ul class="md-nav__list" data-md-scrollfix>`
371
372
373
374
375
376
377
378	`<li class="md-nav__item">`
379	`<a href="../.." class="md-nav__link">`
380
381
382
383	`<span class="md-ellipsis">`
384
385
386	`Home`
387
388
389
390	`</span>`
391
392
393
394	`</a>`
395	`</li>`
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415	`<li class="md-nav__item md-nav__item--nested">`
416
417
418
419
420
421	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >`
422
423
424	`<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">`
425
426
427
428	`<span class="md-ellipsis">`
429
430
431	`Getting Started`
432
433
434
435	`</span>`
436
437
438
439	`<span class="md-nav__icon md-icon"></span>`
440	`</label>`
441
442	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">`
443	`<label class="md-nav__title" for="__nav_2">`
444	`<span class="md-nav__icon md-icon"></span>`
445
446
447	`Getting Started`
448
449
450	`</label>`
451	`<ul class="md-nav__list" data-md-scrollfix>`
452
453
454
455
456
457
458
459	`<li class="md-nav__item">`
460	`<a href="../../getting-started/installation/" class="md-nav__link">`
461
462
463
464	`<span class="md-ellipsis">`
465
466
467	`Installation`
468
469
470
471	`</span>`
472
473
474
475	`</a>`
476	`</li>`
477
478
479
480
481
482
483
484
485
486
487	`<li class="md-nav__item">`
488	`<a href="../../getting-started/quickstart/" class="md-nav__link">`
489
490
491
492	`<span class="md-ellipsis">`
493
494
495	`Quick Start`
496
497
498
499	`</span>`
500
501
502
503	`</a>`
504	`</li>`
505
506
507
508
509
510
511
512
513
514
515	`<li class="md-nav__item">`
516	`<a href="../../getting-started/configuration/" class="md-nav__link">`
517
518
519
520	`<span class="md-ellipsis">`
521
522
523	`Configuration`
524
525
526
527	`</span>`
528
529
530
531	`</a>`
532	`</li>`
533
534
535
536
537	`</ul>`
538	`</nav>`
539
540	`</li>`
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565	`<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">`
566
567
568
569	`<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>`
570
571
572	`<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">`
573
574
575
576	`<span class="md-ellipsis">`
577
578
579	`Guide`
580
581
582
583	`</span>`
584
585
586
587	`<span class="md-nav__icon md-icon"></span>`
588	`</label>`
589
590	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">`
591	`<label class="md-nav__title" for="__nav_3">`
592	`<span class="md-nav__icon md-icon"></span>`
593
594
595	`Guide`
596
597
598	`</label>`
599	`<ul class="md-nav__list" data-md-scrollfix>`
600
601
602
603
604
605
606
607	`<li class="md-nav__item">`
608	`<a href="../ingestion/" class="md-nav__link">`
609
610
611
612	`<span class="md-ellipsis">`
613
614
615	`Ingesting a Repo`
616
617
618
619	`</span>`
620
621
622
623	`</a>`
624	`</li>`
625
626
627
628
629
630
631
632
633
634
635	`<li class="md-nav__item">`
636	`<a href="../context-loading/" class="md-nav__link">`
637
638
639
640	`<span class="md-ellipsis">`
641
642
643	`Loading Context`
644
645
646
647	`</span>`
648
649
650
651	`</a>`
652	`</li>`
653
654
655
656
657
658
659
660
661
662
663	`<li class="md-nav__item">`
664	`<a href="../framework-enrichment/" class="md-nav__link">`
665
666
667
668	`<span class="md-ellipsis">`
669
670
671	`Framework Enrichment`
672
673
674
675	`</span>`
676
677
678
679	`</a>`
680	`</li>`
681
682
683
684
685
686
687
688
689
690
691	`<li class="md-nav__item">`
692	`<a href="../analysis/" class="md-nav__link">`
693
694
695
696	`<span class="md-ellipsis">`
697
698
699	`Structural Analysis`
700
701
702
703	`</span>`
704
705
706
707	`</a>`
708	`</li>`
709
710
711
712
713
714
715
716
717
718
719	`<li class="md-nav__item">`
720	`<a href="../intelligence/" class="md-nav__link">`
721
722
723
724	`<span class="md-ellipsis">`
725
726
727	`Intelligence Layer`
728
729
730
731	`</span>`
732
733
734
735	`</a>`
736	`</li>`
737
738
739
740
741
742
743
744
745
746
747
748
749	`<li class="md-nav__item md-nav__item--active">`
750
751	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
752
753
754
755
756
757	`<label class="md-nav__link md-nav__link--active" for="__toc">`
758
759
760
761	`<span class="md-ellipsis">`
762
763
764	`Python SDK`
765
766
767
768	`</span>`
769
770
771
772	`<span class="md-nav__icon md-icon"></span>`
773	`</label>`
774
775	`<a href="./" class="md-nav__link md-nav__link--active">`
776
777
778
779	`<span class="md-ellipsis">`
780
781
782	`Python SDK`
783
784
785
786	`</span>`
787
788
789
790	`</a>`
791
792
793
794	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
795
796
797
798
799
800
801	`<label class="md-nav__title" for="__toc">`
802	`<span class="md-nav__icon md-icon"></span>`
803	`Table of contents`
804	`</label>`
805	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
806
807	`<li class="md-nav__item">`
808	`<a href="#installation" class="md-nav__link">`
809	`<span class="md-ellipsis">`
810
811	`Installation`
812
813	`</span>`
814	`</a>`
815
816	`</li>`
817
818	`<li class="md-nav__item">`
819	`<a href="#connecting-to-the-graph" class="md-nav__link">`
820	`<span class="md-ellipsis">`
821
822	`Connecting to the graph`
823
824	`</span>`
825	`</a>`
826
827	`</li>`
828
829	`<li class="md-nav__item">`
830	`<a href="#ingestion" class="md-nav__link">`
831	`<span class="md-ellipsis">`
832
833	`Ingestion`
834
835	`</span>`
836	`</a>`
837
838	`<nav class="md-nav" aria-label="Ingestion">`
839	`<ul class="md-nav__list">`
840
841	`<li class="md-nav__item">`
842	`<a href="#ingest-a-repo" class="md-nav__link">`
843	`<span class="md-ellipsis">`
844
845	`Ingest a repo`
846
847	`</span>`
848	`</a>`
849
850	`</li>`
851
852	`<li class="md-nav__item">`
853	`<a href="#incremental-ingest-single-file" class="md-nav__link">`
854	`<span class="md-ellipsis">`
855
856	`Incremental ingest (single file)`
857
858	`</span>`
859	`</a>`
860
861	`</li>`
862
863	`<li class="md-nav__item">`
864	`<a href="#wipe-and-rebuild" class="md-nav__link">`
865	`<span class="md-ellipsis">`
866
867	`Wipe and rebuild`
868
869	`</span>`
870	`</a>`
871
872	`</li>`
873
874	`<li class="md-nav__item">`
875	`<a href="#add-knowledge-programmatically" class="md-nav__link">`
876	`<span class="md-ellipsis">`
877
878	`Add knowledge programmatically`
879
880	`</span>`
881	`</a>`
882
883	`</li>`
884
885	`</ul>`
886	`</nav>`
887
888	`</li>`
889
890	`<li class="md-nav__item">`
891	`<a href="#loading-context" class="md-nav__link">`
892	`<span class="md-ellipsis">`
893
894	`Loading context`
895
896	`</span>`
897	`</a>`
898
899	`<nav class="md-nav" aria-label="Loading context">`
900	`<ul class="md-nav__list">`
901
902	`<li class="md-nav__item">`
903	`<a href="#file-context" class="md-nav__link">`
904	`<span class="md-ellipsis">`
905
906	`File context`
907
908	`</span>`
909	`</a>`
910
911	`</li>`
912
913	`<li class="md-nav__item">`
914	`<a href="#function-with-call-graph" class="md-nav__link">`
915	`<span class="md-ellipsis">`
916
917	`Function with call graph`
918
919	`</span>`
920	`</a>`
921
922	`</li>`
923
924	`<li class="md-nav__item">`
925	`<a href="#class-hierarchy" class="md-nav__link">`
926	`<span class="md-ellipsis">`
927
928	`Class hierarchy`
929
930	`</span>`
931	`</a>`
932
933	`</li>`
934
935	`<li class="md-nav__item">`
936	`<a href="#universal-explain" class="md-nav__link">`
937	`<span class="md-ellipsis">`
938
939	`Universal explain`
940
941	`</span>`
942	`</a>`
943
944	`</li>`
945
946	`<li class="md-nav__item">`
947	`<a href="#concept-and-domain" class="md-nav__link">`
948	`<span class="md-ellipsis">`
949
950	`Concept and domain`
951
952	`</span>`
953	`</a>`
954
955	`</li>`
956
957	`</ul>`
958	`</nav>`
959
960	`</li>`
961
962	`<li class="md-nav__item">`
963	`<a href="#search" class="md-nav__link">`
964	`<span class="md-ellipsis">`
965
966	`Search`
967
968	`</span>`
969	`</a>`
970
971	`</li>`
972
973	`<li class="md-nav__item">`
974	`<a href="#knowledge-queries" class="md-nav__link">`
975	`<span class="md-ellipsis">`
976
977	`Knowledge queries`
978
979	`</span>`
980	`</a>`
981
982	`</li>`
983
984	`<li class="md-nav__item">`
985	`<a href="#exporting-output" class="md-nav__link">`
986	`<span class="md-ellipsis">`
987
988	`Exporting output`
989
990	`</span>`
991	`</a>`
992
993	`</li>`
994
995	`<li class="md-nav__item">`
996	`<a href="#raw-cypher-queries" class="md-nav__link">`
997	`<span class="md-ellipsis">`
998
999	`Raw Cypher queries`
1000
1001	`</span>`
1002	`</a>`
1003
1004	`</li>`
1005
1006	`<li class="md-nav__item">`
1007	`<a href="#wiki-ingestion" class="md-nav__link">`
1008	`<span class="md-ellipsis">`
1009
1010	`Wiki ingestion`
1011
1012	`</span>`
1013	`</a>`
1014
1015	`</li>`
1016
1017	`<li class="md-nav__item">`
1018	`<a href="#error-handling" class="md-nav__link">`
1019	`<span class="md-ellipsis">`
1020
1021	`Error handling`
1022
1023	`</span>`
1024	`</a>`
1025
1026	`</li>`
1027
1028	`</ul>`
1029
1030	`</nav>`
1031
1032	`</li>`
1033
1034
1035
1036
1037
1038
1039
1040
1041
1042
1043	`<li class="md-nav__item">`
1044	`<a href="../graph-queries/" class="md-nav__link">`
1045
1046
1047
1048	`<span class="md-ellipsis">`
1049
1050
1051	`Graph Queries`
1052
1053
1054
1055	`</span>`
1056
1057
1058
1059	`</a>`
1060	`</li>`
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071	`<li class="md-nav__item">`
1072	`<a href="../mcp-integration/" class="md-nav__link">`
1073
1074
1075
1076	`<span class="md-ellipsis">`
1077
1078
1079	`MCP Integration`
1080
1081
1082
1083	`</span>`
1084
1085
1086
1087	`</a>`
1088	`</li>`
1089
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099	`<li class="md-nav__item">`
1100	`<a href="../ci-cd/" class="md-nav__link">`
1101
1102
1103
1104	`<span class="md-ellipsis">`
1105
1106
1107	`CI/CD`
1108
1109
1110
1111	`</span>`
1112
1113
1114
1115	`</a>`
1116	`</li>`
1117
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127	`<li class="md-nav__item">`
1128	`<a href="../cluster/" class="md-nav__link">`
1129
1130
1131
1132	`<span class="md-ellipsis">`
1133
1134
1135	`Cluster Mode`
1136
1137
1138
1139	`</span>`
1140
1141
1142
1143	`</a>`
1144	`</li>`
1145
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155	`<li class="md-nav__item">`
1156	`<a href="../agent-hooks/" class="md-nav__link">`
1157
1158
1159
1160	`<span class="md-ellipsis">`
1161
1162
1163	`Agent Hooks`
1164
1165
1166
1167	`</span>`
1168
1169
1170
1171	`</a>`
1172	`</li>`
1173
1174
1175
1176
1177
1178
1179
1180
1181
1182
1183	`<li class="md-nav__item">`
1184	`<a href="../planopticon/" class="md-nav__link">`
1185
1186
1187
1188	`<span class="md-ellipsis">`
1189
1190
1191	`Planopticon`
1192
1193
1194
1195	`</span>`
1196
1197
1198
1199	`</a>`
1200	`</li>`
1201
1202
1203
1204
1205	`</ul>`
1206	`</nav>`
1207
1208	`</li>`
1209
1210
1211
1212
1213
1214
1215
1216
1217
1218
1219
1220
1221
1222
1223
1224
1225
1226
1227
1228	`<li class="md-nav__item md-nav__item--nested">`
1229
1230
1231
1232
1233
1234	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >`
1235
1236
1237	`<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">`
1238
1239
1240
1241	`<span class="md-ellipsis">`
1242
1243
1244	`Architecture`
1245
1246
1247
1248	`</span>`
1249
1250
1251
1252	`<span class="md-nav__icon md-icon"></span>`
1253	`</label>`
1254
1255	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">`
1256	`<label class="md-nav__title" for="__nav_4">`
1257	`<span class="md-nav__icon md-icon"></span>`
1258
1259
1260	`Architecture`
1261
1262
1263	`</label>`
1264	`<ul class="md-nav__list" data-md-scrollfix>`
1265
1266
1267
1268
1269
1270
1271
1272	`<li class="md-nav__item">`
1273	`<a href="../../architecture/overview/" class="md-nav__link">`
1274
1275
1276
1277	`<span class="md-ellipsis">`
1278
1279
1280	`Overview`
1281
1282
1283
1284	`</span>`
1285
1286
1287
1288	`</a>`
1289	`</li>`
1290
1291
1292
1293
1294
1295
1296
1297
1298
1299
1300	`<li class="md-nav__item">`
1301	`<a href="../../architecture/graph-schema/" class="md-nav__link">`
1302
1303
1304
1305	`<span class="md-ellipsis">`
1306
1307
1308	`Graph Schema`
1309
1310
1311
1312	`</span>`
1313
1314
1315
1316	`</a>`
1317	`</li>`
1318
1319
1320
1321
1322	`</ul>`
1323	`</nav>`
1324
1325	`</li>`
1326
1327
1328
1329
1330
1331
1332
1333
1334
1335
1336
1337
1338
1339
1340
1341
1342
1343
1344
1345	`<li class="md-nav__item md-nav__item--nested">`
1346
1347
1348
1349
1350
1351	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >`
1352
1353
1354	`<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">`
1355
1356
1357
1358	`<span class="md-ellipsis">`
1359
1360
1361	`API Reference`
1362
1363
1364
1365	`</span>`
1366
1367
1368
1369	`<span class="md-nav__icon md-icon"></span>`
1370	`</label>`
1371
1372	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">`
1373	`<label class="md-nav__title" for="__nav_5">`
1374	`<span class="md-nav__icon md-icon"></span>`
1375
1376
1377	`API Reference`
1378
1379
1380	`</label>`
1381	`<ul class="md-nav__list" data-md-scrollfix>`
1382
1383
1384
1385
1386
1387
1388
1389	`<li class="md-nav__item">`
1390	`<a href="../../api/sdk/" class="md-nav__link">`
1391
1392
1393
1394	`<span class="md-ellipsis">`
1395
1396
1397	`Python SDK`
1398
1399
1400
1401	`</span>`
1402
1403
1404
1405	`</a>`
1406	`</li>`
1407
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417	`<li class="md-nav__item">`
1418	`<a href="../../api/ingestion/" class="md-nav__link">`
1419
1420
1421
1422	`<span class="md-ellipsis">`
1423
1424
1425	`Ingestion`
1426
1427
1428
1429	`</span>`
1430
1431
1432
1433	`</a>`
1434	`</li>`
1435
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445	`<li class="md-nav__item">`
1446	`<a href="../../api/analysis/" class="md-nav__link">`
1447
1448
1449
1450	`<span class="md-ellipsis">`
1451
1452
1453	`Analysis`
1454
1455
1456
1457	`</span>`
1458
1459
1460
1461	`</a>`
1462	`</li>`
1463
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473	`<li class="md-nav__item">`
1474	`<a href="../../api/graph/" class="md-nav__link">`
1475
1476
1477
1478	`<span class="md-ellipsis">`
1479
1480
1481	`Graph`
1482
1483
1484
1485	`</span>`
1486
1487
1488
1489	`</a>`
1490	`</li>`
1491
1492
1493
1494
1495
1496
1497
1498
1499
1500
1501	`<li class="md-nav__item">`
1502	`<a href="../../api/mcp/" class="md-nav__link">`
1503
1504
1505
1506	`<span class="md-ellipsis">`
1507
1508
1509	`MCP Server`
1510
1511
1512
1513	`</span>`
1514
1515
1516
1517	`</a>`
1518	`</li>`
1519
1520
1521
1522
1523	`</ul>`
1524	`</nav>`
1525
1526	`</li>`
1527
1528
1529
1530	`</ul>`
1531	`</nav>`
1532	`</div>`
1533	`</div>`
1534	`</div>`
1535
1536
1537
1538	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1539	`<div class="md-sidebar__scrollwrap">`
1540	`<div class="md-sidebar__inner">`
1541
1542
1543	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1544
1545
1546
1547
1548
1549
1550	`<label class="md-nav__title" for="__toc">`
1551	`<span class="md-nav__icon md-icon"></span>`
1552	`Table of contents`
1553	`</label>`
1554	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1555
1556	`<li class="md-nav__item">`
1557	`<a href="#installation" class="md-nav__link">`
1558	`<span class="md-ellipsis">`
1559
1560	`Installation`
1561
1562	`</span>`
1563	`</a>`
1564
1565	`</li>`
1566
1567	`<li class="md-nav__item">`
1568	`<a href="#connecting-to-the-graph" class="md-nav__link">`
1569	`<span class="md-ellipsis">`
1570
1571	`Connecting to the graph`
1572
1573	`</span>`
1574	`</a>`
1575
1576	`</li>`
1577
1578	`<li class="md-nav__item">`
1579	`<a href="#ingestion" class="md-nav__link">`
1580	`<span class="md-ellipsis">`
1581
1582	`Ingestion`
1583
1584	`</span>`
1585	`</a>`
1586
1587	`<nav class="md-nav" aria-label="Ingestion">`
1588	`<ul class="md-nav__list">`
1589
1590	`<li class="md-nav__item">`
1591	`<a href="#ingest-a-repo" class="md-nav__link">`
1592	`<span class="md-ellipsis">`
1593
1594	`Ingest a repo`
1595
1596	`</span>`
1597	`</a>`
1598
1599	`</li>`
1600
1601	`<li class="md-nav__item">`
1602	`<a href="#incremental-ingest-single-file" class="md-nav__link">`
1603	`<span class="md-ellipsis">`
1604
1605	`Incremental ingest (single file)`
1606
1607	`</span>`
1608	`</a>`
1609
1610	`</li>`
1611
1612	`<li class="md-nav__item">`
1613	`<a href="#wipe-and-rebuild" class="md-nav__link">`
1614	`<span class="md-ellipsis">`
1615
1616	`Wipe and rebuild`
1617
1618	`</span>`
1619	`</a>`
1620
1621	`</li>`
1622
1623	`<li class="md-nav__item">`
1624	`<a href="#add-knowledge-programmatically" class="md-nav__link">`
1625	`<span class="md-ellipsis">`
1626
1627	`Add knowledge programmatically`
1628
1629	`</span>`
1630	`</a>`
1631
1632	`</li>`
1633
1634	`</ul>`
1635	`</nav>`
1636
1637	`</li>`
1638
1639	`<li class="md-nav__item">`
1640	`<a href="#loading-context" class="md-nav__link">`
1641	`<span class="md-ellipsis">`
1642
1643	`Loading context`
1644
1645	`</span>`
1646	`</a>`
1647
1648	`<nav class="md-nav" aria-label="Loading context">`
1649	`<ul class="md-nav__list">`
1650
1651	`<li class="md-nav__item">`
1652	`<a href="#file-context" class="md-nav__link">`
1653	`<span class="md-ellipsis">`
1654
1655	`File context`
1656
1657	`</span>`
1658	`</a>`
1659
1660	`</li>`
1661
1662	`<li class="md-nav__item">`
1663	`<a href="#function-with-call-graph" class="md-nav__link">`
1664	`<span class="md-ellipsis">`
1665
1666	`Function with call graph`
1667
1668	`</span>`
1669	`</a>`
1670
1671	`</li>`
1672
1673	`<li class="md-nav__item">`
1674	`<a href="#class-hierarchy" class="md-nav__link">`
1675	`<span class="md-ellipsis">`
1676
1677	`Class hierarchy`
1678
1679	`</span>`
1680	`</a>`
1681
1682	`</li>`
1683
1684	`<li class="md-nav__item">`
1685	`<a href="#universal-explain" class="md-nav__link">`
1686	`<span class="md-ellipsis">`
1687
1688	`Universal explain`
1689
1690	`</span>`
1691	`</a>`
1692
1693	`</li>`
1694
1695	`<li class="md-nav__item">`
1696	`<a href="#concept-and-domain" class="md-nav__link">`
1697	`<span class="md-ellipsis">`
1698
1699	`Concept and domain`
1700
1701	`</span>`
1702	`</a>`
1703
1704	`</li>`
1705
1706	`</ul>`
1707	`</nav>`
1708
1709	`</li>`
1710
1711	`<li class="md-nav__item">`
1712	`<a href="#search" class="md-nav__link">`
1713	`<span class="md-ellipsis">`
1714
1715	`Search`
1716
1717	`</span>`
1718	`</a>`
1719
1720	`</li>`
1721
1722	`<li class="md-nav__item">`
1723	`<a href="#knowledge-queries" class="md-nav__link">`
1724	`<span class="md-ellipsis">`
1725
1726	`Knowledge queries`
1727
1728	`</span>`
1729	`</a>`
1730
1731	`</li>`
1732
1733	`<li class="md-nav__item">`
1734	`<a href="#exporting-output" class="md-nav__link">`
1735	`<span class="md-ellipsis">`
1736
1737	`Exporting output`
1738
1739	`</span>`
1740	`</a>`
1741
1742	`</li>`
1743
1744	`<li class="md-nav__item">`
1745	`<a href="#raw-cypher-queries" class="md-nav__link">`
1746	`<span class="md-ellipsis">`
1747
1748	`Raw Cypher queries`
1749
1750	`</span>`
1751	`</a>`
1752
1753	`</li>`
1754
1755	`<li class="md-nav__item">`
1756	`<a href="#wiki-ingestion" class="md-nav__link">`
1757	`<span class="md-ellipsis">`
1758
1759	`Wiki ingestion`
1760
1761	`</span>`
1762	`</a>`
1763
1764	`</li>`
1765
1766	`<li class="md-nav__item">`
1767	`<a href="#error-handling" class="md-nav__link">`
1768	`<span class="md-ellipsis">`
1769
1770	`Error handling`
1771
1772	`</span>`
1773	`</a>`
1774
1775	`</li>`
1776
1777	`</ul>`
1778
1779	`</nav>`
1780	`</div>`
1781	`</div>`
1782	`</div>`
1783
1784
1785
1786	`<div class="md-content" data-md-component="content">`
1787
1788	`<article class="md-content__inner md-typeset">`
1789
1790
1791
1792
1793
1794
1795
1796
1797	`<h1 id="python-sdk">Python SDK<a class="headerlink" href="#python-sdk" title="Permanent link">¶</a></h1>`
1798	`<p>The navegador Python SDK lets you drive ingestion, query the graph, and load context from your own scripts and tools — without going through the CLI.</p>`
1799	`<hr />`
1800	`<h2 id="installation">Installation<a class="headerlink" href="#installation" title="Permanent link">¶</a></h2>`
1801	`<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>pip<span class="w"> </span>install<span class="w"> </span>navegador`
1802	`</code></pre></div>`
1803	`<p>For Redis (production/team) support:</p>`
1804	`<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a>pip<span class="w"> </span>install<span class="w"> </span><span class="s2">"navegador[redis]"</span>`
1805	`</code></pre></div>`
1806	`<hr />`
1807	`<h2 id="connecting-to-the-graph">Connecting to the graph<a class="headerlink" href="#connecting-to-the-graph" title="Permanent link">¶</a></h2>`
1808	`<div class="tabbed-set tabbed-alternate" data-tabs="1:2"><input checked="checked" id="__tabbed_1_1" name="__tabbed_1" type="radio" /><input id="__tabbed_1_2" name="__tabbed_1" type="radio" /><div class="tabbed-labels"><label for="__tabbed_1_1">SQLite (local)</label><label for="__tabbed_1_2">Redis (production)</label></div>`
1809	`<div class="tabbed-content">`
1810	`<div class="tabbed-block">`
1811	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">GraphStore</span>`
1812	`<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a>`
1813	`<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a><span class="n">store</span> <span class="o">=</span> <span class="n">GraphStore</span><span class="o">.</span><span class="n">sqlite</span><span class="p">(</span><span class="s2">".navegador/navegador.db"</span><span class="p">)</span>`
1814	`</code></pre></div>`
1815	`</div>`
1816	`<div class="tabbed-block">`
1817	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">GraphStore</span>`
1818	`<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a>`
1819	`<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="n">store</span> <span class="o">=</span> <span class="n">GraphStore</span><span class="o">.</span><span class="n">redis</span><span class="p">(</span><span class="s2">"redis://localhost:6379"</span><span class="p">)</span>`
1820	`</code></pre></div>`
1821	`</div>`
1822	`</div>`
1823	`</div>`
1824	`<p>Both backends implement the same interface. All examples below work with either.</p>`
1825	`<p>Use the context manager to ensure the connection is closed:</p>`
1826	`<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="k">with</span> <span class="n">GraphStore</span><span class="o">.</span><span class="n">sqlite</span><span class="p">(</span><span class="s2">".navegador/navegador.db"</span><span class="p">)</span> <span class="k">as</span> <span class="n">store</span><span class="p">:</span>`
1827	`<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-2"></a> <span class="n">results</span> <span class="o">=</span> <span class="n">store</span><span class="o">.</span><span class="n">query</span><span class="p">(</span><span class="s2">"MATCH (n) RETURN count(n) AS total"</span><span class="p">)</span>`
1828	`<a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a> <span class="nb">print</span><span class="p">(</span><span class="n">results</span><span class="p">[</span><span class="mi">0</span><span class="p">][</span><span class="s2">"total"</span><span class="p">])</span>`
1829	`</code></pre></div>`
1830	`<hr />`
1831	`<h2 id="ingestion">Ingestion<a class="headerlink" href="#ingestion" title="Permanent link">¶</a></h2>`
1832	`<h3 id="ingest-a-repo">Ingest a repo<a class="headerlink" href="#ingest-a-repo" title="Permanent link">¶</a></h3>`
1833	`<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">GraphStore</span>`
1834	`<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.ingest</span><span class="w"> </span><span class="kn">import</span> <span class="n">RepoIngester</span>`
1835	`<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>`
1836	`<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="n">store</span> <span class="o">=</span> <span class="n">GraphStore</span><span class="o">.</span><span class="n">sqlite</span><span class="p">(</span><span class="s2">".navegador/navegador.db"</span><span class="p">)</span>`
1837	`<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="n">ingester</span> <span class="o">=</span> <span class="n">RepoIngester</span><span class="p">(</span><span class="n">store</span><span class="p">)</span>`
1838	`<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>`
1839	`<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest</span><span class="p">(</span><span class="s2">"./src"</span><span class="p">)</span>`
1840	<a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">nodes_created</span><span class="si">}</span><span class="s2"> nodes, </span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">edges_created</span><span class="si">}</span><span class="s2"> edges in </span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">duration_seconds</span><span class="si">:</span><span class="s2">.2f</span><span class="si">}</span><span class="s2">s"</span><span class="p">)</span>
1841	`</code></pre></div>`
1842	`<h3 id="incremental-ingest-single-file">Incremental ingest (single file)<a class="headerlink" href="#incremental-ingest-single-file" title="Permanent link">¶</a></h3>`
1843	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest_file</span><span class="p">(</span><span class="s2">"./src/auth/service.py"</span><span class="p">)</span>`
1844	`</code></pre></div>`
1845	`<h3 id="wipe-and-rebuild">Wipe and rebuild<a class="headerlink" href="#wipe-and-rebuild" title="Permanent link">¶</a></h3>`
1846	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest</span><span class="p">(</span><span class="s2">"./src"</span><span class="p">,</span> <span class="n">clear</span><span class="o">=</span><span class="kc">True</span><span class="p">)</span>`
1847	`</code></pre></div>`
1848	`<h3 id="add-knowledge-programmatically">Add knowledge programmatically<a class="headerlink" href="#add-knowledge-programmatically" title="Permanent link">¶</a></h3>`
1849	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.ingest</span><span class="w"> </span><span class="kn">import</span> <span class="n">KnowledgeIngester</span>`
1850	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a>`
1851	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="n">ki</span> <span class="o">=</span> <span class="n">KnowledgeIngester</span><span class="p">(</span><span class="n">store</span><span class="p">)</span>`
1852	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a>`
1853	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="n">ki</span><span class="o">.</span><span class="n">add_domain</span><span class="p">(</span><span class="s2">"Payments"</span><span class="p">,</span> <span class="n">description</span><span class="o">=</span><span class="s2">"Payment processing and billing"</span><span class="p">)</span>`
1854	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="n">ki</span><span class="o">.</span><span class="n">add_concept</span><span class="p">(</span><span class="s2">"Idempotency"</span><span class="p">,</span> <span class="n">domain</span><span class="o">=</span><span class="s2">"Payments"</span><span class="p">,</span>`
1855	`<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a> <span class="n">description</span><span class="o">=</span><span class="s2">"Operations safe to retry without side effects"</span><span class="p">)</span>`
1856	`<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="n">ki</span><span class="o">.</span><span class="n">add_rule</span><span class="p">(</span><span class="s2">"RequireIdempotencyKey"</span><span class="p">,</span>`
1857	`<a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a> <span class="n">domain</span><span class="o">=</span><span class="s2">"Payments"</span><span class="p">,</span> <span class="n">severity</span><span class="o">=</span><span class="s2">"critical"</span><span class="p">,</span>`
1858	`<a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a> <span class="n">rationale</span><span class="o">=</span><span class="s2">"Card networks retry on timeout"</span><span class="p">)</span>`
1859	`<a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="n">ki</span><span class="o">.</span><span class="n">annotate</span><span class="p">(</span><span class="s2">"process_payment"</span><span class="p">,</span> <span class="n">node_type</span><span class="o">=</span><span class="s2">"Function"</span><span class="p">,</span>`
1860	`<a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a> <span class="n">concept</span><span class="o">=</span><span class="s2">"Idempotency"</span><span class="p">,</span> <span class="n">rule</span><span class="o">=</span><span class="s2">"RequireIdempotencyKey"</span><span class="p">)</span>`
1861	`</code></pre></div>`
1862	`<hr />`
1863	`<h2 id="loading-context">Loading context<a class="headerlink" href="#loading-context" title="Permanent link">¶</a></h2>`
1864	`<p><code>ContextLoader</code> builds structured context bundles from the graph. Each method corresponds to a CLI command.</p>`
1865	`<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.graph</span><span class="w"> </span><span class="kn">import</span> <span class="n">GraphStore</span>`
1866	`<a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.context</span><span class="w"> </span><span class="kn">import</span> <span class="n">ContextLoader</span>`
1867	`<a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a>`
1868	`<a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="n">store</span> <span class="o">=</span> <span class="n">GraphStore</span><span class="o">.</span><span class="n">sqlite</span><span class="p">(</span><span class="s2">".navegador/navegador.db"</span><span class="p">)</span>`
1869	`<a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="n">loader</span> <span class="o">=</span> <span class="n">ContextLoader</span><span class="p">(</span><span class="n">store</span><span class="p">)</span>`
1870	`</code></pre></div>`
1871	`<h3 id="file-context">File context<a class="headerlink" href="#file-context" title="Permanent link">¶</a></h3>`
1872	`<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_file</span><span class="p">(</span><span class="s2">"src/auth/service.py"</span><span class="p">)</span>`
1873	`<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="nb">print</span><span class="p">(</span><span class="n">bundle</span><span class="o">.</span><span class="n">to_markdown</span><span class="p">())</span>`
1874	`</code></pre></div>`
1875	`<h3 id="function-with-call-graph">Function with call graph<a class="headerlink" href="#function-with-call-graph" title="Permanent link">¶</a></h3>`
1876	`<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="c1"># depth controls how many hops of callers/callees to include</span>`
1877	`<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_function</span><span class="p">(</span><span class="s2">"validate_token"</span><span class="p">,</span> <span class="n">depth</span><span class="o">=</span><span class="mi">2</span><span class="p">)</span>`
1878	`<a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="nb">print</span><span class="p">(</span><span class="n">bundle</span><span class="o">.</span><span class="n">to_json</span><span class="p">())</span>`
1879	`</code></pre></div>`
1880	`<h3 id="class-hierarchy">Class hierarchy<a class="headerlink" href="#class-hierarchy" title="Permanent link">¶</a></h3>`
1881	<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_class</span><span class="p">(</span><span class="s2">"PaymentProcessor"</span><span class="p">,</span> <span class="n">file</span><span class="o">=</span><span class="s2">"src/payments/processor.py"</span><span class="p">)</span>
1882	`<a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="n">data</span> <span class="o">=</span> <span class="n">bundle</span><span class="o">.</span><span class="n">to_dict</span><span class="p">()</span>`
1883	`</code></pre></div>`
1884	`<h3 id="universal-explain">Universal explain<a class="headerlink" href="#universal-explain" title="Permanent link">¶</a></h3>`
1885	`<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="c1"># works for any node type: function, class, file, concept, rule, decision</span>`
1886	`<a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">explain</span><span class="p">(</span><span class="s2">"AuthService"</span><span class="p">)</span>`
1887	`<a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">explain</span><span class="p">(</span><span class="s2">"PaymentsMustBeIdempotent"</span><span class="p">)</span>`
1888	`</code></pre></div>`
1889	`<h3 id="concept-and-domain">Concept and domain<a class="headerlink" href="#concept-and-domain" title="Permanent link">¶</a></h3>`
1890	`<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_concept</span><span class="p">(</span><span class="s2">"Idempotency"</span><span class="p">)</span>`
1891	`<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_domain</span><span class="p">(</span><span class="s2">"Payments"</span><span class="p">)</span>`
1892	`</code></pre></div>`
1893	`<hr />`
1894	`<h2 id="search">Search<a class="headerlink" href="#search" title="Permanent link">¶</a></h2>`
1895	`<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="c1"># search function and class names (default)</span>`
1896	`<a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a><span class="n">nodes</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="s2">"rate limit"</span><span class="p">)</span>`
1897	`<a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a>`
1898	`<a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a><span class="c1"># search all layers including knowledge and docs</span>`
1899	<a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a><span class="n">nodes</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">search</span><span class="p">(</span><span class="s2">"rate limit"</span><span class="p">,</span> <span class="n">all_layers</span><span class="o">=</span><span class="kc">True</span><span class="p">,</span> <span class="n">limit</span><span class="o">=</span><span class="mi">50</span><span class="p">)</span>
1900	`<a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a>`
1901	`<a id="__codelineno-15-7" name="__codelineno-15-7" href="#__codelineno-15-7"></a><span class="c1"># search docstrings and wiki content only</span>`
1902	`<a id="__codelineno-15-8" name="__codelineno-15-8" href="#__codelineno-15-8"></a><span class="n">nodes</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">search_by_docstring</span><span class="p">(</span><span class="s2">"retry logic"</span><span class="p">)</span>`
1903	`<a id="__codelineno-15-9" name="__codelineno-15-9" href="#__codelineno-15-9"></a>`
1904	`<a id="__codelineno-15-10" name="__codelineno-15-10" href="#__codelineno-15-10"></a><span class="c1"># find all functions using a specific decorator</span>`
1905	`<a id="__codelineno-15-11" name="__codelineno-15-11" href="#__codelineno-15-11"></a><span class="n">nodes</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">decorated_by</span><span class="p">(</span><span class="s2">"login_required"</span><span class="p">)</span>`
1906	`<a id="__codelineno-15-12" name="__codelineno-15-12" href="#__codelineno-15-12"></a>`
1907	`<a id="__codelineno-15-13" name="__codelineno-15-13" href="#__codelineno-15-13"></a><span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">nodes</span><span class="p">:</span>`
1908	<a id="__codelineno-15-14" name="__codelineno-15-14" href="#__codelineno-15-14"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">label</span><span class="si">}</span><span class="s2">: </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> (</span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">properties</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">'file'</span><span class="p">,</span><span class="w"> </span><span class="s1">''</span><span class="p">)</span><span class="si">}</span><span class="s2">)"</span><span class="p">)</span>
1909	`</code></pre></div>`
1910	`<hr />`
1911	`<h2 id="knowledge-queries">Knowledge queries<a class="headerlink" href="#knowledge-queries" title="Permanent link">¶</a></h2>`
1912	`<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="c1"># everything in the Payments domain</span>`
1913	`<a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_domain</span><span class="p">(</span><span class="s2">"Payments"</span><span class="p">)</span>`
1914	`<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a><span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">bundle</span><span class="o">.</span><span class="n">nodes</span><span class="p">:</span>`
1915	<a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">" [</span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">label</span><span class="si">}</span><span class="s2">] </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
1916	`<a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a>`
1917	`<a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="c1"># all code annotated with a concept</span>`
1918	`<a id="__codelineno-16-7" name="__codelineno-16-7" href="#__codelineno-16-7"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_concept</span><span class="p">(</span><span class="s2">"Idempotency"</span><span class="p">)</span>`
1919	`<a id="__codelineno-16-8" name="__codelineno-16-8" href="#__codelineno-16-8"></a><span class="k">for</span> <span class="n">node</span> <span class="ow">in</span> <span class="n">bundle</span><span class="o">.</span><span class="n">nodes</span><span class="p">:</span>`
1920	`<a id="__codelineno-16-9" name="__codelineno-16-9" href="#__codelineno-16-9"></a> <span class="k">if</span> <span class="n">node</span><span class="o">.</span><span class="n">layer</span> <span class="o">==</span> <span class="s2">"code"</span><span class="p">:</span>`
1921	<a id="__codelineno-16-10" name="__codelineno-16-10" href="#__codelineno-16-10"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">" </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">name</span><span class="si">}</span><span class="s2"> </span><span class="si">{</span><span class="n">node</span><span class="o">.</span><span class="n">properties</span><span class="o">.</span><span class="n">get</span><span class="p">(</span><span class="s1">'file'</span><span class="p">,</span><span class="w"> </span><span class="s1">''</span><span class="p">)</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
1922	`</code></pre></div>`
1923	`<hr />`
1924	`<h2 id="exporting-output">Exporting output<a class="headerlink" href="#exporting-output" title="Permanent link">¶</a></h2>`
1925	`<p>Every <code>ContextBundle</code> supports three output formats:</p>`
1926	`<div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="n">bundle</span> <span class="o">=</span> <span class="n">loader</span><span class="o">.</span><span class="n">load_function</span><span class="p">(</span><span class="s2">"process_payment"</span><span class="p">)</span>`
1927	`<a id="__codelineno-17-2" name="__codelineno-17-2" href="#__codelineno-17-2"></a>`
1928	`<a id="__codelineno-17-3" name="__codelineno-17-3" href="#__codelineno-17-3"></a><span class="c1"># JSON string — for agents, APIs, CI</span>`
1929	`<a id="__codelineno-17-4" name="__codelineno-17-4" href="#__codelineno-17-4"></a><span class="n">json_str</span> <span class="o">=</span> <span class="n">bundle</span><span class="o">.</span><span class="n">to_json</span><span class="p">()</span>`
1930	`<a id="__codelineno-17-5" name="__codelineno-17-5" href="#__codelineno-17-5"></a>`
1931	`<a id="__codelineno-17-6" name="__codelineno-17-6" href="#__codelineno-17-6"></a><span class="c1"># Markdown — readable by humans and LLMs</span>`
1932	`<a id="__codelineno-17-7" name="__codelineno-17-7" href="#__codelineno-17-7"></a><span class="n">md_str</span> <span class="o">=</span> <span class="n">bundle</span><span class="o">.</span><span class="n">to_markdown</span><span class="p">()</span>`
1933	`<a id="__codelineno-17-8" name="__codelineno-17-8" href="#__codelineno-17-8"></a>`
1934	`<a id="__codelineno-17-9" name="__codelineno-17-9" href="#__codelineno-17-9"></a><span class="c1"># Python dict — for further processing</span>`
1935	`<a id="__codelineno-17-10" name="__codelineno-17-10" href="#__codelineno-17-10"></a><span class="n">data</span> <span class="o">=</span> <span class="n">bundle</span><span class="o">.</span><span class="n">to_dict</span><span class="p">()</span>`
1936	`<a id="__codelineno-17-11" name="__codelineno-17-11" href="#__codelineno-17-11"></a><span class="nb">print</span><span class="p">(</span><span class="n">data</span><span class="p">[</span><span class="s2">"root"</span><span class="p">][</span><span class="s2">"name"</span><span class="p">])</span>`
1937	`<a id="__codelineno-17-12" name="__codelineno-17-12" href="#__codelineno-17-12"></a><span class="nb">print</span><span class="p">(</span><span class="nb">len</span><span class="p">(</span><span class="n">data</span><span class="p">[</span><span class="s2">"nodes"</span><span class="p">]))</span>`
1938	`</code></pre></div>`
1939	`<hr />`
1940	`<h2 id="raw-cypher-queries">Raw Cypher queries<a class="headerlink" href="#raw-cypher-queries" title="Permanent link">¶</a></h2>`
1941	`<p>Drop to raw Cypher for anything the built-in methods don't cover:</p>`
1942	`<div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="n">results</span> <span class="o">=</span> <span class="n">store</span><span class="o">.</span><span class="n">query</span><span class="p">(</span>`
1943	`<a id="__codelineno-18-2" name="__codelineno-18-2" href="#__codelineno-18-2"></a> <span class="s2">"MATCH (f:Function)-[:CALLS]->(g:Function) "</span>`
1944	`<a id="__codelineno-18-3" name="__codelineno-18-3" href="#__codelineno-18-3"></a> <span class="s2">"WHERE f.file = $file "</span>`
1945	`<a id="__codelineno-18-4" name="__codelineno-18-4" href="#__codelineno-18-4"></a> <span class="s2">"RETURN f.name, g.name"</span><span class="p">,</span>`
1946	`<a id="__codelineno-18-5" name="__codelineno-18-5" href="#__codelineno-18-5"></a> <span class="n">params</span><span class="o">=</span><span class="p">{</span><span class="s2">"file"</span><span class="p">:</span> <span class="s2">"src/payments/processor.py"</span><span class="p">}</span>`
1947	`<a id="__codelineno-18-6" name="__codelineno-18-6" href="#__codelineno-18-6"></a><span class="p">)</span>`
1948	`<a id="__codelineno-18-7" name="__codelineno-18-7" href="#__codelineno-18-7"></a><span class="k">for</span> <span class="n">row</span> <span class="ow">in</span> <span class="n">results</span><span class="p">:</span>`
1949	<a id="__codelineno-18-8" name="__codelineno-18-8" href="#__codelineno-18-8"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"</span><span class="si">{</span><span class="n">row</span><span class="p">[</span><span class="s1">'f.name'</span><span class="p">]</span><span class="si">}</span><span class="s2"> -> </span><span class="si">{</span><span class="n">row</span><span class="p">[</span><span class="s1">'g.name'</span><span class="p">]</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>
1950	`</code></pre></div>`
1951	`<div class="admonition warning">`
1952	`<p class="admonition-title">Warning</p>`
1953	`<p><code>store.query()</code> executes writes as well as reads. Stick to <code>MATCH</code> / <code>RETURN</code> for inspection queries.</p>`
1954	`</div>`
1955	`<hr />`
1956	`<h2 id="wiki-ingestion">Wiki ingestion<a class="headerlink" href="#wiki-ingestion" title="Permanent link">¶</a></h2>`
1957	`<div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="kn">import</span><span class="w"> </span><span class="nn">os</span>`
1958	`<a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a><span class="kn">from</span><span class="w"> </span><span class="nn">navegador.ingest</span><span class="w"> </span><span class="kn">import</span> <span class="n">WikiIngester</span>`
1959	`<a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a>`
1960	`<a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a><span class="n">ingester</span> <span class="o">=</span> <span class="n">WikiIngester</span><span class="p">(</span><span class="n">store</span><span class="p">)</span>`
1961	`<a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a>`
1962	`<a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a><span class="c1"># from GitHub API</span>`
1963	<a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest_repo</span><span class="p">(</span><span class="s2">"myorg/myrepo"</span><span class="p">,</span> <span class="n">token</span><span class="o">=</span><span class="n">os</span><span class="o">.</span><span class="n">environ</span><span class="p">[</span><span class="s2">"GITHUB_TOKEN"</span><span class="p">])</span>
1964	`<a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a>`
1965	`<a id="__codelineno-19-9" name="__codelineno-19-9" href="#__codelineno-19-9"></a><span class="c1"># from a locally cloned wiki directory</span>`
1966	`<a id="__codelineno-19-10" name="__codelineno-19-10" href="#__codelineno-19-10"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest_dir</span><span class="p">(</span><span class="s2">"./myrepo.wiki"</span><span class="p">)</span>`
1967	`</code></pre></div>`
1968	`<hr />`
1969	`<h2 id="error-handling">Error handling<a class="headerlink" href="#error-handling" title="Permanent link">¶</a></h2>`
1970	`<p>All ingesters return an <code>IngestionResult</code> dataclass. Check <code>errors</code> for per-file failures without crashing the whole run:</p>`
1971	`<div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="n">result</span> <span class="o">=</span> <span class="n">ingester</span><span class="o">.</span><span class="n">ingest</span><span class="p">(</span><span class="s2">"./src"</span><span class="p">)</span>`
1972	`<a id="__codelineno-20-2" name="__codelineno-20-2" href="#__codelineno-20-2"></a><span class="k">if</span> <span class="n">result</span><span class="o">.</span><span class="n">errors</span><span class="p">:</span>`
1973	`<a id="__codelineno-20-3" name="__codelineno-20-3" href="#__codelineno-20-3"></a> <span class="k">for</span> <span class="n">err</span> <span class="ow">in</span> <span class="n">result</span><span class="o">.</span><span class="n">errors</span><span class="p">:</span>`
1974	`<a id="__codelineno-20-4" name="__codelineno-20-4" href="#__codelineno-20-4"></a> <span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Warning: </span><span class="si">{</span><span class="n">err</span><span class="si">}</span><span class="s2">"</span><span class="p">)</span>`
1975	<a id="__codelineno-20-5" name="__codelineno-20-5" href="#__codelineno-20-5"></a><span class="nb">print</span><span class="p">(</span><span class="sa">f</span><span class="s2">"Processed </span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">files_processed</span><span class="si">}</span><span class="s2"> files, </span><span class="si">{</span><span class="n">result</span><span class="o">.</span><span class="n">nodes_created</span><span class="si">}</span><span class="s2"> nodes created"</span><span class="p">)</span>
1976	`</code></pre></div>`
1977
1978
1979
1980
1981
1982
1983
1984
1985
1986
1987
1988
1989
1990	`</article>`
1991	`</div>`
1992
1993
1994	`<script>var tabs=__md_get("__tabs");if(Array.isArray(tabs))e:for(var set of document.querySelectorAll(".tabbed-set")){var labels=set.querySelector(".tabbed-labels");for(var tab of tabs)for(var label of labels.getElementsByTagName("label"))if(label.innerText.trim()===tab){var input=document.getElementById(label.htmlFor);input.checked=!0;continue e}}</script>`
1995
1996	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
1997	`</div>`
1998
1999	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
2000
2001	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M13 20h-2V8l-5.5 5.5-1.42-1.42L12 4.16l7.92 7.92-1.42 1.42L13 8z"/></svg>`
2002	`Back to top`
2003	`</button>`
2004
2005	`</main>`
2006
2007	`<footer class="md-footer">`
2008
2009	`<div class="md-footer-meta md-typeset">`
2010	`<div class="md-footer-meta__inner md-grid">`
2011	`<div class="md-copyright">`
2012
2013	`<div class="md-copyright__highlight">`
2014	`Copyright © 2026 CONFLICT LLC`
2015	`</div>`
2016
2017
2018	`Made with`
2019	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
2020	`Material for MkDocs`
2021	`</a>`
2022
2023	`</div>`
2024
2025
2026	`<div class="md-social">`
2027
2028
2029
2030
2031
2032
2033
2034
2035	`<a href="https://github.com/ConflictHQ/navegador" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
2036	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
2037	`</a>`
2038
2039	`</div>`
2040
2041	`</div>`
2042	`</div>`
2043	`</footer>`
2044
2045	`</div>`
2046	`<div class="md-dialog" data-md-component="dialog">`
2047	`<div class="md-dialog__inner md-typeset"></div>`
2048	`</div>`
2049
2050
2051
2052
2053
2054	<script id="__config" type="application/json">{"annotate": null, "base": "../..", "features": ["navigation.instant", "navigation.tabs", "navigation.sections", "navigation.expand", "navigation.top", "search.suggest", "search.highlight", "content.code.copy", "content.tabs.link", "header.autohide"], "search": "../../assets/javascripts/workers/search.2c215733.min.js", "tags": null, "translations": {"clipboard.copied": "Copied to clipboard", "clipboard.copy": "Copy to clipboard", "search.result.more.one": "1 more on this page", "search.result.more.other": "# more on this page", "search.result.none": "No matching documents", "search.result.one": "1 matching document", "search.result.other": "# matching documents", "search.result.placeholder": "Type to start searching", "search.result.term.missing": "Missing", "select.version": "Select version"}, "version": null}</script>
2055
2056
2057	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
2058
2059
2060	`</body>`
2061	`</html>`

Navegador

Keyboard Shortcuts