trustgraph/specs/api/components/schemas/common/Triple.yaml

type: object
description: |
  RDF triple representing a subject-predicate-object statement in the knowledge graph,
  optionally scoped to a named graph.

  Example: (Person1) -[has name]-> ("John Doe")
properties:
  s:
    $ref: './RdfValue.yaml'
    description: Subject - the entity the statement is about
  p:
    $ref: './RdfValue.yaml'
    description: Predicate - the property or relationship
  o:
    $ref: './RdfValue.yaml'
    description: Object - the value or target entity
  g:
    type: string
    description: |
      Named graph URI (optional). When absent, the triple is in the default graph.
      Well-known graphs:
      - (empty/absent): Core knowledge facts
      - urn:graph:source: Extraction provenance
      - urn:graph:retrieval: Query-time explainability
    example: urn:graph:source
required:
  - s
  - p
  - o
example:
  s:
    t: i
    i: http://example.com/Person1
  p:
    t: i
    i: http://schema.org/name
  o:
    t: l
    v: John Doe