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
Kindrecord
Record keyany
Authorityknotless.dev
Commit rev3n2b4g2utmkdl
Indexed

Showing version bafyreid3pfi3h5gzneiyaegxlzxfawluvmtwdcworbv5rdq6i33eb44wpi. Show the latest

Record

record · key any

Properties

agents

array

Accounts, 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
itemsref
Reference

Deprecated, 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
itemsref
Reference

archivedAt

string · datetime

When 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.

Accounts that may push. They push through a gateway the owner has delegated writes to, which checks this list.

  • maxLength: 1000
itemsref
Reference

createdAt

requiredstring · datetime

The branch HEAD points at, without refs/heads/.

  • maxLength: 255
  • maxLength: 3000
  • maxGraphemes: 300

The repository this one was forked from.

gateway

string · did

A gateway the owner has delegated writes to. Collaborators push and commit through it; it batches concurrent commits to a branch into one write.

key

requiredstring · tid

Minted when the repository is created; never reused. The `repo` of its dev.knotless.ref, dev.knotless.claim and dev.knotless.pack records.

labels

array

The 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
itemsref
Reference

name

requiredstring

Equal to the record key.

  • maxLength: 100

publicizedFrom

string · at-uri

The dev.knotless.space space this repository was private in, before its owner made it public under the same key. A record naming one of that space's records in full names the record of the same author, collection and key in its author's account, where each member moves theirs from the space.

readers

array

For 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
itemsref
Reference

rules

array

Protected branches. The gateway holds collaborators to them; the owner, who writes these records directly, is held only by their own client.

  • maxLength: 100
itemsref
Reference

runners

array

Accounts 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
itemsref
Reference

topics

array

What the repository is about, as rust or atproto, in display order. Readers list repositories by them.

  • maxLength: 20
itemsref
Reference

Where 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.

Accounts, such as a triage bot, whose dev.knotless.label records readers honor for the scopes named, and below anyone's who labels as the owner or a collaborator.

  • maxLength: 32
itemsref
Reference

#agent

object

An account whose pulls are checked as they move, as code no one vouches for.

Properties

did

requiredstring · did

#appview

object

An appview the owner lets keep an index of a private repository.

Properties

did

requiredstring · did

The appview's service DID, as did:web:knotless.dev.

#collaborator

object

An account that may push to the repository.

Properties

did

requiredstring · did

#gate

object

An account a protected branch's pulls wait for a review from.

Properties

did

requiredstring · did

#label

object

A label pulls and issues may carry.

Properties

color

string

A hex color, as #d73a4a.

  • maxLength: 7

What the label means, for those who put it on.

  • maxLength: 1000
  • maxGraphemes: 200

exclusive

boolean

At most one of its scope's exclusive labels stands at a time, as priority/high and priority/low: setting one takes the others off.

name

requiredstring

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: 100
  • maxGraphemes: 50

#reader

object

An account a private repository is shared with to read.

Properties

did

requiredstring · did

#reviews

object

The 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

integer

How many approvals the pull needs, from accounts other than its author. Absent is 0.

  • minimum: 0
  • maximum: 10

codeOwners

boolean

Each path the pull changes that the CODEOWNERS file on the target branch gives owners needs an approval from one of them. Absent is false.

Only 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

array

Accounts, 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
itemsref
Reference

#rule

object

A 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

branch

requiredstring

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: 64
  • knownValues: linear | merges

queue

boolean

Pulls 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.

The reviews a pull needs before it merges into this branch. Absent, none.

Reference

#runner

object

An account whose dev.knotless.check records about the repository readers trust.

Properties

did

requiredstring · did

#scope

object

A scope of labels a triager may put on.

Properties

name

requiredstring

As kind is kind/bug's: a label's name up to its last `/`.

  • maxLength: 100

#topic

object

A word for what a repository is about.

Properties

name

requiredstring

Lowercase letters, digits and dashes, as rust or web-components.

  • maxLength: 50
  • maxGraphemes: 50

#triager

object

An 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.

Properties

did

requiredstring · did

scopes

array

The scopes of the labels it may put on. None, when absent.

  • maxLength: 50
itemsref
Reference

Similar lexicons

semantic match

Lexicons 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.

  • A 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

  • Whom one of a repository's maintainers assigns a pull or an issue to, and asks to review a pull.

  • Git repository manifest record. This record is used for git repository discovery like how `org.tangled.actor.profile` is used to find users.