pub.chive.graph.nodeProposal

lexicons.governance.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 
{
  "description": "Unified proposal for creating, updating, merging, or deprecating 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": "#evidence",
          "type": "ref"
        },
        "maxLength": 10,
        "type": "array"
      },
      "kind": {
        "description": "Node kind being proposed",
        "knownValues": [
          "type",
          "object"
        ],
        "type": "string"
      },
      "mergeIntoUri": {
        "description": "AT-URI of node to merge into (for merge action)",
        "format": "at-uri",
        "type": "string"
      },
      "proposalType": {
        "description": "Type of proposal action",
        "knownValues": [
          "create",
          "update",
          "merge",
          "deprecate"
        ],
        "type": "string"
      },
      "proposedNode": {
        "description": "Proposed node data (for create/update)",
        "ref": "#proposedNodeData",
        "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"
      },
      "subkind": {
        "description": "Subkind slug (e.g., 'field', 'institution', 'contribution-type')",
        "maxLength": 50,
        "type": "string"
      },
      "targetUri": {
        "description": "AT-URI of node to update/deprecate/merge",
        "format": "at-uri",
        "type": "string"
      }
    },
    "required": [
      "proposalType",
      "kind",
      "rationale",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record"
}
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 
{
  "description": "Supporting evidence for a proposal",
  "properties": {
    "description": {
      "description": "Description of the evidence",
      "maxLength": 500,
      "type": "string"
    },
    "type": {
      "description": "Evidence type",
      "knownValues": [
        "wikidata",
        "lcsh",
        "fast",
        "ror",
        "credit",
        "usage",
        "citation",
        "external",
        "other"
      ],
      "type": "string"
    },
    "uri": {
      "description": "URI to evidence",
      "format": "uri",
      "type": "string"
    }
  },
  "required": [
    "type"
  ],
  "type": "object"
}
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 
{
  "description": "Proposed node data",
  "properties": {
    "alternateLabels": {
      "items": {
        "maxLength": 500,
        "type": "string"
      },
      "maxLength": 50,
      "type": "array"
    },
    "description": {
      "maxLength": 2000,
      "type": "string"
    },
    "externalIds": {
      "items": {
        "ref": "pub.chive.graph.node#externalId",
        "type": "ref"
      },
      "maxLength": 20,
      "type": "array"
    },
    "label": {
      "maxLength": 500,
      "type": "string"
    },
    "metadata": {
      "ref": "pub.chive.graph.node#nodeMetadata",
      "type": "ref"
    }
  },
  "required": [
    "label"
  ],
  "type": "object"
}

Lexicon Garden

@