pub.chive.graph.edge

chive.pub

Documentation

Typed relationship between knowledge graph nodes. Relation types are themselves nodes with subkind=relation.

main record

Typed relationship between knowledge graph nodes. Relation types are themselves nodes with subkind=relation.

Record Key any Any valid record key

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

createdBy string did Optional

DID of creator or governance

id string Required

UUID identifier (also used as rkey)

proposalUri string at-uri Optional

AT-URI of the proposal that created this edge (null for seeded)

relationSlug string Required

Relation slug for queries (broader, narrower, related, etc.)

maxLength: 50 bytes
relationUri string at-uri Optional

AT-URI of relation type node (subkind=relation)

schemaRevision integer Optional

Schema revision this record was created with. Absent means revision 1.

minimum: 1
sourceUri string at-uri Required

AT-URI of source node

status string Required

Edge lifecycle status

Known values: proposed, established, deprecated
targetUri string at-uri Required

AT-URI of target node

updatedAt string datetime Optional

An RFC 3339 formatted timestamp.

weight integer Optional

Optional edge weight for ranking (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
View raw schema 
{
  "key": "any",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "id",
      "sourceUri",
      "targetUri",
      "relationSlug",
      "status",
      "createdAt"
    ],
    "properties": {
      "id": {
        "type": "string",
        "description": "UUID identifier (also used as rkey)"
      },
      "status": {
        "type": "string",
        "description": "Edge lifecycle status",
        "knownValues": [
          "proposed",
          "established",
          "deprecated"
        ]
      },
      "weight": {
        "type": "integer",
        "maximum": 1000,
        "minimum": 0,
        "description": "Optional edge weight for ranking (scaled by 1000 for 0.0-1.0 range)"
      },
      "metadata": {
        "ref": "#edgeMetadata",
        "type": "ref",
        "description": "Edge-specific metadata"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "createdBy": {
        "type": "string",
        "format": "did",
        "description": "DID of creator or governance"
      },
      "sourceUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of source node"
      },
      "targetUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of target node"
      },
      "updatedAt": {
        "type": "string",
        "format": "datetime"
      },
      "proposalUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of the proposal that created this edge (null for seeded)"
      },
      "relationUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of relation type node (subkind=relation)"
      },
      "relationSlug": {
        "type": "string",
        "maxLength": 50,
        "description": "Relation slug for queries (broader, narrower, related, etc.)"
      },
      "schemaRevision": {
        "type": "integer",
        "minimum": 1,
        "description": "Schema revision this record was created with. Absent means revision 1."
      }
    }
  },
  "description": "Typed relationship between knowledge graph nodes. Relation types are themselves nodes with subkind=relation."
}
edgeMetadata object

Edge-specific metadata

Properties

confidence integer Optional

Confidence score for automatically inferred edges (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
endDate string datetime Optional

Temporal end (for time-bounded relationships)

source string Optional

Source of the relationship assertion

maxLength: 200 bytes
startDate string datetime Optional

Temporal start (for time-bounded relationships)

View raw schema 
{
  "type": "object",
  "properties": {
    "source": {
      "type": "string",
      "maxLength": 200,
      "description": "Source of the relationship assertion"
    },
    "endDate": {
      "type": "string",
      "format": "datetime",
      "description": "Temporal end (for time-bounded relationships)"
    },
    "startDate": {
      "type": "string",
      "format": "datetime",
      "description": "Temporal start (for time-bounded relationships)"
    },
    "confidence": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 0,
      "description": "Confidence score for automatically inferred edges (scaled by 1000 for 0.0-1.0 range)"
    }
  },
  "description": "Edge-specific metadata"
}

Lexicon Garden

@