Skip to content

Make the support matrix Basis column say what the basis is - #11

Merged
donislawdev merged 1 commit into
mainfrom
fix/support-matrix-drift
Sep 8, 2026
Merged

Make the support matrix Basis column say what the basis is#11
donislawdev merged 1 commit into
mainfrom
fix/support-matrix-drift

Conversation

@donislawdev

Copy link
Copy Markdown
Owner

Two rows of the support matrix were not true, and the drift had gone unnoticed because nothing compared the published table with the one the test harness generates.

What was wrong

The network row read the audit detects it under Basis. That is a mechanism, not a basis, and it read as if nobody had measured the row - while the suite runs four network scenarios and passes all four on both architectures. The sentence was worth keeping, so it moved to Notes where it belongs.

The header claimed the suite last ran on 2026-09-03. The run data says 2026-09-08 on both architectures.

Nothing about the promise changes. Every status in the table is untouched, and Python and Electron keep saying in the Basis column that a person checked them and the suite did not - the distinction that column exists to make.

Why it drifted

The generator carried a comment demanding that its rows "must agree with the table in the README". That was unachievable, so it was ignored: the two tables are written for different readers. The README is prose for users - no counts, no ADR references. The generated table reports a measurement - per-architecture counts, shorthand, ADR references. Keeping them identical serves nobody, so nobody did it, and they drifted until one row contradicted itself.

Three things have to agree, and only three: the set of environments, the status of each, and whether the basis is the suite or a person. Prose, counts and row order are free to differ.

That is now checked rather than asserted in a comment. The check lives with the generator, outside this repository, so CI cannot run it - a limitation stated plainly rather than papered over. Reverting either fixed row makes it fail and name the disagreement, for example:

FAIL  DRYF podstawa: suite czy czlowiek
      Applications reading time from the network : README 'nieznane: the audit detects it' vs generator 'suite'

Gates 12/12, Rust 419, C# 365.

🤖 Generated with Claude Code

Two rows of the table were not true.

The network row read "the audit detects it" under Basis. That is a mechanism,
not a basis, and it read as if nobody had measured the row - while the suite
runs four network scenarios and passes all four on both architectures. The
sentence itself was worth keeping, so it moved to Notes where it belongs, and
Basis now says what it is for.

The header claimed the suite last ran on 2026-09-03. The run data says
2026-09-08 on both architectures.

Nothing about the promise changes: every status in the table is untouched, and
Python and Electron keep saying in the Basis column that a person checked them
and the suite did not. That distinction is the one this column exists to make.

Consistency with the generated matrix is now checked rather than asserted in a
comment. The check lives with the generator, outside this repository, so CI
cannot run it - it compares the set of environments, the status of each, and
whether the basis is the suite or a person, and deliberately not the prose,
the per-architecture counts or the row order, which differ by design because
the two tables are written for different readers.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@donislawdev
donislawdev merged commit a4a947d into main Sep 8, 2026
8 checks passed
@donislawdev
donislawdev deleted the fix/support-matrix-drift branch September 8, 2026 18:58
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