Highlights
Bluetape Skills 1.2.1 is a patch release that prevents SVG text which is
visible in browsers from disappearing during CairoSVG PNG rendering. It also
turns semantic code highlighting into an executable diagram quality gate.
Raster text and code highlighting
- Adds a fail-closed SVG text normalizer that detects renderer-sensitive text
halos before canonical PNG generation. - Preserves lane labels and relationship labels by removing only hazardous
halo declarations in bounded write mode. - Detects explicit code snippets without semantic token colors and can add
token spans while preserving the surrounding SVG structure. - Adds five regression tests covering CSS cascade, inline and presentation
attributes, missing token fills, repair behavior, and idempotence. - Requires
text_hazards=0andcode_without_highlight=0as release evidence
for generated diagram assets.
Upgrade
Clone the immutable release tag, validate it, and install with
backup-preserving replacement:
git clone --branch v1.2.1 --depth 1 https://github.com/bluetape4k/bluetape-skills.git bluetape-skills-v1.2.1
cd bluetape-skills-v1.2.1
./scripts/validate.sh
./scripts/install.sh --forceValidation requires Bash, rg, Python 3, and uv. Restart Codex after
installation so the updated skills are discovered.
Verification
- The merged release candidate passed 133 workflow tests, 151 subtests, 22
diagram regression tests, and the 14-skill public bundle boundary checks. - Both release archives passed SHA-256 verification, the complete bundle
validator, and fresh isolated installation of all 14 canonical skills. - The immutable annotated tag is SSH signed, GitHub-verified, and targets
merge commitfae0d7c0dcf971ef1856746dde002d2a595e2ba2.
Related: diagram normalization PR #8, release PR #9
Full Changelog: v1.2.0...v1.2.1