$schema: http://json-schema.org/draft-07/schema#
$id: https://github.com/avadisabelle/coaia-narrative/schema/data-model/knowledge-graph.json
title: COAIA Knowledge Graph
description: >-
  Complete knowledge graph structure containing entities and relations. This is the in-memory
  representation of the graph.
type: object
required:
  - entities
  - relations
properties:
  entities:
    type: array
    description: Array of all entities in the knowledge graph
    items:
      $ref: entity.json
  relations:
    type: array
    description: Array of all relations connecting entities in the graph
    items:
      $ref: relation.json
examples:
  - entities:
      - name: chart_123
        entityType: structural_tension_chart
        observations:
          - Python learning journey
        metadata:
          dueDate: '2026-03-15T00:00:00Z'
          chartId: chart_123
          level: 0
          createdAt: '2026-02-13T07:00:00Z'
      - name: chart_123_desired_outcome
        entityType: desired_outcome
        observations:
          - Build and deploy a Python web application
        metadata:
          chartId: chart_123
      - name: chart_123_current_reality
        entityType: current_reality
        observations:
          - Know basic Python syntax
          - Never worked with web frameworks
        metadata:
          chartId: chart_123
      - name: chart_123_action_1
        entityType: action_step
        observations:
          - Complete Django tutorial
        metadata:
          chartId: chart_123
          dueDate: '2026-02-20T00:00:00Z'
          completionStatus: false
    relations:
      - from: chart_123_current_reality
        to: chart_123_desired_outcome
        relationType: creates_tension_with
      - from: chart_123_action_1
        to: chart_123_desired_outcome
        relationType: advances_toward