You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Commit 95eaf01
Browse filesBrowse the repository at this point in the historyBrowse files
docs(readme): semantic_query is a search_graph parameter; team artifact is opt-in (DeusData#1297)
The Search section introduced `semantic_query` as if it were an MCP tool.
It is a parameter of search_graph (the tool's input schema in src/mcp/mcp.c).
The Team-Shared Graph Artifact section said the artifact is written
whenever you index. `persistence` defaults to false. The Best tier is
written only by index_repository with persistence: true. Without it, an
index only refreshes an artifact that already exists (Fast tier; see
export_after_publish in src/pipeline/pipeline.c), and that applies to
any index, not just the watcher's.
The issue's other points are already correct on main:
- the 17 registered tools match the README;
- trace_call_path is a real alias of trace_path;
- check_index_coverage is documented;
- NOT EXISTS { (f)<-[:CALLS]-() } is supported since 08b62f0.
Signed-off-by: Martin Vogel <martin.vogel.tech@gmail.com>
Copy file name to clipboardExpand all lines: README.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -199,7 +199,7 @@ The install script placed beside the binary is **reported, not deleted** — uni
199
199
-**Cypher-like queries**: `MATCH (f:Function)-[:CALLS]->(g) WHERE f.name = 'main' RETURN g.name`
200
200
201
201
### Search
202
-
-**Semantic search** (`semantic_query`): vector search across the entire graph, powered by bundled Nomic `nomic-embed-code` embeddings (40K tokens, 768d int8) compiled into the binary — no API key, no Ollama, no Docker. 11-signal combined scoring (TF-IDF, RRI, API/Type/Decorator signatures, AST profiles, data flow, Halstead-lite, MinHash, module proximity, graph diffusion).
202
+
-**Semantic search** (the `semantic_query` parameter of `search_graph`, not a separate tool): vector search across the entire graph, powered by bundled Nomic `nomic-embed-code` embeddings (40K tokens, 768d int8) compiled into the binary — no API key, no Ollama, no Docker. 11-signal combined scoring (TF-IDF, RRI, API/Type/Decorator signatures, AST profiles, data flow, Halstead-lite, MinHash, module proximity, graph diffusion).
203
203
-**BM25 full-text search** via SQLite FTS5 with `cbm_camel_split` tokenizer (camelCase / snake_case aware)
-**Code search** (`search_code`): graph-augmented grep over indexed files only
@@ -243,12 +243,12 @@ The install script placed beside the binary is **reported, not deleted** — uni
243
243
244
244
Commit a single compressed file to your repo and your teammates skip the reindex.
245
245
246
-
`.codebase-memory/graph.db.zst` is a zstd-compressed snapshot of the knowledge graph that lives next to your source. When you index, the artifact is written or refreshed; when a teammate clones the repo and runs `codebase-memory-mcp` for the first time, the artifact is decompressed and incremental indexing fills in their local diff.
246
+
`.codebase-memory/graph.db.zst` is a zstd-compressed snapshot of the knowledge graph that lives next to your source. The artifact is opt-in: `index_repository` writes it only with `persistence: true` (the default is `false`), and once it exists later indexes refresh it; when a teammate clones the repo and runs `codebase-memory-mcp` for the first time, the artifact is decompressed and incremental indexing fills in their local diff.
247
247
248
248
-**Format**: SQLite database, indexes stripped, `VACUUM INTO` compacted, then zstd 1.5.7 compressed (8–13:1 ratio typical)
249
249
-**Two tiers**:
250
-
-**Best** (`zstd -9` + index strip + `VACUUM INTO`) — written on explicit `index_repository`
251
-
-**Fast** (`zstd -3`) — written by the watcher for low-latency incremental updates
250
+
-**Best** (`zstd -9` + index strip + `VACUUM INTO`) — written by `index_repository` with `persistence: true`
251
+
-**Fast** (`zstd -3`) — refreshes an existing artifact on every other index (including the watcher's low-latency incremental updates)
252
252
-**Bootstrap**: when no local DB exists but the artifact is present, `index_repository` imports the artifact first, then runs incremental indexing — avoiding the full reindex cost
253
253
-**No merge pain**: a `.codebase-memory/.gitattributes` line with `merge=ours` is auto-created on first export, so concurrent edits don't produce conflicts on the binary artifact
254
254
-**Commit it deliberately**: the artifact is rewritten on every index, including the watcher's Fast tier, and git stores each rewrite as a full new blob. Committing every refresh is what turns a 20 MB file into gigabytes of history — one team reached ~6 GB across ~350 commits of this single path. Pick a cadence (a release, a milestone, a nightly job) rather than committing every save.
0 commit comments