Navegador

navegador / api / sdk / index.html

Source Rendered

Blame History Raw 2857 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/api/sdk/">`
16
17
18	`<link rel="prev" href="../../architecture/graph-schema/">`
19
20
21	`<link rel="next" href="../ingestion/">`
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-reference" 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	`<li class="md-tabs__item">`
274	`<a href="../../guide/ingestion/" class="md-tabs__link">`
275
276
277
278	`Guide`
279
280	`</a>`
281	`</li>`
282
283
284
285
286
287
288
289
290
291
292
293	`<li class="md-tabs__item">`
294	`<a href="../../architecture/overview/" class="md-tabs__link">`
295
296
297
298	`Architecture`
299
300	`</a>`
301	`</li>`
302
303
304
305
306
307
308
309
310
311
312
313
314
315	`<li class="md-tabs__item md-tabs__item--active">`
316	`<a href="./" 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	`<li class="md-nav__item md-nav__item--nested">`
561
562
563
564
565
566	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_3" >`
567
568
569	`<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="0">`
570
571
572
573	`<span class="md-ellipsis">`
574
575
576	`Guide`
577
578
579
580	`</span>`
581
582
583
584	`<span class="md-nav__icon md-icon"></span>`
585	`</label>`
586
587	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="false">`
588	`<label class="md-nav__title" for="__nav_3">`
589	`<span class="md-nav__icon md-icon"></span>`
590
591
592	`Guide`
593
594
595	`</label>`
596	`<ul class="md-nav__list" data-md-scrollfix>`
597
598
599
600
601
602
603
604	`<li class="md-nav__item">`
605	`<a href="../../guide/ingestion/" class="md-nav__link">`
606
607
608
609	`<span class="md-ellipsis">`
610
611
612	`Ingesting a Repo`
613
614
615
616	`</span>`
617
618
619
620	`</a>`
621	`</li>`
622
623
624
625
626
627
628
629
630
631
632	`<li class="md-nav__item">`
633	`<a href="../../guide/context-loading/" class="md-nav__link">`
634
635
636
637	`<span class="md-ellipsis">`
638
639
640	`Loading Context`
641
642
643
644	`</span>`
645
646
647
648	`</a>`
649	`</li>`
650
651
652
653
654
655
656
657
658
659
660	`<li class="md-nav__item">`
661	`<a href="../../guide/framework-enrichment/" class="md-nav__link">`
662
663
664
665	`<span class="md-ellipsis">`
666
667
668	`Framework Enrichment`
669
670
671
672	`</span>`
673
674
675
676	`</a>`
677	`</li>`
678
679
680
681
682
683
684
685
686
687
688	`<li class="md-nav__item">`
689	`<a href="../../guide/analysis/" class="md-nav__link">`
690
691
692
693	`<span class="md-ellipsis">`
694
695
696	`Structural Analysis`
697
698
699
700	`</span>`
701
702
703
704	`</a>`
705	`</li>`
706
707
708
709
710
711
712
713
714
715
716	`<li class="md-nav__item">`
717	`<a href="../../guide/intelligence/" class="md-nav__link">`
718
719
720
721	`<span class="md-ellipsis">`
722
723
724	`Intelligence Layer`
725
726
727
728	`</span>`
729
730
731
732	`</a>`
733	`</li>`
734
735
736
737
738
739
740
741
742
743
744	`<li class="md-nav__item">`
745	`<a href="../../guide/sdk/" class="md-nav__link">`
746
747
748
749	`<span class="md-ellipsis">`
750
751
752	`Python SDK`
753
754
755
756	`</span>`
757
758
759
760	`</a>`
761	`</li>`
762
763
764
765
766
767
768
769
770
771
772	`<li class="md-nav__item">`
773	`<a href="../../guide/graph-queries/" class="md-nav__link">`
774
775
776
777	`<span class="md-ellipsis">`
778
779
780	`Graph Queries`
781
782
783
784	`</span>`
785
786
787
788	`</a>`
789	`</li>`
790
791
792
793
794
795
796
797
798
799
800	`<li class="md-nav__item">`
801	`<a href="../../guide/mcp-integration/" class="md-nav__link">`
802
803
804
805	`<span class="md-ellipsis">`
806
807
808	`MCP Integration`
809
810
811
812	`</span>`
813
814
815
816	`</a>`
817	`</li>`
818
819
820
821
822
823
824
825
826
827
828	`<li class="md-nav__item">`
829	`<a href="../../guide/ci-cd/" class="md-nav__link">`
830
831
832
833	`<span class="md-ellipsis">`
834
835
836	`CI/CD`
837
838
839
840	`</span>`
841
842
843
844	`</a>`
845	`</li>`
846
847
848
849
850
851
852
853
854
855
856	`<li class="md-nav__item">`
857	`<a href="../../guide/cluster/" class="md-nav__link">`
858
859
860
861	`<span class="md-ellipsis">`
862
863
864	`Cluster Mode`
865
866
867
868	`</span>`
869
870
871
872	`</a>`
873	`</li>`
874
875
876
877
878
879
880
881
882
883
884	`<li class="md-nav__item">`
885	`<a href="../../guide/agent-hooks/" class="md-nav__link">`
886
887
888
889	`<span class="md-ellipsis">`
890
891
892	`Agent Hooks`
893
894
895
896	`</span>`
897
898
899
900	`</a>`
901	`</li>`
902
903
904
905
906
907
908
909
910
911
912	`<li class="md-nav__item">`
913	`<a href="../../guide/planopticon/" class="md-nav__link">`
914
915
916
917	`<span class="md-ellipsis">`
918
919
920	`Planopticon`
921
922
923
924	`</span>`
925
926
927
928	`</a>`
929	`</li>`
930
931
932
933
934	`</ul>`
935	`</nav>`
936
937	`</li>`
938
939
940
941
942
943
944
945
946
947
948
949
950
951
952
953
954
955
956
957	`<li class="md-nav__item md-nav__item--nested">`
958
959
960
961
962
963	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >`
964
965
966	`<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">`
967
968
969
970	`<span class="md-ellipsis">`
971
972
973	`Architecture`
974
975
976
977	`</span>`
978
979
980
981	`<span class="md-nav__icon md-icon"></span>`
982	`</label>`
983
984	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">`
985	`<label class="md-nav__title" for="__nav_4">`
986	`<span class="md-nav__icon md-icon"></span>`
987
988
989	`Architecture`
990
991
992	`</label>`
993	`<ul class="md-nav__list" data-md-scrollfix>`
994
995
996
997
998
999
1000
1001	`<li class="md-nav__item">`
1002	`<a href="../../architecture/overview/" class="md-nav__link">`
1003
1004
1005
1006	`<span class="md-ellipsis">`
1007
1008
1009	`Overview`
1010
1011
1012
1013	`</span>`
1014
1015
1016
1017	`</a>`
1018	`</li>`
1019
1020
1021
1022
1023
1024
1025
1026
1027
1028
1029	`<li class="md-nav__item">`
1030	`<a href="../../architecture/graph-schema/" class="md-nav__link">`
1031
1032
1033
1034	`<span class="md-ellipsis">`
1035
1036
1037	`Graph Schema`
1038
1039
1040
1041	`</span>`
1042
1043
1044
1045	`</a>`
1046	`</li>`
1047
1048
1049
1050
1051	`</ul>`
1052	`</nav>`
1053
1054	`</li>`
1055
1056
1057
1058
1059
1060
1061
1062
1063
1064
1065
1066
1067
1068
1069
1070
1071
1072
1073
1074
1075
1076
1077
1078
1079	`<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">`
1080
1081
1082
1083	`<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_5" checked>`
1084
1085
1086	`<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="">`
1087
1088
1089
1090	`<span class="md-ellipsis">`
1091
1092
1093	`API Reference`
1094
1095
1096
1097	`</span>`
1098
1099
1100
1101	`<span class="md-nav__icon md-icon"></span>`
1102	`</label>`
1103
1104	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="true">`
1105	`<label class="md-nav__title" for="__nav_5">`
1106	`<span class="md-nav__icon md-icon"></span>`
1107
1108
1109	`API Reference`
1110
1111
1112	`</label>`
1113	`<ul class="md-nav__list" data-md-scrollfix>`
1114
1115
1116
1117
1118
1119
1120
1121
1122
1123	`<li class="md-nav__item md-nav__item--active">`
1124
1125	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
1126
1127
1128
1129
1130
1131	`<label class="md-nav__link md-nav__link--active" for="__toc">`
1132
1133
1134
1135	`<span class="md-ellipsis">`
1136
1137
1138	`Python SDK`
1139
1140
1141
1142	`</span>`
1143
1144
1145
1146	`<span class="md-nav__icon md-icon"></span>`
1147	`</label>`
1148
1149	`<a href="./" class="md-nav__link md-nav__link--active">`
1150
1151
1152
1153	`<span class="md-ellipsis">`
1154
1155
1156	`Python SDK`
1157
1158
1159
1160	`</span>`
1161
1162
1163
1164	`</a>`
1165
1166
1167
1168	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1169
1170
1171
1172
1173
1174
1175	`<label class="md-nav__title" for="__toc">`
1176	`<span class="md-nav__icon md-icon"></span>`
1177	`Table of contents`
1178	`</label>`
1179	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1180
1181	`<li class="md-nav__item">`
1182	`<a href="#graphstore" class="md-nav__link">`
1183	`<span class="md-ellipsis">`
1184
1185	`GraphStore`
1186
1187	`</span>`
1188	`</a>`
1189
1190	`<nav class="md-nav" aria-label="GraphStore">`
1191	`<ul class="md-nav__list">`
1192
1193	`<li class="md-nav__item">`
1194	`<a href="#class-methods" class="md-nav__link">`
1195	`<span class="md-ellipsis">`
1196
1197	`Class methods`
1198
1199	`</span>`
1200	`</a>`
1201
1202	`<nav class="md-nav" aria-label="Class methods">`
1203	`<ul class="md-nav__list">`
1204
1205	`<li class="md-nav__item">`
1206	`<a href="#graphstoresqlite" class="md-nav__link">`
1207	`<span class="md-ellipsis">`
1208
1209	`GraphStore.sqlite`
1210
1211	`</span>`
1212	`</a>`
1213
1214	`</li>`
1215
1216	`<li class="md-nav__item">`
1217	`<a href="#graphstoreredis" class="md-nav__link">`
1218	`<span class="md-ellipsis">`
1219
1220	`GraphStore.redis`
1221
1222	`</span>`
1223	`</a>`
1224
1225	`</li>`
1226
1227	`</ul>`
1228	`</nav>`
1229
1230	`</li>`
1231
1232	`<li class="md-nav__item">`
1233	`<a href="#instance-methods" class="md-nav__link">`
1234	`<span class="md-ellipsis">`
1235
1236	`Instance methods`
1237
1238	`</span>`
1239	`</a>`
1240
1241	`<nav class="md-nav" aria-label="Instance methods">`
1242	`<ul class="md-nav__list">`
1243
1244	`<li class="md-nav__item">`
1245	`<a href="#query" class="md-nav__link">`
1246	`<span class="md-ellipsis">`
1247
1248	`query`
1249
1250	`</span>`
1251	`</a>`
1252
1253	`</li>`
1254
1255	`<li class="md-nav__item">`
1256	`<a href="#create_node" class="md-nav__link">`
1257	`<span class="md-ellipsis">`
1258
1259	`create_node`
1260
1261	`</span>`
1262	`</a>`
1263
1264	`</li>`
1265
1266	`<li class="md-nav__item">`
1267	`<a href="#merge_node" class="md-nav__link">`
1268	`<span class="md-ellipsis">`
1269
1270	`merge_node`
1271
1272	`</span>`
1273	`</a>`
1274
1275	`</li>`
1276
1277	`<li class="md-nav__item">`
1278	`<a href="#create_edge" class="md-nav__link">`
1279	`<span class="md-ellipsis">`
1280
1281	`create_edge`
1282
1283	`</span>`
1284	`</a>`
1285
1286	`</li>`
1287
1288	`<li class="md-nav__item">`
1289	`<a href="#merge_edge" class="md-nav__link">`
1290	`<span class="md-ellipsis">`
1291
1292	`merge_edge`
1293
1294	`</span>`
1295	`</a>`
1296
1297	`</li>`
1298
1299	`<li class="md-nav__item">`
1300	`<a href="#clear" class="md-nav__link">`
1301	`<span class="md-ellipsis">`
1302
1303	`clear`
1304
1305	`</span>`
1306	`</a>`
1307
1308	`</li>`
1309
1310	`<li class="md-nav__item">`
1311	`<a href="#close" class="md-nav__link">`
1312	`<span class="md-ellipsis">`
1313
1314	`close`
1315
1316	`</span>`
1317	`</a>`
1318
1319	`</li>`
1320
1321	`<li class="md-nav__item">`
1322	`<a href="#context-manager" class="md-nav__link">`
1323	`<span class="md-ellipsis">`
1324
1325	`Context manager`
1326
1327	`</span>`
1328	`</a>`
1329
1330	`</li>`
1331
1332	`</ul>`
1333	`</nav>`
1334
1335	`</li>`
1336
1337	`</ul>`
1338	`</nav>`
1339
1340	`</li>`
1341
1342	`<li class="md-nav__item">`
1343	`<a href="#contextloader" class="md-nav__link">`
1344	`<span class="md-ellipsis">`
1345
1346	`ContextLoader`
1347
1348	`</span>`
1349	`</a>`
1350
1351	`<nav class="md-nav" aria-label="ContextLoader">`
1352	`<ul class="md-nav__list">`
1353
1354	`<li class="md-nav__item">`
1355	`<a href="#methods" class="md-nav__link">`
1356	`<span class="md-ellipsis">`
1357
1358	`Methods`
1359
1360	`</span>`
1361	`</a>`
1362
1363	`<nav class="md-nav" aria-label="Methods">`
1364	`<ul class="md-nav__list">`
1365
1366	`<li class="md-nav__item">`
1367	`<a href="#load_file" class="md-nav__link">`
1368	`<span class="md-ellipsis">`
1369
1370	`load_file`
1371
1372	`</span>`
1373	`</a>`
1374
1375	`</li>`
1376
1377	`<li class="md-nav__item">`
1378	`<a href="#load_function" class="md-nav__link">`
1379	`<span class="md-ellipsis">`
1380
1381	`load_function`
1382
1383	`</span>`
1384	`</a>`
1385
1386	`</li>`
1387
1388	`<li class="md-nav__item">`
1389	`<a href="#load_class" class="md-nav__link">`
1390	`<span class="md-ellipsis">`
1391
1392	`load_class`
1393
1394	`</span>`
1395	`</a>`
1396
1397	`</li>`
1398
1399	`<li class="md-nav__item">`
1400	`<a href="#explain" class="md-nav__link">`
1401	`<span class="md-ellipsis">`
1402
1403	`explain`
1404
1405	`</span>`
1406	`</a>`
1407
1408	`</li>`
1409
1410	`<li class="md-nav__item">`
1411	`<a href="#load_concept" class="md-nav__link">`
1412	`<span class="md-ellipsis">`
1413
1414	`load_concept`
1415
1416	`</span>`
1417	`</a>`
1418
1419	`</li>`
1420
1421	`<li class="md-nav__item">`
1422	`<a href="#load_domain" class="md-nav__link">`
1423	`<span class="md-ellipsis">`
1424
1425	`load_domain`
1426
1427	`</span>`
1428	`</a>`
1429
1430	`</li>`
1431
1432	`<li class="md-nav__item">`
1433	`<a href="#search" class="md-nav__link">`
1434	`<span class="md-ellipsis">`
1435
1436	`search`
1437
1438	`</span>`
1439	`</a>`
1440
1441	`</li>`
1442
1443	`<li class="md-nav__item">`
1444	`<a href="#search_by_docstring" class="md-nav__link">`
1445	`<span class="md-ellipsis">`
1446
1447	`search_by_docstring`
1448
1449	`</span>`
1450	`</a>`
1451
1452	`</li>`
1453
1454	`<li class="md-nav__item">`
1455	`<a href="#decorated_by" class="md-nav__link">`
1456	`<span class="md-ellipsis">`
1457
1458	`decorated_by`
1459
1460	`</span>`
1461	`</a>`
1462
1463	`</li>`
1464
1465	`</ul>`
1466	`</nav>`
1467
1468	`</li>`
1469
1470	`</ul>`
1471	`</nav>`
1472
1473	`</li>`
1474
1475	`<li class="md-nav__item">`
1476	`<a href="#contextbundle" class="md-nav__link">`
1477	`<span class="md-ellipsis">`
1478
1479	`ContextBundle`
1480
1481	`</span>`
1482	`</a>`
1483
1484	`<nav class="md-nav" aria-label="ContextBundle">`
1485	`<ul class="md-nav__list">`
1486
1487	`<li class="md-nav__item">`
1488	`<a href="#fields" class="md-nav__link">`
1489	`<span class="md-ellipsis">`
1490
1491	`Fields`
1492
1493	`</span>`
1494	`</a>`
1495
1496	`</li>`
1497
1498	`<li class="md-nav__item">`
1499	`<a href="#methods_1" class="md-nav__link">`
1500	`<span class="md-ellipsis">`
1501
1502	`Methods`
1503
1504	`</span>`
1505	`</a>`
1506
1507	`<nav class="md-nav" aria-label="Methods">`
1508	`<ul class="md-nav__list">`
1509
1510	`<li class="md-nav__item">`
1511	`<a href="#to_json" class="md-nav__link">`
1512	`<span class="md-ellipsis">`
1513
1514	`to_json`
1515
1516	`</span>`
1517	`</a>`
1518
1519	`</li>`
1520
1521	`<li class="md-nav__item">`
1522	`<a href="#to_markdown" class="md-nav__link">`
1523	`<span class="md-ellipsis">`
1524
1525	`to_markdown`
1526
1527	`</span>`
1528	`</a>`
1529
1530	`</li>`
1531
1532	`<li class="md-nav__item">`
1533	`<a href="#to_dict" class="md-nav__link">`
1534	`<span class="md-ellipsis">`
1535
1536	`to_dict`
1537
1538	`</span>`
1539	`</a>`
1540
1541	`</li>`
1542
1543	`</ul>`
1544	`</nav>`
1545
1546	`</li>`
1547
1548	`</ul>`
1549	`</nav>`
1550
1551	`</li>`
1552
1553	`<li class="md-nav__item">`
1554	`<a href="#contextnode" class="md-nav__link">`
1555	`<span class="md-ellipsis">`
1556
1557	`ContextNode`
1558
1559	`</span>`
1560	`</a>`
1561
1562	`</li>`
1563
1564	`<li class="md-nav__item">`
1565	`<a href="#contextedge" class="md-nav__link">`
1566	`<span class="md-ellipsis">`
1567
1568	`ContextEdge`
1569
1570	`</span>`
1571	`</a>`
1572
1573	`</li>`
1574
1575	`<li class="md-nav__item">`
1576	`<a href="#ingestionresult" class="md-nav__link">`
1577	`<span class="md-ellipsis">`
1578
1579	`IngestionResult`
1580
1581	`</span>`
1582	`</a>`
1583
1584	`</li>`
1585
1586	`</ul>`
1587
1588	`</nav>`
1589
1590	`</li>`
1591
1592
1593
1594
1595
1596
1597
1598
1599
1600
1601	`<li class="md-nav__item">`
1602	`<a href="../ingestion/" class="md-nav__link">`
1603
1604
1605
1606	`<span class="md-ellipsis">`
1607
1608
1609	`Ingestion`
1610
1611
1612
1613	`</span>`
1614
1615
1616
1617	`</a>`
1618	`</li>`
1619
1620
1621
1622
1623
1624
1625
1626
1627
1628
1629	`<li class="md-nav__item">`
1630	`<a href="../analysis/" class="md-nav__link">`
1631
1632
1633
1634	`<span class="md-ellipsis">`
1635
1636
1637	`Analysis`
1638
1639
1640
1641	`</span>`
1642
1643
1644
1645	`</a>`
1646	`</li>`
1647
1648
1649
1650
1651
1652
1653
1654
1655
1656
1657	`<li class="md-nav__item">`
1658	`<a href="../graph/" class="md-nav__link">`
1659
1660
1661
1662	`<span class="md-ellipsis">`
1663
1664
1665	`Graph`
1666
1667
1668
1669	`</span>`
1670
1671
1672
1673	`</a>`
1674	`</li>`
1675
1676
1677
1678
1679
1680
1681
1682
1683
1684
1685	`<li class="md-nav__item">`
1686	`<a href="../mcp/" class="md-nav__link">`
1687
1688
1689
1690	`<span class="md-ellipsis">`
1691
1692
1693	`MCP Server`
1694
1695
1696
1697	`</span>`
1698
1699
1700
1701	`</a>`
1702	`</li>`
1703
1704
1705
1706
1707	`</ul>`
1708	`</nav>`
1709
1710	`</li>`
1711
1712
1713
1714	`</ul>`
1715	`</nav>`
1716	`</div>`
1717	`</div>`
1718	`</div>`
1719
1720
1721
1722	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1723	`<div class="md-sidebar__scrollwrap">`
1724	`<div class="md-sidebar__inner">`
1725
1726
1727	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1728
1729
1730
1731
1732
1733
1734	`<label class="md-nav__title" for="__toc">`
1735	`<span class="md-nav__icon md-icon"></span>`
1736	`Table of contents`
1737	`</label>`
1738	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1739
1740	`<li class="md-nav__item">`
1741	`<a href="#graphstore" class="md-nav__link">`
1742	`<span class="md-ellipsis">`
1743
1744	`GraphStore`
1745
1746	`</span>`
1747	`</a>`
1748
1749	`<nav class="md-nav" aria-label="GraphStore">`
1750	`<ul class="md-nav__list">`
1751
1752	`<li class="md-nav__item">`
1753	`<a href="#class-methods" class="md-nav__link">`
1754	`<span class="md-ellipsis">`
1755
1756	`Class methods`
1757
1758	`</span>`
1759	`</a>`
1760
1761	`<nav class="md-nav" aria-label="Class methods">`
1762	`<ul class="md-nav__list">`
1763
1764	`<li class="md-nav__item">`
1765	`<a href="#graphstoresqlite" class="md-nav__link">`
1766	`<span class="md-ellipsis">`
1767
1768	`GraphStore.sqlite`
1769
1770	`</span>`
1771	`</a>`
1772
1773	`</li>`
1774
1775	`<li class="md-nav__item">`
1776	`<a href="#graphstoreredis" class="md-nav__link">`
1777	`<span class="md-ellipsis">`
1778
1779	`GraphStore.redis`
1780
1781	`</span>`
1782	`</a>`
1783
1784	`</li>`
1785
1786	`</ul>`
1787	`</nav>`
1788
1789	`</li>`
1790
1791	`<li class="md-nav__item">`
1792	`<a href="#instance-methods" class="md-nav__link">`
1793	`<span class="md-ellipsis">`
1794
1795	`Instance methods`
1796
1797	`</span>`
1798	`</a>`
1799
1800	`<nav class="md-nav" aria-label="Instance methods">`
1801	`<ul class="md-nav__list">`
1802
1803	`<li class="md-nav__item">`
1804	`<a href="#query" class="md-nav__link">`
1805	`<span class="md-ellipsis">`
1806
1807	`query`
1808
1809	`</span>`
1810	`</a>`
1811
1812	`</li>`
1813
1814	`<li class="md-nav__item">`
1815	`<a href="#create_node" class="md-nav__link">`
1816	`<span class="md-ellipsis">`
1817
1818	`create_node`
1819
1820	`</span>`
1821	`</a>`
1822
1823	`</li>`
1824
1825	`<li class="md-nav__item">`
1826	`<a href="#merge_node" class="md-nav__link">`
1827	`<span class="md-ellipsis">`
1828
1829	`merge_node`
1830
1831	`</span>`
1832	`</a>`
1833
1834	`</li>`
1835
1836	`<li class="md-nav__item">`
1837	`<a href="#create_edge" class="md-nav__link">`
1838	`<span class="md-ellipsis">`
1839
1840	`create_edge`
1841
1842	`</span>`
1843	`</a>`
1844
1845	`</li>`
1846
1847	`<li class="md-nav__item">`
1848	`<a href="#merge_edge" class="md-nav__link">`
1849	`<span class="md-ellipsis">`
1850
1851	`merge_edge`
1852
1853	`</span>`
1854	`</a>`
1855
1856	`</li>`
1857
1858	`<li class="md-nav__item">`
1859	`<a href="#clear" class="md-nav__link">`
1860	`<span class="md-ellipsis">`
1861
1862	`clear`
1863
1864	`</span>`
1865	`</a>`
1866
1867	`</li>`
1868
1869	`<li class="md-nav__item">`
1870	`<a href="#close" class="md-nav__link">`
1871	`<span class="md-ellipsis">`
1872
1873	`close`
1874
1875	`</span>`
1876	`</a>`
1877
1878	`</li>`
1879
1880	`<li class="md-nav__item">`
1881	`<a href="#context-manager" class="md-nav__link">`
1882	`<span class="md-ellipsis">`
1883
1884	`Context manager`
1885
1886	`</span>`
1887	`</a>`
1888
1889	`</li>`
1890
1891	`</ul>`
1892	`</nav>`
1893
1894	`</li>`
1895
1896	`</ul>`
1897	`</nav>`
1898
1899	`</li>`
1900
1901	`<li class="md-nav__item">`
1902	`<a href="#contextloader" class="md-nav__link">`
1903	`<span class="md-ellipsis">`
1904
1905	`ContextLoader`
1906
1907	`</span>`
1908	`</a>`
1909
1910	`<nav class="md-nav" aria-label="ContextLoader">`
1911	`<ul class="md-nav__list">`
1912
1913	`<li class="md-nav__item">`
1914	`<a href="#methods" class="md-nav__link">`
1915	`<span class="md-ellipsis">`
1916
1917	`Methods`
1918
1919	`</span>`
1920	`</a>`
1921
1922	`<nav class="md-nav" aria-label="Methods">`
1923	`<ul class="md-nav__list">`
1924
1925	`<li class="md-nav__item">`
1926	`<a href="#load_file" class="md-nav__link">`
1927	`<span class="md-ellipsis">`
1928
1929	`load_file`
1930
1931	`</span>`
1932	`</a>`
1933
1934	`</li>`
1935
1936	`<li class="md-nav__item">`
1937	`<a href="#load_function" class="md-nav__link">`
1938	`<span class="md-ellipsis">`
1939
1940	`load_function`
1941
1942	`</span>`
1943	`</a>`
1944
1945	`</li>`
1946
1947	`<li class="md-nav__item">`
1948	`<a href="#load_class" class="md-nav__link">`
1949	`<span class="md-ellipsis">`
1950
1951	`load_class`
1952
1953	`</span>`
1954	`</a>`
1955
1956	`</li>`
1957
1958	`<li class="md-nav__item">`
1959	`<a href="#explain" class="md-nav__link">`
1960	`<span class="md-ellipsis">`
1961
1962	`explain`
1963
1964	`</span>`
1965	`</a>`
1966
1967	`</li>`
1968
1969	`<li class="md-nav__item">`
1970	`<a href="#load_concept" class="md-nav__link">`
1971	`<span class="md-ellipsis">`
1972
1973	`load_concept`
1974
1975	`</span>`
1976	`</a>`
1977
1978	`</li>`
1979
1980	`<li class="md-nav__item">`
1981	`<a href="#load_domain" class="md-nav__link">`
1982	`<span class="md-ellipsis">`
1983
1984	`load_domain`
1985
1986	`</span>`
1987	`</a>`
1988
1989	`</li>`
1990
1991	`<li class="md-nav__item">`
1992	`<a href="#search" class="md-nav__link">`
1993	`<span class="md-ellipsis">`
1994
1995	`search`
1996
1997	`</span>`
1998	`</a>`
1999
2000	`</li>`
2001
2002	`<li class="md-nav__item">`
2003	`<a href="#search_by_docstring" class="md-nav__link">`
2004	`<span class="md-ellipsis">`
2005
2006	`search_by_docstring`
2007
2008	`</span>`
2009	`</a>`
2010
2011	`</li>`
2012
2013	`<li class="md-nav__item">`
2014	`<a href="#decorated_by" class="md-nav__link">`
2015	`<span class="md-ellipsis">`
2016
2017	`decorated_by`
2018
2019	`</span>`
2020	`</a>`
2021
2022	`</li>`
2023
2024	`</ul>`
2025	`</nav>`
2026
2027	`</li>`
2028
2029	`</ul>`
2030	`</nav>`
2031
2032	`</li>`
2033
2034	`<li class="md-nav__item">`
2035	`<a href="#contextbundle" class="md-nav__link">`
2036	`<span class="md-ellipsis">`
2037
2038	`ContextBundle`
2039
2040	`</span>`
2041	`</a>`
2042
2043	`<nav class="md-nav" aria-label="ContextBundle">`
2044	`<ul class="md-nav__list">`
2045
2046	`<li class="md-nav__item">`
2047	`<a href="#fields" class="md-nav__link">`
2048	`<span class="md-ellipsis">`
2049
2050	`Fields`
2051
2052	`</span>`
2053	`</a>`
2054
2055	`</li>`
2056
2057	`<li class="md-nav__item">`
2058	`<a href="#methods_1" class="md-nav__link">`
2059	`<span class="md-ellipsis">`
2060
2061	`Methods`
2062
2063	`</span>`
2064	`</a>`
2065
2066	`<nav class="md-nav" aria-label="Methods">`
2067	`<ul class="md-nav__list">`
2068
2069	`<li class="md-nav__item">`
2070	`<a href="#to_json" class="md-nav__link">`
2071	`<span class="md-ellipsis">`
2072
2073	`to_json`
2074
2075	`</span>`
2076	`</a>`
2077
2078	`</li>`
2079
2080	`<li class="md-nav__item">`
2081	`<a href="#to_markdown" class="md-nav__link">`
2082	`<span class="md-ellipsis">`
2083
2084	`to_markdown`
2085
2086	`</span>`
2087	`</a>`
2088
2089	`</li>`
2090
2091	`<li class="md-nav__item">`
2092	`<a href="#to_dict" class="md-nav__link">`
2093	`<span class="md-ellipsis">`
2094
2095	`to_dict`
2096
2097	`</span>`
2098	`</a>`
2099
2100	`</li>`
2101
2102	`</ul>`
2103	`</nav>`
2104
2105	`</li>`
2106
2107	`</ul>`
2108	`</nav>`
2109
2110	`</li>`
2111
2112	`<li class="md-nav__item">`
2113	`<a href="#contextnode" class="md-nav__link">`
2114	`<span class="md-ellipsis">`
2115
2116	`ContextNode`
2117
2118	`</span>`
2119	`</a>`
2120
2121	`</li>`
2122
2123	`<li class="md-nav__item">`
2124	`<a href="#contextedge" class="md-nav__link">`
2125	`<span class="md-ellipsis">`
2126
2127	`ContextEdge`
2128
2129	`</span>`
2130	`</a>`
2131
2132	`</li>`
2133
2134	`<li class="md-nav__item">`
2135	`<a href="#ingestionresult" class="md-nav__link">`
2136	`<span class="md-ellipsis">`
2137
2138	`IngestionResult`
2139
2140	`</span>`
2141	`</a>`
2142
2143	`</li>`
2144
2145	`</ul>`
2146
2147	`</nav>`
2148	`</div>`
2149	`</div>`
2150	`</div>`
2151
2152
2153
2154	`<div class="md-content" data-md-component="content">`
2155
2156	`<article class="md-content__inner md-typeset">`
2157
2158
2159
2160
2161
2162
2163
2164
2165	`<h1 id="python-sdk-reference">Python SDK Reference<a class="headerlink" href="#python-sdk-reference" title="Permanent link">¶</a></h1>`
2166	`<p>Full API reference for the navegador Python SDK.</p>`
2167	`<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-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>`
2168	`<a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-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><span class="p">,</span> <span class="n">ContextBundle</span><span class="p">,</span> <span class="n">ContextNode</span><span class="p">,</span> <span class="n">ContextEdge</span>`
2169	`<a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></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><span class="p">,</span> <span class="n">KnowledgeIngester</span><span class="p">,</span> <span class="n">WikiIngester</span><span class="p">,</span> <span class="n">PlanopticonIngester</span>`
2170	`</code></pre></div>`
2171	`<hr />`
2172	`<h2 id="graphstore">GraphStore<a class="headerlink" href="#graphstore" title="Permanent link">¶</a></h2>`
2173	`<p>Database abstraction layer. Both SQLite and Redis backends implement this interface.</p>`
2174	`<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">GraphStore</span><span class="p">:</span>`
2175	`<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a> <span class="nd">@classmethod</span>`
2176	<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a> <span class="k">def</span><span class="w"> </span><span class="nf">sqlite</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">\|</span> <span class="n">Path</span> <span class="o">=</span> <span class="s2">"navegador.db"</span><span class="p">)</span> <span class="o">-></span> <span class="s2">"GraphStore"</span><span class="p">:</span> <span class="o">...</span>
2177	`<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>`
2178	`<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a> <span class="nd">@classmethod</span>`
2179	<a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a> <span class="k">def</span><span class="w"> </span><span class="nf">redis</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"redis://localhost:6379"</span><span class="p">)</span> <span class="o">-></span> <span class="s2">"GraphStore"</span><span class="p">:</span> <span class="o">...</span>
2180	`</code></pre></div>`
2181	`<h3 id="class-methods">Class methods<a class="headerlink" href="#class-methods" title="Permanent link">¶</a></h3>`
2182	`<h4 id="graphstoresqlite"><code>GraphStore.sqlite</code><a class="headerlink" href="#graphstoresqlite" title="Permanent link">¶</a></h4>`
2183	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="nd">@classmethod</span>`
2184	<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></a><span class="k">def</span><span class="w"> </span><span class="nf">sqlite</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span> <span class="o">\|</span> <span class="n">Path</span> <span class="o">=</span> <span class="s2">"navegador.db"</span><span class="p">)</span> <span class="o">-></span> <span class="s2">"GraphStore"</span>
2185	`</code></pre></div>`
2186	`<p>Open a local SQLite-backed graph. The file is created if it does not exist. Uses <code>falkordblite</code> (embedded engine — no daemon required).</p>`
2187	`<p><strong>Parameters:</strong></p>`
2188	`<table>`
2189	`<thead>`
2190	`<tr>`
2191	`<th>Name</th>`
2192	`<th>Type</th>`
2193	`<th>Default</th>`
2194	`<th>Description</th>`
2195	`</tr>`
2196	`</thead>`
2197	`<tbody>`
2198	`<tr>`
2199	`<td><code>path</code></td>`
2200	`<td><code>str \\| Path</code></td>`
2201	`<td><code>"navegador.db"</code></td>`
2202	`<td>Path to the <code>.db</code> file</td>`
2203	`</tr>`
2204	`</tbody>`
2205	`</table>`
2206	`<p><strong>Returns:</strong> <code>GraphStore</code></p>`
2207	`<h4 id="graphstoreredis"><code>GraphStore.redis</code><a class="headerlink" href="#graphstoreredis" title="Permanent link">¶</a></h4>`
2208	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="nd">@classmethod</span>`
2209	`<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="k">def</span><span class="w"> </span><span class="nf">redis</span><span class="p">(</span><span class="bp">cls</span><span class="p">,</span> <span class="n">url</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">"redis://localhost:6379"</span><span class="p">)</span> <span class="o">-></span> <span class="s2">"GraphStore"</span>`
2210	`</code></pre></div>`
2211	`<p>Connect to a Redis-backed FalkorDB instance.</p>`
2212	`<p><strong>Parameters:</strong></p>`
2213	`<table>`
2214	`<thead>`
2215	`<tr>`
2216	`<th>Name</th>`
2217	`<th>Type</th>`
2218	`<th>Default</th>`
2219	`<th>Description</th>`
2220	`</tr>`
2221	`</thead>`
2222	`<tbody>`
2223	`<tr>`
2224	`<td><code>url</code></td>`
2225	`<td><code>str</code></td>`
2226	`<td><code>"redis://localhost:6379"</code></td>`
2227	`<td>Redis connection URL</td>`
2228	`</tr>`
2229	`</tbody>`
2230	`</table>`
2231	`<p><strong>Returns:</strong> <code>GraphStore</code></p>`
2232	`<hr />`
2233	`<h3 id="instance-methods">Instance methods<a class="headerlink" href="#instance-methods" title="Permanent link">¶</a></h3>`
2234	`<h4 id="query"><code>query</code><a class="headerlink" href="#query" title="Permanent link">¶</a></h4>`
2235	<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">query</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">cypher</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">params</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">\|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">)</span> <span class="o">-></span> <span class="nb">list</span><span class="p">[</span><span class="nb">dict</span><span class="p">]</span>
2236	`</code></pre></div>`
2237	`<p>Execute a Cypher query and return all result rows.</p>`
2238	`<p><strong>Parameters:</strong></p>`
2239	`<table>`
2240	`<thead>`
2241	`<tr>`
2242	`<th>Name</th>`
2243	`<th>Type</th>`
2244	`<th>Default</th>`
2245	`<th>Description</th>`
2246	`</tr>`
2247	`</thead>`
2248	`<tbody>`
2249	`<tr>`
2250	`<td><code>cypher</code></td>`
2251	`<td><code>str</code></td>`
2252	`<td>—</td>`
2253	`<td>Cypher query string</td>`
2254	`</tr>`
2255	`<tr>`
2256	`<td><code>params</code></td>`
2257	`<td><code>dict \\| None</code></td>`
2258	`<td><code>None</code></td>`
2259	`<td>Optional query parameters</td>`
2260	`</tr>`
2261	`</tbody>`
2262	`</table>`
2263	`<p><strong>Returns:</strong> <code>list[dict]</code> — one dict per result row, keyed by return variable name.</p>`
2264	`<hr />`
2265	`<h4 id="create_node"><code>create_node</code><a class="headerlink" href="#create_node" title="Permanent link">¶</a></h4>`
2266	<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">create_node</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span>
2267	`</code></pre></div>`
2268	`<p>Create a new node and return its ID.</p>`
2269	`<p><strong>Parameters:</strong></p>`
2270	`<table>`
2271	`<thead>`
2272	`<tr>`
2273	`<th>Name</th>`
2274	`<th>Type</th>`
2275	`<th>Description</th>`
2276	`</tr>`
2277	`</thead>`
2278	`<tbody>`
2279	`<tr>`
2280	`<td><code>label</code></td>`
2281	`<td><code>str</code></td>`
2282	`<td>Node label (e.g., <code>"Function"</code>, <code>"Concept"</code>)</td>`
2283	`</tr>`
2284	`<tr>`
2285	`<td><code>properties</code></td>`
2286	`<td><code>dict</code></td>`
2287	`<td>Node properties</td>`
2288	`</tr>`
2289	`</tbody>`
2290	`</table>`
2291	`<p><strong>Returns:</strong> <code>str</code> — node ID</p>`
2292	`<hr />`
2293	`<h4 id="merge_node"><code>merge_node</code><a class="headerlink" href="#merge_node" title="Permanent link">¶</a></h4>`
2294	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">merge_node</span><span class="p">(</span>`
2295	`<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a> <span class="bp">self</span><span class="p">,</span>`
2296	`<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2297	`<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-4"></a> <span class="n">match_properties</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
2298	`<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-5"></a> <span class="n">set_properties</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">\|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2299	`<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span>`
2300	`</code></pre></div>`
2301	`<p>Upsert a node: create it if no node with <code>match_properties</code> exists; otherwise update <code>set_properties</code> on the existing node.</p>`
2302	`<p><strong>Parameters:</strong></p>`
2303	`<table>`
2304	`<thead>`
2305	`<tr>`
2306	`<th>Name</th>`
2307	`<th>Type</th>`
2308	`<th>Default</th>`
2309	`<th>Description</th>`
2310	`</tr>`
2311	`</thead>`
2312	`<tbody>`
2313	`<tr>`
2314	`<td><code>label</code></td>`
2315	`<td><code>str</code></td>`
2316	`<td>—</td>`
2317	`<td>Node label</td>`
2318	`</tr>`
2319	`<tr>`
2320	`<td><code>match_properties</code></td>`
2321	`<td><code>dict</code></td>`
2322	`<td>—</td>`
2323	`<td>Properties to match on (identity key)</td>`
2324	`</tr>`
2325	`<tr>`
2326	`<td><code>set_properties</code></td>`
2327	`<td><code>dict \\| None</code></td>`
2328	`<td><code>None</code></td>`
2329	`<td>Properties to set on create or update</td>`
2330	`</tr>`
2331	`</tbody>`
2332	`</table>`
2333	`<p><strong>Returns:</strong> <code>str</code> — node ID</p>`
2334	`<hr />`
2335	`<h4 id="create_edge"><code>create_edge</code><a class="headerlink" href="#create_edge" title="Permanent link">¶</a></h4>`
2336	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">create_edge</span><span class="p">(</span>`
2337	`<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a> <span class="bp">self</span><span class="p">,</span>`
2338	`<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a> <span class="n">from_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2339	`<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a> <span class="n">to_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2340	`<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2341	`<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">\|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2342	`<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span>`
2343	`</code></pre></div>`
2344	`<p>Create a directed edge between two nodes.</p>`
2345	`<p><strong>Parameters:</strong></p>`
2346	`<table>`
2347	`<thead>`
2348	`<tr>`
2349	`<th>Name</th>`
2350	`<th>Type</th>`
2351	`<th>Default</th>`
2352	`<th>Description</th>`
2353	`</tr>`
2354	`</thead>`
2355	`<tbody>`
2356	`<tr>`
2357	`<td><code>from_id</code></td>`
2358	`<td><code>str</code></td>`
2359	`<td>—</td>`
2360	`<td>Source node ID</td>`
2361	`</tr>`
2362	`<tr>`
2363	`<td><code>to_id</code></td>`
2364	`<td><code>str</code></td>`
2365	`<td>—</td>`
2366	`<td>Target node ID</td>`
2367	`</tr>`
2368	`<tr>`
2369	`<td><code>edge_type</code></td>`
2370	`<td><code>str</code></td>`
2371	`<td>—</td>`
2372	`<td>Relationship type (e.g., <code>"CALLS"</code>, <code>"ANNOTATES"</code>)</td>`
2373	`</tr>`
2374	`<tr>`
2375	`<td><code>properties</code></td>`
2376	`<td><code>dict \\| None</code></td>`
2377	`<td><code>None</code></td>`
2378	`<td>Optional edge properties</td>`
2379	`</tr>`
2380	`</tbody>`
2381	`</table>`
2382	`<hr />`
2383	`<h4 id="merge_edge"><code>merge_edge</code><a class="headerlink" href="#merge_edge" title="Permanent link">¶</a></h4>`
2384	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">merge_edge</span><span class="p">(</span>`
2385	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a> <span class="bp">self</span><span class="p">,</span>`
2386	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a> <span class="n">from_label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2387	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a> <span class="n">from_match</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
2388	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a> <span class="n">to_label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2389	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a> <span class="n">to_match</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
2390	`<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2391	`<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span> <span class="o">\|</span> <span class="kc">None</span> <span class="o">=</span> <span class="kc">None</span><span class="p">,</span>`
2392	`<a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span>`
2393	`</code></pre></div>`
2394	`<p>Upsert an edge between two nodes matched by label and properties.</p>`
2395	`<hr />`
2396	`<h4 id="clear"><code>clear</code><a class="headerlink" href="#clear" title="Permanent link">¶</a></h4>`
2397	`<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">clear</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span>`
2398	`</code></pre></div>`
2399	`<p>Delete all nodes and edges from the graph.</p>`
2400	`<hr />`
2401	`<h4 id="close"><code>close</code><a class="headerlink" href="#close" title="Permanent link">¶</a></h4>`
2402	`<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">close</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span>`
2403	`</code></pre></div>`
2404	`<p>Release the database connection. Called automatically when used as a context manager.</p>`
2405	`<hr />`
2406	`<h4 id="context-manager">Context manager<a class="headerlink" href="#context-manager" title="Permanent link">¶</a></h4>`
2407	`<p><code>GraphStore</code> implements <code>__enter__</code> / <code>__exit__</code>. Use with <code>with</code> to ensure the connection is closed:</p>`
2408	`<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-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>`
2409	`<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-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>`
2410	`</code></pre></div>`
2411	`<hr />`
2412	`<h2 id="contextloader">ContextLoader<a class="headerlink" href="#contextloader" title="Permanent link">¶</a></h2>`
2413	`<p>Builds structured context bundles from graph queries.</p>`
2414	`<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextLoader</span><span class="p">:</span>`
2415	`<a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a> <span class="k">def</span><span class="w"> </span><span class="fm">__init__</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">store</span><span class="p">:</span> <span class="n">GraphStore</span><span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> <span class="o">...</span>`
2416	`</code></pre></div>`
2417	`<h3 id="methods">Methods<a class="headerlink" href="#methods" title="Permanent link">¶</a></h3>`
2418	`<h4 id="load_file"><code>load_file</code><a class="headerlink" href="#load_file" title="Permanent link">¶</a></h4>`
2419	`<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">load_file</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">path</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2420	`</code></pre></div>`
2421	`<p>Return the full context bundle for a source file: the file node, its modules, classes, functions, imports, and their relationships.</p>`
2422	`<p><strong>Parameters:</strong></p>`
2423	`<table>`
2424	`<thead>`
2425	`<tr>`
2426	`<th>Name</th>`
2427	`<th>Type</th>`
2428	`<th>Description</th>`
2429	`</tr>`
2430	`</thead>`
2431	`<tbody>`
2432	`<tr>`
2433	`<td><code>path</code></td>`
2434	`<td><code>str</code></td>`
2435	`<td>Relative or absolute path to the source file</td>`
2436	`</tr>`
2437	`</tbody>`
2438	`</table>`
2439	`<p><strong>Returns:</strong> <code>ContextBundle</code></p>`
2440	`<hr />`
2441	`<h4 id="load_function"><code>load_function</code><a class="headerlink" href="#load_function" title="Permanent link">¶</a></h4>`
2442	`<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">load_function</span><span class="p">(</span>`
2443	`<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a> <span class="bp">self</span><span class="p">,</span>`
2444	`<a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2445	`<a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a> <span class="o">*</span><span class="p">,</span>`
2446	`<a id="__codelineno-14-5" name="__codelineno-14-5" href="#__codelineno-14-5"></a> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">""</span><span class="p">,</span>`
2447	`<a id="__codelineno-14-6" name="__codelineno-14-6" href="#__codelineno-14-6"></a> <span class="n">depth</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">1</span><span class="p">,</span>`
2448	`<a id="__codelineno-14-7" name="__codelineno-14-7" href="#__codelineno-14-7"></a><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2449	`</code></pre></div>`
2450	`<p>Return a function node with its callers, callees, decorators, containing class, and source.</p>`
2451	`<p><strong>Parameters:</strong></p>`
2452	`<table>`
2453	`<thead>`
2454	`<tr>`
2455	`<th>Name</th>`
2456	`<th>Type</th>`
2457	`<th>Default</th>`
2458	`<th>Description</th>`
2459	`</tr>`
2460	`</thead>`
2461	`<tbody>`
2462	`<tr>`
2463	`<td><code>name</code></td>`
2464	`<td><code>str</code></td>`
2465	`<td>—</td>`
2466	`<td>Function name</td>`
2467	`</tr>`
2468	`<tr>`
2469	`<td><code>file</code></td>`
2470	`<td><code>str</code></td>`
2471	`<td><code>""</code></td>`
2472	`<td>Optional file path to disambiguate</td>`
2473	`</tr>`
2474	`<tr>`
2475	`<td><code>depth</code></td>`
2476	`<td><code>int</code></td>`
2477	`<td><code>1</code></td>`
2478	`<td>Call graph traversal depth (1 = direct callers/callees only)</td>`
2479	`</tr>`
2480	`</tbody>`
2481	`</table>`
2482	`<p><strong>Returns:</strong> <code>ContextBundle</code></p>`
2483	`<hr />`
2484	`<h4 id="load_class"><code>load_class</code><a class="headerlink" href="#load_class" title="Permanent link">¶</a></h4>`
2485	`<div class="highlight"><pre><span></span><code><a id="__codelineno-15-1" name="__codelineno-15-1" href="#__codelineno-15-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">load_class</span><span class="p">(</span>`
2486	`<a id="__codelineno-15-2" name="__codelineno-15-2" href="#__codelineno-15-2"></a> <span class="bp">self</span><span class="p">,</span>`
2487	`<a id="__codelineno-15-3" name="__codelineno-15-3" href="#__codelineno-15-3"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2488	`<a id="__codelineno-15-4" name="__codelineno-15-4" href="#__codelineno-15-4"></a> <span class="o">*</span><span class="p">,</span>`
2489	`<a id="__codelineno-15-5" name="__codelineno-15-5" href="#__codelineno-15-5"></a> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">""</span><span class="p">,</span>`
2490	`<a id="__codelineno-15-6" name="__codelineno-15-6" href="#__codelineno-15-6"></a><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2491	`</code></pre></div>`
2492	`<p>Return a class node with its methods, base classes, subclasses, and references from other files.</p>`
2493	`<p><strong>Parameters:</strong></p>`
2494	`<table>`
2495	`<thead>`
2496	`<tr>`
2497	`<th>Name</th>`
2498	`<th>Type</th>`
2499	`<th>Default</th>`
2500	`<th>Description</th>`
2501	`</tr>`
2502	`</thead>`
2503	`<tbody>`
2504	`<tr>`
2505	`<td><code>name</code></td>`
2506	`<td><code>str</code></td>`
2507	`<td>—</td>`
2508	`<td>Class name</td>`
2509	`</tr>`
2510	`<tr>`
2511	`<td><code>file</code></td>`
2512	`<td><code>str</code></td>`
2513	`<td><code>""</code></td>`
2514	`<td>Optional file path to disambiguate</td>`
2515	`</tr>`
2516	`</tbody>`
2517	`</table>`
2518	`<p><strong>Returns:</strong> <code>ContextBundle</code></p>`
2519	`<hr />`
2520	`<h4 id="explain"><code>explain</code><a class="headerlink" href="#explain" title="Permanent link">¶</a></h4>`
2521	`<div class="highlight"><pre><span></span><code><a id="__codelineno-16-1" name="__codelineno-16-1" href="#__codelineno-16-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">explain</span><span class="p">(</span>`
2522	`<a id="__codelineno-16-2" name="__codelineno-16-2" href="#__codelineno-16-2"></a> <span class="bp">self</span><span class="p">,</span>`
2523	`<a id="__codelineno-16-3" name="__codelineno-16-3" href="#__codelineno-16-3"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2524	`<a id="__codelineno-16-4" name="__codelineno-16-4" href="#__codelineno-16-4"></a> <span class="o">*</span><span class="p">,</span>`
2525	`<a id="__codelineno-16-5" name="__codelineno-16-5" href="#__codelineno-16-5"></a> <span class="n">file</span><span class="p">:</span> <span class="nb">str</span> <span class="o">=</span> <span class="s2">""</span><span class="p">,</span>`
2526	`<a id="__codelineno-16-6" name="__codelineno-16-6" href="#__codelineno-16-6"></a><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2527	`</code></pre></div>`
2528	`<p>Universal lookup: explain any node (function, class, file, concept, rule, decision) by name.</p>`
2529	`<p><strong>Parameters:</strong></p>`
2530	`<table>`
2531	`<thead>`
2532	`<tr>`
2533	`<th>Name</th>`
2534	`<th>Type</th>`
2535	`<th>Default</th>`
2536	`<th>Description</th>`
2537	`</tr>`
2538	`</thead>`
2539	`<tbody>`
2540	`<tr>`
2541	`<td><code>name</code></td>`
2542	`<td><code>str</code></td>`
2543	`<td>—</td>`
2544	`<td>Node name or file path</td>`
2545	`</tr>`
2546	`<tr>`
2547	`<td><code>file</code></td>`
2548	`<td><code>str</code></td>`
2549	`<td><code>""</code></td>`
2550	`<td>Optional file path to disambiguate code nodes</td>`
2551	`</tr>`
2552	`</tbody>`
2553	`</table>`
2554	`<p><strong>Returns:</strong> <code>ContextBundle</code></p>`
2555	`<hr />`
2556	`<h4 id="load_concept"><code>load_concept</code><a class="headerlink" href="#load_concept" title="Permanent link">¶</a></h4>`
2557	`<div class="highlight"><pre><span></span><code><a id="__codelineno-17-1" name="__codelineno-17-1" href="#__codelineno-17-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">load_concept</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2558	`</code></pre></div>`
2559	`<p>Return a concept node with its rules, linked wiki pages, and annotated code nodes.</p>`
2560	`<hr />`
2561	`<h4 id="load_domain"><code>load_domain</code><a class="headerlink" href="#load_domain" title="Permanent link">¶</a></h4>`
2562	`<div class="highlight"><pre><span></span><code><a id="__codelineno-18-1" name="__codelineno-18-1" href="#__codelineno-18-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">load_domain</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span>`
2563	`</code></pre></div>`
2564	`<p>Return a domain and all nodes belonging to it: concepts, rules, decisions, people, and annotated code.</p>`
2565	`<hr />`
2566	`<h4 id="search"><code>search</code><a class="headerlink" href="#search" title="Permanent link">¶</a></h4>`
2567	`<div class="highlight"><pre><span></span><code><a id="__codelineno-19-1" name="__codelineno-19-1" href="#__codelineno-19-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span>`
2568	`<a id="__codelineno-19-2" name="__codelineno-19-2" href="#__codelineno-19-2"></a> <span class="bp">self</span><span class="p">,</span>`
2569	`<a id="__codelineno-19-3" name="__codelineno-19-3" href="#__codelineno-19-3"></a> <span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
2570	`<a id="__codelineno-19-4" name="__codelineno-19-4" href="#__codelineno-19-4"></a> <span class="o">*</span><span class="p">,</span>`
2571	`<a id="__codelineno-19-5" name="__codelineno-19-5" href="#__codelineno-19-5"></a> <span class="n">all_layers</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>`
2572	`<a id="__codelineno-19-6" name="__codelineno-19-6" href="#__codelineno-19-6"></a> <span class="n">docs_only</span><span class="p">:</span> <span class="nb">bool</span> <span class="o">=</span> <span class="kc">False</span><span class="p">,</span>`
2573	`<a id="__codelineno-19-7" name="__codelineno-19-7" href="#__codelineno-19-7"></a> <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">20</span><span class="p">,</span>`
2574	`<a id="__codelineno-19-8" name="__codelineno-19-8" href="#__codelineno-19-8"></a><span class="p">)</span> <span class="o">-></span> <span class="nb">list</span><span class="p">[</span><span class="n">ContextNode</span><span class="p">]</span>`
2575	`</code></pre></div>`
2576	`<p>Search the graph by text query.</p>`
2577	`<p><strong>Parameters:</strong></p>`
2578	`<table>`
2579	`<thead>`
2580	`<tr>`
2581	`<th>Name</th>`
2582	`<th>Type</th>`
2583	`<th>Default</th>`
2584	`<th>Description</th>`
2585	`</tr>`
2586	`</thead>`
2587	`<tbody>`
2588	`<tr>`
2589	`<td><code>query</code></td>`
2590	`<td><code>str</code></td>`
2591	`<td>—</td>`
2592	`<td>Search string</td>`
2593	`</tr>`
2594	`<tr>`
2595	`<td><code>all_layers</code></td>`
2596	`<td><code>bool</code></td>`
2597	`<td><code>False</code></td>`
2598	`<td>Search all layers including knowledge and docs</td>`
2599	`</tr>`
2600	`<tr>`
2601	`<td><code>docs_only</code></td>`
2602	`<td><code>bool</code></td>`
2603	`<td><code>False</code></td>`
2604	`<td>Search docstrings and wiki content only</td>`
2605	`</tr>`
2606	`<tr>`
2607	`<td><code>limit</code></td>`
2608	`<td><code>int</code></td>`
2609	`<td><code>20</code></td>`
2610	`<td>Maximum number of results</td>`
2611	`</tr>`
2612	`</tbody>`
2613	`</table>`
2614	`<p><strong>Returns:</strong> <code>list[ContextNode]</code></p>`
2615	`<hr />`
2616	`<h4 id="search_by_docstring"><code>search_by_docstring</code><a class="headerlink" href="#search_by_docstring" title="Permanent link">¶</a></h4>`
2617	<div class="highlight"><pre><span></span><code><a id="__codelineno-20-1" name="__codelineno-20-1" href="#__codelineno-20-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">search_by_docstring</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span> <span class="o">*</span><span class="p">,</span> <span class="n">limit</span><span class="p">:</span> <span class="nb">int</span> <span class="o">=</span> <span class="mi">20</span><span class="p">)</span> <span class="o">-></span> <span class="nb">list</span><span class="p">[</span><span class="n">ContextNode</span><span class="p">]</span>
2618	`</code></pre></div>`
2619	`<p>Search docstrings and wiki page content. Equivalent to <code>search(query, docs_only=True)</code>.</p>`
2620	`<hr />`
2621	`<h4 id="decorated_by"><code>decorated_by</code><a class="headerlink" href="#decorated_by" title="Permanent link">¶</a></h4>`
2622	<div class="highlight"><pre><span></span><code><a id="__codelineno-21-1" name="__codelineno-21-1" href="#__codelineno-21-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">decorated_by</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">decorator</span><span class="p">:</span> <span class="nb">str</span><span class="p">)</span> <span class="o">-></span> <span class="nb">list</span><span class="p">[</span><span class="n">ContextNode</span><span class="p">]</span>
2623	`</code></pre></div>`
2624	`<p>Find all functions and classes that use a specific decorator.</p>`
2625	`<p><strong>Parameters:</strong></p>`
2626	`<table>`
2627	`<thead>`
2628	`<tr>`
2629	`<th>Name</th>`
2630	`<th>Type</th>`
2631	`<th>Description</th>`
2632	`</tr>`
2633	`</thead>`
2634	`<tbody>`
2635	`<tr>`
2636	`<td><code>decorator</code></td>`
2637	`<td><code>str</code></td>`
2638	`<td>Decorator name (e.g., <code>"login_required"</code>, <code>"pytest.mark.parametrize"</code>)</td>`
2639	`</tr>`
2640	`</tbody>`
2641	`</table>`
2642	`<p><strong>Returns:</strong> <code>list[ContextNode]</code></p>`
2643	`<hr />`
2644	`<h2 id="contextbundle">ContextBundle<a class="headerlink" href="#contextbundle" title="Permanent link">¶</a></h2>`
2645	`<p>Structured result returned by <code>ContextLoader</code> methods.</p>`
2646	`<div class="highlight"><pre><span></span><code><a id="__codelineno-22-1" name="__codelineno-22-1" href="#__codelineno-22-1"></a><span class="nd">@dataclass</span>`
2647	`<a id="__codelineno-22-2" name="__codelineno-22-2" href="#__codelineno-22-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextBundle</span><span class="p">:</span>`
2648	`<a id="__codelineno-22-3" name="__codelineno-22-3" href="#__codelineno-22-3"></a> <span class="n">root</span><span class="p">:</span> <span class="n">ContextNode</span>`
2649	`<a id="__codelineno-22-4" name="__codelineno-22-4" href="#__codelineno-22-4"></a> <span class="n">nodes</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ContextNode</span><span class="p">]</span>`
2650	`<a id="__codelineno-22-5" name="__codelineno-22-5" href="#__codelineno-22-5"></a> <span class="n">edges</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="n">ContextEdge</span><span class="p">]</span>`
2651	`<a id="__codelineno-22-6" name="__codelineno-22-6" href="#__codelineno-22-6"></a> <span class="n">metadata</span><span class="p">:</span> <span class="nb">dict</span>`
2652	`</code></pre></div>`
2653	`<h3 id="fields">Fields<a class="headerlink" href="#fields" title="Permanent link">¶</a></h3>`
2654	`<table>`
2655	`<thead>`
2656	`<tr>`
2657	`<th>Field</th>`
2658	`<th>Type</th>`
2659	`<th>Description</th>`
2660	`</tr>`
2661	`</thead>`
2662	`<tbody>`
2663	`<tr>`
2664	`<td><code>root</code></td>`
2665	`<td><code>ContextNode</code></td>`
2666	`<td>The primary node (function, class, file, etc.)</td>`
2667	`</tr>`
2668	`<tr>`
2669	`<td><code>nodes</code></td>`
2670	`<td><code>list[ContextNode]</code></td>`
2671	`<td>All nodes in the bundle, including <code>root</code></td>`
2672	`</tr>`
2673	`<tr>`
2674	`<td><code>edges</code></td>`
2675	`<td><code>list[ContextEdge]</code></td>`
2676	`<td>All edges between nodes in the bundle</td>`
2677	`</tr>`
2678	`<tr>`
2679	`<td><code>metadata</code></td>`
2680	`<td><code>dict</code></td>`
2681	`<td>Query metadata (depth, timing, node counts)</td>`
2682	`</tr>`
2683	`</tbody>`
2684	`</table>`
2685	`<h3 id="methods_1">Methods<a class="headerlink" href="#methods_1" title="Permanent link">¶</a></h3>`
2686	`<h4 id="to_json"><code>to_json</code><a class="headerlink" href="#to_json" title="Permanent link">¶</a></h4>`
2687	`<div class="highlight"><pre><span></span><code><a id="__codelineno-23-1" name="__codelineno-23-1" href="#__codelineno-23-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">to_json</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span>`
2688	`</code></pre></div>`
2689	`<p>Serialize the bundle to a JSON string.</p>`
2690	`<h4 id="to_markdown"><code>to_markdown</code><a class="headerlink" href="#to_markdown" title="Permanent link">¶</a></h4>`
2691	`<div class="highlight"><pre><span></span><code><a id="__codelineno-24-1" name="__codelineno-24-1" href="#__codelineno-24-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">to_markdown</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">str</span>`
2692	`</code></pre></div>`
2693	`<p>Render the bundle as a Markdown string. Suitable for pasting into agent context.</p>`
2694	`<h4 id="to_dict"><code>to_dict</code><a class="headerlink" href="#to_dict" title="Permanent link">¶</a></h4>`
2695	`<div class="highlight"><pre><span></span><code><a id="__codelineno-25-1" name="__codelineno-25-1" href="#__codelineno-25-1"></a><span class="k">def</span><span class="w"> </span><span class="nf">to_dict</span><span class="p">(</span><span class="bp">self</span><span class="p">)</span> <span class="o">-></span> <span class="nb">dict</span>`
2696	`</code></pre></div>`
2697	`<p>Return the bundle as a plain Python dict.</p>`
2698	`<hr />`
2699	`<h2 id="contextnode">ContextNode<a class="headerlink" href="#contextnode" title="Permanent link">¶</a></h2>`
2700	`<p>A single node in a context bundle.</p>`
2701	`<div class="highlight"><pre><span></span><code><a id="__codelineno-26-1" name="__codelineno-26-1" href="#__codelineno-26-1"></a><span class="nd">@dataclass</span>`
2702	`<a id="__codelineno-26-2" name="__codelineno-26-2" href="#__codelineno-26-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextNode</span><span class="p">:</span>`
2703	`<a id="__codelineno-26-3" name="__codelineno-26-3" href="#__codelineno-26-3"></a> <span class="nb">id</span><span class="p">:</span> <span class="nb">str</span>`
2704	`<a id="__codelineno-26-4" name="__codelineno-26-4" href="#__codelineno-26-4"></a> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># e.g. "Function", "Concept"</span>`
2705	`<a id="__codelineno-26-5" name="__codelineno-26-5" href="#__codelineno-26-5"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span>`
2706	`<a id="__codelineno-26-6" name="__codelineno-26-6" href="#__codelineno-26-6"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span> <span class="c1"># all node properties from the graph</span>`
2707	`<a id="__codelineno-26-7" name="__codelineno-26-7" href="#__codelineno-26-7"></a> <span class="n">layer</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># "code" or "knowledge"</span>`
2708	`<a id="__codelineno-26-8" name="__codelineno-26-8" href="#__codelineno-26-8"></a> <span class="n">score</span><span class="p">:</span> <span class="nb">float</span> <span class="c1"># relevance score (search results only)</span>`
2709	`</code></pre></div>`
2710	`<hr />`
2711	`<h2 id="contextedge">ContextEdge<a class="headerlink" href="#contextedge" title="Permanent link">¶</a></h2>`
2712	`<p>A relationship between two nodes in a context bundle.</p>`
2713	`<div class="highlight"><pre><span></span><code><a id="__codelineno-27-1" name="__codelineno-27-1" href="#__codelineno-27-1"></a><span class="nd">@dataclass</span>`
2714	`<a id="__codelineno-27-2" name="__codelineno-27-2" href="#__codelineno-27-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextEdge</span><span class="p">:</span>`
2715	`<a id="__codelineno-27-3" name="__codelineno-27-3" href="#__codelineno-27-3"></a> <span class="n">from_id</span><span class="p">:</span> <span class="nb">str</span>`
2716	`<a id="__codelineno-27-4" name="__codelineno-27-4" href="#__codelineno-27-4"></a> <span class="n">to_id</span><span class="p">:</span> <span class="nb">str</span>`
2717	`<a id="__codelineno-27-5" name="__codelineno-27-5" href="#__codelineno-27-5"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># e.g. "CALLS", "ANNOTATES", "INHERITS"</span>`
2718	`<a id="__codelineno-27-6" name="__codelineno-27-6" href="#__codelineno-27-6"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span>`
2719	`</code></pre></div>`
2720	`<hr />`
2721	`<h2 id="ingestionresult">IngestionResult<a class="headerlink" href="#ingestionresult" title="Permanent link">¶</a></h2>`
2722	`<p>Returned by all ingest methods.</p>`
2723	`<div class="highlight"><pre><span></span><code><a id="__codelineno-28-1" name="__codelineno-28-1" href="#__codelineno-28-1"></a><span class="nd">@dataclass</span>`
2724	`<a id="__codelineno-28-2" name="__codelineno-28-2" href="#__codelineno-28-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">IngestionResult</span><span class="p">:</span>`
2725	`<a id="__codelineno-28-3" name="__codelineno-28-3" href="#__codelineno-28-3"></a> <span class="n">nodes_created</span><span class="p">:</span> <span class="nb">int</span>`
2726	`<a id="__codelineno-28-4" name="__codelineno-28-4" href="#__codelineno-28-4"></a> <span class="n">nodes_updated</span><span class="p">:</span> <span class="nb">int</span>`
2727	`<a id="__codelineno-28-5" name="__codelineno-28-5" href="#__codelineno-28-5"></a> <span class="n">edges_created</span><span class="p">:</span> <span class="nb">int</span>`
2728	`<a id="__codelineno-28-6" name="__codelineno-28-6" href="#__codelineno-28-6"></a> <span class="n">files_processed</span><span class="p">:</span> <span class="nb">int</span>`
2729	`<a id="__codelineno-28-7" name="__codelineno-28-7" href="#__codelineno-28-7"></a> <span class="n">errors</span><span class="p">:</span> <span class="nb">list</span><span class="p">[</span><span class="nb">str</span><span class="p">]</span>`
2730	`<a id="__codelineno-28-8" name="__codelineno-28-8" href="#__codelineno-28-8"></a> <span class="n">duration_seconds</span><span class="p">:</span> <span class="nb">float</span>`
2731	`</code></pre></div>`
2732	`<table>`
2733	`<thead>`
2734	`<tr>`
2735	`<th>Field</th>`
2736	`<th>Type</th>`
2737	`<th>Description</th>`
2738	`</tr>`
2739	`</thead>`
2740	`<tbody>`
2741	`<tr>`
2742	`<td><code>nodes_created</code></td>`
2743	`<td><code>int</code></td>`
2744	`<td>New nodes written to the graph</td>`
2745	`</tr>`
2746	`<tr>`
2747	`<td><code>nodes_updated</code></td>`
2748	`<td><code>int</code></td>`
2749	`<td>Existing nodes updated</td>`
2750	`</tr>`
2751	`<tr>`
2752	`<td><code>edges_created</code></td>`
2753	`<td><code>int</code></td>`
2754	`<td>New edges written</td>`
2755	`</tr>`
2756	`<tr>`
2757	`<td><code>files_processed</code></td>`
2758	`<td><code>int</code></td>`
2759	`<td>Source files walked</td>`
2760	`</tr>`
2761	`<tr>`
2762	`<td><code>errors</code></td>`
2763	`<td><code>list[str]</code></td>`
2764	`<td>Per-file parse errors (non-fatal)</td>`
2765	`</tr>`
2766	`<tr>`
2767	`<td><code>duration_seconds</code></td>`
2768	`<td><code>float</code></td>`
2769	`<td>Wall time for the ingest operation</td>`
2770	`</tr>`
2771	`</tbody>`
2772	`</table>`
2773
2774
2775
2776
2777
2778
2779
2780
2781
2782
2783
2784
2785
2786	`</article>`
2787	`</div>`
2788
2789
2790	`<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>`
2791
2792	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
2793	`</div>`
2794
2795	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
2796
2797	`<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>`
2798	`Back to top`
2799	`</button>`
2800
2801	`</main>`
2802
2803	`<footer class="md-footer">`
2804
2805	`<div class="md-footer-meta md-typeset">`
2806	`<div class="md-footer-meta__inner md-grid">`
2807	`<div class="md-copyright">`
2808
2809	`<div class="md-copyright__highlight">`
2810	`Copyright © 2026 CONFLICT LLC`
2811	`</div>`
2812
2813
2814	`Made with`
2815	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
2816	`Material for MkDocs`
2817	`</a>`
2818
2819	`</div>`
2820
2821
2822	`<div class="md-social">`
2823
2824
2825
2826
2827
2828
2829
2830
2831	`<a href="https://github.com/ConflictHQ/navegador" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
2832	<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>
2833	`</a>`
2834
2835	`</div>`
2836
2837	`</div>`
2838	`</div>`
2839	`</footer>`
2840
2841	`</div>`
2842	`<div class="md-dialog" data-md-component="dialog">`
2843	`<div class="md-dialog__inner md-typeset"></div>`
2844	`</div>`
2845
2846
2847
2848
2849
2850	<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>
2851
2852
2853	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
2854
2855
2856	`</body>`
2857	`</html>`

Navegador

Keyboard Shortcuts