software.release.version

software.release.version

{
  "lexicon": 1,
  "id": "software.release.version",
  "defs": {
    "main": {
      "type": "record",
      "description": "An immutable named pointer to a manifest. The record key is '{projectName}:{version}', making uniqueness per (project, version) mechanical and enabling AppView-free resolution. Version strings follow the project-name grammar (lowercase alphanumerics, interior hyphens) but allow dots. The version string cannot contain colons, but the rkey must contain exactly one colon. Valid only when same-DID with the referenced project, and only when target references a manifest of that same project.",
      "key": "any",
      "record": {
        "type": "object",
        "required": [
          "project",
          "version",
          "manifest"
        ],
        "properties": {
          "project": {
            "type": "string",
            "format": "at-uri",
            "description": "The software.release.project this pointer belongs to. Must be same-DID."
          },
          "version": {
            "type": "string",
            "maxLength": 64,
            "description": "Version string (e.g. v1.0.0, 2026.10.13). Follows the project-name grammar, minus colons. MUST match the record rkey after the colon."
          },
          "changelog": {
            "type": "string",
            "format": "uri",
            "description": "Canonical site.standard.document or website changelog linked at version creation. The document may be published by a different DID. This URI does not pin the document's contents."
          },
          "manifest": {
            "type": "ref",
            "ref": "com.atproto.repo.strongRef#main",
            "description": "Strong reference to the software.release.manifest this version stamps. MUST belong to the same project."
          }
        }
      }
    }
  }
}

#mainrecordkey:any

An immutable named pointer to a manifest. The record key is '{projectName}:{version}', making uniqueness per (project, version) mechanical and enabling AppView-free resolution. Version strings follow the project-name grammar (lowercase alphanumerics, interior hyphens) but allow dots. The version string cannot contain colons, but the rkey must contain exactly one colon. Valid only when same-DID with the referenced project, and only when target references a manifest of that same project.

projectstringat-uriRequired: The software.release.project this pointer belongs to. Must be same-DID.
versionstringRequiredmaxLength:64: Version string (e.g. v1.0.0, 2026.10.13). Follows the project-name grammar, minus colons. MUST match the record rkey after the colon.
changelogstringuriOptional: Canonical site.standard.document or website changelog linked at version creation. The document may be published by a different DID. This URI does not pin the document's contents.
manifestrefRequiredref:com.atproto.repo.strongRef#main: Strong reference to the software.release.manifest this version stamps. MUST belong to the same project.