id.sifa.profile.involvement

{
  "description": "Record representing one involvement — an ongoing role and/or a body of discrete contributions to a single upstream.",
  "key": "tid",
  "record": {
    "properties": {
      "agentRef": {
        "description": "The upstream project, community, event, or cause, as a single nested reference mirroring the flat upstream / upstreamDid / entityRef fields. Additive dual-write: the flat fields remain the source of truth for existing consumers.",
        "ref": "id.sifa.defs#agentRef",
        "type": "ref"
      },
      "collaborators": {
        "description": "Other people who worked on this alongside you. Each entry is a claim by the record author and is not self-verifying: the named person supplies the other half by publishing an id.sifa.confirmation record whose subject is this record and whose relation is id.sifa.defs#collaborator. Until they do, consumers must render the entry without their display name, avatar, or profile link. Confirming never puts this record on their profile: it lives in the author's repository and the author can rename it at any time.",
        "items": {
          "ref": "id.sifa.defs#projectMemberRef",
          "type": "ref"
        },
        "maxLength": 50,
        "type": "array"
      },
      "createdAt": {
        "description": "Client-declared timestamp when this record was originally created.",
        "format": "datetime",
        "type": "string"
      },
      "description": {
        "description": "What the user did and why it mattered.",
        "maxGraphemes": 5000,
        "maxLength": 50000,
        "type": "string"
      },
      "endedAt": {
        "description": "End date in YYYY-MM or YYYY-MM-DD format. Omit if ongoing.",
        "type": "string"
      },
      "entityRef": {
        "description": "Portable, app-neutral identifier for the upstream the user selected from a resolver dropdown: a Wikidata Q-ID URI (http://www.wikidata.org/entity/Q...), a ROR URI, or an LEI URI. Enables deterministic resolution to a canonical entity even before the upstream claims an ATproto account. Absent for free-text or one-off entries.",
        "format": "uri",
        "type": "string"
      },
      "isPrimary": {
        "description": "Whether this is the user's primary current involvement, surfaced in profile Highlights. Only ongoing entries may be primary.",
        "type": "boolean"
      },
      "kind": {
        "description": "The nature of the involvement. Drives the display heading (Open Source / Community / Volunteering / Civic).",
        "knownValues": [
          "id.sifa.defs#involvementOpenSource",
          "id.sifa.defs#involvementCommunity",
          "id.sifa.defs#involvementCharity",
          "id.sifa.defs#involvementCivic",
          "id.sifa.defs#involvementOther"
        ],
        "type": "string"
      },
      "labels": {
        "description": "Self-label values for this record.",
        "refs": [
          "com.atproto.label.defs#selfLabels"
        ],
        "type": "union"
      },
      "links": {
        "description": "Public artifacts proving the involvement (PRs, releases, talk recordings, published translations).",
        "items": {
          "ref": "id.sifa.defs#artifactLink",
          "type": "ref"
        },
        "maxLength": 50,
        "type": "array"
      },
      "location": {
        "description": "Where the involvement takes place. Sifa enforces ISO 3166-1 alpha-2 country codes at the app layer.",
        "ref": "community.lexicon.location.address",
        "type": "ref"
      },
      "role": {
        "description": "The user's role (e.g. 'Maintainer', 'Translator', 'Organizer', 'Contributor').",
        "maxGraphemes": 256,
        "maxLength": 2560,
        "type": "string"
      },
      "sameAs": {
        "description": "The same involvement as recorded on another person's profile. Set when you keep your own entry for work someone else has also recorded, so consumers can tell the two describe one thing rather than showing it twice. Each side stays its own record: the other person cannot edit yours, and yours does not change theirs. Resolve by AT-URI, since they will keep editing their copy.",
        "ref": "id.sifa.defs#externalRecordRef",
        "type": "ref"
      },
      "skills": {
        "description": "Skills demonstrated by this involvement. Each entry is a URI reference to an id.sifa.profile.skill record owned by the same DID.",
        "items": {
          "ref": "id.sifa.defs#skillRef",
          "type": "ref"
        },
        "maxLength": 50,
        "type": "array"
      },
      "startedAt": {
        "description": "Start date in YYYY-MM or YYYY-MM-DD format. Freeform (NOT strict datetime) to allow partial dates and importer writes.",
        "type": "string"
      },
      "upstream": {
        "description": "Name of the project, community, event, or cause (e.g. 'atproto', 'Linux kernel', 'PyCon NL'). Optional — a one-off contribution need not name an organization.",
        "maxGraphemes": 256,
        "maxLength": 2560,
        "type": "string"
      },
      "upstreamDid": {
        "description": "DID of the upstream's ATproto account, if one exists.",
        "format": "did",
        "type": "string"
      },
      "upstreamUrl": {
        "description": "Primary URL of the upstream (project homepage, repo, event site).",
        "format": "uri",
        "type": "string"
      }
    },
    "required": [
      "kind",
      "createdAt"
    ],
    "type": "object"
  },
  "type": "record",
  "x-skos:broadMatch": [
    "org:Membership"
  ],
  "x-skos:note": "The kind known values have no external equivalent."
}