routing_cache_dump

Overview ¶

routing_cache_dump inspects the Trace agent's routing embedding cache.

The routing cache persists tool embedding vectors (BM25 + embedding hybrid router, GR-61) in BadgerDB between service restarts. This tool opens the cache read-only and prints a human-readable summary: keys, corpus hashes, TTL remaining, per-tool vector dimensions, and a short sample of each vector.

Usage:

routing_cache_dump [--path /path/to/routing/cache]

If --path is not given, reads ROUTING_CACHE_DIR from the environment, falling back to ~/.aleutian/cache/routing/.

Exit codes:

0 — success (including "empty cache" which prints a message and exits 0)
1 — error opening or reading the database