Skip to content

Write the role word out of this board's two tracked files - #308

Merged
iderex merged 1 commit into
mainfrom
role-word-out-of-the-tree-306
Sep 5, 2026
Merged

iderex merged 1 commit into
mainfrom
role-word-out-of-the-tree-306

Conversation

@iderex

@iderex iderex commented Sep 5, 2026

Copy link
Copy Markdown
Contributor

The issue this belongs to

Closes #306

What changed

Five sentences in two tracked files stop describing me from outside.

Four of them are justification fields in security/statements.json. Three said
this repository has one person in the role word's shape; each is now a first-person
sentence, because each is about this account and about nothing else. The fourth is
the OSS-Fuzz entry, where the plural is about somebody who could be paged rather
than about me, so it takes a neutral noun and stays a statement about what
onboarding needs.

The fifth is FIXTURE_FINDING in .github/statements/statements.sh, where the
word sat inside a filler value in a fixture document.

No disposition moves. The document's updated date is deliberately left at
2026-09-02, because nothing here re-examined whether a dismissal still holds, and
bumping it would say that something did.

I read every one of the five in the diff before committing, one line at a time.

What failure it prevents

The fleet's write gate refuses the role word in every text posted to GitHub. While
the word stands in the tree, a quotation of either file in an issue or a pull
request body cannot reproduce what the file says - the quote is refused, or it is
posted altered and then no longer matches its source. op#1789 is the parent that
measured that across the fleet and found the trees are where the word now lives;
this is that repair for this board.

Evidence

The role word is elided in the commands below the way the issue elides it, because
a body carrying the literal is refused by the gate this change exists for. The word
is the one the gate names when it refuses.

At the commit being pushed, 40d38fbc1d33de91ebc4a364bcea93a305e7383d, whole-word
and case-insensitive over the tracked set:

$ git grep -il -w <the role word> HEAD -- . | wc -l
0
$ echo "grep-exit=${PIPESTATUS[0]}"
grep-exit=1

A substring search over the same tree, which is wider than the issue's own command
and catches the plural too, returns nothing:

$ git grep -in -E '<the role word>' HEAD -- . ; echo "exit=$?"
exit=1

The claim that every replaced sentence is about this account and no other, read
from the repository rather than recalled:

$ gh api repos/Flowfin/core/collaborators --jq '.[].login'
iderex

The two commands CONTRIBUTING.md names, run on this machine at that commit:

$ cargo build --locked --all-targets
    Finished `dev` profile [unoptimized + debuginfo] target(s) in 0.23s

$ cargo test --locked
[...]
$ cargo test --locked 2>&1 | grep -E '^test result:' | awk -F'[ ;]' '{s+=$4} END {print s}'
772

The check whose own fixtures and document this change touches:

$ bash .github/statements/statements.sh check | tail -3
NOT MADE HERE: whether the document is valid OpenVEX. It does not claim to be, and no projection to it has been produced.

Every directive this repository excludes has a published statement saying why, and what is consequently not looked for.

Its selftest runs before it judges anything, so the fixture I edited was proved
against every rule in the same run:

$ bash .github/statements/statements.sh check | grep -c '^ok'
22

And the document check that reads every Markdown path in the tree:

$ bash .github/doc-paths/doc-paths.sh check | tail -2
Every path these documents name resolves against the tracked set.

What a guard here refuses, and the proof it bites

This change adds no guard and edits no rule. What it edits inside a guard's file is
FIXTURE_FINDING's justification value, and that value is filler: the only two
places justification appears in .github/statements/statements.sh are the field
list at line 47, which asks for presence and non-emptiness, and the fixture literal
itself. No assertion in the selftest reads the value, so no rule's direction changed
with it, and the 22 ok lines above are the same 22 as before.

That is also why I did not leave it standing under the issue's exemption for
fixture bytes. That exemption is for bytes a test is proven against; these are not,
so the word had no reason to stay.

What this does not cover

The shellcheck leg was NOT run on this machine. shellcheck is not on the PATH
here, so .github/shell-analysis/shell-analysis.sh had nothing to run and I did not
install one. The gate's own run on this pull request is the first time that leg sees
this change.

Every other leg of the gate is likewise unrun locally: lint, format,
invariants, targets, cross-toolchain, thread-detector, dependencies,
codeql, zizmor, fixture-scrub, branch-health and the Unicode guard have no
verdict from me, only from the runner.

Nothing here re-examines whether any dismissal in security/statements.json is
still correct. The wording moved and the reasoning did not, and no reading was taken
of the live code-scanning surface, which statements.sh already prints as something
it cannot reach.

The board's other tracked files were searched and hold no occurrence, so this change
is the whole of what the issue measured. It says nothing about any other board.

I also edited issue #306's own Scope: line, which is outside this diff. It read
Scope: the tracked files listed below, and scope_prefixes in
.github/pr-hygiene/hygiene.sh reads that line at column zero and splits it on
commas, so it declared a prefix no changed path could be inside and would have
refused exactly the change the issue asks for. It now names the two paths, and the
issue body says why it changed.

Who has read it

Nobody other than me has read this change. There is one account on this repository,
which is the reading above, so no second reader was available; the evidence in this
body stands in place of one and is not a substitute for one.

The word for the person who runs a project stood in five places across two
tracked files here: four sentences in security/statements.json that describe me
from outside, and one filler value in a fixture in
.github/statements/statements.sh. The fleet's write gate refuses that word in
every text posted to GitHub, so a quotation of these files in an issue or a
pull request body cannot reproduce them, and the tree goes on saying what the
posted texts may no longer say.

Each replacement is a sentence rather than a substitution, and I read every one
in the diff before committing. The three singular occurrences in the document
become first person, because every one of them is about this account: there is
one collaborator on this repository and it is me. The plural on the OSS-Fuzz
entry is about somebody who can be paged rather than about me, so it takes a
neutral noun instead. The dismissals themselves do not move, and the document's
`updated` date stays where it is, because no disposition was re-examined.

The fixture value is filler and nothing is proven against those bytes:
statements.sh reads the field for presence and non-emptiness only, so the value
carries no meaning a test depends on and it is not a fixture the rule about
foreign text protects.

Signed-off-by: Nils Lehnen <30603423+iderex@users.noreply.github.com>
@iderex iderex added the documentation Improvements or additions to documentation label Sep 5, 2026
@iderex iderex self-assigned this Sep 5, 2026
@iderex
iderex merged commit 341368b into main Sep 5, 2026
28 checks passed
@iderex
iderex deleted the role-word-out-of-the-tree-306 branch September 5, 2026 20:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

The role word leaves this board's 2 tracked file(s), and foreign text keeps it

1 participant