software-brain-engine

Architecture

Software Brain Engine is a modular Rust workspace. Each crate has one responsibility and communicates through stable data types from sbe-common.

V1 Data Flow

scanner -> parser -> storage
                 \-> symbols -> graph -> impact -> query -> cli

indexer orchestrates scanning, parsing, and persistence. The CLI calls the indexer for writes and the query layer for reads.

Storage Boundary

The .sbe/ directory is private to sbe-storage. Other crates pass typed values into storage and receive typed snapshots back. V1 uses JSON for inspectability and versioned metadata for future migrations.

TypeScript Boundary

V1 uses Tree-sitter syntax parsing. It extracts declarations, imports, exports, and best-effort references. It does not perform type-aware name resolution, overload resolution, or project-wide TypeScript compiler analysis.

Phase Notes

• Phase 0: workspace, docs, CI, and shared types.
• Phase 1: scanner and storage.
• Phase 2: parser and symbol registry.
• Phase 3: graph, impact, and query.
• Phase 4: CLI and end-to-end indexing.

This site is open source. Improve this page.