full diff

dev.knotless.comment

lexicons.knotless.dev +5 −0

← Back to Compare Lexicon page

From

bafyreih5fglybkuwe7c532flm2okjck4hftaa5nadklkt5zwi5d7ek44rq indexed 2026-10-29 06:54 UTC View this version

bafyreid4b2ag3g4mcej65ehzf3ccarh6salxp2riocrm2zo4qoxgmtwetu indexed 2026-11-03 18:11 UTC View this version

Compatibility

backward compatible Backward compatible. 2 non-breaking changes.

Non-breaking changes (2)

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

Migration guidance

Added

AddedVertex { vertex_id: "dev.knotless.comment:body.dismisses" }

Notes

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

Changes

11{

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

33 "defs": {

44 "lineRef": {

55 "description": "Lines of a file in a pull's diff, as GitHub's review comments name them.",

66 "properties": {

77 "line": {

88 "description": "The last line commented on, counting from 1.",

99 "minimum": 1,

1010 "type": "integer"

1111 },

1212 "path": {

1313 "description": "The file's path on the side commented on.",

1414 "maxLength": 1024,

1515 "type": "string"

1616 },

1717 "side": {

1818

          "description": "`new`, the side the pull brings in, or `old`, the side it leaves, for lines it removes. Absent, `new`.",

1919 "knownValues": [

2020 "old",

2121 "new"

2222 ],

2323 "maxLength": 16,

2424 "type": "string"

2525 },

2626 "startLine": {

2727 "description": "The first, for more than one line; no later than `line`.",

2828 "minimum": 1,

2929 "type": "integer"

3030 }

3131 },

3232 "required": [

3333 "path",

3434 "line"

3535 ],

3636 "type": "object"

3737 },

3838 "main": {

3939

      "description": "Kept in the commenter's account; for a private repository, in their repo inside the repository's space.",

4040 "key": "tid",

4141 "record": {

4242 "properties": {

4343 "attachments": {

4444

            "description": "What it carries beside its body: the pictures the body shows. Kinds unknown to a reader are passed over, and kept by a client changing it.",

4545 "items": {

4646 "refs": [

4747 "dev.knotless.defs#image"

4848 ],

4949 "type": "union"

5050 },

5151 "maxLength": 32,

5252 "type": "array"

5353 },

5454 "body": {

5555 "description": "Markdown.",

5656 "maxLength": 20000,

5757 "type": "string"

5858 },

5959 "commit": {

6060 "description": "The hex object ID of the head commit a review looked at, or that a comment's `line` is in.",

6161 "maxLength": 64,

6262 "minLength": 40,

6363 "type": "string"

6464 },

6565 "createdAt": {

6666 "format": "datetime",

6767 "type": "string"

6868 },

69 "dismisses": {

            "description": "The review, a dev.knotless.comment with a verdict on the same pull, this dismisses, its body saying why. From the repository's owner or a collaborator, the review stops counting toward the pull's reviews, for or against it, until its reviewer reviews again; one from anyone else changes nothing.",

71 "format": "at-uri",

72 "type": "string"

73 },

6974 "facets": {

7075

            "description": "The accounts its body mentions, by where: written as it is, from each `@handle` outside code and links.",

7176 "items": {

7277 "ref": "dev.knotless.defs#facet",

7378 "type": "ref"

7479 },

7580 "maxLength": 50,

7681 "type": "array"

7782 },

7883 "line": {

7984

            "description": "For a comment on a pull's diff, the lines it is on, in the file as it was at `commit` on that side.",

8085 "ref": "#lineRef",

8186 "type": "ref"

8287 },

8388 "reply": {

8489

            "description": "The dev.knotless.comment, with a `line`, whose thread this answers. An answer has no `line` of its own.",

8590 "format": "at-uri",

8691 "type": "string"

8792 },

8893 "repo": {

8994 "description": "The repository the pull or issue is on.",

9095 "ref": "dev.knotless.defs#repoRef",

9196 "type": "ref"

9297 },

9398 "review": {

9499

            "description": "The review, a dev.knotless.comment, this was sent with as one of its line comments, all in one write.",

95100 "format": "at-uri",

96101 "type": "string"

97102 },

98103 "subject": {

99104 "description": "The dev.knotless.pull or dev.knotless.issue commented on.",

100105 "format": "at-uri",

101106 "type": "string"

102107 },

103108 "updatedAt": {

104109 "description": "When its author last changed its body.",

105110 "format": "datetime",

106111 "type": "string"

107112 },

108113 "verdict": {

109114

            "description": "Present on a review: `approve`, or `changes` to ask for changes. Readers take each reviewer's latest as where they stand, and none from the pull's author.",

110115 "knownValues": [

111116 "approve",

112117 "changes"

113118 ],

114119 "maxLength": 64,

115120 "type": "string"

116121 }

117122 },

118123 "required": [

119124 "repo",

120125 "subject",

121126 "body",

122127 "createdAt"

123128 ],

124129 "type": "object"

125130 },

126131 "type": "record"

127132 }

128133 },

129134

  "description": "A comment on a pull or issue. With a verdict it is a review; with a line, a comment on lines of a pull's diff, starting a thread there; with a reply, an answer in such a thread.",

130135 "id": "dev.knotless.comment",

131136 "lexicon": 1