pub.chive.graph.edgeProposal

chive.pub

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 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "proposalType",
      "rationale",
      "createdAt"
    ],
    "properties": {
      "evidence": {
        "type": "array",
        "items": {
          "ref": "pub.chive.graph.nodeProposal#evidence",
          "type": "ref"
        },
        "maxLength": 10,
        "description": "Supporting evidence for the proposal"
      },
      "createdAt": {
        "type": "string",
        "format": "datetime"
      },
      "rationale": {
        "type": "string",
        "maxLength": 2000,
        "description": "Justification for the proposal"
      },
      "proposalType": {
        "type": "string",
        "description": "Type of proposal action",
        "knownValues": [
          "create",
          "update",
          "deprecate"
        ]
      },
      "proposedEdge": {
        "ref": "#proposedEdgeData",
        "type": "ref",
        "description": "Proposed edge data (for create/update)"
      },
      "targetEdgeUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of edge to update/deprecate"
      },
      "schemaRevision": {
        "type": "integer",
        "minimum": 1,
        "description": "Schema revision this record was created with. Absent means revision 1."
      }
    }
  },
  "description": "Proposal for creating, updating, or deprecating edges between knowledge graph nodes (stored in user PDS)"
}
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 
{
  "type": "object",
  "required": [
    "sourceUri",
    "targetUri",
    "relationSlug"
  ],
  "properties": {
    "weight": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 0,
      "description": "Edge weight (scaled by 1000 for 0.0-1.0 range)"
    },
    "metadata": {
      "ref": "pub.chive.graph.edge#edgeMetadata",
      "type": "ref"
    },
    "sourceUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of source node"
    },
    "targetUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of target node"
    },
    "relationUri": {
      "type": "string",
      "format": "at-uri",
      "description": "AT-URI of relation type node"
    },
    "relationSlug": {
      "type": "string",
      "maxLength": 50,
      "description": "Relation slug (broader, narrower, related, etc.)"
    }
  },
  "description": "Proposed edge data"
}

Lexicon Garden

@