dev.knotless.repo
Keyed by the repository's name, so a clone URL resolves with one getRecord. `key` prefixes the record keys of everything the repository holds; a rename writes a record under the new name with the same key, deletes the old one and leaves a dev.knotless.redirect under the old name.
Details · record, key any
| Kind | record |
|---|---|
| Record key | any |
| Authority | knotless.dev |
| Indexed |
Record
record · key anyProperties
agents
arrayAccounts, such as a coding agent, whose pulls the repository's runners check as they move, as they do a collaborator's, but as code no one vouches for: given no secrets, reading caches apart, and keeping nothing they write. An account named here counts as an agent even if it is a collaborator too.
maxLength: 32
appviews
arrayDeprecated, and no longer read: knotless.dev indexes every private repository its members read there, named here or not. Was, for a private repository, the appviews its owner let keep an index of it.
maxLength: 32
archivedAt
string · datetimeWhen the owner archived the repository: read only from then. Clients push and commit nothing to it, nor write pulls, issues, comments or states about it; a gateway takes no pushes or commits for it; runners leave it; and readers show it as archived. Dropped to unarchive it.
collaborators
arrayAccounts that may push. They push through a gateway the owner has delegated writes to, which checks this list.
maxLength: 1000
defaultBranch
stringThe branch HEAD points at, without refs/heads/.
maxLength: 255
description
stringmaxLength: 3000maxGraphemes: 300
forkOf
refThe repository this one was forked from.
gateway
string · didA gateway the owner has delegated writes to. Collaborators push and commit through it; it batches concurrent commits to a branch into one write.
Minted when the repository is created; never reused. The `repo` of its dev.knotless.ref, dev.knotless.claim and dev.knotless.pack records.
labels
arrayThe labels its pulls and issues may carry. The owner and collaborators put them on with dev.knotless.label records; readers show none but these.
maxLength: 200
links
arrayLinks shown on the repository's pages, in display order: its website first.
maxLength: 5
Equal to the record key.
maxLength: 100
readers
arrayFor a private repository, the accounts it is shared with to read but not to push: members of its space. An appview takes this as the owner's word that they may hear of what is said there.
maxLength: 1000
rules
arrayProtected branches. The gateway holds collaborators to them; the owner, who writes these records directly, is held only by their own client.
maxLength: 100
runners
arrayAccounts that run the repository's workflows. Readers show the dev.knotless.check records these accounts write about the repository, and no one else's.
maxLength: 32
topics
arrayWhat the repository is about, as rust or atproto, in display order. Readers list repositories by them.
maxLength: 20
transfer
refWhere the owner has offered to move the repository: a record in another account, named before it exists. Once that account holds a dev.knotless.repo there whose `transferredFrom` names this one, the repository has moved, and readers follow.
The repository this one was moved from. Readers count records naming that one as naming this one, if its owner agreed: its `transfer`, or the redirect left in its place, leads here.
#agent
objectAn account whose pulls are checked as they move, as code no one vouches for.
Properties
#appview
objectAn appview the owner lets keep an index of a private repository.
Properties
The appview's service DID, as did:web:knotless.dev.
#collaborator
objectAn account that may push to the repository.
Properties
#gate
objectAn account a protected branch's pulls wait for a review from.
Properties
#label
objectA label pulls and issues may carry.
Properties
color
stringA hex color, as #d73a4a.
maxLength: 7
description
stringWhat the label means, for those who put it on.
maxLength: 1000maxGraphemes: 200
exclusive
booleanAt most one of its scope's exclusive labels stands at a time, as priority/high and priority/low: setting one takes the others off.
Unique among the repository's labels. Up to its last `/`, if it has one, it names the label's scope, as kind/bug's is kind.
maxLength: 100maxGraphemes: 50
#reader
objectAn account a private repository is shared with to read.
Properties
#reviews
objectThe reviews a protected branch asks of a pull before it merges, counted from those who may write to the repository: its owner and collaborators. A review is a dev.knotless.comment with a verdict, and each reviewer's newest one stands. A standing request for changes from one of them blocks the merge. A reader that finds a field here it does not know merges into the branch only once it knows it, so a rule is never held more loosely than it was written.
Properties
approvals
integerHow many approvals the pull needs, from accounts other than its author. Absent is 0.
minimum: 0maximum: 10
codeOwners
booleanEach path the pull changes that the CODEOWNERS file on the target branch gives owners needs an approval from one of them. Absent is false.
dismissStale
booleanOnly an approval of the pull's head as it is now counts: one of an earlier head no longer does. Absent is false, and any standing approval counts.
gates
arrayAccounts, such as review agents, whose review of the pull's head it waits for, though they may not write to the repository: the merge queue holds it until each has reviewed its head, and one asking for changes blocks it until that account reviews again. Their approvals count toward nothing else. An approval of the head from the owner or a collaborator, given after a gate's newest review, stands in for that gate's. Absent, none.
maxLength: 10
#rule
objectA protected branch: through a gateway it only moves forward and is never deleted, and, as its rule says, takes no merge commits, takes pulls only through the merge queue, or takes a pull only once it is reviewed.
Properties
The branch, without refs/heads/.
maxLength: 255
history
string`linear`: the branch takes no merge commits, so pulls merge into it by squashing. `merges`: it takes them. Absent, or a value a reader does not know, is read as `linear`, so a rule is never held more loosely than it was written.
maxLength: 64knownValues: linear | merges
queue
booleanPulls into this branch land only through the merge queue: a merge queues them instead, unless the owner forces it, and through a gateway the branch moves for no one but the owner and the runner that lands the queue. Absent is false.
#runner
objectAn account whose dev.knotless.check records about the repository readers trust.
Properties
#scope
objectA scope of labels a triager may put on.
Properties
As kind is kind/bug's: a label's name up to its last `/`.
maxLength: 100
#topic
objectA word for what a repository is about.
Properties
Lowercase letters, digits and dashes, as rust or web-components.
maxLength: 50maxGraphemes: 50
#triager
objectAn account that puts labels of some scopes on pulls and issues. Its labels give way to the owner's and collaborators', whenever they were set; an account named here counts as a triager even if it is a collaborator too.
Similar lexicons
semantic matchLexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.
-
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.
-
dev.knotless.space
spaceA private repository on knotless, keyed by its name, with its owner as its authority. Its members alone read it. The owner's records of the repository are in their repo in the space, as a public repository's are in their public repo, and so are their requests that its runners run its workflows again or cancel them; each member writes their pulls, issues, comments, reactions, labels and assignments in theirs, and a runner its checks, so that what is said of the code is as private as the code. Its
-
dev.knotless.assignment
recordWhom one of a repository's maintainers assigns a pull or an issue to, and asks to review a pull.
-
dev.knotless.label
recordThe labels one account puts on a pull or issue, from those its repository defines.
-
org.tangled.repo.manifest
recordGit repository manifest record. This record is used for git repository discovery like how `org.tangled.actor.profile` is used to find users.