Skip to content

Amend Constitution §3: scope the compile-time capability claim - #13

Merged
MatejGomboc merged 1 commit into
mainfrom
docs/constitution-3-compile-time-claim
Aug 1, 2026
Merged

Amend Constitution §3: scope the compile-time capability claim#13
MatejGomboc merged 1 commit into
mainfrom
docs/constitution-3-compile-time-claim

Conversation

@MatejGomboc

Copy link
Copy Markdown
Member

What

Takes the reword the 2026-07-30 prior-art review recommended for Constitution §3 — exactly as flagged in docs/CHANGELOG.md, now on the maintainer's authorisation.

Before:

Rust's ownership and move semantics model capability transfer at compile time.

After:

Rust's ownership and move semantics model the kernel's own capability handling at compile time — no accidental duplication or use-after-move; cross-process transfer is a runtime table operation the generation scheme secures.

Why

The old sentence was true of one thing and false of another. True: inside the kernel, the no-Clone Capability makes duplication and use-after-move compiler-checked properties (PR #12 proves it with a compile_fail test). False: what a process observes when authority transfers is a runtime table operation — the borrow checker sees one compilation unit and cannot span protection domains (RedLeaf's group reached the same conclusion for ownership types generally). Our own generation counters exist precisely because runtime checks are what hold that boundary.

The constitution had become the last place in the repository making the unscoped claim — RFC-0003's amendment, the research note and the capability crate's docs all already state the scoped version. In a project whose law demands every line be explainable (§5.2), a slogan the maintainer would have to walk back when explaining it does not belong in the doctrine list.

Scope

  • CONSTITUTION.md §3 — the one sentence, reworded as flagged
  • docs/CHANGELOG.md — the amendment logged, as constitutional amendments always are, however small
  • RFC-0003 §6 and the research note still quote the old sentence, deliberately unedited — they are the historical record of what was reviewed

Markdown and British-spelling gates clean.

🤖 Generated with Claude Code

On the maintainer's authorisation, taking the reword the 2026-07-30
prior-art review recommended, exactly as flagged in docs/CHANGELOG.md.

The kernel-doctrine slogan said Rust's ownership and move semantics
"model capability transfer at compile time". That is true of the
kernel's internal handling - the no-Clone Capability makes duplication
and use-after-move compiler-checked properties - and false of the
userspace-observable cross-process transfer, which is a runtime table
operation the generation scheme secures. The borrow checker sees one
compilation unit and cannot span protection domains; RedLeaf's group
reached the same conclusion for ownership types generally, and our own
generation counters exist precisely because runtime checks hold that
boundary.

The constitution had become the last place in the repository making
the unscoped claim: RFC-0003's amendment, the research note and the
capability crate's documentation all already state the scoped version.
RFC-0003 SS6 and the research note still quote the old sentence,
deliberately unedited, as the historical record of what was reviewed.

Logged in docs/CHANGELOG.md, as constitutional amendments always are.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@MatejGomboc
MatejGomboc merged commit a604de0 into main Aug 1, 2026
6 checks passed
@MatejGomboc
MatejGomboc deleted the docs/constitution-3-compile-time-claim branch August 1, 2026 08:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant