full diff

dev.knotless.getRepoSettings

lexicons.knotless.dev +4 −0

← Back to Compare Lexicon page

From

bafyreiaux6sbxjnr7uv4lvaajkob4gauwub3ppzkjlusnthjuo7s3utwpe indexed 2026-11-04 13:32 UTC View this version

bafyreig6fkasjplsv3zgmfeh2t5nyjfhl7sxuih6ujrladgtlr72jhg4ee indexed 2026-11-07 05:41 UTC View this version

Compatibility

backward compatible Backward compatible. 2 non-breaking changes.

Non-breaking changes (2)

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

Migration guidance

Added

AddedVertex { vertex_id: "dev.knotless.getRepoSettings:output.runners" }

Notes

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

Changes

11{

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

33 "defs": {

44 "main": {

      "description": "A repository's settings, read from its dev.knotless.repo record as its PDS has it now, for the pages' settings to show and change. All of it is public, as the record is.",

66 "errors": [

77 {

88 "description": "No such repository.",

99 "name": "NotFound"

1010 }

1111 ],

1212 "output": {

1313 "encoding": "application/json",

1414 "schema": {

1515 "properties": {

1616 "collaborators": {

1717 "description": "The accounts that may push to it.",

1818 "items": {

1919 "ref": "dev.knotless.defs#actorView",

2020 "type": "ref"

2121 },

2222 "type": "array"

2323 },

2424 "defaultBranch": {

2525 "description": "The branch its record names for HEAD, without refs/heads/.",

2626 "type": "string"

2727 },

2828 "delegated": {

2929

              "description": "The gateway its owner delegated writes to from this appview's pages (dev.knotless.delegateWrites), which sharing it for writing names as its gateway; absent until they have.",

3030 "format": "did",

3131 "type": "string"

3232 },

3333 "description": {

3434 "description": "What the repository says it is.",

3535 "type": "string"

3636 },

3737 "gates": {

3838

              "description": "The accounts its protected branches' rules name as gates (dev.knotless.repo#reviews), each once: for the pages to show by handle. Absent when there are none.",

3939 "items": {

4040 "ref": "dev.knotless.defs#actorView",

4141 "type": "ref"

4242 },

4343 "type": "array"

4444 },

4545 "gateway": {

4646

              "description": "The gateway the owner delegated writes to, through which collaborators push: absent until the owner delegates.",

4747 "format": "did",

4848 "type": "string"

4949 },

5050 "indexed": {

5151

              "description": "Deprecated, and no longer set: knotless.dev indexes every private repository its members read there. Was, for a private repository, whether its owner let this appview keep an index of it.",

5252 "type": "boolean"

5353 },

5454 "labels": {

5555 "description": "The labels its pulls and issues may carry.",

5656 "items": {

5757 "ref": "dev.knotless.repo#label",

5858 "type": "ref"

5959 },

6060 "type": "array"

6161 },

6262 "links": {

6363 "description": "The links its pages show, in order, as its record names them.",

6464 "items": {

6565 "ref": "dev.knotless.defs#link",

6666 "type": "ref"

6767 },

6868 "type": "array"

6969 },

7070 "readers": {

7171

              "description": "For a private repository, asked by its owner, the members who read it but do not push to it, its runners among them; absent for a public one, which anyone reads, and empty to anyone else.",

7272 "items": {

7373 "ref": "dev.knotless.defs#actorView",

7474 "type": "ref"

7575 },

7676 "type": "array"

7777 },

7878 "rules": {

7979 "description": "Its protected branches.",

8080 "items": {

8181 "ref": "dev.knotless.repo#rule",

8282 "type": "ref"

8383 },

8484 "type": "array"

8585 },

86 "runners": {

              "description": "Whether it names a runner, which the merge queue needs to land it. Absent when it names none.",

88 "type": "boolean"

89 },

8690 "storage": {

8791

              "description": "Deprecated, and no longer set: dev.knotless.getRepoStorage counts it, apart, as counting reads every pack record from the PDS. Was what it takes up on its owner's PDS.",

8892 "ref": "#storageView",

8993 "type": "ref"

9094 },

9195 "topics": {

9296 "description": "What it is about, in order, as its record names them.",

9397 "items": {

9498 "ref": "dev.knotless.repo#topic",

9599 "type": "ref"

96100 },

97101 "type": "array"

98102 },

99103 "transfer": {

100104

              "description": "Where the owner has offered to move it, if they have: the account, and the name it would have there.",

101105 "ref": "dev.knotless.defs#repoViewBasic",

102106 "type": "ref"

103107 },

104108 "triagers": {

105109 "description": "The accounts whose labels of some scopes count.",

106110 "items": {

107111 "ref": "#triagerView",

108112 "type": "ref"

109113 },

110114 "type": "array"

111115 },

112116 "uri": {

113117 "description": "Its dev.knotless.repo record, under the name it has now.",

114118 "format": "at-uri",

115119 "type": "string"

116120 }

117121 },

118122 "required": [

119123 "uri",

120124 "rules",

121125 "labels",

122126 "collaborators",

123127 "triagers"

124128 ],

125129 "type": "object"

126130 }

127131 },

128132 "parameters": {

129133 "properties": {

130134 "repo": {

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

132136 "format": "at-uri",

133137 "type": "string"

134138 }

135139 },

136140 "required": [

137141 "repo"

138142 ],

139143 "type": "params"

140144 },

141145 "type": "query"

142146 },

143147 "storageView": {

144148 "description": "A repository's packs, which hold all of its history, as `knotless repo storage` counts them.",

145149 "properties": {

146150 "blobBytes": {

147151 "description": "Of those, the bytes in blobs rather than inline in records.",

148152 "minimum": 0,

149153 "type": "integer"

150154 },

151155 "bytes": {

152156 "description": "Their bytes, as git packs them.",

153157 "minimum": 0,

154158 "type": "integer"

155159 },

156160 "objects": {

157161

          "description": "The objects in them, pack by pack: one in two packs counts twice, until compaction folds them.",

158162 "minimum": 0,

159163 "type": "integer"

160164 },

161165 "packs": {

162166 "minimum": 0,

163167 "type": "integer"

164168 }

165169 },

166170 "required": [

167171 "packs",

168172 "objects",

169173 "bytes",

170174 "blobBytes"

171175 ],

172176 "type": "object"

173177 },

174178 "triagerView": {

175179 "description": "An account whose labels of some scopes count on a repository.",

176180 "properties": {

177181 "actor": {

178182 "ref": "dev.knotless.defs#actorView",

179183 "type": "ref"

180184 },

181185 "scopes": {

182186 "description": "The scopes of the labels it may put on.",

183187 "items": {

184188 "ref": "dev.knotless.repo#scope",

185189 "type": "ref"

186190 },

187191 "type": "array"

188192 }

189193 },

190194 "required": [

191195 "actor",

192196 "scopes"

193197 ],

194198 "type": "object"

195199 }

196200 },

197201

  "description": "What a repository's owner sets: its description, links, topics and default branch, protected branches, labels, collaborators and triagers, and an offer to move it.",

198202 "id": "dev.knotless.getRepoSettings",

199203 "lexicon": 1