docs(governance): a human may ratify a bounded class of change in advance - #502
Merged
Conversation
…ance §2 draws the authorship asymmetry as a rule about who decides. Read as a rule about when, it forces a false choice: either every instance of a repeating mechanical change waits for a person, or a change is in force with nothing having ratified it. A repeating mechanical change is usually not a decision each time — it is the Nth execution of one decision. New §2.1 states the third case. A human ratifies the class ahead of time in a standing grant naming the exact change permitted, the conditions that must hold on every use, and an end condition. An agent acting inside a ratified class executes a decision rather than takes one, so the record of each instance is the run rather than a fresh decision record. The guarantee is unchanged and is restated where a skimming reader lands: every change in force was ratified by a human — the instance, or the class — and an agent may never author, widen, or ratify the grant it acts under, nor read the absence of an applicable grant as permission. §4 carries the condition the whole construct rests on: a grant's conditions hold only where a guard evaluates them on every use, so a grant whose guard is missing is not in force. §2's table row and §6's summary test are amended in the same pass. 07 §4 and 09 §5 restated the doctrine in a form the new section would contradict, and now point at it: a ratified class needs no per-instance record, while the `author: agent` gate and the default per-instance path are untouched. Signed-off-by: Valerii Korobeinikov <valerii@korobeinikov.consulting>
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
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.
What changed
New §2.1 in
method/08-governance.md— Ratification may precede the change — the standing grant.§2's asymmetry ("an agent may propose; only a human may commit the repository to a decision") is about who decides. Read as a rule about when, it forces a false choice: either every instance of a repeating mechanical change waits for a person, or a change is in force with nothing having ratified it. §2.1 states the third case — a repeating mechanical change is usually not a decision each time, but the Nth execution of one decision, so a human ratifies the class ahead of time in a standing grant that names the exact change permitted, the conditions that must hold on every use, and an end condition. An agent acting inside a ratified class executes a decision rather than taking one, and the record of each instance is the run rather than a fresh decision record.
The guarantee is unchanged, and is restated at every point a skimming reader lands so nobody comes away with a weaker one:
§2's table row for methodology/catalog version upgrades is amended to match.
Two files restated the doctrine in a form §2.1 would contradict, and now point at it instead:
method/09-releases-and-propagation.md§5 — splits into the default per-instance path (unchanged, including thecheck-adl.mjsA3 gate) and landing inside a ratified class, with aMAJORbump or an unmet condition taking the default path.method/07-decisions.md§4 — a ratified class needs no per-instance record; theauthor: agentgate in the table above is untouched, and the grant itself is an ordinary human-authored, human-accepted, immutable record.How it is verified
node scripts/check-notations.mjs— clean (20 view notations; examples, internal links, version pins and notation counts consistent). Two pre-existingSIZE1soft-ceiling warnings on06-team-operations.mdand07-decisions.mdare unchanged: this PR adds one###subsection and no##sections.node scripts/check-adl.mjs— clean.Checklist
main, one concern per PR.git commit -s) — DCO.