pub.chive.graph.nodeProposal

chive.pub

Documentation

Unified proposal for creating, updating, merging, or deprecating knowledge graph nodes (stored in user PDS)

main record

Unified proposal for creating, updating, merging, or deprecating knowledge graph nodes (stored in user PDS)

Record Key tid Timestamp-based ID

Properties

createdAt string datetime Required

An RFC 3339 formatted timestamp.

evidence array of ref #evidence Optional

Supporting evidence for the proposal

maxLength: 10 items
kind string Required

Node kind being proposed

Known values: type, object
mergeIntoUri string at-uri Optional

AT-URI of node to merge into (for merge action)

proposalType string Required

Type of proposal action

Known values: create, update, merge, 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
subkind string Optional

Subkind slug (e.g., 'field', 'institution', 'contribution-type')

maxLength: 50 bytes
targetUri string at-uri Optional

AT-URI of node to update/deprecate/merge

View raw schema 
{
  "key": "tid",
  "type": "record",
  "record": {
    "type": "object",
    "required": [
      "proposalType",
      "kind",
      "rationale",
      "createdAt"
    ],
    "properties": {
      "kind": {
        "type": "string",
        "description": "Node kind being proposed",
        "knownValues": [
          "type",
          "object"
        ]
      },
      "subkind": {
        "type": "string",
        "maxLength": 50,
        "description": "Subkind slug (e.g., 'field', 'institution', 'contribution-type')"
      },
      "evidence": {
        "type": "array",
        "items": {
          "ref": "#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"
      },
      "targetUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of node to update/deprecate/merge"
      },
      "mergeIntoUri": {
        "type": "string",
        "format": "at-uri",
        "description": "AT-URI of node to merge into (for merge action)"
      },
      "proposalType": {
        "type": "string",
        "description": "Type of proposal action",
        "knownValues": [
          "create",
          "update",
          "merge",
          "deprecate"
        ]
      },
      "proposedNode": {
        "ref": "#proposedNodeData",
        "type": "ref",
        "description": "Proposed node data (for create/update)"
      },
      "schemaRevision": {
        "type": "integer",
        "minimum": 1,
        "description": "Schema revision this record was created with. Absent means revision 1."
      }
    }
  },
  "description": "Unified proposal for creating, updating, merging, or deprecating knowledge graph nodes (stored in user PDS)"
}
evidence object

Supporting evidence for a proposal

Properties

description string Optional

Description of the evidence

maxLength: 500 bytes
type string Required

Evidence type

Known values: wikidata, lcsh, fast, ror, credit, usage, citation, external, other
uri string uri Optional

URI to evidence

View raw schema 
{
  "type": "object",
  "required": [
    "type"
  ],
  "properties": {
    "uri": {
      "type": "string",
      "format": "uri",
      "description": "URI to evidence"
    },
    "type": {
      "type": "string",
      "description": "Evidence type",
      "knownValues": [
        "wikidata",
        "lcsh",
        "fast",
        "ror",
        "credit",
        "usage",
        "citation",
        "external",
        "other"
      ]
    },
    "description": {
      "type": "string",
      "maxLength": 500,
      "description": "Description of the evidence"
    }
  },
  "description": "Supporting evidence for a proposal"
}
proposedNodeData object

Proposed node data

Properties

alternateLabels array of string Optional

No description available.

maxLength: 50 items
description string Optional

No description available.

maxLength: 2000 bytes
label string Required

No description available.

maxLength: 500 bytes
View raw schema 
{
  "type": "object",
  "required": [
    "label"
  ],
  "properties": {
    "label": {
      "type": "string",
      "maxLength": 500
    },
    "metadata": {
      "ref": "pub.chive.graph.node#nodeMetadata",
      "type": "ref"
    },
    "description": {
      "type": "string",
      "maxLength": 2000
    },
    "externalIds": {
      "type": "array",
      "items": {
        "ref": "pub.chive.graph.node#externalId",
        "type": "ref"
      },
      "maxLength": 20
    },
    "alternateLabels": {
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 500
      },
      "maxLength": 50
    }
  },
  "description": "Proposed node data"
}

Lexicon Garden

@