Skip to content

Commit cbb1b13

Browse files
book/glossary: add Capability entry
The glossary covered every other major concept (Pile, Repository, Trible, etc.) but didn't define Capability — the entire auth arc's central abstraction. Reader has to flip to the chapter to learn what the term even means. Add a 6-line entry between Blob Store and Checkout (alphabetical slot) covering: - The two-blob shape (cap + sig) - The chain-of-trust verification model - The OP_AUTH presentation pattern - Cross-link to the capability-auth chapter for depth mdbook build is clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 1323c5f commit cbb1b13

1 file changed

Lines changed: 11 additions & 0 deletions

File tree

book/src/glossary.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -28,6 +28,17 @@ An abstraction that persists blobs. Implementations back local piles, in-memory
2828
workspaces, or remote object stores while presenting a common `BlobStore`
2929
interface that handles hashing, deduplication, and retrieval.
3030

31+
### Capability
32+
A signed authorisation to act with a specific scope on a triblespace network.
33+
Each capability is two `SimpleArchive` blobs: a `cap` blob carrying
34+
`cap_subject` (the pubkey it authorises), `cap_issuer`, `cap_scope_root`, and
35+
`metadata::expires_at`; and a `sig` blob whose `sig_signs` points at the cap
36+
blob's handle and carries the issuer's `signed_by` + `signature_r/s`. Caps chain
37+
off the team root (or off another cap with admin scope) and verify by walking
38+
back to the configured `team_root`. Holders present the sig blob's handle on
39+
connection (`OP_AUTH`); the relay enforces the verified scope on every
40+
subsequent op. See the [Capability Auth](capability-auth.md) chapter.
41+
3142
### Checkout
3243
The result of `Workspace::checkout`. A `Checkout` pairs a `TribleSet` with the
3344
`CommitSet` that produced it. It derefs to `TribleSet` for querying and its

0 commit comments

Comments
 (0)