docs(planning): five architecture decision documents - #1319
Merged
Conversation
3 tasks
joepio
marked this pull request as ready for review
September 1, 2026 19:39
Add RFC-style decision documents, each with a "Decision needed by maintainer" box and consequences for open PRs: - runtime-boundary-decision.md: Rust decides, TS displays; twins only for pure fixtured functions; first AtomicNode slice. - authority-unit-decision.md: drive stays the identity/replication unit; additive zone chain is the rights unit; what #1254 must change. - commit-retention-floor-decision.md: envelope-on-resource floor; sequence #1274 -> #1313 -> #1254. - trust-model-decision.md: the node that owns the URL is trusted with plaintext; anything that only stores is blind. - schema-routes-decision.md: did:ad:frozen is the on-ramp; optional schema is policy; defaults fingerprint closes the repopulate gap. Index them under "Decisions pending" in planning/README.md. Claude-Session: https://claude.ai/code/session_019asLKBrBWY5ovyeCgtmdSd
All five RFCs accepted 2026-09-01. Status boxes record the outcome, the README table is renamed to "Decisions", and encryption.md is closed to "at-rest + vault" with an explicit reopen test. Claude-Session: https://claude.ai/code/session_019asLKBrBWY5ovyeCgtmdSd
joepio
force-pushed
the
docs/architecture-decisions
branch
from
September 1, 2026 20:05
d9cac3d to
47f9ceb
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Docs-only. Adds five RFC-style decision documents to
planning/, each ≤250 lines, opening with a decision box and closing with Consequences for open PRs. Indexed under a "Decisions" table inplanning/README.md.All five RFCs were accepted on 2026-09-01. Each document's status line records the outcome;
planning/encryption.mdis closed to "at-rest + vault" with an explicit reopen test.runtime-boundary-decision.mdAtomicNodeinlib/src/runtime/is the binding runtime; #1277 and #1241 must bind it, no parallelsimple.rs/ffi/surface. First slice onfeat/atomic-node-slice.authority-unit-decision.mdcollect_zone_subjects, and keep the zone chain hybrid/additive.commit-retention-floor-decision.mdTree::Envelopesexists; sequence #1274 → #1313 → #1254.trust-model-decision.mdencryption.mdclosed to at-rest + vault.schema-routes-decision.mdfix/defaults-bootstrap-gate.Every code claim cites a file path and was checked against
developor the PR branch; unverifiable points are marked as such in the documents.https://claude.ai/code/session_019asLKBrBWY5ovyeCgtmdSd