Decisions
Decisions
Decisions that are expensive to reverse are ADRs, one file each in docs/human/decisions/. Accepted records stay as written. The files are not rendered on this site.
Each ADR records its own status, acceptance and supersession in front matter (ADR 0083), so this table is built from the files each time the site is built; npm run adr:index prints the same table. The folder’s README explains the format.
| # | Decision | Status |
|---|---|---|
| 0001 | Defaults taken to start Phase 0; append-only decisions log | Proposed (awaiting Alex); log entries accepted as dated; the decisions log (closed) amended by 0083 |
| 0002 | Engineering rules from the reading list (decision 35) | Accepted 2026-10-04; D7 partly superseded by 0078 for the profile page; D8's ADR 0001 log clause superseded by 0083 |
| 0003 | Chat does not reveal private members by handle (decision 36) | Accepted 2026-10-04 |
| 0004 | No false sense of privacy: show what the network can see (decision 37) | Accepted 2026-10-04; partly superseded by 0078 for the profile page |
| 0005 | Atproto Spaces is the destination for private data (decision 38) | Accepted 2026-10-04 |
| 0006 | Private likes, comments and follows are shown to their target (decision 39) | Accepted 2026-10-04 |
| 0007 | Bootstrap reconciliation: which Phase 0 step changes each bootstrap file | Proposed (awaiting Alex) |
| 0008 | Main-branch ruleset without required approvals (decision 40) | Accepted 2026-10-04; merge clause and SE-6 review clause superseded by 0019 |
| 0009 | No branch protection while the repository is private on the free plan (decision 41) | Superseded by 0017 |
| 0010 | Opaque chat ids close the key-query membership leak (decision 42) | Accepted 2026-10-04 |
| 0011 | No orchestrator until a measured need beyond one host (rule AB-3) | Accepted 2026-10-04 |
| 0012 | AGPL-3.0-only for the product, MIT for shared/ (decision 27) | Accepted 2026-10-03 |
| 0013 | Identity resolution behind a network port, DNS on c-ares | Proposed (awaiting Alex) |
| 0014 | node-postgres as the Postgres driver | Proposed (awaiting Alex) |
| 0015 | Web framework glue: Hono with server-rendered React and islands (P1.20 spike) | Superseded by 0054 |
| 0016 | The unset.sh design sheet is the design source (P1.21) | Superseded by 0055 |
| 0017 | Main ruleset applied; supersedes 0009 | Accepted 2026-10-06; merge sentence superseded by 0019 |
| 0018 | Edge rate limiting with caddy-ratelimit, in memory only (P1.28) | Accepted 2026-10-07 (P1.28, #409) |
| 0019 | Verified agent merges: a verifier session merges checked agent PRs (P0.15) | Accepted on merge (2026-10-12) |
| 0020 | Permanent choices: Matrix server name, Tailnet Lock custody, permission set NSID (P1.32) | Superseded by 0025 |
| 0021 | @atproto/oauth-client-node as the OAuth client (P2.04) | Proposed (awaiting Alex) |
| 0022 | web gets its own egress network; we use the shared PLC (P2.05e) | Proposed (awaiting Alex) |
| 0023 | The local PDS publishes to the shared PLC, with a few fixed test accounts (P1.34t) | Proposed (awaiting Alex) |
| 0024 | @atproto/api Agent as the XRPC client over an OAuth session (P2.07) | Proposed (awaiting Alex) |
| 0025 | Public domains: app unset.sh, PDS unset.ac, handles unset.im, chat unset.cc; development staging.unset.* | Accepted by Alex 2026-10-19 |
| 0026 | Local-only email-gate exception for alice.unset.im and bob.unset.im (mechanism 2) | Proposed (awaiting Alex) |
| 0027 | PDS frontend distribution replacement with unchanged backend and runtime configuration (P2.24a) | Accepted by Alex 2026-10-18; implementation pending |
| 0029 | Media domain unset.site; development staging.unset.site | Proposed (awaiting Alex) |
| 0030 | Staging behind Pangolin: method scope and last-hop trust move to our edge, cookie and logging clauses of 0025 restated | Accepted by Alex 2026-10-19 |
| 0031 | Staging public through Pangolin, no login, no certificate at our edge; departs from 0025 and 0030 for dev only | Accepted 2026-10-20; Decision 2 and Decision 1's plain-http sentence superseded by 0032 |
| 0032 | Self-signed certificate at the dev edge behind Pangolin; supersedes 0031 Decision 2 for dev only | Accepted 2026-10-20 |
| 0033 | Image signing: keyless cosign with our exact workflow identity (P1.27s) | Accepted 2026-10-20 |
| 0034 | Docs-only pull requests auto-merge when CI is green (P0.07e) | Proposed (awaiting Alex) |
| 0035 | Web search through our own SearXNG, queried by the server through net-guard (P3.14s) | Proposed (awaiting Alex) |
| 0036 | Staging builds its images from the checkout under --env dev --source; production stays signed and pinned (P1.37y) | Accepted 2026-10-28 |
| 0037 | The profile is its own module, stored on the member's PDS, edited by its owner (P2.20) | Accepted 2026-10-28; Decision 2's strict-validator clause superseded by 0038; decisions 4, 5, 8 and the README half of 7 superseded by 0051 |
| 0038 | A profile save keeps stored fields the lexicon does not define (P2.20f) | Accepted 2026-10-29 |
| 0039 | Sign-in asks only for the scopes a shipped feature uses (P1.31s) | Accepted 2026-11-16 |
| 0040 | Index any repo that holds our profile record, with caps and non-member privacy (P3.08d) | Accepted 2026-11-16 |
| 0041 | One S3-compatible object store (SeaweedFS in our stacks) for app media and PDS blobs (P2.18s, P2.18p) | Accepted 2026-11-15 |
| 0042 | Behind the edge, the app's rate limits are site-wide ceilings; the edge is the only per-client limiter (P1.06s) | Accepted 2026-11-15 |
| 0043 | The audit side row names its actor in a DID column, so erasure finds a person's rows as actor as well as subject (P1.15k) | Accepted 2026-11-15 |
| 0044 | A trusted-path change carries the security-review label and is reviewed at its exact head; the trusted-base split and its guards are retired; five template headings (P0.09c) | Accepted 2026-11-15 |
| 0045 | The request kit enforces the session gate on routes that require one (P1.04g) | Accepted 2026-11-15 |
| 0046 | The edge's checks read Caddy's own adapted config, not our reading of the Caddyfile (P1.39a to P1.39e) | Accepted |
| 0047 | A lock bump the publish run opened merges itself once the lock check is required and green (P2.26n) | Accepted 2026-11-16 |
| 0048 | The session row records the sign-in server's origin, so account pages stop unsealing the token set for a link (P2.03n) | Accepted 2026-11-15 |
| 0049 | A browser session ends with its token set, enforced by a foreign key with ON DELETE CASCADE (P2.03t) | Accepted 2026-11-16 |
| 0050 | The object store's buckets and clean-up run through its own shell; no S3 admin key; supersedes two clauses of 0041 (P2.18s) | Accepted 2026-11-16 |
| 0051 | The profile is a minimal record plus one card record per card; supersedes parts of 0037 (P2.20m) | Accepted 2026-11-17 |
| 0052 | Ingest our own PDS with @atproto/sync, not Tap, for the first indexer slice (P3.05s) | Accepted 2026-11-17; decision 3's queue clause superseded by 0053, decision 1's Firehose phrase by 0058 |
| 0053 | Queue members for the index when their onboarding ends, in idx; supersedes one clause of 0052 (P3.02s) | Accepted 2026-11-17 |
| 0054 | The web process runs on SvelteKit with Svelte 5 screens; Hono is removed; supersedes 0015 (P1.20a) | Accepted 2026-11-18 |
| 0055 | shadcn-svelte components, themed by one file in the repo; supersedes 0016 (P1.20a) | Accepted 2026-11-18 |
| 0056 | In the web process the UI/server boundary is by file kind, checked; the request gate is server.ts plus the hook (P1.20a) | Accepted 2026-11-18 |
| 0057 | "Small and auditable" means our own code; a package meeting a written bar needs no ADR unless it touches auth, crypto, egress or personal data; amends DO-1 (P0.09) | Accepted 2026-11-17 |
| 0058 | Read our PDS's stream with @atproto/sync's parsers, not its Firehose class; supersedes one phrase of 0052 (P3.05s) | Accepted 2026-11-17 |
| 0059 | Alex's typed line only for security loosenings and ADRs; grouped Renovate updates; drafts run the cheap checks; merges tested on main's tip; amends 0019 (P0.07l) | Accepted 2026-11-18 |
| 0060 | pds-admin, the one holder of the PDS admin password, issues member invites (P2.09) | Proposed (awaiting Alex) |
| 0062 | Members choose whether search engines and AI search may show their public page; AI training is blocked site-wide (P3.12s) | Proposed (awaiting Alex) |
| 0063 | Each member's handle record is written to DNS when they claim it, in zones at deSEC (unset.name and staging.unset.name); supersedes 0025's hand-added staging records (P3.08s) | Proposed (awaiting Alex) |
| 0064 | Handles move from unset.im to unset.name, a DNSSEC-signed domain; supersedes 0025's handle rows | Proposed (awaiting Alex) |
| 0065 | Resend sends account mail for now, with its data in the United States; drops answer 21's Canada or EU hosting (P2.25) | Proposed (awaiting Alex) |
| 0066 | The edge's app_burst zone allows 60 requests per 10 seconds per address; supersedes 0031's value 20 and two sizing statements of 0042 (P1.20r) | Accepted 2026-11-20 |
| 0067 | Deactivation, deletion after 30 days, takedown and moving away follow atproto's account model; no PLC tombstone by default; every hosted name is burned (P1.21e) | Accepted 2026-11-20 |
| 0068 | Each profile card chooses Filled, Outlined or Plain through an optional surface field | Accepted 2026-11-20 |
| 0069 | The web client is split into content-hashed pieces, and the dev app edge counts them in their own zone, app_files; supersedes "no matcher" for app_burst in 0031 and 0066 (P1.21g) | Accepted 2026-11-20 |
| 0070 | One shared image foundation: images are blobs in the member's repository, each use carries its alt text; intake, processing in its own no-network process, an empty inspection port, storage and publish; uploads with nothing mounted only on a closed list of test origins (P2.17) | Accepted 2026-11-20 |
| 0071 | Limits sized for thousands of members; web marks its own PDS calls with a key so the edge gives them their own zones; app_signin counts only the login and join posts (P1.21j) | Accepted 2026-11-20 |
| 0072 | The profile chooses its page layout, sidebar or compact, through an optional layout field (P1.21n) | Superseded by 0077 |
| 0073 | The Text card is written in a Milkdown editor over the plain field, loaded on open; the CSP adds the one Trusted Types name ProseMirrorClipboard (P1.21u) | Accepted 2026-11-20 |
| 0074 | Text cards are edited in place on the owner's page and saved together by one Save, all or none, through applyWrites on the repo head; drafts stay on the device (P1.21v) | Proposed (awaiting Alex) |
| 0075 | The docs site at docs.unset.sh is a third site on the staging edge, served as files from the checkout with its own CSP and zone (P1.21w) | Accepted 2026-11-20 |
| 0076 | Image uploads up to 64 MiB and 110 megapixels; web, net-guard and review caps, memory and the edge's read window rise with it (P2.19e) | Accepted 2026-11-20 |
| 0077 | The profile page has one layout, the header above the cards; the unpublished layout field is removed (P1.21x); supersedes 0072 | Accepted 2026-11-21 |
| 0078 | The member chooses who sees their page: Public, Signed-in members only or Only me; others get a limited page; partly supersedes 0004 and D7 for the profile page (P1.22a) | Accepted 2026-11-21 |
| 0079 | Notifications are a core inbox: one send call, one reason table, gone once opened and at 30 days, a sign-in entry only older browsers can clear, and the contract a module will get (P2.27) | Accepted 2026-11-21; point 3 amended by 0081 |
| 0080 | Invite requests: web mails the owner each visitor's address over SMTP, keeps no copy, limits by address and site-wide (P2.10r) | Accepted 2026-11-21 |
| 0081 | Notifications stay until dismissed: looking changes nothing; dismiss one, the selected or all; the full-window page with a list beside the detail (P2.27b); amends 0079 point 3 | Proposed (awaiting Alex); points 1 and 3, looking writes nothing and the badge counts what is waiting amended by 0085 |
| 0082 | Sign-in history: the time of each sign-in only, kept 30 days, any entry deletable by the member, a second check later (P2.27c, P2.28) | Accepted 2026-11-21 |
| 0083 | Each ADR file is its own record; the index is generated and the 0001 log is closed | Accepted 2026-11-21 |
| 0084 | The notes index counts as a docs-only path | Proposed (awaiting Alex) |
| 0085 | The bell's count clears once this browser has seen the list | Accepted 2026-11-21 |
| 0086 | A card holds one reusable block, and the profile lists its cards by address | Proposed (awaiting Alex) |
| 0087 | One Lucide icon draws the editor's drag handle | Proposed (awaiting Alex) |
| 0088 | A picture's main version is a WebP of up to 4,096 px and 5,000,000 bytes | Proposed (awaiting Alex) |
| 0090 | Seen once is seen on the whole account, except a sign-in alert | Proposed (awaiting Alex) |
| 0091 | A page record holds the card list, and the profile is the account's identity | Proposed (awaiting Alex) |
| 0092 | The chat Synapse image runs on distroless Python | Accepted 2026-11-21 |
| 0111 | Human docs are gathered in one docs repository, and docs.unset.sh is GitHub Pages built from it | Proposed (awaiting Alex) |