zil-graph-worker

Section: section5.5-background-services Subsystem: telegram-services_v2 Port: 3555 Deploy type: image-copy Health: http://zil-graph-worker:3555/health Compose: phase2-section5.5-background-services/docker-compose.yml

Description

Zoey Intelligence Layer — receives research.source.ingested events, runs LLM entity extraction, writes Concept/Source/Article nodes to neo4j-kg. Phase 1 of a multi-phase GraphRAG engine.

Role

Consumes research.source.ingested events via HTTP (dispatched by system-event-listener). Queries Qdrant user_documents for article chunks, runs callLLMFromTemplate(zil.extract), writes to neo4j-kg. Logs to zil_extraction_log.

Restart Procedure

cd /mnt/blaze/prysm-infra/telegram-services_v2/phase2-section5.5-background-services && docker compose build zil-graph-worker && docker compose up -d zil-graph-worker

Dependencies

hard rabbitmq (prysm-store)

hard mariadb (prysm-store)

hard qdrant (prysm-store)

hard redis (prysm-store)

hard redis (prysm-store)

Runbooks

Active learning flooding research requests graphrag

Activity detector not re-summarizing fast-growing communities summarization

Communities not being summarized after GDS pipeline runs summarization

Fix APOC jaroWinklerDistance threshold (distance ≠ similarity) data-quality

Fix APOC jaroWinklerDistance threshold (distance ≠ similarity) data-quality

Fix Cypher NOT IN after function call (type(r) NOT IN [...]) bug

Fix ERR_DLOPEN_FAILED for onnxruntime-node (Alpine → Debian) deployment

Fix ERR_DLOPEN_FAILED for onnxruntime-node (Alpine → Debian) deployment

Fix silent MATCH failure in apoc.merge.relationship (count check) bug

GDS pipeline not running after research.topic.complete gds_pipeline

GraphRAG queries not returning results graphrag

Re-queuing failed ZIL extractions (recover-failed) zil_extraction

ZIL HTTP query endpoint timing out or returning 500 zil_query

zil_entity_embeddings empty or not updating after GDS run gds_pipeline

Behavioral Assertions

None

Diagnostic Tools

Confirm zil-graph-worker base image is Debian (not Alpine) bash —

Confirm zil-graph-worker base image is Debian (not Alpine) bash —

Run zil-graph-worker entity resolution test suite bash —

Run zil-graph-worker entity resolution test suite bash —

Verify Cypher NOT IN syntax in neo4j-kg bash —

Recent Issues

No issues on record