Skip to content
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.

#DecisionStatus
0001Defaults taken to start Phase 0; append-only decisions logProposed (awaiting Alex); log entries accepted as dated; the decisions log (closed) amended by 0083
0002Engineering 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
0003Chat does not reveal private members by handle (decision 36)Accepted 2026-10-04
0004No false sense of privacy: show what the network can see (decision 37)Accepted 2026-10-04; partly superseded by 0078 for the profile page
0005Atproto Spaces is the destination for private data (decision 38)Accepted 2026-10-04
0006Private likes, comments and follows are shown to their target (decision 39)Accepted 2026-10-04
0007Bootstrap reconciliation: which Phase 0 step changes each bootstrap fileProposed (awaiting Alex)
0008Main-branch ruleset without required approvals (decision 40)Accepted 2026-10-04; merge clause and SE-6 review clause superseded by 0019
0009No branch protection while the repository is private on the free plan (decision 41)Superseded by 0017
0010Opaque chat ids close the key-query membership leak (decision 42)Accepted 2026-10-04
0011No orchestrator until a measured need beyond one host (rule AB-3)Accepted 2026-10-04
0012AGPL-3.0-only for the product, MIT for shared/ (decision 27)Accepted 2026-10-03
0013Identity resolution behind a network port, DNS on c-aresProposed (awaiting Alex)
0014node-postgres as the Postgres driverProposed (awaiting Alex)
0015Web framework glue: Hono with server-rendered React and islands (P1.20 spike)Superseded by 0054
0016The unset.sh design sheet is the design source (P1.21)Superseded by 0055
0017Main ruleset applied; supersedes 0009Accepted 2026-10-06; merge sentence superseded by 0019
0018Edge rate limiting with caddy-ratelimit, in memory only (P1.28)Accepted 2026-10-07 (P1.28, #409)
0019Verified agent merges: a verifier session merges checked agent PRs (P0.15)Accepted on merge (2026-10-12)
0020Permanent 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)
0022web gets its own egress network; we use the shared PLC (P2.05e)Proposed (awaiting Alex)
0023The 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)
0025Public domains: app unset.sh, PDS unset.ac, handles unset.im, chat unset.cc; development staging.unset.*Accepted by Alex 2026-10-19
0026Local-only email-gate exception for alice.unset.im and bob.unset.im (mechanism 2)Proposed (awaiting Alex)
0027PDS frontend distribution replacement with unchanged backend and runtime configuration (P2.24a)Accepted by Alex 2026-10-18; implementation pending
0029Media domain unset.site; development staging.unset.siteProposed (awaiting Alex)
0030Staging behind Pangolin: method scope and last-hop trust move to our edge, cookie and logging clauses of 0025 restatedAccepted by Alex 2026-10-19
0031Staging public through Pangolin, no login, no certificate at our edge; departs from 0025 and 0030 for dev onlyAccepted 2026-10-20; Decision 2 and Decision 1's plain-http sentence superseded by 0032
0032Self-signed certificate at the dev edge behind Pangolin; supersedes 0031 Decision 2 for dev onlyAccepted 2026-10-20
0033Image signing: keyless cosign with our exact workflow identity (P1.27s)Accepted 2026-10-20
0034Docs-only pull requests auto-merge when CI is green (P0.07e)Proposed (awaiting Alex)
0035Web search through our own SearXNG, queried by the server through net-guard (P3.14s)Proposed (awaiting Alex)
0036Staging builds its images from the checkout under --env dev --source; production stays signed and pinned (P1.37y)Accepted 2026-10-28
0037The 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
0038A profile save keeps stored fields the lexicon does not define (P2.20f)Accepted 2026-10-29
0039Sign-in asks only for the scopes a shipped feature uses (P1.31s)Accepted 2026-11-16
0040Index any repo that holds our profile record, with caps and non-member privacy (P3.08d)Accepted 2026-11-16
0041One S3-compatible object store (SeaweedFS in our stacks) for app media and PDS blobs (P2.18s, P2.18p)Accepted 2026-11-15
0042Behind 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
0043The 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
0044A 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
0045The request kit enforces the session gate on routes that require one (P1.04g)Accepted 2026-11-15
0046The edge's checks read Caddy's own adapted config, not our reading of the Caddyfile (P1.39a to P1.39e)Accepted
0047A lock bump the publish run opened merges itself once the lock check is required and green (P2.26n)Accepted 2026-11-16
0048The 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
0049A browser session ends with its token set, enforced by a foreign key with ON DELETE CASCADE (P2.03t)Accepted 2026-11-16
0050The 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
0051The profile is a minimal record plus one card record per card; supersedes parts of 0037 (P2.20m)Accepted 2026-11-17
0052Ingest 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
0053Queue members for the index when their onboarding ends, in idx; supersedes one clause of 0052 (P3.02s)Accepted 2026-11-17
0054The web process runs on SvelteKit with Svelte 5 screens; Hono is removed; supersedes 0015 (P1.20a)Accepted 2026-11-18
0055shadcn-svelte components, themed by one file in the repo; supersedes 0016 (P1.20a)Accepted 2026-11-18
0056In 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
0058Read our PDS's stream with @atproto/sync's parsers, not its Firehose class; supersedes one phrase of 0052 (P3.05s)Accepted 2026-11-17
0059Alex'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
0060pds-admin, the one holder of the PDS admin password, issues member invites (P2.09)Proposed (awaiting Alex)
0062Members choose whether search engines and AI search may show their public page; AI training is blocked site-wide (P3.12s)Proposed (awaiting Alex)
0063Each 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)
0064Handles move from unset.im to unset.name, a DNSSEC-signed domain; supersedes 0025's handle rowsProposed (awaiting Alex)
0065Resend 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)
0066The 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
0067Deactivation, 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
0068Each profile card chooses Filled, Outlined or Plain through an optional surface fieldAccepted 2026-11-20
0069The 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
0070One 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
0071Limits 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
0072The profile chooses its page layout, sidebar or compact, through an optional layout field (P1.21n)Superseded by 0077
0073The 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
0074Text 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)
0075The 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
0076Image 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
0077The profile page has one layout, the header above the cards; the unpublished layout field is removed (P1.21x); supersedes 0072Accepted 2026-11-21
0078The 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
0079Notifications 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
0080Invite 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
0081Notifications 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 3Proposed (awaiting Alex); points 1 and 3, looking writes nothing and the badge counts what is waiting amended by 0085
0082Sign-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
0083Each ADR file is its own record; the index is generated and the 0001 log is closedAccepted 2026-11-21
0084The notes index counts as a docs-only pathProposed (awaiting Alex)
0085The bell's count clears once this browser has seen the listAccepted 2026-11-21
0086A card holds one reusable block, and the profile lists its cards by addressProposed (awaiting Alex)
0087One Lucide icon draws the editor's drag handleProposed (awaiting Alex)
0088A picture's main version is a WebP of up to 4,096 px and 5,000,000 bytesProposed (awaiting Alex)
0090Seen once is seen on the whole account, except a sign-in alertProposed (awaiting Alex)
0091A page record holds the card list, and the profile is the account's identityProposed (awaiting Alex)
0092The chat Synapse image runs on distroless PythonAccepted 2026-11-21
0111Human docs are gathered in one docs repository, and docs.unset.sh is GitHub Pages built from itProposed (awaiting Alex)