Knowledge Graph

The knowledge graph (state/graph.json) is the structured representation of all extracted knowledge.

Graph Structure

{
  "generatedAt": "2025-01-15T10:30:00Z",
  "nodes": [...],
  "edges": [...],
  "sources": [...],
  "pages": [...]
}

Nodes

Each node represents a source, concept, or entity:

  • **type** — source, concept, or entity
  • **freshness** — fresh or stale
  • confidence — Extraction confidence score

Edges

Edges connect nodes with relationship metadata:

  • **claimStatus** — extracted (from source), inferred (derived), conflicted (contradictory), stale (outdated)
  • **polarity** — positive, negative, or neutral
  • sourceId — Provenance back to the originating source

Provenance

Every edge in the graph traces back to a specific source and claim. This enables you to verify any piece of knowledge by following the provenance chain back to the raw input.