Expand description
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 for detailed documentation.
Re-exports§
pub use common::detect_language_from_path;pub use common::format_symbol_kind;pub use common::parse_symbol_kind;pub use common::resolve_path;pub use diagnostics::DiagnosticStage;pub use diagnostics::SkipReason;pub use diagnostics::WatchDiagnostic;pub use generation::ChunkStore;pub use generation::CodeChunk;pub use graph::filter::FileFilter;pub use graph::query::SymbolQueryResult;pub use graph::scan::ScanResult;pub use graph::CodeGraph;pub use graph::DeleteResult;pub use graph::ExportConfig;pub use graph::ExportFormat;pub use graph::ReconcileOutcome;pub use graph::ScanProgress;pub use graph::MAGELLAN_SCHEMA_VERSION;pub use indexer::run_indexer;pub use indexer::run_indexer_n;pub use indexer::run_watch_pipeline;pub use indexer::WatchPipelineConfig;pub use ingest::detect::detect_language;pub use ingest::detect::Language;pub use ingest::Parser;pub use ingest::SymbolFact;pub use ingest::SymbolKind;pub use output::command::ReferenceMatch;pub use output::command::Span;pub use output::command::SymbolMatch;pub use output::generate_execution_id;pub use output::output_json;pub use output::JsonResponse;pub use output::OutputFormat;pub use references::CallFact;pub use references::ReferenceFact;pub use validation::canonicalize_path;pub use validation::normalize_path;pub use validation::validate_path_within_root;pub use validation::PathValidationError;pub use verify::verify_graph;pub use verify::VerifyReport;pub use watcher::EventType;pub use watcher::FileEvent;pub use watcher::FileSystemWatcher;pub use watcher::WatcherBatch;pub use watcher::WatcherConfig;
Modules§
- common
- Common utility functions shared across command modules
- diagnostics
- Structured diagnostics for Magellan watch/index operations.
- error_
codes - Magellan-specific error codes
- generation
- Code generation and storage module.
- graph
- Graph persistence layer using sqlitegraph
- indexer
- Indexer coordinator for Magellan
- ingest
- migrate_
cmd - Database migration command implementation
- output
- JSON output module for CLI commands
- references
- Reference and call extraction from Rust source code
- validation
- Path validation and canonicalization utilities.
- verify
- Database verification module
- watcher
- Filesystem watcher with debounced batch events.
Enums§
- Fail
Point - Test operations that can be verified during delete.
Functions§
- delete_
file_ facts_ with_ injection - Delete ALL facts derived from a file path with verification points.