git-ents.gitmain
⌘K
foforge
commit 9033f6c
spec: finish the Advance-ref rename in gate and meta-ref normative text

The phase-3 rename commit updated code and prose docs but missed the two normative spec statements that name the trailer.

Assisted-by: Claude:claude-fable-5

Joseph D. Carpinelli · 1 month ago

Reviews

No reviews of this commit yet — record a verdict below.

Start a review

verdict

docs/spec/gate.adoc @@ -21,7 +21,7 @@ [role="requirement", id="gate.refname-binding"] .Refname Binding -- -The commit's `Ents-Ref:` trailer MUST match the refname being updated. +The commit's `Advance-ref:` trailer MUST match the refname being updated. Without this check a signed commit could be replayed as the tip of a different meta-ref than the one its author signed for. --
docs/spec/meta-ref.adoc @@ -79,7 +79,7 @@ Ref-level metadata that is not entity content MUST live in the mutation commit's trailers, never inside the tree (<<meta-ref.typed-tree>>). Two trailers are reserved: `Schema-Version:`, for explicit encoding -detection if it is ever needed, and `Ents-Ref:`, for binding the commit +detection if it is ever needed, and `Advance-ref:`, for binding the commit to the refname it was authored for. --