# pub.chive.graph.nodeProposal

> Published by [chive.pub](https://lexicon.garden/identity/did:plc:7natp5xae72bddaqlkef2t4e)

✓ This is the authoritative definition for this NSID.

## Links

- [View on Lexicon Garden](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.nodeProposal)
- [Documentation](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.nodeProposal/docs)
- [Examples](https://lexicon.garden/lexicon/did:plc:7natp5xae72bddaqlkef2t4e/pub.chive.graph.nodeProposal/examples)

## Definitions

### `pub.chive.graph.nodeProposal`

**Type**: `record`

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

**Key**: `tid`

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `kind` | `string` | Yes | Node kind being proposed |
| `subkind` | `string` | No | Subkind slug (e.g., 'field', 'institution', 'contribution-type') |
| `evidence` | `array` | No | Supporting evidence for the proposal |
| `createdAt` | `string` (datetime) | Yes |  |
| `rationale` | `string` | Yes | Justification for the proposal |
| `targetUri` | `string` (at-uri) | No | AT-URI of node to update/deprecate/merge |
| `mergeIntoUri` | `string` (at-uri) | No | AT-URI of node to merge into (for merge action) |
| `proposalType` | `string` | Yes | Type of proposal action |
| `proposedNode` | `ref` → `#proposedNodeData` | No | Proposed node data (for create/update) |
| `schemaRevision` | `integer` | No | Schema revision this record was created with. Absent means revision 1. |

### `pub.chive.graph.nodeProposal#evidence`

**Type**: `object`

Supporting evidence for a proposal

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `uri` | `string` (uri) | No | URI to evidence |
| `type` | `string` | Yes | Evidence type |
| `description` | `string` | No | Description of the evidence |

### `pub.chive.graph.nodeProposal#proposedNodeData`

**Type**: `object`

Proposed node data

| Property | Type | Required | Description |
|----------|------|----------|-------------|
| `label` | `string` | Yes |  |
| `metadata` | `ref` → `pub.chive.graph.node#nodeMetadata` | No |  |
| `description` | `string` | No |  |
| `externalIds` | `array` | No |  |
| `alternateLabels` | `array` | No |  |

## Raw Schema

```json
{
  "id": "pub.chive.graph.nodeProposal",
  "defs": {
    "main": {
      "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": {
      "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": {
      "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"
    }
  },
  "$type": "com.atproto.lexicon.schema",
  "lexicon": 1,
  "revision": 1
}
```