OptionalbuildStatus of the most recent backfill/rebuild job, when one exists.
OptionalbuildPer-build LLM usage of the KB's most recent rebuildGraph runs, newest first, bounded to the last
50 builds. Unlike lastRebuildUsage no build erases another's record, so back-to-back builds
are all accounted for.
OptionalcombinedLifetime LLM usage of the combined contextual-blurb + graph-extraction call (run automatically for
ragType:'contextual' graph-enabled KBs), when any was recorded. Covers BOTH the contextual blurb
and graph extraction in one call, so it is not directly comparable to the graph-only
ingestUsage.
Number of communities detected (Phase 3), 0 when none.
OptionalconceptTrue when graph-scoped search (graphFilter.underConcept) runs on the index-native denormalized
conceptIds pre-filter: the backend's search indexes serve the field AND the chunk copies are in
sync with the doc nodes. False while either half is not ready (index still building, or a rebuild
is in flight — a rebuild drops the sync gate for its duration); scoped search then uses the
capped contextId-closure fallback. Absent when GraphRAG is disabled.
Contexts stamped as graph-indexed.
Total contexts in the KB.
OptionaldocDocument nodes in the KB's graph (Layered KB Graph L1) — one per graph-indexed context.
OptionaldocsDocument nodes carrying a non-empty LLM description (failed descriptions retry on rebuild).
Whether GraphRAG is enabled on the KB.
Number of live entities in the KB's graph partition (quarantined ones excluded).
OptionalfacetsThe KB's facet trees (Layered KB Graph L3, deterministic) — empty until a rebuild builds them.
OptionalingestLifetime LLM usage of incremental graph ingestion (per-upsert extraction), when any was recorded.
OptionallastLLM usage of the most recent COMPLETED rebuildGraph run (including its re-extraction), when one
ran. A build in flight leaves it on the previous build until it completes — read
buildUsageHistory for the in-flight run.
OptionallastWhen a structural/full rebuild last completed successfully (epoch millis), when one ever has.
OptionalnextWhen the debounced auto-build sweep will pick the KB up (epoch millis), present while an auto-build is pending. Recomputed per poll — it moves forward while ingest activity continues.
OptionalquarantinedEntities hidden by a dead-weight quarantine run; absent when the KB's graph store cannot quarantine.
Number of outgoing relationships (mirrors excluded).
OptionalresolutionThe incremental entity-resolution sweep's latest readings, present once a sweep has sampled the KB.
OptionalstaleDocuments added since the last topic build (the structureStale numerator).
OptionalstructureTrue when documents were graph-indexed after the last topic build — themes may lag content until
the next rebuildGraph. Only meaningful once topics exist (absent before the first rebuild).
OptionaltopicLeaf-level inter-topic edges (relationship counts crossing topic boundaries), present once a graph build has computed them. Roll up to coarser tiers by mapping each endpoint to its ancestor.
OptionaltopicsThe KB's topic (theme) hierarchy — present once a graph build has clustered topics. Ids churn on rebuild (KnowledgeBaseGraphTopic.id); resolve them per session, never persist them.
Response structure for a knowledge base's GraphRAG build/readiness status. Drives the ai-eval readiness poll (index until
contextsIndexed === contextsTotalandbuildJobis not in-progress).