Skip to content

[Docs] DIRIGO.md: record the one code change on the branch - #22

Merged
rwkeyes merged 1 commit into
dirigo/0.2.12-verifiedfrom
docs/dirigo-invariant
Nov 15, 2026
Merged

rwkeyes merged 1 commit into
dirigo/0.2.12-verifiedfrom
docs/dirigo-invariant

Conversation

@rwkeyes

@rwkeyes rwkeyes commented Nov 15, 2026

Copy link
Copy Markdown
Owner

Problem

DIRIGO.md told readers that every commit after the snapshot 9fd4e15d is documentation and that serve/ is
byte-identical. Merging PR #16 (b906f0b5) made that false: three files under serve/ changed. A page that justifies
its own trustworthiness with a checkable invariant must not keep a stale one.

Result

The sentence now names the single exception, its commit, and the three files; says why it does not change behaviour (the
launcher sets CONV_ROUTE_BATCH_AFTER=4, the resolver returns 4 for it, so the serving tree and the branch agree); and
prints the command that reproduces the whole difference:

git diff 9fd4e15d..HEAD -- serve/        # 3 files, 38 insertions, 4 deletions

Validation

  • git diff --shortstat 9fd4e15d..HEAD -- serve/ → 3 files changed, 38 insertions(+), 4 deletions(-), matching the
    text.
  • git diff --name-only 9fd4e15d..HEAD -- src include sycl metal setup.py CMakeLists.txt → 0 files, so "every other
    path is still byte-identical" is true as written.
  • grep -rn 'documentation only\|byte-identical' over the branch → DIRIGO.md was the only page making the claim.

Limits

  • The deployed tree is still the 0.2.12 tree on vega, not this branch; the patch has never run in production. That is
    stated on the page rather than implied.

… none

DIRIGO.md said commits after snapshot 9fd4e15 "change documentation only
and leave ... serve/ ... byte-identical". b906f0b (PR #16) broke that
with three files under serve/, so the sentence is now false and the page
has to say what actually happened.

The replacement names the exception, gives its commit, states the three
files, and explains why it does not move behaviour: the launcher sets
CONV_ROUTE_BATCH_AFTER=4 and the resolver returns 4 for it, so the tree
that served :8095 and this branch behave the same. It also gives the one
command that reproduces the difference, because a claim you cannot check
is the thing that went wrong here.

Verified: git diff --shortstat 9fd4e15..HEAD -- serve/ = 3 files, 38
insertions, 4 deletions; src, include, sycl, metal, setup.py and
CMakeLists.txt still show zero changes. No other page made the claim.
@rwkeyes
rwkeyes merged commit 83567e3 into dirigo/0.2.12-verified Nov 15, 2026
3 checks passed
@rwkeyes
rwkeyes deleted the docs/dirigo-invariant branch November 15, 2026 12:19
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