GCC Build OSv0
/api

EdgeRecordedevent type

A graph edge was materialised. Emitted via @gcc/graph addEdge for non-RACI edges (under_function, depends_on, evidence_for, references, cites, supersedes, invalidates, sequenced_under, provides_capability, enables, annotated_by, mitigates, targets, defines, installed_into, measured_along, affiliated_with, moves_through, captured_by, linked_to, blocks). RACI edges (has_role_on) use the existing RoleAssigned event, which carries equivalent role + step-index payload. object_type is null because an edge is not a node-shaped object.

Full spec

{
  "name": "EdgeRecorded",
  "description": "A graph edge was materialised. Emitted via @gcc/graph addEdge for non-RACI edges (under_function, depends_on, evidence_for, references, cites, supersedes, invalidates, sequenced_under, provides_capability, enables, annotated_by, mitigates, targets, defines, installed_into, measured_along, affiliated_with, moves_through, captured_by, linked_to, blocks). RACI edges (has_role_on) use the existing RoleAssigned event, which carries equivalent role + step-index payload. object_type is null because an edge is not a node-shaped object.",
  "current_version": 1,
  "actor_type_allowed": [
    "human",
    "system"
  ],
  "object_type": null,
  "payload_versions": {
    "v1": {
      "type": "object",
      "additionalProperties": false,
      "required": [
        "edge_id",
        "edge_type",
        "source_node_id",
        "target_node_id",
        "attributes",
        "created_by"
      ],
      "properties": {
        "edge_id": {
          "type": "string",
          "format": "uuid"
        },
        "edge_type": {
          "type": "string",
          "description": "One of the 22 canonical edge types from packages/ontology/edge-types.json. Excludes has_role_on, which uses RoleAssigned."
        },
        "source_node_id": {
          "type": "string",
          "format": "uuid"
        },
        "target_node_id": {
          "type": "string",
          "format": "uuid"
        },
        "attributes": {
          "type": "object",
          "description": "Edge attributes conforming to the edge type's attributes_schema in edge-types.json.",
          "additionalProperties": true
        },
        "created_by": {
          "type": "string",
          "format": "uuid",
          "description": "User ID of the actor who materialised the edge."
        }
      }
    }
  },
  "projections_consuming": [
    "audit_log",
    "blast_radius_view"
  ],
  "canonicalizer_module": "event-canonicalizers/edge_recorded.ts"
}