Navegador

navegador / api / graph / index.html

Source Rendered

Blame History Raw 1919 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/graph/">`
16
17
18	`<link rel="prev" href="../analysis/">`
19
20
21	`<link rel="next" href="../mcp/">`
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>Graph - 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="#graph-api" 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	`Graph`
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="../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	`<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	`<li class="md-nav__item">`
1122	`<a href="../sdk/" class="md-nav__link">`
1123
1124
1125
1126	`<span class="md-ellipsis">`
1127
1128
1129	`Python SDK`
1130
1131
1132
1133	`</span>`
1134
1135
1136
1137	`</a>`
1138	`</li>`
1139
1140
1141
1142
1143
1144
1145
1146
1147
1148
1149	`<li class="md-nav__item">`
1150	`<a href="../ingestion/" class="md-nav__link">`
1151
1152
1153
1154	`<span class="md-ellipsis">`
1155
1156
1157	`Ingestion`
1158
1159
1160
1161	`</span>`
1162
1163
1164
1165	`</a>`
1166	`</li>`
1167
1168
1169
1170
1171
1172
1173
1174
1175
1176
1177	`<li class="md-nav__item">`
1178	`<a href="../analysis/" class="md-nav__link">`
1179
1180
1181
1182	`<span class="md-ellipsis">`
1183
1184
1185	`Analysis`
1186
1187
1188
1189	`</span>`
1190
1191
1192
1193	`</a>`
1194	`</li>`
1195
1196
1197
1198
1199
1200
1201
1202
1203
1204
1205
1206
1207	`<li class="md-nav__item md-nav__item--active">`
1208
1209	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
1210
1211
1212
1213
1214
1215	`<label class="md-nav__link md-nav__link--active" for="__toc">`
1216
1217
1218
1219	`<span class="md-ellipsis">`
1220
1221
1222	`Graph`
1223
1224
1225
1226	`</span>`
1227
1228
1229
1230	`<span class="md-nav__icon md-icon"></span>`
1231	`</label>`
1232
1233	`<a href="./" class="md-nav__link md-nav__link--active">`
1234
1235
1236
1237	`<span class="md-ellipsis">`
1238
1239
1240	`Graph`
1241
1242
1243
1244	`</span>`
1245
1246
1247
1248	`</a>`
1249
1250
1251
1252	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1253
1254
1255
1256
1257
1258
1259	`<label class="md-nav__title" for="__toc">`
1260	`<span class="md-nav__icon md-icon"></span>`
1261	`Table of contents`
1262	`</label>`
1263	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1264
1265	`<li class="md-nav__item">`
1266	`<a href="#graphstore" class="md-nav__link">`
1267	`<span class="md-ellipsis">`
1268
1269	`GraphStore`
1270
1271	`</span>`
1272	`</a>`
1273
1274	`<nav class="md-nav" aria-label="GraphStore">`
1275	`<ul class="md-nav__list">`
1276
1277	`<li class="md-nav__item">`
1278	`<a href="#usage" class="md-nav__link">`
1279	`<span class="md-ellipsis">`
1280
1281	`Usage`
1282
1283	`</span>`
1284	`</a>`
1285
1286	`</li>`
1287
1288	`<li class="md-nav__item">`
1289	`<a href="#context-manager" class="md-nav__link">`
1290	`<span class="md-ellipsis">`
1291
1292	`Context manager`
1293
1294	`</span>`
1295	`</a>`
1296
1297	`</li>`
1298
1299	`</ul>`
1300	`</nav>`
1301
1302	`</li>`
1303
1304	`<li class="md-nav__item">`
1305	`<a href="#contextloader" class="md-nav__link">`
1306	`<span class="md-ellipsis">`
1307
1308	`ContextLoader`
1309
1310	`</span>`
1311	`</a>`
1312
1313	`<nav class="md-nav" aria-label="ContextLoader">`
1314	`<ul class="md-nav__list">`
1315
1316	`<li class="md-nav__item">`
1317	`<a href="#usage_1" class="md-nav__link">`
1318	`<span class="md-ellipsis">`
1319
1320	`Usage`
1321
1322	`</span>`
1323	`</a>`
1324
1325	`</li>`
1326
1327	`</ul>`
1328	`</nav>`
1329
1330	`</li>`
1331
1332	`<li class="md-nav__item">`
1333	`<a href="#contextbundle" class="md-nav__link">`
1334	`<span class="md-ellipsis">`
1335
1336	`ContextBundle`
1337
1338	`</span>`
1339	`</a>`
1340
1341	`</li>`
1342
1343	`<li class="md-nav__item">`
1344	`<a href="#contextnode" class="md-nav__link">`
1345	`<span class="md-ellipsis">`
1346
1347	`ContextNode`
1348
1349	`</span>`
1350	`</a>`
1351
1352	`</li>`
1353
1354	`<li class="md-nav__item">`
1355	`<a href="#contextedge" class="md-nav__link">`
1356	`<span class="md-ellipsis">`
1357
1358	`ContextEdge`
1359
1360	`</span>`
1361	`</a>`
1362
1363	`</li>`
1364
1365	`<li class="md-nav__item">`
1366	`<a href="#schema-migrations" class="md-nav__link">`
1367	`<span class="md-ellipsis">`
1368
1369	`Schema migrations`
1370
1371	`</span>`
1372	`</a>`
1373
1374	`</li>`
1375
1376	`<li class="md-nav__item">`
1377	`<a href="#formatting-output" class="md-nav__link">`
1378	`<span class="md-ellipsis">`
1379
1380	`Formatting output`
1381
1382	`</span>`
1383	`</a>`
1384
1385	`</li>`
1386
1387	`</ul>`
1388
1389	`</nav>`
1390
1391	`</li>`
1392
1393
1394
1395
1396
1397
1398
1399
1400
1401
1402	`<li class="md-nav__item">`
1403	`<a href="../mcp/" class="md-nav__link">`
1404
1405
1406
1407	`<span class="md-ellipsis">`
1408
1409
1410	`MCP Server`
1411
1412
1413
1414	`</span>`
1415
1416
1417
1418	`</a>`
1419	`</li>`
1420
1421
1422
1423
1424	`</ul>`
1425	`</nav>`
1426
1427	`</li>`
1428
1429
1430
1431	`</ul>`
1432	`</nav>`
1433	`</div>`
1434	`</div>`
1435	`</div>`
1436
1437
1438
1439	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1440	`<div class="md-sidebar__scrollwrap">`
1441	`<div class="md-sidebar__inner">`
1442
1443
1444	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1445
1446
1447
1448
1449
1450
1451	`<label class="md-nav__title" for="__toc">`
1452	`<span class="md-nav__icon md-icon"></span>`
1453	`Table of contents`
1454	`</label>`
1455	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1456
1457	`<li class="md-nav__item">`
1458	`<a href="#graphstore" class="md-nav__link">`
1459	`<span class="md-ellipsis">`
1460
1461	`GraphStore`
1462
1463	`</span>`
1464	`</a>`
1465
1466	`<nav class="md-nav" aria-label="GraphStore">`
1467	`<ul class="md-nav__list">`
1468
1469	`<li class="md-nav__item">`
1470	`<a href="#usage" class="md-nav__link">`
1471	`<span class="md-ellipsis">`
1472
1473	`Usage`
1474
1475	`</span>`
1476	`</a>`
1477
1478	`</li>`
1479
1480	`<li class="md-nav__item">`
1481	`<a href="#context-manager" class="md-nav__link">`
1482	`<span class="md-ellipsis">`
1483
1484	`Context manager`
1485
1486	`</span>`
1487	`</a>`
1488
1489	`</li>`
1490
1491	`</ul>`
1492	`</nav>`
1493
1494	`</li>`
1495
1496	`<li class="md-nav__item">`
1497	`<a href="#contextloader" class="md-nav__link">`
1498	`<span class="md-ellipsis">`
1499
1500	`ContextLoader`
1501
1502	`</span>`
1503	`</a>`
1504
1505	`<nav class="md-nav" aria-label="ContextLoader">`
1506	`<ul class="md-nav__list">`
1507
1508	`<li class="md-nav__item">`
1509	`<a href="#usage_1" class="md-nav__link">`
1510	`<span class="md-ellipsis">`
1511
1512	`Usage`
1513
1514	`</span>`
1515	`</a>`
1516
1517	`</li>`
1518
1519	`</ul>`
1520	`</nav>`
1521
1522	`</li>`
1523
1524	`<li class="md-nav__item">`
1525	`<a href="#contextbundle" class="md-nav__link">`
1526	`<span class="md-ellipsis">`
1527
1528	`ContextBundle`
1529
1530	`</span>`
1531	`</a>`
1532
1533	`</li>`
1534
1535	`<li class="md-nav__item">`
1536	`<a href="#contextnode" class="md-nav__link">`
1537	`<span class="md-ellipsis">`
1538
1539	`ContextNode`
1540
1541	`</span>`
1542	`</a>`
1543
1544	`</li>`
1545
1546	`<li class="md-nav__item">`
1547	`<a href="#contextedge" class="md-nav__link">`
1548	`<span class="md-ellipsis">`
1549
1550	`ContextEdge`
1551
1552	`</span>`
1553	`</a>`
1554
1555	`</li>`
1556
1557	`<li class="md-nav__item">`
1558	`<a href="#schema-migrations" class="md-nav__link">`
1559	`<span class="md-ellipsis">`
1560
1561	`Schema migrations`
1562
1563	`</span>`
1564	`</a>`
1565
1566	`</li>`
1567
1568	`<li class="md-nav__item">`
1569	`<a href="#formatting-output" class="md-nav__link">`
1570	`<span class="md-ellipsis">`
1571
1572	`Formatting output`
1573
1574	`</span>`
1575	`</a>`
1576
1577	`</li>`
1578
1579	`</ul>`
1580
1581	`</nav>`
1582	`</div>`
1583	`</div>`
1584	`</div>`
1585
1586
1587
1588	`<div class="md-content" data-md-component="content">`
1589
1590	`<article class="md-content__inner md-typeset">`
1591
1592
1593
1594
1595
1596
1597
1598
1599	`<h1 id="graph-api">Graph API<a class="headerlink" href="#graph-api" title="Permanent link">¶</a></h1>`
1600	`<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>`
1601	`<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>`
1602	`</code></pre></div>`
1603	`<hr />`
1604	`<h2 id="graphstore">GraphStore<a class="headerlink" href="#graphstore" title="Permanent link">¶</a></h2>`
1605	`<p>The database abstraction layer. Both SQLite and Redis backends implement this interface.</p>`
1606	`<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>`
1607	`<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a> <span class="nd">@classmethod</span>`
1608	<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>
1609	`<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a>`
1610	`<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a> <span class="nd">@classmethod</span>`
1611	<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>
1612	`<a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a>`
1613	`<a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a> <span class="k">def</span><span class="w"> </span><span class="nf">query</span><span class="p">(</span>`
1614	`<a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a> <span class="bp">self</span><span class="p">,</span>`
1615	`<a id="__codelineno-1-10" name="__codelineno-1-10" href="#__codelineno-1-10"></a> <span class="n">cypher</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1616	`<a id="__codelineno-1-11" name="__codelineno-1-11" href="#__codelineno-1-11"></a> <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>`
1617	`<a id="__codelineno-1-12" name="__codelineno-1-12" href="#__codelineno-1-12"></a> <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> <span class="o">...</span>`
1618	`<a id="__codelineno-1-13" name="__codelineno-1-13" href="#__codelineno-1-13"></a>`
1619	`<a id="__codelineno-1-14" name="__codelineno-1-14" href="#__codelineno-1-14"></a> <span class="k">def</span><span class="w"> </span><span class="nf">create_node</span><span class="p">(</span>`
1620	`<a id="__codelineno-1-15" name="__codelineno-1-15" href="#__codelineno-1-15"></a> <span class="bp">self</span><span class="p">,</span>`
1621	`<a id="__codelineno-1-16" name="__codelineno-1-16" href="#__codelineno-1-16"></a> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1622	`<a id="__codelineno-1-17" name="__codelineno-1-17" href="#__codelineno-1-17"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
1623	`<a id="__codelineno-1-18" name="__codelineno-1-18" href="#__codelineno-1-18"></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> <span class="o">...</span> <span class="c1"># returns node ID</span>`
1624	`<a id="__codelineno-1-19" name="__codelineno-1-19" href="#__codelineno-1-19"></a>`
1625	`<a id="__codelineno-1-20" name="__codelineno-1-20" href="#__codelineno-1-20"></a> <span class="k">def</span><span class="w"> </span><span class="nf">merge_node</span><span class="p">(</span>`
1626	`<a id="__codelineno-1-21" name="__codelineno-1-21" href="#__codelineno-1-21"></a> <span class="bp">self</span><span class="p">,</span>`
1627	`<a id="__codelineno-1-22" name="__codelineno-1-22" href="#__codelineno-1-22"></a> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1628	`<a id="__codelineno-1-23" name="__codelineno-1-23" href="#__codelineno-1-23"></a> <span class="n">match_properties</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
1629	`<a id="__codelineno-1-24" name="__codelineno-1-24" href="#__codelineno-1-24"></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>`
1630	`<a id="__codelineno-1-25" name="__codelineno-1-25" href="#__codelineno-1-25"></a> <span class="p">)</span> <span class="o">-></span> <span class="nb">str</span><span class="p">:</span> <span class="o">...</span> <span class="c1"># upsert by match_properties, returns node ID</span>`
1631	`<a id="__codelineno-1-26" name="__codelineno-1-26" href="#__codelineno-1-26"></a>`
1632	`<a id="__codelineno-1-27" name="__codelineno-1-27" href="#__codelineno-1-27"></a> <span class="k">def</span><span class="w"> </span><span class="nf">create_edge</span><span class="p">(</span>`
1633	`<a id="__codelineno-1-28" name="__codelineno-1-28" href="#__codelineno-1-28"></a> <span class="bp">self</span><span class="p">,</span>`
1634	`<a id="__codelineno-1-29" name="__codelineno-1-29" href="#__codelineno-1-29"></a> <span class="n">from_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1635	`<a id="__codelineno-1-30" name="__codelineno-1-30" href="#__codelineno-1-30"></a> <span class="n">to_id</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1636	`<a id="__codelineno-1-31" name="__codelineno-1-31" href="#__codelineno-1-31"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1637	`<a id="__codelineno-1-32" name="__codelineno-1-32" href="#__codelineno-1-32"></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>`
1638	`<a id="__codelineno-1-33" name="__codelineno-1-33" href="#__codelineno-1-33"></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> <span class="o">...</span>`
1639	`<a id="__codelineno-1-34" name="__codelineno-1-34" href="#__codelineno-1-34"></a>`
1640	`<a id="__codelineno-1-35" name="__codelineno-1-35" href="#__codelineno-1-35"></a> <span class="k">def</span><span class="w"> </span><span class="nf">merge_edge</span><span class="p">(</span>`
1641	`<a id="__codelineno-1-36" name="__codelineno-1-36" href="#__codelineno-1-36"></a> <span class="bp">self</span><span class="p">,</span>`
1642	`<a id="__codelineno-1-37" name="__codelineno-1-37" href="#__codelineno-1-37"></a> <span class="n">from_label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1643	`<a id="__codelineno-1-38" name="__codelineno-1-38" href="#__codelineno-1-38"></a> <span class="n">from_match</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
1644	`<a id="__codelineno-1-39" name="__codelineno-1-39" href="#__codelineno-1-39"></a> <span class="n">to_label</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1645	`<a id="__codelineno-1-40" name="__codelineno-1-40" href="#__codelineno-1-40"></a> <span class="n">to_match</span><span class="p">:</span> <span class="nb">dict</span><span class="p">,</span>`
1646	`<a id="__codelineno-1-41" name="__codelineno-1-41" href="#__codelineno-1-41"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1647	`<a id="__codelineno-1-42" name="__codelineno-1-42" href="#__codelineno-1-42"></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>`
1648	`<a id="__codelineno-1-43" name="__codelineno-1-43" href="#__codelineno-1-43"></a> <span class="p">)</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> <span class="o">...</span>`
1649	`<a id="__codelineno-1-44" name="__codelineno-1-44" href="#__codelineno-1-44"></a>`
1650	`<a id="__codelineno-1-45" name="__codelineno-1-45" href="#__codelineno-1-45"></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><span class="p">:</span> <span class="o">...</span>`
1651	`<a id="__codelineno-1-46" name="__codelineno-1-46" href="#__codelineno-1-46"></a>`
1652	`<a id="__codelineno-1-47" name="__codelineno-1-47" href="#__codelineno-1-47"></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><span class="p">:</span> <span class="o">...</span>`
1653	`<a id="__codelineno-1-48" name="__codelineno-1-48" href="#__codelineno-1-48"></a>`
1654	<a id="__codelineno-1-49" name="__codelineno-1-49" href="#__codelineno-1-49"></a> <span class="k">def</span><span class="w"> </span><span class="nf">export_jsonl</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fp</span><span class="p">:</span> <span class="n">IO</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> <span class="o">...</span>
1655	`<a id="__codelineno-1-50" name="__codelineno-1-50" href="#__codelineno-1-50"></a><span class="w"> </span><span class="sd">"""Write all nodes and edges to a JSONL stream."""</span>`
1656	`<a id="__codelineno-1-51" name="__codelineno-1-51" href="#__codelineno-1-51"></a>`
1657	<a id="__codelineno-1-52" name="__codelineno-1-52" href="#__codelineno-1-52"></a> <span class="k">def</span><span class="w"> </span><span class="nf">import_jsonl</span><span class="p">(</span><span class="bp">self</span><span class="p">,</span> <span class="n">fp</span><span class="p">:</span> <span class="n">IO</span><span class="p">[</span><span class="nb">str</span><span class="p">])</span> <span class="o">-></span> <span class="kc">None</span><span class="p">:</span> <span class="o">...</span>
1658	`<a id="__codelineno-1-53" name="__codelineno-1-53" href="#__codelineno-1-53"></a><span class="w"> </span><span class="sd">"""Read nodes and edges from a JSONL stream and merge into the graph."""</span>`
1659	`</code></pre></div>`
1660	`<h3 id="usage">Usage<a class="headerlink" href="#usage" title="Permanent link">¶</a></h3>`
1661	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a><span class="c1"># SQLite (local dev)</span>`
1662	`<a id="__codelineno-2-2" name="__codelineno-2-2" href="#__codelineno-2-2"></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>`
1663	`<a id="__codelineno-2-3" name="__codelineno-2-3" href="#__codelineno-2-3"></a>`
1664	`<a id="__codelineno-2-4" name="__codelineno-2-4" href="#__codelineno-2-4"></a><span class="c1"># Redis (production)</span>`
1665	`<a id="__codelineno-2-5" name="__codelineno-2-5" href="#__codelineno-2-5"></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>`
1666	`<a id="__codelineno-2-6" name="__codelineno-2-6" href="#__codelineno-2-6"></a>`
1667	`<a id="__codelineno-2-7" name="__codelineno-2-7" href="#__codelineno-2-7"></a><span class="c1"># raw Cypher query</span>`
1668	`<a id="__codelineno-2-8" name="__codelineno-2-8" href="#__codelineno-2-8"></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>`
1669	`<a id="__codelineno-2-9" name="__codelineno-2-9" href="#__codelineno-2-9"></a> <span class="s2">"MATCH (f:Function {name: $name}) RETURN f"</span><span class="p">,</span>`
1670	`<a id="__codelineno-2-10" name="__codelineno-2-10" href="#__codelineno-2-10"></a> <span class="n">params</span><span class="o">=</span><span class="p">{</span><span class="s2">"name"</span><span class="p">:</span> <span class="s2">"validate_token"</span><span class="p">}</span>`
1671	`<a id="__codelineno-2-11" name="__codelineno-2-11" href="#__codelineno-2-11"></a><span class="p">)</span>`
1672	`<a id="__codelineno-2-12" name="__codelineno-2-12" href="#__codelineno-2-12"></a>`
1673	`<a id="__codelineno-2-13" name="__codelineno-2-13" href="#__codelineno-2-13"></a><span class="c1"># create a node</span>`
1674	`<a id="__codelineno-2-14" name="__codelineno-2-14" href="#__codelineno-2-14"></a><span class="n">node_id</span> <span class="o">=</span> <span class="n">store</span><span class="o">.</span><span class="n">create_node</span><span class="p">(</span><span class="s2">"Concept"</span><span class="p">,</span> <span class="p">{</span>`
1675	`<a id="__codelineno-2-15" name="__codelineno-2-15" href="#__codelineno-2-15"></a> <span class="s2">"name"</span><span class="p">:</span> <span class="s2">"Idempotency"</span><span class="p">,</span>`
1676	`<a id="__codelineno-2-16" name="__codelineno-2-16" href="#__codelineno-2-16"></a> <span class="s2">"description"</span><span class="p">:</span> <span class="s2">"Operations safe to retry"</span>`
1677	`<a id="__codelineno-2-17" name="__codelineno-2-17" href="#__codelineno-2-17"></a><span class="p">})</span>`
1678	`<a id="__codelineno-2-18" name="__codelineno-2-18" href="#__codelineno-2-18"></a>`
1679	`<a id="__codelineno-2-19" name="__codelineno-2-19" href="#__codelineno-2-19"></a><span class="c1"># upsert a node (match by name, update description)</span>`
1680	`<a id="__codelineno-2-20" name="__codelineno-2-20" href="#__codelineno-2-20"></a><span class="n">node_id</span> <span class="o">=</span> <span class="n">store</span><span class="o">.</span><span class="n">merge_node</span><span class="p">(</span>`
1681	`<a id="__codelineno-2-21" name="__codelineno-2-21" href="#__codelineno-2-21"></a> <span class="s2">"Concept"</span><span class="p">,</span>`
1682	`<a id="__codelineno-2-22" name="__codelineno-2-22" href="#__codelineno-2-22"></a> <span class="n">match_properties</span><span class="o">=</span><span class="p">{</span><span class="s2">"name"</span><span class="p">:</span> <span class="s2">"Idempotency"</span><span class="p">},</span>`
1683	`<a id="__codelineno-2-23" name="__codelineno-2-23" href="#__codelineno-2-23"></a> <span class="n">set_properties</span><span class="o">=</span><span class="p">{</span><span class="s2">"description"</span><span class="p">:</span> <span class="s2">"Updated description"</span><span class="p">}</span>`
1684	`<a id="__codelineno-2-24" name="__codelineno-2-24" href="#__codelineno-2-24"></a><span class="p">)</span>`
1685	`<a id="__codelineno-2-25" name="__codelineno-2-25" href="#__codelineno-2-25"></a>`
1686	`<a id="__codelineno-2-26" name="__codelineno-2-26" href="#__codelineno-2-26"></a><span class="c1"># create an edge</span>`
1687	`<a id="__codelineno-2-27" name="__codelineno-2-27" href="#__codelineno-2-27"></a><span class="n">store</span><span class="o">.</span><span class="n">create_edge</span><span class="p">(</span><span class="n">from_id</span><span class="p">,</span> <span class="n">to_id</span><span class="p">,</span> <span class="s2">"ANNOTATES"</span><span class="p">)</span>`
1688	`<a id="__codelineno-2-28" name="__codelineno-2-28" href="#__codelineno-2-28"></a>`
1689	`<a id="__codelineno-2-29" name="__codelineno-2-29" href="#__codelineno-2-29"></a><span class="c1"># wipe the graph</span>`
1690	`<a id="__codelineno-2-30" name="__codelineno-2-30" href="#__codelineno-2-30"></a><span class="n">store</span><span class="o">.</span><span class="n">clear</span><span class="p">()</span>`
1691	`</code></pre></div>`
1692	`<h3 id="context-manager">Context manager<a class="headerlink" href="#context-manager" title="Permanent link">¶</a></h3>`
1693	`<p><code>GraphStore</code> implements the context manager protocol:</p>`
1694	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-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>`
1695	`<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-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>`
1696	`</code></pre></div>`
1697	`<hr />`
1698	`<h2 id="contextloader">ContextLoader<a class="headerlink" href="#contextloader" title="Permanent link">¶</a></h2>`
1699	`<p>Builds structured context bundles from graph queries. Each method corresponds to a CLI command.</p>`
1700	`<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextLoader</span><span class="p">:</span>`
1701	`<a id="__codelineno-4-2" name="__codelineno-4-2" href="#__codelineno-4-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>`
1702	`<a id="__codelineno-4-3" name="__codelineno-4-3" href="#__codelineno-4-3"></a>`
1703	`<a id="__codelineno-4-4" name="__codelineno-4-4" href="#__codelineno-4-4"></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><span class="p">:</span> <span class="o">...</span>`
1704	`<a id="__codelineno-4-5" name="__codelineno-4-5" href="#__codelineno-4-5"></a>`
1705	`<a id="__codelineno-4-6" name="__codelineno-4-6" href="#__codelineno-4-6"></a> <span class="k">def</span><span class="w"> </span><span class="nf">load_function</span><span class="p">(</span>`
1706	`<a id="__codelineno-4-7" name="__codelineno-4-7" href="#__codelineno-4-7"></a> <span class="bp">self</span><span class="p">,</span>`
1707	`<a id="__codelineno-4-8" name="__codelineno-4-8" href="#__codelineno-4-8"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1708	`<a id="__codelineno-4-9" name="__codelineno-4-9" href="#__codelineno-4-9"></a> <span class="o">*</span><span class="p">,</span>`
1709	`<a id="__codelineno-4-10" name="__codelineno-4-10" href="#__codelineno-4-10"></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>`
1710	`<a id="__codelineno-4-11" name="__codelineno-4-11" href="#__codelineno-4-11"></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>`
1711	`<a id="__codelineno-4-12" name="__codelineno-4-12" href="#__codelineno-4-12"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span><span class="p">:</span> <span class="o">...</span>`
1712	`<a id="__codelineno-4-13" name="__codelineno-4-13" href="#__codelineno-4-13"></a>`
1713	`<a id="__codelineno-4-14" name="__codelineno-4-14" href="#__codelineno-4-14"></a> <span class="k">def</span><span class="w"> </span><span class="nf">load_class</span><span class="p">(</span>`
1714	`<a id="__codelineno-4-15" name="__codelineno-4-15" href="#__codelineno-4-15"></a> <span class="bp">self</span><span class="p">,</span>`
1715	`<a id="__codelineno-4-16" name="__codelineno-4-16" href="#__codelineno-4-16"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1716	`<a id="__codelineno-4-17" name="__codelineno-4-17" href="#__codelineno-4-17"></a> <span class="o">*</span><span class="p">,</span>`
1717	`<a id="__codelineno-4-18" name="__codelineno-4-18" href="#__codelineno-4-18"></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>`
1718	`<a id="__codelineno-4-19" name="__codelineno-4-19" href="#__codelineno-4-19"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span><span class="p">:</span> <span class="o">...</span>`
1719	`<a id="__codelineno-4-20" name="__codelineno-4-20" href="#__codelineno-4-20"></a>`
1720	`<a id="__codelineno-4-21" name="__codelineno-4-21" href="#__codelineno-4-21"></a> <span class="k">def</span><span class="w"> </span><span class="nf">explain</span><span class="p">(</span>`
1721	`<a id="__codelineno-4-22" name="__codelineno-4-22" href="#__codelineno-4-22"></a> <span class="bp">self</span><span class="p">,</span>`
1722	`<a id="__codelineno-4-23" name="__codelineno-4-23" href="#__codelineno-4-23"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1723	`<a id="__codelineno-4-24" name="__codelineno-4-24" href="#__codelineno-4-24"></a> <span class="o">*</span><span class="p">,</span>`
1724	`<a id="__codelineno-4-25" name="__codelineno-4-25" href="#__codelineno-4-25"></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>`
1725	`<a id="__codelineno-4-26" name="__codelineno-4-26" href="#__codelineno-4-26"></a> <span class="p">)</span> <span class="o">-></span> <span class="n">ContextBundle</span><span class="p">:</span> <span class="o">...</span>`
1726	`<a id="__codelineno-4-27" name="__codelineno-4-27" href="#__codelineno-4-27"></a>`
1727	`<a id="__codelineno-4-28" name="__codelineno-4-28" href="#__codelineno-4-28"></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><span class="p">:</span> <span class="o">...</span>`
1728	`<a id="__codelineno-4-29" name="__codelineno-4-29" href="#__codelineno-4-29"></a>`
1729	`<a id="__codelineno-4-30" name="__codelineno-4-30" href="#__codelineno-4-30"></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><span class="p">:</span> <span class="o">...</span>`
1730	`<a id="__codelineno-4-31" name="__codelineno-4-31" href="#__codelineno-4-31"></a>`
1731	`<a id="__codelineno-4-32" name="__codelineno-4-32" href="#__codelineno-4-32"></a> <span class="k">def</span><span class="w"> </span><span class="nf">search</span><span class="p">(</span>`
1732	`<a id="__codelineno-4-33" name="__codelineno-4-33" href="#__codelineno-4-33"></a> <span class="bp">self</span><span class="p">,</span>`
1733	`<a id="__codelineno-4-34" name="__codelineno-4-34" href="#__codelineno-4-34"></a> <span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1734	`<a id="__codelineno-4-35" name="__codelineno-4-35" href="#__codelineno-4-35"></a> <span class="o">*</span><span class="p">,</span>`
1735	`<a id="__codelineno-4-36" name="__codelineno-4-36" href="#__codelineno-4-36"></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>`
1736	`<a id="__codelineno-4-37" name="__codelineno-4-37" href="#__codelineno-4-37"></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>`
1737	`<a id="__codelineno-4-38" name="__codelineno-4-38" href="#__codelineno-4-38"></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>`
1738	`<a id="__codelineno-4-39" name="__codelineno-4-39" href="#__codelineno-4-39"></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> <span class="o">...</span>`
1739	`<a id="__codelineno-4-40" name="__codelineno-4-40" href="#__codelineno-4-40"></a>`
1740	`<a id="__codelineno-4-41" name="__codelineno-4-41" href="#__codelineno-4-41"></a> <span class="k">def</span><span class="w"> </span><span class="nf">search_by_docstring</span><span class="p">(</span>`
1741	`<a id="__codelineno-4-42" name="__codelineno-4-42" href="#__codelineno-4-42"></a> <span class="bp">self</span><span class="p">,</span>`
1742	`<a id="__codelineno-4-43" name="__codelineno-4-43" href="#__codelineno-4-43"></a> <span class="n">query</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1743	`<a id="__codelineno-4-44" name="__codelineno-4-44" href="#__codelineno-4-44"></a> <span class="o">*</span><span class="p">,</span>`
1744	`<a id="__codelineno-4-45" name="__codelineno-4-45" href="#__codelineno-4-45"></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>`
1745	`<a id="__codelineno-4-46" name="__codelineno-4-46" href="#__codelineno-4-46"></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> <span class="o">...</span>`
1746	`<a id="__codelineno-4-47" name="__codelineno-4-47" href="#__codelineno-4-47"></a>`
1747	`<a id="__codelineno-4-48" name="__codelineno-4-48" href="#__codelineno-4-48"></a> <span class="k">def</span><span class="w"> </span><span class="nf">decorated_by</span><span class="p">(</span>`
1748	`<a id="__codelineno-4-49" name="__codelineno-4-49" href="#__codelineno-4-49"></a> <span class="bp">self</span><span class="p">,</span>`
1749	`<a id="__codelineno-4-50" name="__codelineno-4-50" href="#__codelineno-4-50"></a> <span class="n">decorator</span><span class="p">:</span> <span class="nb">str</span><span class="p">,</span>`
1750	`<a id="__codelineno-4-51" name="__codelineno-4-51" href="#__codelineno-4-51"></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> <span class="o">...</span>`
1751	`</code></pre></div>`
1752	`<h3 id="usage_1">Usage<a class="headerlink" href="#usage_1" title="Permanent link">¶</a></h3>`
1753	`<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></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>`
1754	`<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></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>`
1755	`<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a>`
1756	`<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="c1"># file context</span>`
1757	`<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></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>`
1758	`<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>`
1759	`<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="c1"># function with 2-hop call graph</span>`
1760	`<a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></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>`
1761	`<a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a>`
1762	`<a id="__codelineno-5-10" name="__codelineno-5-10" href="#__codelineno-5-10"></a><span class="c1"># class hierarchy</span>`
1763	`<a id="__codelineno-5-11" name="__codelineno-5-11" href="#__codelineno-5-11"></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>`
1764	`<a id="__codelineno-5-12" name="__codelineno-5-12" href="#__codelineno-5-12"></a>`
1765	`<a id="__codelineno-5-13" name="__codelineno-5-13" href="#__codelineno-5-13"></a><span class="c1"># universal explain</span>`
1766	`<a id="__codelineno-5-14" name="__codelineno-5-14" href="#__codelineno-5-14"></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>`
1767	`<a id="__codelineno-5-15" name="__codelineno-5-15" href="#__codelineno-5-15"></a>`
1768	`<a id="__codelineno-5-16" name="__codelineno-5-16" href="#__codelineno-5-16"></a><span class="c1"># concept with annotated code</span>`
1769	`<a id="__codelineno-5-17" name="__codelineno-5-17" href="#__codelineno-5-17"></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>`
1770	`<a id="__codelineno-5-18" name="__codelineno-5-18" href="#__codelineno-5-18"></a>`
1771	`<a id="__codelineno-5-19" name="__codelineno-5-19" href="#__codelineno-5-19"></a><span class="c1"># domain overview</span>`
1772	`<a id="__codelineno-5-20" name="__codelineno-5-20" href="#__codelineno-5-20"></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>`
1773	`<a id="__codelineno-5-21" name="__codelineno-5-21" href="#__codelineno-5-21"></a>`
1774	`<a id="__codelineno-5-22" name="__codelineno-5-22" href="#__codelineno-5-22"></a><span class="c1"># search</span>`
1775	<a id="__codelineno-5-23" name="__codelineno-5-23" href="#__codelineno-5-23"></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">10</span><span class="p">)</span>
1776	`<a id="__codelineno-5-24" name="__codelineno-5-24" href="#__codelineno-5-24"></a>`
1777	`<a id="__codelineno-5-25" name="__codelineno-5-25" href="#__codelineno-5-25"></a><span class="c1"># all @login_required functions</span>`
1778	`<a id="__codelineno-5-26" name="__codelineno-5-26" href="#__codelineno-5-26"></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>`
1779	`</code></pre></div>`
1780	`<hr />`
1781	`<h2 id="contextbundle">ContextBundle<a class="headerlink" href="#contextbundle" title="Permanent link">¶</a></h2>`
1782	`<p>The structured result type returned by <code>ContextLoader</code> methods.</p>`
1783	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a><span class="nd">@dataclass</span>`
1784	`<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextBundle</span><span class="p">:</span>`
1785	`<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a> <span class="n">root</span><span class="p">:</span> <span class="n">ContextNode</span>`
1786	`<a id="__codelineno-6-4" name="__codelineno-6-4" href="#__codelineno-6-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>`
1787	`<a id="__codelineno-6-5" name="__codelineno-6-5" href="#__codelineno-6-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>`
1788	`<a id="__codelineno-6-6" name="__codelineno-6-6" href="#__codelineno-6-6"></a> <span class="n">metadata</span><span class="p">:</span> <span class="nb">dict</span>`
1789	`<a id="__codelineno-6-7" name="__codelineno-6-7" href="#__codelineno-6-7"></a>`
1790	`<a id="__codelineno-6-8" name="__codelineno-6-8" href="#__codelineno-6-8"></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><span class="p">:</span> <span class="o">...</span>`
1791	`<a id="__codelineno-6-9" name="__codelineno-6-9" href="#__codelineno-6-9"></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><span class="p">:</span> <span class="o">...</span>`
1792	`<a id="__codelineno-6-10" name="__codelineno-6-10" href="#__codelineno-6-10"></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><span class="p">:</span> <span class="o">...</span>`
1793	`</code></pre></div>`
1794	`<hr />`
1795	`<h2 id="contextnode">ContextNode<a class="headerlink" href="#contextnode" title="Permanent link">¶</a></h2>`
1796	`<p>A single node in a context bundle.</p>`
1797	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="nd">@dataclass</span>`
1798	`<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextNode</span><span class="p">:</span>`
1799	`<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a> <span class="nb">id</span><span class="p">:</span> <span class="nb">str</span>`
1800	`<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a> <span class="n">label</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># e.g. "Function", "Concept"</span>`
1801	`<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a> <span class="n">name</span><span class="p">:</span> <span class="nb">str</span>`
1802	`<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="c1"># all node properties</span>`
1803	`<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a> <span class="n">layer</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># "code" or "knowledge"</span>`
1804	`</code></pre></div>`
1805	`<hr />`
1806	`<h2 id="contextedge">ContextEdge<a class="headerlink" href="#contextedge" title="Permanent link">¶</a></h2>`
1807	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="nd">@dataclass</span>`
1808	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="k">class</span><span class="w"> </span><span class="nc">ContextEdge</span><span class="p">:</span>`
1809	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a> <span class="n">from_id</span><span class="p">:</span> <span class="nb">str</span>`
1810	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a> <span class="n">to_id</span><span class="p">:</span> <span class="nb">str</span>`
1811	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a> <span class="n">edge_type</span><span class="p">:</span> <span class="nb">str</span> <span class="c1"># e.g. "CALLS", "ANNOTATES"</span>`
1812	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a> <span class="n">properties</span><span class="p">:</span> <span class="nb">dict</span>`
1813	`</code></pre></div>`
1814	`<hr />`
1815	`<h2 id="schema-migrations">Schema migrations<a class="headerlink" href="#schema-migrations" title="Permanent link">¶</a></h2>`
1816	`<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">migrate</span>`
1817	`<a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a>`
1818	`<a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-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>`
1819	`<a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="n">migrate</span><span class="p">(</span><span class="n">store</span><span class="p">)</span> <span class="c1"># applies any pending schema migrations; idempotent</span>`
1820	`</code></pre></div>`
1821	`<p>The <code>migrate()</code> function is safe to call on every startup. It compares the stored migration version against the current schema and applies only missing migrations.</p>`
1822	`<hr />`
1823	`<h2 id="formatting-output">Formatting output<a class="headerlink" href="#formatting-output" title="Permanent link">¶</a></h2>`
1824	`<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_function</span><span class="p">(</span><span class="s2">"validate_token"</span><span class="p">)</span>`
1825	`<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a>`
1826	`<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="c1"># JSON string</span>`
1827	`<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></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>`
1828	`<a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a>`
1829	`<a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="c1"># Markdown string (for agent consumption)</span>`
1830	`<a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></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>`
1831	`<a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a>`
1832	`<a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a><span class="c1"># Python dict (for further processing)</span>`
1833	`<a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-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>`
1834	`</code></pre></div>`
1835
1836
1837
1838
1839
1840
1841
1842
1843
1844
1845
1846
1847
1848	`</article>`
1849	`</div>`
1850
1851
1852	`<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>`
1853
1854	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
1855	`</div>`
1856
1857	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
1858
1859	`<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>`
1860	`Back to top`
1861	`</button>`
1862
1863	`</main>`
1864
1865	`<footer class="md-footer">`
1866
1867	`<div class="md-footer-meta md-typeset">`
1868	`<div class="md-footer-meta__inner md-grid">`
1869	`<div class="md-copyright">`
1870
1871	`<div class="md-copyright__highlight">`
1872	`Copyright © 2026 CONFLICT LLC`
1873	`</div>`
1874
1875
1876	`Made with`
1877	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
1878	`Material for MkDocs`
1879	`</a>`
1880
1881	`</div>`
1882
1883
1884	`<div class="md-social">`
1885
1886
1887
1888
1889
1890
1891
1892
1893	`<a href="https://github.com/ConflictHQ/navegador" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
1894	<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>
1895	`</a>`
1896
1897	`</div>`
1898
1899	`</div>`
1900	`</div>`
1901	`</footer>`
1902
1903	`</div>`
1904	`<div class="md-dialog" data-md-component="dialog">`
1905	`<div class="md-dialog__inner md-typeset"></div>`
1906	`</div>`
1907
1908
1909
1910
1911
1912	<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>
1913
1914
1915	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
1916
1917
1918	`</body>`
1919	`</html>`

Navegador

Keyboard Shortcuts