full diff

dev.knotless.ref

lexicons.knotless.dev +5 −0

← Back to Compare Lexicon page

From

bafyreia2vq46kk6zvxsz3typlxjceavfj5y45p6nmqftthglb5r4y5u7we indexed 2026-11-02 21:17 UTC View this version

bafyreie5jnm2ualjqojxgioonefuylrqx3rddsh5as7ynypaljdstojdaq indexed 2026-11-04 06:49 UTC View this version

Compatibility

backward compatible Backward compatible. 2 non-breaking changes.

Non-breaking changes (2)

AddedVertex AddedVertex { vertex_id: "dev.knotless.ref:body.pack" }
AddedEdge AddedEdge { src: "dev.knotless.ref:body", tgt: "dev.knotless.ref:body.pack", kind: "prop", name: Some("pack") }

Migration guidance

Added

AddedVertex { vertex_id: "dev.knotless.ref:body.pack" }

Notes

Non-breaking: AddedEdge { src: "dev.knotless.ref:body", tgt: "dev.knotless.ref:body.pack", kind: "prop", name: Some("pack") }

Changes

11{

22 "$type": "com.atproto.lexicon.schema",

33 "defs": {

44 "main": {

      "description": "Keyed `<repo key>.<ref hash>`, where the hash is the first 26 characters of the lowercase unpadded base32 SHA-256 of `name`. Written only in the same applyWrites as the dev.knotless.claim for its current generation.",

66 "key": "any",

77 "record": {

88 "properties": {

99 "createdAt": {

1010 "description": "When the ref was made: the same as updatedAt until it first moves.",

1111 "format": "datetime",

1212 "type": "string"

1313 },

1414 "generation": {

1515

            "description": "Goes up by one each time the ref moves. A new ref starts at the time in milliseconds since the epoch, past any generation an earlier ref of the same name reached; records written before 0.6 started at 1.",

1616 "minimum": 1,

1717 "type": "integer"

1818 },

1919 "name": {

2020 "description": "The full ref name, such as refs/heads/main.",

2121 "maxLength": 1024,

2222 "type": "string"

2323 },

24 "pack": {

            "description": "The record key of the dev.knotless.pack holding `target`, as the move that set it knew: the pack that move wrote, or the one another ref at the same commit named. A fetch reads it rather than walking the packs. A compaction folds packs into a new one without moving refs, so a reader finding it gone walks the packs instead.",

26 "format": "record-key",

27 "type": "string"

28 },

2429 "pusher": {

2530

            "description": "The account that last moved the ref, when not the repository's owner: a collaborator or runner pushing through the gateway, which sets it from the caller's verified service token. Readers credit it only while the repository names it among its collaborators or runners.",

2631 "format": "did",

2732 "type": "string"

2833 },

2934 "repo": {

3035 "description": "The `key` of the dev.knotless.repo this ref belongs to.",

3136 "format": "tid",

3237 "type": "string"

3338 },

3439 "target": {

3540

            "description": "The hex object ID the ref points at. Absent only from a record a client before 0.6 left of a deleted ref; a delete now deletes the record.",

3641 "maxLength": 64,

3742 "minLength": 40,

3843 "type": "string"

3944 },

4045 "updatedAt": {

4146 "description": "When the ref last moved.",

4247 "format": "datetime",

4348 "type": "string"

4449 }

4550 },

4651 "required": [

4752 "repo",

4853 "name",

4954 "generation",

5055 "updatedAt"

5156 ],

5257 "type": "object"

5358 },

5459 "type": "record"

5560 }

5661 },

5762 "description": "One git ref of a repository.",

5863 "id": "dev.knotless.ref",

5964 "lexicon": 1