Skip to content

docs(readme): semantic_query is a search_graph parameter; team artifact is opt-in (#1297) - #2403

Merged
DeusData merged 1 commit into
mainfrom
fix/issue-1297
Sep 30, 2026
Merged

DeusData merged 1 commit into
mainfrom
fix/issue-1297

Conversation

@DeusData

Copy link
Copy Markdown
Owner

Two README statements still disagreed with the server:

  • semantic_query is a search_graph parameter, not a tool. The Search section now says so.
  • The team-shared artifact is opt-in. persistence defaults to false. index_repository writes .codebase-memory/graph.db.zst (Best tier) only with persistence: true. Without it, an index only refreshes an artifact that already exists (Fast tier, export_after_publish in src/pipeline/pipeline.c). The paragraph and both tier bullets now match.

The report's other points were already fixed on main (checked against the source):

  • the README's 17 tools match the registered TOOLS[];
  • trace_call_path is a real alias of trace_path;
  • check_index_coverage is in the tools table;
  • the inbound NOT EXISTS { (f)<-[:CALLS]-() } example has been supported since 08b62f0 (covered by cypher_exists_no_callers).

Docs only; no code change. Note: draft PR #1245 rewrites the same artifact paragraph, so whichever lands second needs a rebase.

Huge thanks to @melihemreguler for checking the README against the running server, and to @mindplay-dk for the follow-up catches. Thanks also to the author of the earlier attempt in #1315.

Fixes #1297

…ct is opt-in (#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>
@DeusData
DeusData merged commit 39da5de into main Sep 30, 2026
35 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

README: semantic_query is not a tool, the tool count is 14 not 15, and the team artifact is not written by default

1 participant