ryu-search 0.1.9

Conversation search primitive for Ryu: a sqlite-vec (`vec0`) semantic KNN index plus a contentless FTS5 lexical index over past chat messages, storing vectors/inverted-index + metadata only (never message text — the caller re-reads and decrypts snippets from `conversations.db`). An extracted Core capability crate; in-process by default and consumed as a NON-optional path dependency (the ConversationStore reaches it unconditionally). The embedder is injected via the narrow `SearchEmbedder` trait, so the crate has ZERO dependency on apps/core — the registry-driven embedder choice and the default db paths stay Core-side (`apps/core/src/search_host.rs`).
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33

# <img src="https://raw.githubusercontent.com/amajorai/ryu/main/.github/logo.png" width="50" align="middle" alt="" />&nbsp; ryu-search

> Conversation search primitive for Ryu. Part of [Ryu](../../README.md).

[![License](https://shieldcn.dev/badge/License-Apache--2.0-73DC8C.svg?logo=apache&logoColor=white)](./LICENSE)
[![Stack](https://shieldcn.dev/badge/Rust-Crate-dea584.svg?logo=rust&logoColor=white)](../../README.md)

`ryu-search` indexes past chat messages for recall. It pairs a [sqlite-vec](https://github.com/asg017/sqlite-vec) `vec0` semantic KNN index (`MessageIndex`) with a contentless FTS5 lexical index (`MessageFtsIndex`). Both stores hold **vectors / inverted-index + metadata only — never message text**; the caller re-reads and decrypts each hit's snippet from `conversations.db`.

## Role in the decomposition

An extracted Core capability crate compiled in-process as a **non-optional path dependency** — the `ConversationStore` reaches it unconditionally. **ZERO dependency on `apps/core`** (it never sees `ModelRegistry`).

**Swap-seam:** the narrow `SearchEmbedder` trait (`dims` / `model_id` / `is_local` / `embed`). Core wraps its registry-configured `retrieval::Embedder` behind this trait object at construction, so *which* embedder (local hashing vs. remote `/v1/embeddings`) is a per-consumer RAG choice that stays out of the crate. The default db paths (`~/.ryu/message-embeddings.db`, `~/.ryu/message-fts.db`) and the embedder choice live in the Core host shim `apps/core/src/search_host.rs`, mirroring the `ryu-storage` `open(path)` precedent.

## What it provides

- **`MessageIndex`** (`message_index.rs`) — semantic vec0 KNN index → `MessageHit`.
- **`MessageFtsIndex`** (`message_fts.rs`) — contentless FTS5 lexical index → `MessageFtsHit`.
- **`SearchEmbedder`** — the injection seam, plus a bundled `LocalHashingEmbedder` default.

Placement (CLAUDE.md §1): searching Core's own conversation history is *what runs*, so Core.

## Build

```bash
cargo build -p ryu-search
cargo test  -p ryu-search
```

## License

Apache-2.0; see [LICENSE](./LICENSE). © 2026 A Major Pte. Ltd.