trustgraph/trustgraph-base/trustgraph
Cyber MacGeddon c6ef354290 Deliver explainability triples inline in retrieval response stream
Provenance triples are now included directly in explain messages from
GraphRAG, DocumentRAG, and Agent services, eliminating the need for
follow-up knowledge graph queries to retrieve explainability details.

Each explain message in the response stream now carries:
- explain_id: root URI for this provenance step (unchanged)
- explain_graph: named graph where triples are stored (unchanged)
- explain_triples: the actual provenance triples for this step (new)

Changes across the stack:
- Schema: added explain_triples field to GraphRagResponse,
  DocumentRagResponse, and AgentResponse
- Services: all explain message call sites pass triples through
  (graph_rag, document_rag, agent react, agent orchestrator)
- Translators: encode explain_triples via TripleTranslator for
  gateway wire format
- Python SDK: ProvenanceEvent now includes parsed ExplainEntity
  and raw triples; expanded event_type detection
- CLI: invoke_graph_rag, invoke_agent, invoke_document_rag use
  inline entity when available, fall back to graph query
- Tech specs updated
2026-04-07 11:40:54 +01:00
..
api Deliver explainability triples inline in retrieval response stream 2026-04-07 11:40:54 +01:00
base Config push notify pattern: replace stateful pub/sub with signal+ fetch (#760) 2026-04-06 16:57:27 +01:00
clients RabbitMQ pub/sub backend with topic exchange architecture (#752) 2026-04-02 12:47:16 +01:00
knowledge Subgraph provenance (#694) 2026-03-13 11:37:59 +00:00
messaging Deliver explainability triples inline in retrieval response stream 2026-04-07 11:40:54 +01:00
objects Feature/pkgsplit (#83) 2024-09-30 19:36:09 +01:00
provenance Wire message_id on all answer chunks, fix DAG structure (#748) 2026-04-01 13:27:41 +01:00
schema Deliver explainability triples inline in retrieval response stream 2026-04-07 11:40:54 +01:00
exceptions.py Librarian (#304) 2025-02-11 16:01:03 +00:00
log_level.py Pub/sub abstraction: decouple from Pulsar (#751) 2026-04-01 20:16:53 +01:00
rdf.py Remove schema:subjectOf edges from KG extraction (#695) 2026-03-13 12:11:21 +00:00