@@ -15,7 +15,7 @@ Note put template ID here before making public `RUSTY_RED_GRAPH_DATABASE_TEMPLA
1515## What Rusty Red does
1616
1717- ** Graph storage** with AOF/snapshot persistence, per-tenant isolation, single-writer serializable commits, and committed read snapshots
18- - ** Stable, versioned on-disk format** with ` thg -upgrade-format` migrations between releases (no export/re-import on upgrade)
18+ - ** Stable, versioned on-disk format** with ` rustyred -upgrade-format` migrations between releases (no export/re-import on upgrade)
1919- ** HNSW vector search** on node properties via ` instant-distance ` , with hybrid scoring that blends vector similarity and graph proximity
2020- ** Inverted-index BM25 full-text search** with automatic indexing on node upserts
2121- ** H3 spatial index** on node lat/lon properties with radius and bounding-box queries
@@ -45,11 +45,11 @@ These are on the roadmap, in roughly this priority order:
4545
4646| Crate | Purpose |
4747| -------| ---------|
48- | ` thg -core` | Graph store engine, command executor, HNSW vector index, epistemic edges |
49- | ` thg -mcp` | MCP agent port: tool dispatch, resource reads, prompt surface |
50- | ` thg-product -server` | HTTP server, query surface, graph cache, auth, OpenAPI |
51- | ` thg -server` | Standalone compatibility command server |
52- | ` thg -resp-server` | RESP protocol shim (limited, not a Redis replacement) |
48+ | ` rustyred -core` | Graph store engine, command executor, HNSW vector index, epistemic edges |
49+ | ` rustyred -mcp` | MCP agent port: tool dispatch, resource reads, prompt surface |
50+ | ` rustyred -server` | HTTP server, query surface, graph cache, auth, OpenAPI |
51+ | ` rustyred-compat -server` | Standalone compatibility command server |
52+ | ` rustyred -resp-server` | RESP protocol shim (limited, not a Redis replacement) |
5353| root crate | PyO3 compatibility bindings for native graph/search helpers |
5454
5555## Build (local development)
@@ -78,7 +78,7 @@ second Rusty Red service.
7878Run the product server locally:
7979
8080``` bash
81- RUSTY_RED_MODE=embedded RUSTY_RED_DATA_DIR=data/rusty-red cargo run -p thg-product -server
81+ RUSTY_RED_MODE=embedded RUSTY_RED_DATA_DIR=data/rusty-red cargo run -p rustyred -server
8282```
8383
8484Strict local durability mode is explicit:
@@ -90,20 +90,20 @@ RUSTY_RED_TXN_ISOLATION=serializable \
9090RUSTY_RED_STRICT_ACID=true \
9191RUSTY_RED_DURABILITY=aof_always \
9292RUSTY_RED_DATA_DIR=data/rusty-red \
93- cargo run -p thg-product -server
93+ cargo run -p rustyred -server
9494```
9595
9696Core routes are documented by ` GET /openapi.json ` . The OpenAPI document is
9797generated from the product server crate version and currently covers every
98- canonical route in ` crates/thg-product -server/src/router.rs ` .
98+ canonical route in ` crates/rustyred -server/src/router.rs ` .
9999
100100Canonical routes:
101101
102102``` text
103103GET /health
104104GET /ready
105105GET /openapi.json
106- GET /.well-known/mcp/thg .json
106+ GET /.well-known/mcp/rustyred .json
107107GET /.well-known/agent.json
108108POST /mcp
109109GET /metrics
@@ -163,16 +163,16 @@ The `/mcp` endpoint exposes these tools (via JSON-RPC `tools/list` and `tools/ca
163163
164164| Tool | Description |
165165| ------| -------------|
166- | ` thg .graph.query` / ` thg .graph.explain` / ` thg .graph.neighbors` | Bounded native graph reads and plan inspection |
167- | ` thg .graph.schema` / ` thg .graph.index_status` | Graph schema and index-health reads |
168- | ` thg .algorithm.ppr` (alias: ` thg .algo.ppr` ) / ` thg .algorithm.components` (` thg .algo.components` ) / ` thg .algorithm.pagerank` (` thg .algo.pagerank` ) / ` thg .algorithm.communities` (` thg .algo.communities` ) | Graph algorithms: PPR, connected components, PageRank, label-propagation communities |
169- | ` thg .fulltext.search` (alias: ` thg .graph.fulltext.search` ) / ` thg .spatial.radius` (` thg .graph.spatial.radius` ) / ` thg .spatial.bbox` (` thg .graph.spatial.bbox` ) | Full-text and spatial read surfaces |
170- | ` thg .vector.search` | HNSW nearest-neighbor search on vector properties |
171- | ` thg .vector.hybrid` | Hybrid search blending vector similarity with graph proximity |
172- | ` thg .vector.designate` | Register a vector property for HNSW indexing (write) |
173- | ` thg .epistemic.neighbors` | Confidence-weighted epistemic traversal by edge type |
174- | ` thg .fulltext.designate` (alias: ` thg .graph.fulltext.designate` ) / ` thg .spatial.designate` (` thg .graph.spatial.designate` ) / ` thg .bulk.nodes` (` thg .graph.bulk.nodes` ) / ` thg .bulk.edges` (` thg .graph.bulk.edges` ) | Write-mode-only designation and bulk ingest tools |
175- | ` thg .admin.verify` | Admin-only index-integrity verification; rebuild remains on the HTTP graph route |
166+ | ` rustyred .graph.query` / ` rustyred .graph.explain` / ` rustyred .graph.neighbors` | Bounded native graph reads and plan inspection |
167+ | ` rustyred .graph.schema` / ` rustyred .graph.index_status` | Graph schema and index-health reads |
168+ | ` rustyred .algorithm.ppr` (alias: ` rustyred .algo.ppr` ) / ` rustyred .algorithm.components` (` rustyred .algo.components` ) / ` rustyred .algorithm.pagerank` (` rustyred .algo.pagerank` ) / ` rustyred .algorithm.communities` (` rustyred .algo.communities` ) | Graph algorithms: PPR, connected components, PageRank, label-propagation communities |
169+ | ` rustyred .fulltext.search` (alias: ` rustyred .graph.fulltext.search` ) / ` rustyred .spatial.radius` (` rustyred .graph.spatial.radius` ) / ` rustyred .spatial.bbox` (` rustyred .graph.spatial.bbox` ) | Full-text and spatial read surfaces |
170+ | ` rustyred .vector.search` | HNSW nearest-neighbor search on vector properties |
171+ | ` rustyred .vector.hybrid` | Hybrid search blending vector similarity with graph proximity |
172+ | ` rustyred .vector.designate` | Register a vector property for HNSW indexing (write) |
173+ | ` rustyred .epistemic.neighbors` | Confidence-weighted epistemic traversal by edge type |
174+ | ` rustyred .fulltext.designate` (alias: ` rustyred .graph.fulltext.designate` ) / ` rustyred .spatial.designate` (` rustyred .graph.spatial.designate` ) / ` rustyred .bulk.nodes` (` rustyred .graph.bulk.nodes` ) / ` rustyred .bulk.edges` (` rustyred .graph.bulk.edges` ) | Write-mode-only designation and bulk ingest tools |
175+ | ` rustyred .admin.verify` | Admin-only index-integrity verification; rebuild remains on the HTTP graph route |
176176
177177The public query surface is now split cleanly:
178178
@@ -232,10 +232,10 @@ RUSTY_RED_MCP_ALLOW_ADMIN=false
232232## Compatibility command server
233233
234234The product server is the recommended deployment target. A smaller compatibility
235- HTTP command server also lives in ` crates/thg -server ` :
235+ HTTP command server also lives in ` crates/rustyred-compat -server ` :
236236
237237``` bash
238- cargo run -p thg -server -- --host 127.0.0.1 --port 7379
238+ cargo run -p rustyred-compat -server -- --host 127.0.0.1 --port 7379
239239```
240240
241241Endpoints:
0 commit comments