pub.chive.graph.edgeProposal

chive.pub View official

Documentation

Proposal for creating, updating, or deprecating edges between knowledge graph nodes (stored in user PDS)

main record

Proposal for creating, updating, or deprecating edges between knowledge graph nodes (stored in user PDS)

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

proposalType string Required

Type of proposal action

Known values: create, update, deprecate
rationale string Required

Justification for the proposal

maxLength: 2000 bytes
schemaRevision integer Optional

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

minimum: 1
targetEdgeUri string at-uri Optional

AT-URI of edge to update/deprecate

View raw schema 
{
  "description": "Proposal for creating, updating, or deprecating edges between knowledge graph nodes (stored in user PDS)",
  "key": "tid",
  "record": {
    "properties": {
      "createdAt": {
        "format": "datetime",
        "type": "string"
      },
      "evidence": {
        "description": "Supporting evidence for the proposal",
        "items": {
          "ref": "pub.chive.graph.nodeProposal#evidence",
          "type": "ref"
        },
        "maxLength": 10,
        "type": "array"
      },
      "proposalType": {
        "description": "Type of proposal action",
        "knownValues": [
          "create",
          "update",
          "deprecate"
        ],
        "type": "string"
      },
      "proposedEdge": {
        "description": "Proposed edge data (for create/update)",
        "ref": "#proposedEdgeData",
        "type": "ref"
      },
      "rationale": {
        "description": "Justification for the proposal",
        "maxLength": 2000,
        "type": "string"
      },
      "schemaRevision": {
        "description": "Schema revision this record was created with. Absent means revision 1.",
        "minimum": 1,
        "type": "integer"
      },
      "targetEdgeUri": {
        "description": "AT-URI of edge to update/deprecate",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "proposalType",
      "rationale",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
proposedEdgeData object

Proposed edge data

Properties

relationSlug string Required

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

maxLength: 50 bytes
relationUri string at-uri Optional

AT-URI of relation type node

sourceUri string at-uri Required

AT-URI of source node

targetUri string at-uri Required

AT-URI of target node

weight integer Optional

Edge weight (scaled by 1000 for 0.0-1.0 range)

minimum: 0maximum: 1000
View raw schema 
{
  "description": "Proposed edge data",
  "properties": {
    "metadata": {
      "ref": "pub.chive.graph.edge#edgeMetadata",
      "type": "ref"
    },
    "relationSlug": {
      "description": "Relation slug (broader, narrower, related, etc.)",
      "maxLength": 50,
      "type": "string"
    },
    "relationUri": {
      "description": "AT-URI of relation type node",
      "format": "at-uri",
      "type": "string"
    },
    "sourceUri": {
      "description": "AT-URI of source node",
      "format": "at-uri",
      "type": "string"
    },
    "targetUri": {
      "description": "AT-URI of target node",
      "format": "at-uri",
      "type": "string"
    },
    "weight": {
      "description": "Edge weight (scaled by 1000 for 0.0-1.0 range)",
      "maximum": 1000,
      "minimum": 0,
      "type": "integer"
    }
  },
  "required": [
    "sourceUri",
    "targetUri",
    "relationSlug"
  ],
  "type": "object"
}

Lexicon Garden

@