Skip to content
quarry Artifact [1358cb99f2]
Login

Artifact [1358cb99f2]

Artifact 1358cb99f2bb3d8dece4472595b8554e39386d0aa37490c0b6c218c932b78d4e:


# quarry RFCs

Numbers are stable: code comments cite them by number, so an RFC is
amended in place rather than replaced, and a retired one keeps its number
in history. Status lines in each file are kept true; this page is the map.

## The spec

| RFC | What | Status |
|---|---|---|
| [0001](0001-quarry-forge.md) | quarry itself: a forge for zit that holds no hostage bytes | Living spec; single-node scope implemented |
| [0005](0005-event-vocabulary.md) | one named event stream that pipelines, webhooks and notifications subscribe to | Implemented |
| [0003](0003-implementation-plan.md) | how it was built: technology choices, salvage and provenance rules (§8, formerly RFC 0002), status as built | Historical; §2 and §8 remain in force |

## Authorization

| RFC | What | Status |
|---|---|---|
| [0004](0004-fossil-capability-compat.md) | fossil capability letters as the native model; a hosted fossil repository brings its users with it | Implemented |
| [0008](0008-roles.md) | roles as the interface over the letters; next amendment: the steward role, so hosting a repository is not owning it | Implemented; amendment pending |
| [0017](0017-write-tiers.md) | the bar for a write scales with how permanent the write is: a companion or the local tier may ask less than the store. Amends 0015 | Draft, questions settled; implemented after teams |
| [0018](0018-teams.md) | teams: a user-owned place that holds repositories, carries grants, and gathers their chat and tickets. 0008's deferred team layer | Draft; four of five features built, two amendments (see its status line). Ticket board outstanding; the room does not stream (82b9615eaf3d) |

## Landings

`docs/landings.md` is the base: a landing is a reading of forum posts.

| RFC | What | Status |
|---|---|---|
| [0006](0006-strata.md) | stacked landings, rendered as a chain | Implemented |
| [0007](0007-protected-branches.md) | branch ownership enforced at the sync front | Implemented |
| [0009](0009-ci.md) | verdicts on landings: dagnats runs, checks, logs, premerge | In progress (see its status line) |
| [0019](0019-workflows.md) | CI files a person writes in five minutes: Actions-shaped YAML in `ci/`, `on:` filters, environments whose secrets only reviewed code can reach. Amends 0009 | Draft, questions settled; not built |

## Attention and what arrives

| RFC | What | Status |
|---|---|---|
| [0011](0011-attention.md) | chat that never loses a message, mentions, the inbox, push; notify owns transport, quarry owns policy | Implemented; its live model does not yet reach four surfaces (82b9615eaf3d) |
| [0012](0012-attention-plan.md) | 0011's delivery plan in five phases | Implemented; kept because code cites its phases |
| [0014](0014-inbound.md) | what may write to a forge from outside: reply-by-email first, source keys and external CI later | Phase 1 implemented |
| [0015](0015-companions.md) | a repository's forum in a separate fossil-compatible store, bound by the forge | Phase 1 implemented |
| [0016](0016-attachments.md) | files on tickets, wiki, technotes and forum posts: fossil's A card in the DAG, the bytes in the steward's own bucket | Draft |

## Standalone

| RFC | What | Status |
|---|---|---|
| [0010](0010-local-mode.md) | `quarry ui`: one repository, one browser, no accounts | Draft, not built |
| [0013](0013-activity-profile.md) | who touched what, when: the activity page | Implemented |

## Retired

- **0002 — Forgejo salvage plan.** The page inventory was delivered; the
  rules that outlive it (three modes of take, the provenance ledger, the
  resolver seam, the per-page definition of done) moved to 0003 §8. The
  document itself is in history at every check-in before 2026-09-10.