BearWisdom — Architecture

Parser / Input

Core Engine

Consumers

Cross-cutting

Data flow

Layer 1 — Parser

31 Language Parsers

tree-sitter

Dedicated Extractors — 7 languages

C# TypeScript TSX Rust Python Go Java JavaScript

Generic Grammar Extraction — 24 languages

Ruby PHP C++ C Kotlin Swift HTML CSS JSON Bash YAML Lua R Dart Scala Haskell Elixir Markdown XML Dockerfile SQL + more

Layer 2 — Core Engine (bearwisdom lib)

bearwisdom

Rust library crate — statically linked into all consumers

🗂

Indexer

Full, incremental, and post-index embedding pipelines

full_index incremental chunker

🗃

Graph DB

SQLite · 16 tables · FTS5 · sqlite-vec vector extension

files symbols edges chunks concepts

🔍

Search Engine

6 modes: FTS5 · fuzzy (nucleo) · grep · trigram · hybrid RRF · vector

hybrid RRF CodeRankEmbed ONNX

🔭

Query Layer

Architecture · blast radius · call hierarchy · references · concepts

blast_radius call_hierarchy subgraph

🔌

Connectors

13 framework connectors — HTTP, EF Core, gRPC, DI, React, Tauri, GraphQL, MQ

13 frameworks cross-boundary

🌉

Bridge

GraphBridge + BackgroundEnricher — resolves edges via live LSP data

GraphBridge BackgroundEnricher

🔗

LSP Manager

8 language servers · registry-driven · TypeScript · C# · Rust · Python · Go

8 servers registry

🚶 Walker — .gitignore-aware file tree traversal feeds all source paths into the Indexer

Cross-cutting

🧊

sqlite-vec

Statically linked into all binaries — vector storage & ANN search

⚡

ONNX Runtime

Dynamically loaded for CodeRankEmbed inference — graceful degradation if absent

Layer 3 — Consumers (binary crates)

⬡

Command-line interface

25 JSON commands

.bw/ project DB

🤖

bw-mcp

MCP Server

8 MCP tools

stdio JSON-RPC

🌐

bw-web

Web Server + React UI

23 API endpoints

D3 force graph

📊

bw-bench

Benchmark utility

BW vs native tools

latency · quality

Layer 4 — Frontend (web/)

3 Zustand stores

6 Custom hooks

13 Component groups

54 Tests (Vitest)

🗄 Zustand Stores

useGraphStore — nodes, edges, layout

useSelectionStore — active node/edge

useEmbedStore — vector search state

🪝 Custom Hooks

useGraphData — fetch + normalize

useSymbolDetail — symbol panel

useD3Simulation — force layout

useZoomControls — pan/zoom

useResizePanel — split pane

useEmbedding — semantic search

📦 D3 Force Graph

forceLink · forceManyBody

forceCenter · forceCollide

Drag · zoom · pan

Node kind color mapping

SVG canvas + labels

Click any consumer to highlight which core modules it uses · Hover any module for details · Click again to deselect

System Architecture