Make docs image generation deterministic and enforce committed `docs/images` in CI - #46

Draft

yawkat with Copilot wants to merge 26 commits into

mainfrom

copilot/add-image-canonicalization-step

Commits on May 8, 2026

Initial plan
Copilot
authored
3ce8aaa
Add PNG canonicalization and docs image verification workflow

Copilot
and
yawkat
authored
6c28041
Address validation feedback for docs image checks

Copilot
and
yawkat
authored
b5d1480
Limit docs render retries and document failure sentinel

Copilot
and
yawkat
authored
b727445
Refactor PNG channel mapping constant

Copilot
and
yawkat
authored
9d2a102
Document deterministic PNG canonicalization details

Copilot
and
yawkat
authored
62d378e
Clarify PNG constants used in docs canonicalization

Copilot
and
yawkat
authored
df81323
Refine OpenSCAD failure sentinel handling

Copilot
and
yawkat
authored
671ab60
Polish PNG canonicalization diagnostics readability

Copilot
and
yawkat
authored
97fa2bb
Add documentation to PNG filter helpers

Copilot
and
yawkat
authored
5595a14
Normalize PNG canonicalization constants

Copilot
and
yawkat
authored
7e03967
Use explicit DEFLATE NLEN complement encoding

Copilot
and
yawkat
authored
44d5fe6
Tighten PNG size constant naming and NLEN mask

Copilot
and
yawkat
authored
70d686a

Commits on May 9, 2026

Extract docs image generation script from justfile

Copilot
and
yawkat
authored
848dd3a
Use context manager for README parsing in docs generator

Copilot
and
yawkat
authored
dddd1ad
Harden docs command parsing in extracted generator

Copilot
and
yawkat
authored
0058792
Validate OpenSCAD -o output argument shape

Copilot
and
yawkat
authored
c2fd080
Simplify README OpenSCAD output flag validation

Copilot
and
yawkat
authored
efb70b5
Polish naming in extracted docs generator

Copilot
and
yawkat
authored
a9eb3a0
Run paths generation before docs image regeneration in CI

Copilot
and
yawkat
authored
69f1e16
Use OpenSCAD nightly snapshot in docs image CI workflow

Copilot
and
yawkat
authored
f355201
regenerate
yawkat
committed
3639040
Regenerate docs images with OpenSCAD 2026.04.08 (matching CI)
yawkat
committed
b111dde
Force Mesa softpipe renderer for deterministic docs image generation
yawkat
committed
080acd0
Auto-commit regenerated docs images from CI
yawkat
committed
6b24f8b
Regenerate docs images [skip ci]
github-actions[bot]
committed
6984c30