Lexicon Garden

dev.knotless.ref

Keyed `<repo key>.<ref hash>`, where the hash is the first 26 characters of the lowercase unpadded base32 SHA-256 of `name`. Written only in the same applyWrites as the dev.knotless.claim for its current generation.

Repository @lexicons.knotless.dev did:plc:yqsg7znbbhfmj3a2nrpnaerk namespace authority
Details · record, key any
Kindrecord
Record keyany
Authorityknotless.dev
Indexed
Compare Edit in builder → Fork →

Record

record · key any

Properties

createdAt

string · datetime

When the ref was made: the same as updatedAt until it first moves.

generation

requiredinteger

Goes up by one each time the ref moves. A new ref starts at the time in milliseconds since the epoch, past any generation an earlier ref of the same name reached; records written before 0.6 started at 1.

  • minimum: 1

name

requiredstring

The full ref name, such as refs/heads/main.

  • maxLength: 1024

pack

string · record-key

The record key of the dev.knotless.pack holding `target`, as the move that set it knew: the pack that move wrote, or the one another ref at the same commit named. A fetch reads it rather than walking the packs. A compaction folds packs into a new one without moving refs, so a reader finding it gone walks the packs instead.

pusher

string · did

The account that last moved the ref, when not the repository's owner: a collaborator or runner pushing through the gateway, which sets it from the caller's verified service token. Readers credit it only while the repository names it among its collaborators or runners.

repo

requiredstring · tid

The `key` of the dev.knotless.repo this ref belongs to.

target

string

The hex object ID the ref points at. Absent only from a record a client before 0.6 left of a deleted ref; a delete now deletes the record.

  • minLength: 40
  • maxLength: 64

updatedAt

requiredstring · datetime

When the ref last moved.

Similar lexicons

semantic match

Lexicons whose schemas describe something close to this one. Check them before publishing a new one that overlaps.

  • dev.knotless.claim

    record

    The move of a ref off one generation: its key is the compare-and-swap, its body the reflog entry.

  • tech.lenooby09.didgit.ref

    record

    A did-git ref stored in an AT Protocol repository. Each record maps a repository name and ref name (e.g. refs/heads/main) to the hex SHA-256 object ID it points to.

  • dev.knotless.pack

    record

    A self-contained git packfile: every object reachable from `tips` and not from `bases`.

  • org.tangled.git.refs

    record

  • org.tangled.repo.declaration

    record

    Git repository declaration. Record is owned by the repository owner and record-key is slug of the git repository.