Stop naming a second runtime as the condition for a grade to diverge - #654
Merged
Conversation
The sentence said a record had graded differently through the CLI and through MCP "when more than one CommitLore runtime was installed", which reads as a safety condition: install one runtime and this cannot happen. It can. #653 reproduces the divergence from one build, because the index caches the signature status and a signature status is not a property of the repository — it is the verdict of whichever process ran git log, and it depends on the keys that process could reach. Naming the cause rather than the count also gives the reader something to do: comparing a route against --no-index says whether the answer came from a stale cache. The old wording offered no such check, because it pointed at a condition that was not the cause. Limit: only the English README carries this sentence; the three translations do not, so nothing is left inconsistent by correcting it alone Ruled-out: wait for the F-001 branch to avoid a conflict | main states something false about when records can be trusted, and every hour of waiting is an hour of holding it Blast: local Undo: easy Certainty: firm Provenance: authored Record-Id: r-readmecache653 Verified: spec/verify.sh 32 fixtures + README example sync + vocab table; check-readme-numbers matches bench/report.ts; readme-order 18 cases
CommitLore — record lintTrailers: clean — 1 commit in Trailer violations fail this check. Active constraints are informational — they are what the repository already decided, not a verdict on this PR. |
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.
main states something false about when a record's grade can be trusted. Correcting it ahead of the F-001 follow-ups, because waiting means holding the false statement for that long.
The sentence, on main today
That reads as a safety condition. A reader with one runtime installed concludes this cannot happen to them.
Why it is wrong
#653 reproduces the divergence from a single build:
Steps 2 and 3 are the same repository, the same record, the same moment and the same binary. The cause is not how many runtimes are installed — it is that the index caches a signature status, and a signature status is not a property of the repository. It is the verdict of whichever process ran
git log, and it depends on the keys that process could reach.What the replacement does
It moves the cause from the runtime count to the nature of the cache, and it gives the reader a check they can actually run: comparing a route against
--no-indextells them whether they are reading a stale verdict. The old wording offered nothing to do, because it named a condition that was not the cause.Scope
Only the English README carries this sentence — the three translations do not, so correcting it alone leaves nothing inconsistent, and the four-file section-order contracts are untouched.
spec/verify.sh32 fixtures + README example sync + vocab table,check-readme-numbersmatchesbench/report.ts,readme-order18 cases.Provenance
The sentence was added earlier today in #643, in the same PR that corrected four other README claims for overstating what is proven. This is the same class of defect in the same place — a statement stronger than the evidence — found by the finding that came after it.