full diff

dev.knotless.getLastCommits

lexicons.knotless.dev +5 −0

← Back to Compare Lexicon page

From

bafyreialdwomwc2atylrpzpzvnhnadomnfmdpl4zygop4grzoby6wrcczy indexed 2026-10-28 21:21 UTC View this version

bafyreif4we6qoc65wvitdequax6bskpxlvchpqbsp57ctuelbmayakvh7i indexed 2026-11-01 01:51 UTC View this version

Compatibility

backward compatible Backward compatible. 2 non-breaking changes.

Non-breaking changes (2)

AddedVertex AddedVertex { vertex_id: "dev.knotless.getLastCommits:output.commitCount" }
AddedEdge AddedEdge { src: "dev.knotless.getLastCommits:output", tgt: "dev.knotless.getLastCommits:output.commitCount", kind: "prop", name: Some("commitCount") }

Migration guidance

Added

AddedVertex { vertex_id: "dev.knotless.getLastCommits:output.commitCount" }

Notes

Non-breaking: AddedEdge { src: "dev.knotless.getLastCommits:output", tgt: "dev.knotless.getLastCommits:output.commitCount", kind: "prop", name: Some("commitCount") }

Changes

11{

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

33 "defs": {

44 "entry": {

55 "description": "One entry of the directory, and the commit that last changed it.",

66 "properties": {

77 "name": {

88 "description": "The entry's name in the directory.",

99 "type": "string"

1010 },

1111 "sha": {

1212 "description": "The commit that last changed it, in hex: one of `commits`.",

1313 "type": "string"

1414 }

1515 },

1616 "required": [

1717 "name",

1818 "sha"

1919 ],

2020 "type": "object"

2121 },

2222 "main": {

2323

      "description": "The newest commit to change each entry of a directory at a revision, as its history shows it: a commit that left an entry as one of its parents had it did not change it. Asked apart from dev.knotless.getTree, as finding them can walk a long history. No authentication needed; asked as an account, with a service token or the pages' session cookie, a private repository it is a member of is read too, and the answer is that account's alone.",

2424 "errors": [

2525 {

2626 "description": "No such repository, revision or directory.",

2727 "name": "NotFound"

2828 }

2929 ],

3030 "output": {

3131 "encoding": "application/json",

3232 "schema": {

3333 "properties": {

34 "commitCount": {

              "description": "How many commits the ref's history holds, its own among them. Only when `path` is the root.",

36 "minimum": 0,

37 "type": "integer"

38 },

3439 "commits": {

3540 "description": "Each commit an entry names, once.",

3641 "items": {

3742 "ref": "dev.knotless.defs#commitView",

3843 "type": "ref"

3944 },

4045 "type": "array"

4146 },

4247 "entries": {

4348 "description": "Each entry of the directory, in the tree's order.",

4449 "items": {

4550 "ref": "#entry",

4651 "type": "ref"

4752 },

4853 "type": "array"

4954 },

5055 "path": {

5156 "description": "The directory, from the root; empty for the root.",

5257 "type": "string"

5358 },

5459 "ref": {

5560 "description": "The ref or commit shown, as `ref` named it, less any path.",

5661 "type": "string"

5762 }

5863 },

5964 "required": [

6065 "ref",

6166 "path",

6267 "entries",

6368 "commits"

6469 ],

6570 "type": "object"

6671 }

6772 },

6873 "parameters": {

6974 "properties": {

7075 "path": {

7176 "description": "A directory in the tree, from its root.",

7277 "maxLength": 4096,

7378 "type": "string"

7479 },

7580 "ref": {

7681

            "description": "A branch, a tag or a commit, which may run on into the path, as dev.knotless.getTree takes it; the default branch if absent.",

7782 "maxLength": 1024,

7883 "type": "string"

7984 },

8085 "repo": {

8186 "description": "The repository's dev.knotless.repo record, as dev.knotless.getTree takes it.",

8287 "format": "at-uri",

8388 "type": "string"

8489 }

8590 },

8691 "required": [

8792 "repo"

8893 ],

8994 "type": "params"

9095 },

9196 "type": "query"

9297 }

9398 },

9499 "description": "The newest commit to change each entry of a directory.",

95100 "id": "dev.knotless.getLastCommits",

96101 "lexicon": 1