Correct a false claim in .gitattributes, and control two uncontrolled gates

[HarperZ9]

A correction first

The .gitattributes comment I merged here said this:

The artwork under docs/art/ is generated, and a gate compares the committed
bytes to a fresh render. Normalizing line endings per platform would make that
comparison depend on who checked the repository out.

That is not true, and I wrote it. The gate compares like this:

if path.read_text(encoding="utf-8") != text + "\n":

Path.read_text applies universal-newline translation, so a CRLF checkout is
read back as LF and the comparison passes with or without the pin. The gate was
never at risk.

The pin is still worth keeping, for a narrower reason. The receipt records each
drawing's byte count and SHA-256 read from the checked-out file with
read_bytes, and those two numbers do depend on the checkout. The pin keeps them
the same for everyone. The comment now says that and nothing more.

What the gate could not do

tests/test_repo_art.py names its gates and asserts they all report clean.
Twelve green lines say the checks ran. They do not say the checks work: a check
that returns [] unconditionally is indistinguishable from one that found
nothing wrong.

art.the_gate_can_fail closes that. The three geometry checks now take their
spec list as an argument instead of reading the loaded set directly, and the new
check feeds them one spec built to break all three at once:

• a stage note far too long for the wrapper,
• a tagline past the rule it sits above,
• an outcome band with one over-wide label and one over-long note.

It asserts the exact count of complaints, so a check that catches one problem
out of two fails here too. Verified against a deliberately weakened copy of the
module: with TAGLINE_BUDGET raised to 10000 and the page widened to 100000, the
control goes from empty to naming both budgets that stopped catching anything.

What this does not cover

The renderer itself is unchanged, and no drawing moves. Nothing here checks that
a drawing looks right, only that its text fits the shapes it is drawn into.

🤖 Generated with Claude Code