Skip to content

Architecture

mish is split at a versioned process boundary.

ComponentLanguageResponsibility
mish-coreRustScanner, index (snapshots + columns), query engine, Docker collector
mish-cliRustmish binary and the UDS JSON-RPC daemon
mish-ipcRustProtocol types — the single source of truth
apps/serverTypeScript (Bun + Hono)REST/SSE, orchestration, static serving
apps/webTypeScript (Svelte 5 + Vite)Treemap and all visualizations
packages/api-typesTypeScriptShared wire types mirroring mish-ipc

A snapshot is a directory:

snapshots/<id>/
manifest.json # metadata, stats, extension table, errors
nodes.bin # fixed-size node records; id = index (pre-order)
names.bin # concatenated names
subtree.bin # u32 subtree size per node

Nodes are emitted in pre-order, so every subtree is a contiguous id range. subtree_size is computed on the way back up during the scan. The format is versioned; any layout change bumps FORMAT_VERSION.

scan → pre-order nodes → snapshot → query engine (mmap) → JSON-RPC → REST/SSE → browser

The server supervises the core daemon over a Unix socket and relays progress to browsers via SSE.