Skip to content

Commit b236f76

Browse files
committed
docs: codify the numeric-contract exception in VISUAL-STYLE Layer 1
Two shipped examples have contracts with no visual signature: vertex-weight-limit's pose-preserving prune and triangulate-tangents' mikktspace field both falsify pixel-identical, and both declared it honestly. Layer 1 now makes that an explicit, narrow exception: the README declares the contract numeric, the render depicts subject and setup legibly rather than a break that cannot exist, and falsification is satisfied by naming why. Anchored to the two precedents by name so the exception stays narrow — where a visual witness is possible, it is still required. Signed-off-by: fOuttaMyPaint <TMhospitalitystrategies@gmail.com>
1 parent 50d90d8 commit b236f76

1 file changed

Lines changed: 12 additions & 0 deletions

File tree

‎docs/VISUAL-STYLE.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -85,6 +85,18 @@ the default stage.
8585
- The image must witness the API: if the contract failed, the render should
8686
visibly break. If the render would look the same whether the code worked or
8787
not, the scene design is wrong, not merely unpolished.
88+
- **Numeric-only contracts are a narrow, declared exception.** Some contracts
89+
have no visual signature: the broken state renders pixel-identical because
90+
the evidence is a count, a cap, or a buffer invariant, not a shape. Then
91+
the example says so in its README, the render's job is to depict the
92+
subject and its setup legibly — so the reader can see what the numbers
93+
describe — and the falsification pass is satisfied by naming why no visual
94+
difference exists. Precedents: `vertex-weight-limit` (the prune preserves
95+
the pose by design, so the 4-influence cap is numeric) and
96+
`triangulate-tangents` (the ring sweep is UV/bump-driven, so a
97+
tangent-field break does not move pixels). This is for contracts that
98+
genuinely cannot be seen, not for scenes that were not designed hard
99+
enough: where a visual witness is possible, it is required.
88100
- Presentation may be staged; evidence may not. When the witnessed artifact
89101
is itself an image (a sequencer frame, a pixel buffer, a baked texture),
90102
the authentic pixels must appear unaltered — mount them in the scene

0 commit comments

Comments
 (0)