Navegador

navegador / guide / ci-cd / index.html

Source Rendered

Blame History Raw 2073 lines

1
2	`<!doctype html>`
3	`<html lang="en" class="no-js">`
4	`<head>`
5
6	`<meta charset="utf-8">`
7	`<meta name="viewport" content="width=device-width,initial-scale=1">`
8
9	`<meta name="description" content="Project knowledge graph for AI coding agents — code structure, business rules, and architectural decisions in one queryable graph">`
10
11
12	`<meta name="author" content="CONFLICT LLC">`
13
14
15	`<link rel="canonical" href="https://navegador.dev/guide/ci-cd/">`
16
17
18	`<link rel="prev" href="../mcp-integration/">`
19
20
21	`<link rel="next" href="../cluster/">`
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>CI/CD - 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="#cicd-integration" 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	`CI/CD`
121
122	`</span>`
123	`</div>`
124	`</div>`
125	`</div>`
126
127
128	`<form class="md-header__option" data-md-component="palette">`
129
130
131
132
133	`<input class="md-option" data-md-color-media="(prefers-color-scheme: dark)" data-md-color-scheme="slate" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to light mode" type="radio" name="__palette" id="__palette_0">`
134
135	`<label class="md-header__button md-icon" title="Switch to light mode" for="__palette_1" hidden>`
136	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 18c-.89 0-1.74-.2-2.5-.55C11.56 16.5 13 14.42 13 12s-1.44-4.5-3.5-5.45C10.26 6.2 11.11 6 12 6a6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
137	`</label>`
138
139
140
141
142
143	`<input class="md-option" data-md-color-media="(prefers-color-scheme: light)" data-md-color-scheme="default" data-md-color-primary="custom" data-md-color-accent="custom" aria-label="Switch to dark mode" type="radio" name="__palette" id="__palette_1">`
144
145	`<label class="md-header__button md-icon" title="Switch to dark mode" for="__palette_0" hidden>`
146	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M12 8a4 4 0 0 0-4 4 4 4 0 0 0 4 4 4 4 0 0 0 4-4 4 4 0 0 0-4-4m0 10a6 6 0 0 1-6-6 6 6 0 0 1 6-6 6 6 0 0 1 6 6 6 6 0 0 1-6 6m8-9.31V4h-4.69L12 .69 8.69 4H4v4.69L.69 12 4 15.31V20h4.69L12 23.31 15.31 20H20v-4.69L23.31 12z"/></svg>`
147	`</label>`
148
149
150	`</form>`
151
152
153
154	<script>var palette=__md_get("__palette");if(palette&&palette.color){if("(prefers-color-scheme)"===palette.color.media){var media=matchMedia("(prefers-color-scheme: light)"),input=document.querySelector(media.matches?"[data-md-color-media='(prefers-color-scheme: light)']":"[data-md-color-media='(prefers-color-scheme: dark)']");palette.color.media=input.getAttribute("data-md-color-media"),palette.color.scheme=input.getAttribute("data-md-color-scheme"),palette.color.primary=input.getAttribute("data-md-color-primary"),palette.color.accent=input.getAttribute("data-md-color-accent")}for(var[key,value]of Object.entries(palette.color))document.body.setAttribute("data-md-color-"+key,value)}</script>
155
156
157
158
159
160	`<label class="md-header__button md-icon" for="__search">`
161
162	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
163	`</label>`
164	`<div class="md-search" data-md-component="search" role="dialog">`
165	`<label class="md-search__overlay" for="__search"></label>`
166	`<div class="md-search__inner" role="search">`
167	`<form class="md-search__form" name="search">`
168	`<input type="text" class="md-search__input" name="query" aria-label="Search" placeholder="Search" autocapitalize="off" autocorrect="off" autocomplete="off" spellcheck="false" data-md-component="search-query" required>`
169	`<label class="md-search__icon md-icon" for="__search">`
170
171	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M9.5 3A6.5 6.5 0 0 1 16 9.5c0 1.61-.59 3.09-1.56 4.23l.27.27h.79l5 5-1.5 1.5-5-5v-.79l-.27-.27A6.52 6.52 0 0 1 9.5 16 6.5 6.5 0 0 1 3 9.5 6.5 6.5 0 0 1 9.5 3m0 2C7 5 5 7 5 9.5S7 14 9.5 14 14 12 14 9.5 12 5 9.5 5"/></svg>`
172
173	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M20 11v2H8l5.5 5.5-1.42 1.42L4.16 12l7.92-7.92L13.5 5.5 8 11z"/></svg>`
174	`</label>`
175	`<nav class="md-search__options" aria-label="Search">`
176
177	`<button type="reset" class="md-search__icon md-icon" title="Clear" aria-label="Clear" tabindex="-1">`
178
179	`<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24"><path d="M19 6.41 17.59 5 12 10.59 6.41 5 5 6.41 10.59 12 5 17.59 6.41 19 12 13.41 17.59 19 19 17.59 13.41 12z"/></svg>`
180	`</button>`
181	`</nav>`
182
183	`<div class="md-search__suggest" data-md-component="search-suggest"></div>`
184
185	`</form>`
186	`<div class="md-search__output">`
187	`<div class="md-search__scrollwrap" tabindex="0" data-md-scrollfix>`
188	`<div class="md-search-result" data-md-component="search-result">`
189	`<div class="md-search-result__meta">`
190	`Initializing search`
191	`</div>`
192	`<ol class="md-search-result__list" role="presentation"></ol>`
193	`</div>`
194	`</div>`
195	`</div>`
196	`</div>`
197	`</div>`
198
199
200
201	`<div class="md-header__source">`
202	`<a href="https://github.com/ConflictHQ/navegador" title="Go to repository" class="md-source" data-md-component="source">`
203	`<div class="md-source__icon md-icon">`
204
205	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
206	`</div>`
207	`<div class="md-source__repository">`
208	`ConflictHQ/navegador`
209	`</div>`
210	`</a>`
211	`</div>`
212
213	`</nav>`
214
215	`</header>`
216
217	`<div class="md-container" data-md-component="container">`
218
219
220
221
222
223	`<nav class="md-tabs" aria-label="Tabs" data-md-component="tabs">`
224	`<div class="md-grid">`
225	`<ul class="md-tabs__list">`
226
227
228
229
230
231
232	`<li class="md-tabs__item">`
233	`<a href="../.." class="md-tabs__link">`
234
235
236
237
238
239	`Home`
240
241	`</a>`
242	`</li>`
243
244
245
246
247
248
249
250
251
252
253	`<li class="md-tabs__item">`
254	`<a href="../../getting-started/installation/" class="md-tabs__link">`
255
256
257
258	`Getting Started`
259
260	`</a>`
261	`</li>`
262
263
264
265
266
267
268
269
270
271
272
273
274
275	`<li class="md-tabs__item md-tabs__item--active">`
276	`<a href="../ingestion/" class="md-tabs__link">`
277
278
279
280	`Guide`
281
282	`</a>`
283	`</li>`
284
285
286
287
288
289
290
291
292
293
294
295	`<li class="md-tabs__item">`
296	`<a href="../../architecture/overview/" class="md-tabs__link">`
297
298
299
300	`Architecture`
301
302	`</a>`
303	`</li>`
304
305
306
307
308
309
310
311
312
313
314
315	`<li class="md-tabs__item">`
316	`<a href="../../api/sdk/" class="md-tabs__link">`
317
318
319
320	`API Reference`
321
322	`</a>`
323	`</li>`
324
325
326
327
328	`</ul>`
329	`</div>`
330	`</nav>`
331
332
333
334	`<main class="md-main" data-md-component="main">`
335	`<div class="md-main__inner md-grid">`
336
337
338
339	`<div class="md-sidebar md-sidebar--primary" data-md-component="sidebar" data-md-type="navigation" >`
340	`<div class="md-sidebar__scrollwrap">`
341	`<div class="md-sidebar__inner">`
342
343
344
345
346
347
348	`<nav class="md-nav md-nav--primary md-nav--lifted" aria-label="Navigation" data-md-level="0">`
349	`<label class="md-nav__title" for="__drawer">`
350	`<a href="../.." title="Navegador" class="md-nav__button md-logo" aria-label="Navegador" data-md-component="logo">`
351
352	`<img src="../../assets/images/conflict-logo.svg" alt="logo">`
353
354	`</a>`
355	`Navegador`
356	`</label>`
357
358	`<div class="md-nav__source">`
359	`<a href="https://github.com/ConflictHQ/navegador" title="Go to repository" class="md-source" data-md-component="source">`
360	`<div class="md-source__icon md-icon">`
361
362	<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 512 512"><!--! Font Awesome Free 7.1.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License) Copyright 2025 Fonticons, Inc.--><path d="M173.9 397.4c0 2-2.3 3.6-5.2 3.6-3.3.3-5.6-1.3-5.6-3.6 0-2 2.3-3.6 5.2-3.6 3-.3 5.6 1.3 5.6 3.6m-31.1-4.5c-.7 2 1.3 4.3 4.3 4.9 2.6 1 5.6 0 6.2-2s-1.3-4.3-4.3-5.2c-2.6-.7-5.5.3-6.2 2.3m44.2-1.7c-2.9.7-4.9 2.6-4.6 4.9.3 2 2.9 3.3 5.9 2.6 2.9-.7 4.9-2.6 4.6-4.6-.3-1.9-3-3.2-5.9-2.9M252.8 8C114.1 8 8 113.3 8 252c0 110.9 69.8 205.8 169.5 239.2 12.8 2.3 17.3-5.6 17.3-12.1 0-6.2-.3-40.4-.3-61.4 0 0-70 15-84.7-29.8 0 0-11.4-29.1-27.8-36.6 0 0-22.9-15.7 1.6-15.4 0 0 24.9 2 38.6 25.8 21.9 38.6 58.6 27.5 72.9 20.9 2.3-16 8.8-27.1 16-33.7-55.9-6.2-112.3-14.3-112.3-110.5 0-27.5 7.6-41.3 23.6-58.9-2.6-6.5-11.1-33.3 2.6-67.9 20.9-6.5 69 27 69 27 20-5.6 41.5-8.5 62.8-8.5s42.8 2.9 62.8 8.5c0 0 48.1-33.6 69-27 13.7 34.7 5.2 61.4 2.6 67.9 16 17.7 25.8 31.5 25.8 58.9 0 96.5-58.9 104.2-114.8 110.5 9.2 7.9 17 22.9 17 46.4 0 33.7-.3 75.4-.3 83.6 0 6.5 4.6 14.4 17.3 12.1C436.2 457.8 504 362.9 504 252 504 113.3 391.5 8 252.8 8M105.2 352.9c-1.3 1-1 3.3.7 5.2 1.6 1.6 3.9 2.3 5.2 1 1.3-1 1-3.3-.7-5.2-1.6-1.6-3.9-2.3-5.2-1m-10.8-8.1c-.7 1.3.3 2.9 2.3 3.9 1.6 1 3.6.7 4.3-.7.7-1.3-.3-2.9-2.3-3.9-2-.6-3.6-.3-4.3.7m32.4 35.6c-1.6 1.3-1 4.3 1.3 6.2 2.3 2.3 5.2 2.6 6.5 1 1.3-1.3.7-4.3-1.3-6.2-2.2-2.3-5.2-2.6-6.5-1m-11.4-14.7c-1.6 1-1.6 3.6 0 5.9s4.3 3.3 5.6 2.3c1.6-1.3 1.6-3.9 0-6.2-1.4-2.3-4-3.3-5.6-2"/></svg>
363	`</div>`
364	`<div class="md-source__repository">`
365	`ConflictHQ/navegador`
366	`</div>`
367	`</a>`
368	`</div>`
369
370	`<ul class="md-nav__list" data-md-scrollfix>`
371
372
373
374
375
376
377
378	`<li class="md-nav__item">`
379	`<a href="../.." class="md-nav__link">`
380
381
382
383	`<span class="md-ellipsis">`
384
385
386	`Home`
387
388
389
390	`</span>`
391
392
393
394	`</a>`
395	`</li>`
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415	`<li class="md-nav__item md-nav__item--nested">`
416
417
418
419
420
421	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_2" >`
422
423
424	`<label class="md-nav__link" for="__nav_2" id="__nav_2_label" tabindex="0">`
425
426
427
428	`<span class="md-ellipsis">`
429
430
431	`Getting Started`
432
433
434
435	`</span>`
436
437
438
439	`<span class="md-nav__icon md-icon"></span>`
440	`</label>`
441
442	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_2_label" aria-expanded="false">`
443	`<label class="md-nav__title" for="__nav_2">`
444	`<span class="md-nav__icon md-icon"></span>`
445
446
447	`Getting Started`
448
449
450	`</label>`
451	`<ul class="md-nav__list" data-md-scrollfix>`
452
453
454
455
456
457
458
459	`<li class="md-nav__item">`
460	`<a href="../../getting-started/installation/" class="md-nav__link">`
461
462
463
464	`<span class="md-ellipsis">`
465
466
467	`Installation`
468
469
470
471	`</span>`
472
473
474
475	`</a>`
476	`</li>`
477
478
479
480
481
482
483
484
485
486
487	`<li class="md-nav__item">`
488	`<a href="../../getting-started/quickstart/" class="md-nav__link">`
489
490
491
492	`<span class="md-ellipsis">`
493
494
495	`Quick Start`
496
497
498
499	`</span>`
500
501
502
503	`</a>`
504	`</li>`
505
506
507
508
509
510
511
512
513
514
515	`<li class="md-nav__item">`
516	`<a href="../../getting-started/configuration/" class="md-nav__link">`
517
518
519
520	`<span class="md-ellipsis">`
521
522
523	`Configuration`
524
525
526
527	`</span>`
528
529
530
531	`</a>`
532	`</li>`
533
534
535
536
537	`</ul>`
538	`</nav>`
539
540	`</li>`
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565	`<li class="md-nav__item md-nav__item--active md-nav__item--section md-nav__item--nested">`
566
567
568
569	`<input class="md-nav__toggle md-toggle " type="checkbox" id="__nav_3" checked>`
570
571
572	`<label class="md-nav__link" for="__nav_3" id="__nav_3_label" tabindex="">`
573
574
575
576	`<span class="md-ellipsis">`
577
578
579	`Guide`
580
581
582
583	`</span>`
584
585
586
587	`<span class="md-nav__icon md-icon"></span>`
588	`</label>`
589
590	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_3_label" aria-expanded="true">`
591	`<label class="md-nav__title" for="__nav_3">`
592	`<span class="md-nav__icon md-icon"></span>`
593
594
595	`Guide`
596
597
598	`</label>`
599	`<ul class="md-nav__list" data-md-scrollfix>`
600
601
602
603
604
605
606
607	`<li class="md-nav__item">`
608	`<a href="../ingestion/" class="md-nav__link">`
609
610
611
612	`<span class="md-ellipsis">`
613
614
615	`Ingesting a Repo`
616
617
618
619	`</span>`
620
621
622
623	`</a>`
624	`</li>`
625
626
627
628
629
630
631
632
633
634
635	`<li class="md-nav__item">`
636	`<a href="../context-loading/" class="md-nav__link">`
637
638
639
640	`<span class="md-ellipsis">`
641
642
643	`Loading Context`
644
645
646
647	`</span>`
648
649
650
651	`</a>`
652	`</li>`
653
654
655
656
657
658
659
660
661
662
663	`<li class="md-nav__item">`
664	`<a href="../framework-enrichment/" class="md-nav__link">`
665
666
667
668	`<span class="md-ellipsis">`
669
670
671	`Framework Enrichment`
672
673
674
675	`</span>`
676
677
678
679	`</a>`
680	`</li>`
681
682
683
684
685
686
687
688
689
690
691	`<li class="md-nav__item">`
692	`<a href="../analysis/" class="md-nav__link">`
693
694
695
696	`<span class="md-ellipsis">`
697
698
699	`Structural Analysis`
700
701
702
703	`</span>`
704
705
706
707	`</a>`
708	`</li>`
709
710
711
712
713
714
715
716
717
718
719	`<li class="md-nav__item">`
720	`<a href="../intelligence/" class="md-nav__link">`
721
722
723
724	`<span class="md-ellipsis">`
725
726
727	`Intelligence Layer`
728
729
730
731	`</span>`
732
733
734
735	`</a>`
736	`</li>`
737
738
739
740
741
742
743
744
745
746
747	`<li class="md-nav__item">`
748	`<a href="../sdk/" class="md-nav__link">`
749
750
751
752	`<span class="md-ellipsis">`
753
754
755	`Python SDK`
756
757
758
759	`</span>`
760
761
762
763	`</a>`
764	`</li>`
765
766
767
768
769
770
771
772
773
774
775	`<li class="md-nav__item">`
776	`<a href="../graph-queries/" class="md-nav__link">`
777
778
779
780	`<span class="md-ellipsis">`
781
782
783	`Graph Queries`
784
785
786
787	`</span>`
788
789
790
791	`</a>`
792	`</li>`
793
794
795
796
797
798
799
800
801
802
803	`<li class="md-nav__item">`
804	`<a href="../mcp-integration/" class="md-nav__link">`
805
806
807
808	`<span class="md-ellipsis">`
809
810
811	`MCP Integration`
812
813
814
815	`</span>`
816
817
818
819	`</a>`
820	`</li>`
821
822
823
824
825
826
827
828
829
830
831
832
833	`<li class="md-nav__item md-nav__item--active">`
834
835	`<input class="md-nav__toggle md-toggle" type="checkbox" id="__toc">`
836
837
838
839
840
841	`<label class="md-nav__link md-nav__link--active" for="__toc">`
842
843
844
845	`<span class="md-ellipsis">`
846
847
848	`CI/CD`
849
850
851
852	`</span>`
853
854
855
856	`<span class="md-nav__icon md-icon"></span>`
857	`</label>`
858
859	`<a href="./" class="md-nav__link md-nav__link--active">`
860
861
862
863	`<span class="md-ellipsis">`
864
865
866	`CI/CD`
867
868
869
870	`</span>`
871
872
873
874	`</a>`
875
876
877
878	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
879
880
881
882
883
884
885	`<label class="md-nav__title" for="__toc">`
886	`<span class="md-nav__icon md-icon"></span>`
887	`Table of contents`
888	`</label>`
889	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
890
891	`<li class="md-nav__item">`
892	`<a href="#ci-commands" class="md-nav__link">`
893	`<span class="md-ellipsis">`
894
895	`CI commands`
896
897	`</span>`
898	`</a>`
899
900	`<nav class="md-nav" aria-label="CI commands">`
901	`<ul class="md-nav__list">`
902
903	`<li class="md-nav__item">`
904	`<a href="#navegador-ci-ingest" class="md-nav__link">`
905	`<span class="md-ellipsis">`
906
907	`navegador ci ingest`
908
909	`</span>`
910	`</a>`
911
912	`</li>`
913
914	`<li class="md-nav__item">`
915	`<a href="#navegador-ci-stats" class="md-nav__link">`
916	`<span class="md-ellipsis">`
917
918	`navegador ci stats`
919
920	`</span>`
921	`</a>`
922
923	`</li>`
924
925	`<li class="md-nav__item">`
926	`<a href="#navegador-ci-check" class="md-nav__link">`
927	`<span class="md-ellipsis">`
928
929	`navegador ci check`
930
931	`</span>`
932	`</a>`
933
934	`</li>`
935
936	`<li class="md-nav__item">`
937	`<a href="#running-specific-checks" class="md-nav__link">`
938	`<span class="md-ellipsis">`
939
940	`Running specific checks`
941
942	`</span>`
943	`</a>`
944
945	`</li>`
946
947	`</ul>`
948	`</nav>`
949
950	`</li>`
951
952	`<li class="md-nav__item">`
953	`<a href="#exit-codes" class="md-nav__link">`
954	`<span class="md-ellipsis">`
955
956	`Exit codes`
957
958	`</span>`
959	`</a>`
960
961	`</li>`
962
963	`<li class="md-nav__item">`
964	`<a href="#github-actions" class="md-nav__link">`
965	`<span class="md-ellipsis">`
966
967	`GitHub Actions`
968
969	`</span>`
970	`</a>`
971
972	`<nav class="md-nav" aria-label="GitHub Actions">`
973	`<ul class="md-nav__list">`
974
975	`<li class="md-nav__item">`
976	`<a href="#basic-ingest-on-push" class="md-nav__link">`
977	`<span class="md-ellipsis">`
978
979	`Basic: ingest on push`
980
981	`</span>`
982	`</a>`
983
984	`</li>`
985
986	`<li class="md-nav__item">`
987	`<a href="#with-graph-caching" class="md-nav__link">`
988	`<span class="md-ellipsis">`
989
990	`With graph caching`
991
992	`</span>`
993	`</a>`
994
995	`</li>`
996
997	`<li class="md-nav__item">`
998	`<a href="#shared-graph-via-redis-cluster-mode" class="md-nav__link">`
999	`<span class="md-ellipsis">`
1000
1001	`Shared graph via Redis (cluster mode)`
1002
1003	`</span>`
1004	`</a>`
1005
1006	`</li>`
1007
1008	`<li class="md-nav__item">`
1009	`<a href="#pr-impact-report" class="md-nav__link">`
1010	`<span class="md-ellipsis">`
1011
1012	`PR impact report`
1013
1014	`</span>`
1015	`</a>`
1016
1017	`</li>`
1018
1019	`</ul>`
1020	`</nav>`
1021
1022	`</li>`
1023
1024	`<li class="md-nav__item">`
1025	`<a href="#editor-integration" class="md-nav__link">`
1026	`<span class="md-ellipsis">`
1027
1028	`Editor integration`
1029
1030	`</span>`
1031	`</a>`
1032
1033	`<nav class="md-nav" aria-label="Editor integration">`
1034	`<ul class="md-nav__list">`
1035
1036	`<li class="md-nav__item">`
1037	`<a href="#vs-code" class="md-nav__link">`
1038	`<span class="md-ellipsis">`
1039
1040	`VS Code`
1041
1042	`</span>`
1043	`</a>`
1044
1045	`</li>`
1046
1047	`<li class="md-nav__item">`
1048	`<a href="#neovim" class="md-nav__link">`
1049	`<span class="md-ellipsis">`
1050
1051	`Neovim`
1052
1053	`</span>`
1054	`</a>`
1055
1056	`</li>`
1057
1058	`<li class="md-nav__item">`
1059	`<a href="#pre-commit-hook" class="md-nav__link">`
1060	`<span class="md-ellipsis">`
1061
1062	`Pre-commit hook`
1063
1064	`</span>`
1065	`</a>`
1066
1067	`</li>`
1068
1069	`</ul>`
1070	`</nav>`
1071
1072	`</li>`
1073
1074	`<li class="md-nav__item">`
1075	`<a href="#secrets-and-auth" class="md-nav__link">`
1076	`<span class="md-ellipsis">`
1077
1078	`Secrets and auth`
1079
1080	`</span>`
1081	`</a>`
1082
1083	`</li>`
1084
1085	`</ul>`
1086
1087	`</nav>`
1088
1089	`</li>`
1090
1091
1092
1093
1094
1095
1096
1097
1098
1099
1100	`<li class="md-nav__item">`
1101	`<a href="../cluster/" class="md-nav__link">`
1102
1103
1104
1105	`<span class="md-ellipsis">`
1106
1107
1108	`Cluster Mode`
1109
1110
1111
1112	`</span>`
1113
1114
1115
1116	`</a>`
1117	`</li>`
1118
1119
1120
1121
1122
1123
1124
1125
1126
1127
1128	`<li class="md-nav__item">`
1129	`<a href="../agent-hooks/" class="md-nav__link">`
1130
1131
1132
1133	`<span class="md-ellipsis">`
1134
1135
1136	`Agent Hooks`
1137
1138
1139
1140	`</span>`
1141
1142
1143
1144	`</a>`
1145	`</li>`
1146
1147
1148
1149
1150
1151
1152
1153
1154
1155
1156	`<li class="md-nav__item">`
1157	`<a href="../planopticon/" class="md-nav__link">`
1158
1159
1160
1161	`<span class="md-ellipsis">`
1162
1163
1164	`Planopticon`
1165
1166
1167
1168	`</span>`
1169
1170
1171
1172	`</a>`
1173	`</li>`
1174
1175
1176
1177
1178	`</ul>`
1179	`</nav>`
1180
1181	`</li>`
1182
1183
1184
1185
1186
1187
1188
1189
1190
1191
1192
1193
1194
1195
1196
1197
1198
1199
1200
1201	`<li class="md-nav__item md-nav__item--nested">`
1202
1203
1204
1205
1206
1207	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_4" >`
1208
1209
1210	`<label class="md-nav__link" for="__nav_4" id="__nav_4_label" tabindex="0">`
1211
1212
1213
1214	`<span class="md-ellipsis">`
1215
1216
1217	`Architecture`
1218
1219
1220
1221	`</span>`
1222
1223
1224
1225	`<span class="md-nav__icon md-icon"></span>`
1226	`</label>`
1227
1228	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_4_label" aria-expanded="false">`
1229	`<label class="md-nav__title" for="__nav_4">`
1230	`<span class="md-nav__icon md-icon"></span>`
1231
1232
1233	`Architecture`
1234
1235
1236	`</label>`
1237	`<ul class="md-nav__list" data-md-scrollfix>`
1238
1239
1240
1241
1242
1243
1244
1245	`<li class="md-nav__item">`
1246	`<a href="../../architecture/overview/" class="md-nav__link">`
1247
1248
1249
1250	`<span class="md-ellipsis">`
1251
1252
1253	`Overview`
1254
1255
1256
1257	`</span>`
1258
1259
1260
1261	`</a>`
1262	`</li>`
1263
1264
1265
1266
1267
1268
1269
1270
1271
1272
1273	`<li class="md-nav__item">`
1274	`<a href="../../architecture/graph-schema/" class="md-nav__link">`
1275
1276
1277
1278	`<span class="md-ellipsis">`
1279
1280
1281	`Graph Schema`
1282
1283
1284
1285	`</span>`
1286
1287
1288
1289	`</a>`
1290	`</li>`
1291
1292
1293
1294
1295	`</ul>`
1296	`</nav>`
1297
1298	`</li>`
1299
1300
1301
1302
1303
1304
1305
1306
1307
1308
1309
1310
1311
1312
1313
1314
1315
1316
1317
1318	`<li class="md-nav__item md-nav__item--nested">`
1319
1320
1321
1322
1323
1324	`<input class="md-nav__toggle md-toggle md-toggle--indeterminate" type="checkbox" id="__nav_5" >`
1325
1326
1327	`<label class="md-nav__link" for="__nav_5" id="__nav_5_label" tabindex="0">`
1328
1329
1330
1331	`<span class="md-ellipsis">`
1332
1333
1334	`API Reference`
1335
1336
1337
1338	`</span>`
1339
1340
1341
1342	`<span class="md-nav__icon md-icon"></span>`
1343	`</label>`
1344
1345	`<nav class="md-nav" data-md-level="1" aria-labelledby="__nav_5_label" aria-expanded="false">`
1346	`<label class="md-nav__title" for="__nav_5">`
1347	`<span class="md-nav__icon md-icon"></span>`
1348
1349
1350	`API Reference`
1351
1352
1353	`</label>`
1354	`<ul class="md-nav__list" data-md-scrollfix>`
1355
1356
1357
1358
1359
1360
1361
1362	`<li class="md-nav__item">`
1363	`<a href="../../api/sdk/" class="md-nav__link">`
1364
1365
1366
1367	`<span class="md-ellipsis">`
1368
1369
1370	`Python SDK`
1371
1372
1373
1374	`</span>`
1375
1376
1377
1378	`</a>`
1379	`</li>`
1380
1381
1382
1383
1384
1385
1386
1387
1388
1389
1390	`<li class="md-nav__item">`
1391	`<a href="../../api/ingestion/" class="md-nav__link">`
1392
1393
1394
1395	`<span class="md-ellipsis">`
1396
1397
1398	`Ingestion`
1399
1400
1401
1402	`</span>`
1403
1404
1405
1406	`</a>`
1407	`</li>`
1408
1409
1410
1411
1412
1413
1414
1415
1416
1417
1418	`<li class="md-nav__item">`
1419	`<a href="../../api/analysis/" class="md-nav__link">`
1420
1421
1422
1423	`<span class="md-ellipsis">`
1424
1425
1426	`Analysis`
1427
1428
1429
1430	`</span>`
1431
1432
1433
1434	`</a>`
1435	`</li>`
1436
1437
1438
1439
1440
1441
1442
1443
1444
1445
1446	`<li class="md-nav__item">`
1447	`<a href="../../api/graph/" class="md-nav__link">`
1448
1449
1450
1451	`<span class="md-ellipsis">`
1452
1453
1454	`Graph`
1455
1456
1457
1458	`</span>`
1459
1460
1461
1462	`</a>`
1463	`</li>`
1464
1465
1466
1467
1468
1469
1470
1471
1472
1473
1474	`<li class="md-nav__item">`
1475	`<a href="../../api/mcp/" class="md-nav__link">`
1476
1477
1478
1479	`<span class="md-ellipsis">`
1480
1481
1482	`MCP Server`
1483
1484
1485
1486	`</span>`
1487
1488
1489
1490	`</a>`
1491	`</li>`
1492
1493
1494
1495
1496	`</ul>`
1497	`</nav>`
1498
1499	`</li>`
1500
1501
1502
1503	`</ul>`
1504	`</nav>`
1505	`</div>`
1506	`</div>`
1507	`</div>`
1508
1509
1510
1511	`<div class="md-sidebar md-sidebar--secondary" data-md-component="sidebar" data-md-type="toc" >`
1512	`<div class="md-sidebar__scrollwrap">`
1513	`<div class="md-sidebar__inner">`
1514
1515
1516	`<nav class="md-nav md-nav--secondary" aria-label="Table of contents">`
1517
1518
1519
1520
1521
1522
1523	`<label class="md-nav__title" for="__toc">`
1524	`<span class="md-nav__icon md-icon"></span>`
1525	`Table of contents`
1526	`</label>`
1527	`<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>`
1528
1529	`<li class="md-nav__item">`
1530	`<a href="#ci-commands" class="md-nav__link">`
1531	`<span class="md-ellipsis">`
1532
1533	`CI commands`
1534
1535	`</span>`
1536	`</a>`
1537
1538	`<nav class="md-nav" aria-label="CI commands">`
1539	`<ul class="md-nav__list">`
1540
1541	`<li class="md-nav__item">`
1542	`<a href="#navegador-ci-ingest" class="md-nav__link">`
1543	`<span class="md-ellipsis">`
1544
1545	`navegador ci ingest`
1546
1547	`</span>`
1548	`</a>`
1549
1550	`</li>`
1551
1552	`<li class="md-nav__item">`
1553	`<a href="#navegador-ci-stats" class="md-nav__link">`
1554	`<span class="md-ellipsis">`
1555
1556	`navegador ci stats`
1557
1558	`</span>`
1559	`</a>`
1560
1561	`</li>`
1562
1563	`<li class="md-nav__item">`
1564	`<a href="#navegador-ci-check" class="md-nav__link">`
1565	`<span class="md-ellipsis">`
1566
1567	`navegador ci check`
1568
1569	`</span>`
1570	`</a>`
1571
1572	`</li>`
1573
1574	`<li class="md-nav__item">`
1575	`<a href="#running-specific-checks" class="md-nav__link">`
1576	`<span class="md-ellipsis">`
1577
1578	`Running specific checks`
1579
1580	`</span>`
1581	`</a>`
1582
1583	`</li>`
1584
1585	`</ul>`
1586	`</nav>`
1587
1588	`</li>`
1589
1590	`<li class="md-nav__item">`
1591	`<a href="#exit-codes" class="md-nav__link">`
1592	`<span class="md-ellipsis">`
1593
1594	`Exit codes`
1595
1596	`</span>`
1597	`</a>`
1598
1599	`</li>`
1600
1601	`<li class="md-nav__item">`
1602	`<a href="#github-actions" class="md-nav__link">`
1603	`<span class="md-ellipsis">`
1604
1605	`GitHub Actions`
1606
1607	`</span>`
1608	`</a>`
1609
1610	`<nav class="md-nav" aria-label="GitHub Actions">`
1611	`<ul class="md-nav__list">`
1612
1613	`<li class="md-nav__item">`
1614	`<a href="#basic-ingest-on-push" class="md-nav__link">`
1615	`<span class="md-ellipsis">`
1616
1617	`Basic: ingest on push`
1618
1619	`</span>`
1620	`</a>`
1621
1622	`</li>`
1623
1624	`<li class="md-nav__item">`
1625	`<a href="#with-graph-caching" class="md-nav__link">`
1626	`<span class="md-ellipsis">`
1627
1628	`With graph caching`
1629
1630	`</span>`
1631	`</a>`
1632
1633	`</li>`
1634
1635	`<li class="md-nav__item">`
1636	`<a href="#shared-graph-via-redis-cluster-mode" class="md-nav__link">`
1637	`<span class="md-ellipsis">`
1638
1639	`Shared graph via Redis (cluster mode)`
1640
1641	`</span>`
1642	`</a>`
1643
1644	`</li>`
1645
1646	`<li class="md-nav__item">`
1647	`<a href="#pr-impact-report" class="md-nav__link">`
1648	`<span class="md-ellipsis">`
1649
1650	`PR impact report`
1651
1652	`</span>`
1653	`</a>`
1654
1655	`</li>`
1656
1657	`</ul>`
1658	`</nav>`
1659
1660	`</li>`
1661
1662	`<li class="md-nav__item">`
1663	`<a href="#editor-integration" class="md-nav__link">`
1664	`<span class="md-ellipsis">`
1665
1666	`Editor integration`
1667
1668	`</span>`
1669	`</a>`
1670
1671	`<nav class="md-nav" aria-label="Editor integration">`
1672	`<ul class="md-nav__list">`
1673
1674	`<li class="md-nav__item">`
1675	`<a href="#vs-code" class="md-nav__link">`
1676	`<span class="md-ellipsis">`
1677
1678	`VS Code`
1679
1680	`</span>`
1681	`</a>`
1682
1683	`</li>`
1684
1685	`<li class="md-nav__item">`
1686	`<a href="#neovim" class="md-nav__link">`
1687	`<span class="md-ellipsis">`
1688
1689	`Neovim`
1690
1691	`</span>`
1692	`</a>`
1693
1694	`</li>`
1695
1696	`<li class="md-nav__item">`
1697	`<a href="#pre-commit-hook" class="md-nav__link">`
1698	`<span class="md-ellipsis">`
1699
1700	`Pre-commit hook`
1701
1702	`</span>`
1703	`</a>`
1704
1705	`</li>`
1706
1707	`</ul>`
1708	`</nav>`
1709
1710	`</li>`
1711
1712	`<li class="md-nav__item">`
1713	`<a href="#secrets-and-auth" class="md-nav__link">`
1714	`<span class="md-ellipsis">`
1715
1716	`Secrets and auth`
1717
1718	`</span>`
1719	`</a>`
1720
1721	`</li>`
1722
1723	`</ul>`
1724
1725	`</nav>`
1726	`</div>`
1727	`</div>`
1728	`</div>`
1729
1730
1731
1732	`<div class="md-content" data-md-component="content">`
1733
1734	`<article class="md-content__inner md-typeset">`
1735
1736
1737
1738
1739
1740
1741
1742
1743	`<h1 id="cicd-integration">CI/CD Integration<a class="headerlink" href="#cicd-integration" title="Permanent link">¶</a></h1>`
1744	`<p>Navegador's <code>ci</code> subcommand is designed for non-interactive use in pipelines. All CI commands emit structured output and use exit codes that CI systems understand.</p>`
1745	`<hr />`
1746	`<h2 id="ci-commands">CI commands<a class="headerlink" href="#ci-commands" title="Permanent link">¶</a></h2>`
1747	`<h3 id="navegador-ci-ingest"><code>navegador ci ingest</code><a class="headerlink" href="#navegador-ci-ingest" title="Permanent link">¶</a></h3>`
1748	`<p>Ingest the repo and output a machine-readable summary. Exits non-zero on errors.</p>`
1749	`<div class="highlight"><pre><span></span><code><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a>navegador<span class="w"> </span>ci<span class="w"> </span>ingest<span class="w"> </span>./src`
1750	`</code></pre></div>`
1751	`<p>JSON output (always on in CI mode):</p>`
1752	`<div class="highlight"><pre><span></span><code><a id="__codelineno-1-1" name="__codelineno-1-1" href="#__codelineno-1-1"></a><span class="p">{</span>`
1753	`<a id="__codelineno-1-2" name="__codelineno-1-2" href="#__codelineno-1-2"></a><span class="w"> </span><span class="nt">"status"</span><span class="p">:</span><span class="w"> </span><span class="s2">"ok"</span><span class="p">,</span>`
1754	`<a id="__codelineno-1-3" name="__codelineno-1-3" href="#__codelineno-1-3"></a><span class="w"> </span><span class="nt">"nodes_created"</span><span class="p">:</span><span class="w"> </span><span class="mi">1240</span><span class="p">,</span>`
1755	`<a id="__codelineno-1-4" name="__codelineno-1-4" href="#__codelineno-1-4"></a><span class="w"> </span><span class="nt">"nodes_updated"</span><span class="p">:</span><span class="w"> </span><span class="mi">38</span><span class="p">,</span>`
1756	`<a id="__codelineno-1-5" name="__codelineno-1-5" href="#__codelineno-1-5"></a><span class="w"> </span><span class="nt">"edges_created"</span><span class="p">:</span><span class="w"> </span><span class="mi">4821</span><span class="p">,</span>`
1757	`<a id="__codelineno-1-6" name="__codelineno-1-6" href="#__codelineno-1-6"></a><span class="w"> </span><span class="nt">"files_processed"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span>`
1758	`<a id="__codelineno-1-7" name="__codelineno-1-7" href="#__codelineno-1-7"></a><span class="w"> </span><span class="nt">"errors"</span><span class="p">:</span><span class="w"> </span><span class="p">[],</span>`
1759	`<a id="__codelineno-1-8" name="__codelineno-1-8" href="#__codelineno-1-8"></a><span class="w"> </span><span class="nt">"duration_seconds"</span><span class="p">:</span><span class="w"> </span><span class="mf">4.2</span>`
1760	`<a id="__codelineno-1-9" name="__codelineno-1-9" href="#__codelineno-1-9"></a><span class="p">}</span>`
1761	`</code></pre></div>`
1762	`<h3 id="navegador-ci-stats"><code>navegador ci stats</code><a class="headerlink" href="#navegador-ci-stats" title="Permanent link">¶</a></h3>`
1763	`<p>Print graph statistics as JSON. Use to track graph growth over time or assert a minimum coverage threshold.</p>`
1764	`<div class="highlight"><pre><span></span><code><a id="__codelineno-2-1" name="__codelineno-2-1" href="#__codelineno-2-1"></a>navegador<span class="w"> </span>ci<span class="w"> </span>stats`
1765	`</code></pre></div>`
1766	`<div class="highlight"><pre><span></span><code><a id="__codelineno-3-1" name="__codelineno-3-1" href="#__codelineno-3-1"></a><span class="p">{</span>`
1767	`<a id="__codelineno-3-2" name="__codelineno-3-2" href="#__codelineno-3-2"></a><span class="w"> </span><span class="nt">"repositories"</span><span class="p">:</span><span class="w"> </span><span class="mi">1</span><span class="p">,</span>`
1768	`<a id="__codelineno-3-3" name="__codelineno-3-3" href="#__codelineno-3-3"></a><span class="w"> </span><span class="nt">"files"</span><span class="p">:</span><span class="w"> </span><span class="mi">87</span><span class="p">,</span>`
1769	`<a id="__codelineno-3-4" name="__codelineno-3-4" href="#__codelineno-3-4"></a><span class="w"> </span><span class="nt">"classes"</span><span class="p">:</span><span class="w"> </span><span class="mi">143</span><span class="p">,</span>`
1770	`<a id="__codelineno-3-5" name="__codelineno-3-5" href="#__codelineno-3-5"></a><span class="w"> </span><span class="nt">"functions"</span><span class="p">:</span><span class="w"> </span><span class="mi">891</span><span class="p">,</span>`
1771	`<a id="__codelineno-3-6" name="__codelineno-3-6" href="#__codelineno-3-6"></a><span class="w"> </span><span class="nt">"methods"</span><span class="p">:</span><span class="w"> </span><span class="mi">412</span><span class="p">,</span>`
1772	`<a id="__codelineno-3-7" name="__codelineno-3-7" href="#__codelineno-3-7"></a><span class="w"> </span><span class="nt">"concepts"</span><span class="p">:</span><span class="w"> </span><span class="mi">14</span><span class="p">,</span>`
1773	`<a id="__codelineno-3-8" name="__codelineno-3-8" href="#__codelineno-3-8"></a><span class="w"> </span><span class="nt">"rules"</span><span class="p">:</span><span class="w"> </span><span class="mi">9</span><span class="p">,</span>`
1774	`<a id="__codelineno-3-9" name="__codelineno-3-9" href="#__codelineno-3-9"></a><span class="w"> </span><span class="nt">"decisions"</span><span class="p">:</span><span class="w"> </span><span class="mi">6</span><span class="p">,</span>`
1775	`<a id="__codelineno-3-10" name="__codelineno-3-10" href="#__codelineno-3-10"></a><span class="w"> </span><span class="nt">"total_edges"</span><span class="p">:</span><span class="w"> </span><span class="mi">4821</span>`
1776	`<a id="__codelineno-3-11" name="__codelineno-3-11" href="#__codelineno-3-11"></a><span class="p">}</span>`
1777	`</code></pre></div>`
1778	`<h3 id="navegador-ci-check"><code>navegador ci check</code><a class="headerlink" href="#navegador-ci-check" title="Permanent link">¶</a></h3>`
1779	`<p>Run assertion checks against the graph. Exits non-zero if any check fails.</p>`
1780	`<div class="highlight"><pre><span></span><code><a id="__codelineno-4-1" name="__codelineno-4-1" href="#__codelineno-4-1"></a>navegador<span class="w"> </span>ci<span class="w"> </span>check`
1781	`</code></pre></div>`
1782	`<p>Checks run by default:</p>`
1783	`<table>`
1784	`<thead>`
1785	`<tr>`
1786	`<th>Check</th>`
1787	`<th>Condition for failure</th>`
1788	`</tr>`
1789	`</thead>`
1790	`<tbody>`
1791	`<tr>`
1792	`<td><code>no-cycles</code></td>`
1793	`<td>Circular import chains detected</td>`
1794	`</tr>`
1795	`<tr>`
1796	`<td><code>min-coverage</code></td>`
1797	`<td>Functions with no tests below threshold</td>`
1798	`</tr>`
1799	`<tr>`
1800	`<td><code>critical-rules</code></td>`
1801	`<td>Code violates a <code>critical</code>-severity rule</td>`
1802	`</tr>`
1803	`<tr>`
1804	`<td><code>dead-code</code></td>`
1805	`<td>High-confidence dead code above threshold</td>`
1806	`</tr>`
1807	`</tbody>`
1808	`</table>`
1809	`<p>Configure checks in <code>navegador.toml</code>:</p>`
1810	`<div class="highlight"><pre><span></span><code><a id="__codelineno-5-1" name="__codelineno-5-1" href="#__codelineno-5-1"></a><span class="k">[ci.checks]</span>`
1811	`<a id="__codelineno-5-2" name="__codelineno-5-2" href="#__codelineno-5-2"></a><span class="n">no-cycles</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">true</span>`
1812	`<a id="__codelineno-5-3" name="__codelineno-5-3" href="#__codelineno-5-3"></a><span class="n">min-coverage</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">60</span><span class="w"> </span><span class="c1"># percent of functions with tests</span>`
1813	`<a id="__codelineno-5-4" name="__codelineno-5-4" href="#__codelineno-5-4"></a><span class="n">critical-rules</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">true</span>`
1814	`<a id="__codelineno-5-5" name="__codelineno-5-5" href="#__codelineno-5-5"></a><span class="n">dead-code</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">false</span><span class="w"> </span><span class="c1"># disable dead-code check</span>`
1815	`<a id="__codelineno-5-6" name="__codelineno-5-6" href="#__codelineno-5-6"></a>`
1816	`<a id="__codelineno-5-7" name="__codelineno-5-7" href="#__codelineno-5-7"></a><span class="k">[ci.thresholds]</span>`
1817	`<a id="__codelineno-5-8" name="__codelineno-5-8" href="#__codelineno-5-8"></a><span class="n">dead_code_max</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">10</span><span class="w"> </span><span class="c1"># fail if more than 10 dead-code candidates</span>`
1818	`<a id="__codelineno-5-9" name="__codelineno-5-9" href="#__codelineno-5-9"></a><span class="n">uncovered_max_percent</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="mi">40</span><span class="w"> </span><span class="c1"># fail if more than 40% of functions lack tests</span>`
1819	`</code></pre></div>`
1820	`<h3 id="running-specific-checks">Running specific checks<a class="headerlink" href="#running-specific-checks" title="Permanent link">¶</a></h3>`
1821	`<div class="highlight"><pre><span></span><code><a id="__codelineno-6-1" name="__codelineno-6-1" href="#__codelineno-6-1"></a>navegador<span class="w"> </span>ci<span class="w"> </span>check<span class="w"> </span>--only<span class="w"> </span>no-cycles`
1822	`<a id="__codelineno-6-2" name="__codelineno-6-2" href="#__codelineno-6-2"></a>navegador<span class="w"> </span>ci<span class="w"> </span>check<span class="w"> </span>--only<span class="w"> </span>critical-rules,min-coverage`
1823	`<a id="__codelineno-6-3" name="__codelineno-6-3" href="#__codelineno-6-3"></a>navegador<span class="w"> </span>ci<span class="w"> </span>check<span class="w"> </span>--skip<span class="w"> </span>dead-code`
1824	`</code></pre></div>`
1825	`<hr />`
1826	`<h2 id="exit-codes">Exit codes<a class="headerlink" href="#exit-codes" title="Permanent link">¶</a></h2>`
1827	`<table>`
1828	`<thead>`
1829	`<tr>`
1830	`<th>Code</th>`
1831	`<th>Meaning</th>`
1832	`</tr>`
1833	`</thead>`
1834	`<tbody>`
1835	`<tr>`
1836	`<td><code>0</code></td>`
1837	`<td>Success — all checks passed</td>`
1838	`</tr>`
1839	`<tr>`
1840	`<td><code>1</code></td>`
1841	`<td>Check failure — one or more assertions failed</td>`
1842	`</tr>`
1843	`<tr>`
1844	`<td><code>2</code></td>`
1845	`<td>Ingest error — files could not be parsed (partial result)</td>`
1846	`</tr>`
1847	`<tr>`
1848	`<td><code>3</code></td>`
1849	`<td>Configuration error — bad flags or missing config</td>`
1850	`</tr>`
1851	`<tr>`
1852	`<td><code>4</code></td>`
1853	`<td>Connection error — cannot reach database or Redis</td>`
1854	`</tr>`
1855	`</tbody>`
1856	`</table>`
1857	`<hr />`
1858	`<h2 id="github-actions">GitHub Actions<a class="headerlink" href="#github-actions" title="Permanent link">¶</a></h2>`
1859	`<h3 id="basic-ingest-on-push">Basic: ingest on push<a class="headerlink" href="#basic-ingest-on-push" title="Permanent link">¶</a></h3>`
1860	`<div class="highlight"><pre><span></span><code><a id="__codelineno-7-1" name="__codelineno-7-1" href="#__codelineno-7-1"></a><span class="c1"># .github/workflows/navegador.yml</span>`
1861	`<a id="__codelineno-7-2" name="__codelineno-7-2" href="#__codelineno-7-2"></a><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador</span>`
1862	`<a id="__codelineno-7-3" name="__codelineno-7-3" href="#__codelineno-7-3"></a>`
1863	`<a id="__codelineno-7-4" name="__codelineno-7-4" href="#__codelineno-7-4"></a><span class="nt">on</span><span class="p">:</span>`
1864	`<a id="__codelineno-7-5" name="__codelineno-7-5" href="#__codelineno-7-5"></a><span class="w"> </span><span class="nt">push</span><span class="p">:</span>`
1865	`<a id="__codelineno-7-6" name="__codelineno-7-6" href="#__codelineno-7-6"></a><span class="w"> </span><span class="nt">branches</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">main</span><span class="p p-Indicator">]</span>`
1866	`<a id="__codelineno-7-7" name="__codelineno-7-7" href="#__codelineno-7-7"></a><span class="w"> </span><span class="nt">pull_request</span><span class="p">:</span>`
1867	`<a id="__codelineno-7-8" name="__codelineno-7-8" href="#__codelineno-7-8"></a>`
1868	`<a id="__codelineno-7-9" name="__codelineno-7-9" href="#__codelineno-7-9"></a><span class="nt">jobs</span><span class="p">:</span>`
1869	`<a id="__codelineno-7-10" name="__codelineno-7-10" href="#__codelineno-7-10"></a><span class="w"> </span><span class="nt">graph</span><span class="p">:</span>`
1870	`<a id="__codelineno-7-11" name="__codelineno-7-11" href="#__codelineno-7-11"></a><span class="w"> </span><span class="nt">runs-on</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">ubuntu-latest</span>`
1871	`<a id="__codelineno-7-12" name="__codelineno-7-12" href="#__codelineno-7-12"></a><span class="w"> </span><span class="nt">steps</span><span class="p">:</span>`
1872	`<a id="__codelineno-7-13" name="__codelineno-7-13" href="#__codelineno-7-13"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">actions/checkout@v4</span>`
1873	`<a id="__codelineno-7-14" name="__codelineno-7-14" href="#__codelineno-7-14"></a>`
1874	`<a id="__codelineno-7-15" name="__codelineno-7-15" href="#__codelineno-7-15"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Install navegador</span>`
1875	`<a id="__codelineno-7-16" name="__codelineno-7-16" href="#__codelineno-7-16"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">pip install navegador</span>`
1876	`<a id="__codelineno-7-17" name="__codelineno-7-17" href="#__codelineno-7-17"></a>`
1877	`<a id="__codelineno-7-18" name="__codelineno-7-18" href="#__codelineno-7-18"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Ingest</span>`
1878	`<a id="__codelineno-7-19" name="__codelineno-7-19" href="#__codelineno-7-19"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador ci ingest ./src</span>`
1879	`<a id="__codelineno-7-20" name="__codelineno-7-20" href="#__codelineno-7-20"></a>`
1880	`<a id="__codelineno-7-21" name="__codelineno-7-21" href="#__codelineno-7-21"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Check</span>`
1881	`<a id="__codelineno-7-22" name="__codelineno-7-22" href="#__codelineno-7-22"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador ci check</span>`
1882	`</code></pre></div>`
1883	`<h3 id="with-graph-caching">With graph caching<a class="headerlink" href="#with-graph-caching" title="Permanent link">¶</a></h3>`
1884	`<p>Cache the SQLite database between runs to speed up incremental ingestion:</p>`
1885	`<div class="highlight"><pre><span></span><code><a id="__codelineno-8-1" name="__codelineno-8-1" href="#__codelineno-8-1"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Cache navegador graph</span>`
1886	`<a id="__codelineno-8-2" name="__codelineno-8-2" href="#__codelineno-8-2"></a><span class="w"> </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">actions/cache@v4</span>`
1887	`<a id="__codelineno-8-3" name="__codelineno-8-3" href="#__codelineno-8-3"></a><span class="w"> </span><span class="nt">with</span><span class="p">:</span>`
1888	`<a id="__codelineno-8-4" name="__codelineno-8-4" href="#__codelineno-8-4"></a><span class="w"> </span><span class="nt">path</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">.navegador/navegador.db</span>`
1889	`<a id="__codelineno-8-5" name="__codelineno-8-5" href="#__codelineno-8-5"></a><span class="w"> </span><span class="nt">key</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador-${{ runner.os }}-${{ hashFiles('src/**') }}</span>`
1890	`<a id="__codelineno-8-6" name="__codelineno-8-6" href="#__codelineno-8-6"></a><span class="w"> </span><span class="nt">restore-keys</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador-${{ runner.os }}-</span>`
1891	`<a id="__codelineno-8-7" name="__codelineno-8-7" href="#__codelineno-8-7"></a>`
1892	`<a id="__codelineno-8-8" name="__codelineno-8-8" href="#__codelineno-8-8"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Ingest</span>`
1893	`<a id="__codelineno-8-9" name="__codelineno-8-9" href="#__codelineno-8-9"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador ci ingest ./src</span>`
1894	`<a id="__codelineno-8-10" name="__codelineno-8-10" href="#__codelineno-8-10"></a>`
1895	`<a id="__codelineno-8-11" name="__codelineno-8-11" href="#__codelineno-8-11"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Check</span>`
1896	`<a id="__codelineno-8-12" name="__codelineno-8-12" href="#__codelineno-8-12"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador ci check</span>`
1897	`</code></pre></div>`
1898	`<h3 id="shared-graph-via-redis-cluster-mode">Shared graph via Redis (cluster mode)<a class="headerlink" href="#shared-graph-via-redis-cluster-mode" title="Permanent link">¶</a></h3>`
1899	`<p>Use a shared Redis instance for team-wide graph persistence across branches and PRs:</p>`
1900	`<div class="highlight"><pre><span></span><code><a id="__codelineno-9-1" name="__codelineno-9-1" href="#__codelineno-9-1"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Ingest to shared graph</span>`
1901	`<a id="__codelineno-9-2" name="__codelineno-9-2" href="#__codelineno-9-2"></a><span class="w"> </span><span class="nt">env</span><span class="p">:</span>`
1902	`<a id="__codelineno-9-3" name="__codelineno-9-3" href="#__codelineno-9-3"></a><span class="w"> </span><span class="nt">NAVEGADOR_REDIS_URL</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">${{ secrets.NAVEGADOR_REDIS_URL }}</span>`
1903	`<a id="__codelineno-9-4" name="__codelineno-9-4" href="#__codelineno-9-4"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">\|</span>`
1904	`<a id="__codelineno-9-5" name="__codelineno-9-5" href="#__codelineno-9-5"></a><span class="w"> </span><span class="no">navegador ci ingest ./src --cluster</span>`
1905	`<a id="__codelineno-9-6" name="__codelineno-9-6" href="#__codelineno-9-6"></a><span class="w"> </span><span class="no">navegador ci check --cluster</span>`
1906	`</code></pre></div>`
1907	`<h3 id="pr-impact-report">PR impact report<a class="headerlink" href="#pr-impact-report" title="Permanent link">¶</a></h3>`
1908	`<p>Post an impact analysis comment on pull requests:</p>`
1909	`<div class="highlight"><pre><span></span><code><a id="__codelineno-10-1" name="__codelineno-10-1" href="#__codelineno-10-1"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Impact analysis</span>`
1910	`<a id="__codelineno-10-2" name="__codelineno-10-2" href="#__codelineno-10-2"></a><span class="w"> </span><span class="nt">if</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">github.event_name == 'pull_request'</span>`
1911	`<a id="__codelineno-10-3" name="__codelineno-10-3" href="#__codelineno-10-3"></a><span class="w"> </span><span class="nt">run</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">\|</span>`
1912	`<a id="__codelineno-10-4" name="__codelineno-10-4" href="#__codelineno-10-4"></a><span class="w"> </span><span class="no">CHANGED=$(git diff --name-only origin/main...HEAD \| grep '\.py$' \| head -20)</span>`
1913	`<a id="__codelineno-10-5" name="__codelineno-10-5" href="#__codelineno-10-5"></a><span class="w"> </span><span class="no">for f in $CHANGED; do</span>`
1914	`<a id="__codelineno-10-6" name="__codelineno-10-6" href="#__codelineno-10-6"></a><span class="w"> </span><span class="no">navegador ci ingest "$f"</span>`
1915	`<a id="__codelineno-10-7" name="__codelineno-10-7" href="#__codelineno-10-7"></a><span class="w"> </span><span class="no">done</span>`
1916	`<a id="__codelineno-10-8" name="__codelineno-10-8" href="#__codelineno-10-8"></a><span class="w"> </span><span class="no">navegador impact --changed-since origin/main --format json > impact.json</span>`
1917	`<a id="__codelineno-10-9" name="__codelineno-10-9" href="#__codelineno-10-9"></a>`
1918	`<a id="__codelineno-10-10" name="__codelineno-10-10" href="#__codelineno-10-10"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Comment impact</span>`
1919	`<a id="__codelineno-10-11" name="__codelineno-10-11" href="#__codelineno-10-11"></a><span class="w"> </span><span class="nt">if</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">github.event_name == 'pull_request'</span>`
1920	`<a id="__codelineno-10-12" name="__codelineno-10-12" href="#__codelineno-10-12"></a><span class="w"> </span><span class="nt">uses</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">actions/github-script@v7</span>`
1921	`<a id="__codelineno-10-13" name="__codelineno-10-13" href="#__codelineno-10-13"></a><span class="w"> </span><span class="nt">with</span><span class="p">:</span>`
1922	`<a id="__codelineno-10-14" name="__codelineno-10-14" href="#__codelineno-10-14"></a><span class="w"> </span><span class="nt">script</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">\|</span>`
1923	`<a id="__codelineno-10-15" name="__codelineno-10-15" href="#__codelineno-10-15"></a><span class="w"> </span><span class="no">const impact = require('./impact.json')</span>`
1924	<a id="__codelineno-10-16" name="__codelineno-10-16" href="#__codelineno-10-16"></a><span class="w"> </span><span class="no">const body = `## Navegador impact analysis\n\n${impact.summary}`</span>
1925	`<a id="__codelineno-10-17" name="__codelineno-10-17" href="#__codelineno-10-17"></a><span class="w"> </span><span class="no">github.rest.issues.createComment({</span>`
1926	`<a id="__codelineno-10-18" name="__codelineno-10-18" href="#__codelineno-10-18"></a><span class="w"> </span><span class="no">issue_number: context.issue.number,</span>`
1927	`<a id="__codelineno-10-19" name="__codelineno-10-19" href="#__codelineno-10-19"></a><span class="w"> </span><span class="no">owner: context.repo.owner,</span>`
1928	`<a id="__codelineno-10-20" name="__codelineno-10-20" href="#__codelineno-10-20"></a><span class="w"> </span><span class="no">repo: context.repo.repo,</span>`
1929	`<a id="__codelineno-10-21" name="__codelineno-10-21" href="#__codelineno-10-21"></a><span class="w"> </span><span class="no">body</span>`
1930	`<a id="__codelineno-10-22" name="__codelineno-10-22" href="#__codelineno-10-22"></a><span class="w"> </span><span class="no">})</span>`
1931	`</code></pre></div>`
1932	`<hr />`
1933	`<h2 id="editor-integration">Editor integration<a class="headerlink" href="#editor-integration" title="Permanent link">¶</a></h2>`
1934	`<h3 id="vs-code">VS Code<a class="headerlink" href="#vs-code" title="Permanent link">¶</a></h3>`
1935	`<p>Install the <a href="https://marketplace.visualstudio.com/items?itemName=ConflictHQ.navegador">Navegador VS Code extension</a> for inline context overlays and on-save re-ingest.</p>`
1936	`<p>Or configure a task in <code>.vscode/tasks.json</code> to run on save:</p>`
1937	`<div class="highlight"><pre><span></span><code><a id="__codelineno-11-1" name="__codelineno-11-1" href="#__codelineno-11-1"></a><span class="p">{</span>`
1938	`<a id="__codelineno-11-2" name="__codelineno-11-2" href="#__codelineno-11-2"></a><span class="w"> </span><span class="nt">"version"</span><span class="p">:</span><span class="w"> </span><span class="s2">"2.0.0"</span><span class="p">,</span>`
1939	`<a id="__codelineno-11-3" name="__codelineno-11-3" href="#__codelineno-11-3"></a><span class="w"> </span><span class="nt">"tasks"</span><span class="p">:</span><span class="w"> </span><span class="p">[</span>`
1940	`<a id="__codelineno-11-4" name="__codelineno-11-4" href="#__codelineno-11-4"></a><span class="w"> </span><span class="p">{</span>`
1941	`<a id="__codelineno-11-5" name="__codelineno-11-5" href="#__codelineno-11-5"></a><span class="w"> </span><span class="nt">"label"</span><span class="p">:</span><span class="w"> </span><span class="s2">"Navegador: re-ingest on save"</span><span class="p">,</span>`
1942	`<a id="__codelineno-11-6" name="__codelineno-11-6" href="#__codelineno-11-6"></a><span class="w"> </span><span class="nt">"type"</span><span class="p">:</span><span class="w"> </span><span class="s2">"shell"</span><span class="p">,</span>`
1943	`<a id="__codelineno-11-7" name="__codelineno-11-7" href="#__codelineno-11-7"></a><span class="w"> </span><span class="nt">"command"</span><span class="p">:</span><span class="w"> </span><span class="s2">"navegador ingest ${file}"</span><span class="p">,</span>`
1944	`<a id="__codelineno-11-8" name="__codelineno-11-8" href="#__codelineno-11-8"></a><span class="w"> </span><span class="nt">"group"</span><span class="p">:</span><span class="w"> </span><span class="s2">"build"</span><span class="p">,</span>`
1945	`<a id="__codelineno-11-9" name="__codelineno-11-9" href="#__codelineno-11-9"></a><span class="w"> </span><span class="nt">"presentation"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>`
1946	`<a id="__codelineno-11-10" name="__codelineno-11-10" href="#__codelineno-11-10"></a><span class="w"> </span><span class="nt">"reveal"</span><span class="p">:</span><span class="w"> </span><span class="s2">"silent"</span><span class="p">,</span>`
1947	`<a id="__codelineno-11-11" name="__codelineno-11-11" href="#__codelineno-11-11"></a><span class="w"> </span><span class="nt">"panel"</span><span class="p">:</span><span class="w"> </span><span class="s2">"shared"</span>`
1948	`<a id="__codelineno-11-12" name="__codelineno-11-12" href="#__codelineno-11-12"></a><span class="w"> </span><span class="p">},</span>`
1949	`<a id="__codelineno-11-13" name="__codelineno-11-13" href="#__codelineno-11-13"></a><span class="w"> </span><span class="nt">"runOptions"</span><span class="p">:</span><span class="w"> </span><span class="p">{</span>`
1950	`<a id="__codelineno-11-14" name="__codelineno-11-14" href="#__codelineno-11-14"></a><span class="w"> </span><span class="nt">"runOn"</span><span class="p">:</span><span class="w"> </span><span class="s2">"folderOpen"</span>`
1951	`<a id="__codelineno-11-15" name="__codelineno-11-15" href="#__codelineno-11-15"></a><span class="w"> </span><span class="p">}</span>`
1952	`<a id="__codelineno-11-16" name="__codelineno-11-16" href="#__codelineno-11-16"></a><span class="w"> </span><span class="p">}</span>`
1953	`<a id="__codelineno-11-17" name="__codelineno-11-17" href="#__codelineno-11-17"></a><span class="w"> </span><span class="p">]</span>`
1954	`<a id="__codelineno-11-18" name="__codelineno-11-18" href="#__codelineno-11-18"></a><span class="p">}</span>`
1955	`</code></pre></div>`
1956	`<h3 id="neovim">Neovim<a class="headerlink" href="#neovim" title="Permanent link">¶</a></h3>`
1957	`<p>Add a post-write autocmd to trigger incremental ingest:</p>`
1958	`<div class="highlight"><pre><span></span><code><a id="__codelineno-12-1" name="__codelineno-12-1" href="#__codelineno-12-1"></a><span class="c1">-- in your init.lua or a plugin config</span>`
1959	`<a id="__codelineno-12-2" name="__codelineno-12-2" href="#__codelineno-12-2"></a><span class="nv">vim</span><span class="p">.</span><span class="py">api</span><span class="p">.</span><span class="nf">nvim_create_autocmd</span><span class="p">(</span><span class="s2">"BufWritePost"</span><span class="p">,</span><span class="w"> </span><span class="p">{</span>`
1960	<a id="__codelineno-12-3" name="__codelineno-12-3" href="#__codelineno-12-3"></a><span class="w"> </span><span class="nv">pattern</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="s2">".py"</span><span class="p">,</span><span class="w"> </span><span class="s2">".ts"</span><span class="p">,</span><span class="w"> </span><span class="s2">".tsx"</span><span class="p">,</span><span class="w"> </span><span class="s2">".js"</span><span class="w"> </span><span class="p">},</span>
1961	`<a id="__codelineno-12-4" name="__codelineno-12-4" href="#__codelineno-12-4"></a><span class="w"> </span><span class="nv">callback</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kr">function</span><span class="p">(</span><span class="nv">ev</span><span class="p">)</span>`
1962	`<a id="__codelineno-12-5" name="__codelineno-12-5" href="#__codelineno-12-5"></a><span class="w"> </span><span class="kd">local</span><span class="w"> </span><span class="nv">file</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="nv">ev</span><span class="p">.</span><span class="py">file</span>`
1963	<a id="__codelineno-12-6" name="__codelineno-12-6" href="#__codelineno-12-6"></a><span class="w"> </span><span class="nv">vim</span><span class="p">.</span><span class="py">fn</span><span class="p">.</span><span class="nf">jobstart</span><span class="p">({</span><span class="w"> </span><span class="s2">"navegador"</span><span class="p">,</span><span class="w"> </span><span class="s2">"ingest"</span><span class="p">,</span><span class="w"> </span><span class="nv">file</span><span class="w"> </span><span class="p">},</span><span class="w"> </span><span class="p">{</span><span class="w"> </span><span class="nv">detach</span><span class="w"> </span><span class="o">=</span><span class="w"> </span><span class="kc">true</span><span class="w"> </span><span class="p">})</span>
1964	`<a id="__codelineno-12-7" name="__codelineno-12-7" href="#__codelineno-12-7"></a><span class="w"> </span><span class="kr">end</span><span class="p">,</span>`
1965	`<a id="__codelineno-12-8" name="__codelineno-12-8" href="#__codelineno-12-8"></a><span class="p">})</span>`
1966	`</code></pre></div>`
1967	`<h3 id="pre-commit-hook">Pre-commit hook<a class="headerlink" href="#pre-commit-hook" title="Permanent link">¶</a></h3>`
1968	`<p>Run checks before committing:</p>`
1969	`<div class="highlight"><pre><span></span><code><a id="__codelineno-13-1" name="__codelineno-13-1" href="#__codelineno-13-1"></a><span class="c1"># .pre-commit-config.yaml</span>`
1970	`<a id="__codelineno-13-2" name="__codelineno-13-2" href="#__codelineno-13-2"></a><span class="nt">repos</span><span class="p">:</span>`
1971	`<a id="__codelineno-13-3" name="__codelineno-13-3" href="#__codelineno-13-3"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">repo</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">local</span>`
1972	`<a id="__codelineno-13-4" name="__codelineno-13-4" href="#__codelineno-13-4"></a><span class="w"> </span><span class="nt">hooks</span><span class="p">:</span>`
1973	`<a id="__codelineno-13-5" name="__codelineno-13-5" href="#__codelineno-13-5"></a><span class="w"> </span><span class="p p-Indicator">-</span><span class="w"> </span><span class="nt">id</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador-check</span>`
1974	`<a id="__codelineno-13-6" name="__codelineno-13-6" href="#__codelineno-13-6"></a><span class="w"> </span><span class="nt">name</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">Navegador graph checks</span>`
1975	`<a id="__codelineno-13-7" name="__codelineno-13-7" href="#__codelineno-13-7"></a><span class="w"> </span><span class="nt">entry</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">navegador ci check --only no-cycles,critical-rules</span>`
1976	`<a id="__codelineno-13-8" name="__codelineno-13-8" href="#__codelineno-13-8"></a><span class="w"> </span><span class="nt">language</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">system</span>`
1977	`<a id="__codelineno-13-9" name="__codelineno-13-9" href="#__codelineno-13-9"></a><span class="w"> </span><span class="nt">pass_filenames</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">false</span>`
1978	`<a id="__codelineno-13-10" name="__codelineno-13-10" href="#__codelineno-13-10"></a><span class="w"> </span><span class="nt">stages</span><span class="p">:</span><span class="w"> </span><span class="p p-Indicator">[</span><span class="nv">commit</span><span class="p p-Indicator">]</span>`
1979	`</code></pre></div>`
1980	`<hr />`
1981	`<h2 id="secrets-and-auth">Secrets and auth<a class="headerlink" href="#secrets-and-auth" title="Permanent link">¶</a></h2>`
1982	`<p>The graph database path and Redis URL should come from environment variables in CI, not from committed config:</p>`
1983	`<div class="highlight"><pre><span></span><code><a id="__codelineno-14-1" name="__codelineno-14-1" href="#__codelineno-14-1"></a><span class="c1"># CI environment variables</span>`
1984	`<a id="__codelineno-14-2" name="__codelineno-14-2" href="#__codelineno-14-2"></a><span class="nv">NAVEGADOR_DB</span><span class="o">=</span>.navegador/navegador.db<span class="w"> </span><span class="c1"># SQLite path</span>`
1985	`<a id="__codelineno-14-3" name="__codelineno-14-3" href="#__codelineno-14-3"></a><span class="nv">NAVEGADOR_REDIS_URL</span><span class="o">=</span>redis://...<span class="w"> </span><span class="c1"># Redis URL (cluster mode)</span>`
1986	`<a id="__codelineno-14-4" name="__codelineno-14-4" href="#__codelineno-14-4"></a><span class="nv">GITHUB_TOKEN</span><span class="o">=</span>ghp_...<span class="w"> </span><span class="c1"># for wiki ingestion</span>`
1987	`</code></pre></div>`
1988	`<p>Set these as <a href="https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions">GitHub Actions secrets</a> and reference them in your workflow with <code>${{ secrets.NAME }}</code>.</p>`
1989
1990
1991
1992
1993
1994
1995
1996
1997
1998
1999
2000
2001
2002	`</article>`
2003	`</div>`
2004
2005
2006	`<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>`
2007
2008	`<script>var target=document.getElementById(location.hash.slice(1));target&&target.name&&(target.checked=target.name.startsWith("__tabbed_"))</script>`
2009	`</div>`
2010
2011	`<button type="button" class="md-top md-icon" data-md-component="top" hidden>`
2012
2013	`<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>`
2014	`Back to top`
2015	`</button>`
2016
2017	`</main>`
2018
2019	`<footer class="md-footer">`
2020
2021	`<div class="md-footer-meta md-typeset">`
2022	`<div class="md-footer-meta__inner md-grid">`
2023	`<div class="md-copyright">`
2024
2025	`<div class="md-copyright__highlight">`
2026	`Copyright © 2026 CONFLICT LLC`
2027	`</div>`
2028
2029
2030	`Made with`
2031	`<a href="https://squidfunk.github.io/mkdocs-material/" target="_blank" rel="noopener">`
2032	`Material for MkDocs`
2033	`</a>`
2034
2035	`</div>`
2036
2037
2038	`<div class="md-social">`
2039
2040
2041
2042
2043
2044
2045
2046
2047	`<a href="https://github.com/ConflictHQ/navegador" target="_blank" rel="noopener" title="github.com" class="md-social__link">`
2048	<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>
2049	`</a>`
2050
2051	`</div>`
2052
2053	`</div>`
2054	`</div>`
2055	`</footer>`
2056
2057	`</div>`
2058	`<div class="md-dialog" data-md-component="dialog">`
2059	`<div class="md-dialog__inner md-typeset"></div>`
2060	`</div>`
2061
2062
2063
2064
2065
2066	<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>
2067
2068
2069	`<script src="../../assets/javascripts/bundle.79ae519e.min.js"></script>`
2070
2071
2072	`</body>`
2073	`</html>`

Navegador

Keyboard Shortcuts