magellan 3.2.0

Deterministic codebase mapping tool for local development
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108

#![allow(unused_imports)]
//! Magellan: A dumb, deterministic codebase mapping tool
//!
//! Magellan observes files, extracts symbols and references, and persists facts to sqlitegraph.
//!
//! # Position Conventions
//!
//! Magellan uses tree-sitter position conventions for all symbol and reference data:
//! - **Line positions**: 1-indexed (line 1 is the first line)
//! - **Column positions**: 0-indexed (column 0 is the first character)
//! - **Byte offsets**: 0-indexed from file start
//!
//! See [MANUAL.md](../MANUAL.md#3-position-conventions) for detailed documentation.
//!
//! # Feature Flags
//!
//! ## Backend Selection (Choose One)
//!
//! Magellan supports two storage backends via sqlitegraph:
//!
//! ### SQLite Backend (Default)
//! - **`sqlite-backend`**: Stable SQLite-based storage
//!   - Widely compatible, well-tested
//!   - Use for maximum compatibility
//!
//! ## Optional Features
//!
//! - **`llvm-cfg`**: LLVM IR-based CFG extraction for C/C++ (requires clang)
//! - **`bytecode-cfg`**: Java bytecode-based CFG extraction (requires Java bytecode library)

pub mod backend_router;
pub mod capabilities;
pub mod common;
pub mod config;
pub mod context;
pub mod diagnostics;
pub mod error_codes;
pub mod generation;
pub mod geo_builder;
pub mod geo_staleness;
pub mod graph;
pub mod indexer;
pub mod ingest;
pub mod lsif;
pub mod lsp;
#[cfg(feature = "web-ui")]
pub mod web_ui;

pub mod ingest_coverage_cmd;
pub mod migrate_backend_cmd;
pub mod migrate_cmd;

// Re-export backend detection for CLI commands
pub use backend_router::{MagellanBackend, UnifiedSymbolInfo};
pub use capabilities::all_capabilities;
pub use migrate_backend_cmd::{detect_backend_format, BackendFormat};
pub mod output;
pub mod references;
pub mod validation;
pub mod verify;
pub mod watcher;

pub use common::{
    detect_language_from_path, detect_project_root, extract_context_safe,
    extract_symbol_content_safe, format_symbol_kind, parse_symbol_kind, resolve_path,
};
pub use diagnostics::{DiagnosticStage, SkipReason, WatchDiagnostic};
pub use generation::{ChunkStore, CodeChunk};
pub use graph::filter::FileFilter;
pub use graph::query::{cross_file_references_to, SymbolQueryResult};
pub use graph::scan::ScanResult;
pub use graph::test_helpers::{delete_file_facts_with_injection, FailPoint};
pub use graph::CrossFileRef;
pub use graph::{
    CodeGraph,
    CondensationGraph,
    CondensationResult,
    Cycle,
    CycleKind,
    CycleReport,
    DeadSymbol,
    DeleteResult,
    ExecutionPath,
    ExportConfig,
    ExportFormat, // GraphSymbol, MemoryGraph,
    PathEnumerationResult,
    PathStatistics,
    ProgramSlice,
    ReconcileOutcome,
    ScanProgress,
    SliceDirection,
    SliceResult,
    SliceStatistics,
    Supernode,
    SymbolInfo,
    MAGELLAN_SCHEMA_VERSION,
};
pub use indexer::{run_indexer, run_indexer_n, run_watch_pipeline, WatchPipelineConfig};
pub use ingest::detect::{detect_language, Language};
pub use ingest::{Parser, SymbolFact, SymbolKind};
pub use output::command::{MigrateResponse, ReferenceMatch, Span, SymbolMatch};
pub use output::{generate_execution_id, output_json, JsonResponse, OutputFormat};
pub use references::{CallFact, ReferenceFact};
pub use validation::{
    canonicalize_path, normalize_path, validate_path_within_root, PathValidationError,
};
pub use verify::{verify_graph, VerifyReport};
pub use watcher::{EventType, FileEvent, FileSystemWatcher, WatcherBatch, WatcherConfig};