pub.chive.governance.listProposals

{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "consensusProgress": {
      "properties": {
        "approvalPercentage": {
          "description": "Current approval percentage (0-100)",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "consensusReached": {
          "description": "Whether consensus has been reached",
          "type": "boolean"
        },
        "minimumVotes": {
          "description": "Minimum votes required",
          "minimum": 0,
          "type": "integer"
        },
        "recommendedStatus": {
          "description": "Recommended status based on votes",
          "knownValues": [
            "approved",
            "rejected",
            "pending"
          ],
          "type": "string"
        },
        "threshold": {
          "description": "Required threshold for approval (0-100)",
          "maximum": 100,
          "minimum": 0,
          "type": "integer"
        },
        "voterCount": {
          "description": "Number of voters",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "approvalPercentage",
        "threshold",
        "voterCount",
        "minimumVotes",
        "consensusReached",
        "recommendedStatus"
      ],
      "type": "object"
    },
    "externalId": {
      "properties": {
        "identifier": {
          "description": "Identifier in external system",
          "type": "string"
        },
        "matchType": {
          "description": "Match type",
          "knownValues": [
            "exact",
            "close",
            "broader",
            "narrower",
            "related"
          ],
          "type": "string"
        },
        "system": {
          "description": "External system name",
          "type": "string"
        },
        "uri": {
          "description": "URI in external system",
          "format": "uri",
          "type": "string"
        }
      },
      "required": [
        "system",
        "identifier"
      ],
      "type": "object"
    },
    "main": {
      "description": "List governance proposals with optional filtering by status, type, and other criteria",
      "errors": [],
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "cursor": {
              "description": "Cursor for next page",
              "type": "string"
            },
            "proposals": {
              "description": "List of proposals",
              "items": {
                "ref": "#proposalView",
                "type": "ref"
              },
              "type": "array"
            },
            "total": {
              "description": "Total number of proposals matching filters",
              "type": "integer"
            }
          },
          "required": [
            "proposals",
            "total"
          ],
          "type": "object"
        }
      },
      "parameters": {
        "properties": {
          "cursor": {
            "description": "Pagination cursor for next page",
            "type": "string"
          },
          "kind": {
            "description": "Filter by node kind",
            "knownValues": [
              "type",
              "object"
            ],
            "type": "string"
          },
          "limit": {
            "default": 50,
            "description": "Maximum number of results to return",
            "maximum": 100,
            "minimum": 1,
            "type": "integer"
          },
          "nodeUri": {
            "description": "Filter by target node URI",
            "format": "at-uri",
            "type": "string"
          },
          "proposedBy": {
            "description": "Filter by proposer DID",
            "format": "did",
            "type": "string"
          },
          "status": {
            "description": "Filter by proposal status",
            "knownValues": [
              "pending",
              "approved",
              "rejected",
              "expired"
            ],
            "type": "string"
          },
          "subkind": {
            "description": "Filter by subkind (field, institution, etc.)",
            "type": "string"
          },
          "type": {
            "description": "Filter by proposal type",
            "knownValues": [
              "create",
              "update",
              "merge",
              "deprecate"
            ],
            "type": "string"
          }
        },
        "type": "params"
      },
      "type": "query"
    },
    "proposalChanges": {
      "description": "Proposed changes to a node",
      "properties": {
        "alternateLabels": {
          "description": "Alternate labels",
          "items": {
            "type": "string"
          },
          "type": "array"
        },
        "description": {
          "description": "Node description",
          "type": "string"
        },
        "externalIds": {
          "description": "External identifiers",
          "items": {
            "ref": "#externalId",
            "type": "ref"
          },
          "type": "array"
        },
        "kind": {
          "description": "Node kind",
          "knownValues": [
            "type",
            "object"
          ],
          "type": "string"
        },
        "label": {
          "description": "Node label",
          "type": "string"
        },
        "mergeIntoUri": {
          "description": "Merge target URI",
          "format": "at-uri",
          "type": "string"
        },
        "metadata": {
          "description": "Additional metadata",
          "type": "unknown"
        },
        "subkind": {
          "description": "Node subkind",
          "type": "string"
        },
        "targetUri": {
          "description": "Target URI for update/deprecate",
          "format": "at-uri",
          "type": "string"
        }
      },
      "type": "object"
    },
    "proposalView": {
      "description": "View of a governance proposal",
      "properties": {
        "changes": {
          "description": "Proposed changes",
          "ref": "#proposalChanges",
          "type": "ref"
        },
        "cid": {
          "description": "Content identifier",
          "type": "string"
        },
        "consensus": {
          "ref": "#consensusProgress",
          "type": "ref"
        },
        "createdAt": {
          "description": "Creation timestamp",
          "format": "datetime",
          "type": "string"
        },
        "expiresAt": {
          "description": "Expiration timestamp",
          "format": "datetime",
          "type": "string"
        },
        "id": {
          "description": "Proposal identifier",
          "type": "string"
        },
        "label": {
          "description": "Node label (from target node or proposed changes)",
          "type": "string"
        },
        "nodeUri": {
          "description": "Target node URI (for update/merge/deprecate)",
          "format": "at-uri",
          "type": "string"
        },
        "proposedBy": {
          "description": "DID of the proposer",
          "format": "did",
          "type": "string"
        },
        "proposerName": {
          "description": "Display name of the proposer",
          "type": "string"
        },
        "rationale": {
          "description": "Rationale for the proposal",
          "type": "string"
        },
        "status": {
          "description": "Current proposal status",
          "knownValues": [
            "pending",
            "approved",
            "rejected",
            "expired"
          ],
          "type": "string"
        },
        "type": {
          "description": "Proposal type",
          "knownValues": [
            "create",
            "update",
            "merge",
            "deprecate"
          ],
          "type": "string"
        },
        "updatedAt": {
          "description": "Last update timestamp",
          "format": "datetime",
          "type": "string"
        },
        "uri": {
          "description": "Proposal AT-URI",
          "format": "at-uri",
          "type": "string"
        },
        "votes": {
          "ref": "#voteCounts",
          "type": "ref"
        }
      },
      "required": [
        "id",
        "uri",
        "cid",
        "type",
        "changes",
        "status",
        "proposedBy",
        "votes",
        "consensus",
        "createdAt"
      ],
      "type": "object"
    },
    "voteCounts": {
      "properties": {
        "abstain": {
          "description": "Number of abstain votes",
          "minimum": 0,
          "type": "integer"
        },
        "approve": {
          "description": "Number of approve votes",
          "minimum": 0,
          "type": "integer"
        },
        "reject": {
          "description": "Number of reject votes",
          "minimum": 0,
          "type": "integer"
        }
      },
      "required": [
        "approve",
        "reject",
        "abstain"
      ],
      "type": "object"
    }
  },
  "id": "pub.chive.governance.listProposals",
  "lexicon": 1,
  "revision": 1
}