terraphim_grep 1.20.5

Intelligent hybrid grep with RLM fallback and KG curation
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
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

[package]
name = "terraphim_grep"
version.workspace = true
edition.workspace = true
authors = ["Terraphim AI Team <team@terraphim.ai>"]
description = "Intelligent hybrid grep with RLM fallback and KG curation"
documentation = "https://terraphim.ai"
homepage = "https://terraphim.ai"
readme = "README.md"
license = "MIT"
repository = "https://github.com/terraphim/terraphim-ai"
keywords = ["grep", "search", "knowledge-graph", "rlm"]
categories = ["development-tools"]

[dependencies]
tokio.workspace = true
serde.workspace = true
serde_json.workspace = true
thiserror.workspace = true
anyhow.workspace = true
log.workspace = true

# Path deps include `version` so `cargo publish` accepts the manifest. The script
# `scripts/publish-crates.sh` rewrites these versions at publish time to align with
# the release version; the field's *presence* is what the publisher requires. The
# value here must match each crate's currently-declared local version so path
# resolution succeeds for local builds.
terraphim_types = { version = "1.15.0" }
terraphim_rolegraph = { version = "1.15.0" }
terraphim_automata = { version = "1.19.2" }
terraphim_service = { version = "1.20.4", optional = true }
terraphim_config = { version = "1.15.0" }

fff-search = { version = "0.8.4", optional = true }

async-trait.workspace = true
parking_lot = "0.12"
tracing = { workspace = true }
tracing-subscriber = { version = "0.3", features = ["env-filter"] }

clap = { version = "4", features = ["derive"] }

[features]
default = ["llm"]
llm = ["dep:terraphim_service"]
code-search = ["dep:fff-search"]
# Enable OpenRouter provider support (required for live OpenRouter tests against free models)
openrouter = ["llm", "terraphim_service/openrouter"]

[dev-dependencies]
tokio-test = "0.4"
tempfile.workspace = true
criterion = { version = "0.8", features = ["async_tokio"] }
terraphim_router = { version = "1.8.0" }

[[bin]]
name = "terraphim-grep"
path = "src/main.rs"

[[bench]]
name = "hybrid_search"
harness = false
required-features = ["code-search"]

# Debian package metadata; consumed by `cargo deb -p terraphim_grep`. Mirrors the
# pattern in `crates/terraphim_agent/Cargo.toml` for consistency across binaries.
[package.metadata.deb]
maintainer = "Terraphim Contributors <team@terraphim.ai>"
copyright = "2026, Terraphim Contributors"
license-file = ["../../LICENSE-MIT", "4"]
extended-description = """
Terraphim Grep -- intelligent hybrid grep with knowledge-graph boosting and
LLM fallback. Runs fff-search code retrieval and a knowledge-graph concept
lookup in parallel, applies KG-aware boosting so chunks matching your thesaurus
rank above generic matches, and falls back to an LLM only when local sufficiency
is below threshold. Configured via role JSON; works in search-only mode without
any API key."""
depends = "$auto"
section = "utility"
priority = "optional"
assets = [
    ["target/release/terraphim-grep", "usr/bin/", "755"],
    ["../../README.md", "usr/share/doc/terraphim-grep/README", "644"],
    ["RELEASE_NOTES_v1.20.0.md", "usr/share/doc/terraphim-grep/RELEASE_NOTES.md", "644"],
]