GraphRAG queries not returning results

Component: zil-graph-worker Category: graphrag Version: 1 Author: claude Last used: 6/3/2026, 10:59:53 AM
Prerequisites

zil-graph-worker running. Neo4j-kg has at least some Concept nodes (MATCH (c:Concept) RETURN count(c) > 0).

Expected Outcome

curl /api/zil/graphrag-status shows query_count incrementing on each zil.query.request event.

Steps

1. curl -s http://localhost:3555/api/zil/graphrag-status — check query_count.

2. docker logs --tail 50 zil-graph-worker | grep query-planner

3. If "LLM decomposition failed": check LLM gateway — docker logs --tail 20 llm-queue-watchdog

4. If concept_count=0 in logs: zil.query.plan returned no concepts — check prompt_templates row for zil.query.plan.

5. If Neo4j has no Concept nodes yet: KG may be empty — trigger a research pipeline run first.

6. Verify zil.query.request handler registered: SELECT * FROM system_event_handlers WHERE event_type='zil.query.request';