Bluetape Skills 1.2.1

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=0 and code_without_highlight=0 as 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 --force

Validation 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 commit fae0d7c0dcf971ef1856746dde002d2a595e2ba2.

Related: diagram normalization PR #8, release PR #9

Full Changelog: v1.2.0...v1.2.1

Bluetape Skills 1.2.0

Highlights

Bluetape Skills 1.2.0 strengthens $bluetape-diagram without replacing the established Bluetape visual style. Connector-heavy diagrams now receive broader automatic geometry screening before the required full-size PNG review.

Diagram validation

• Detects relationship-label collisions with cards, labels, and unrelated connectors.
• Rejects shared connector segments and reports data-from/data-to relationship names in failures.
• Applies SVG affine transforms while keeping disconnected path subpaths separate.
• Distinguishes connector identity from display names so duplicate relationships cannot hide crossings.
• Fails closed on malformed transform arguments and unsupported SVG path commands.

The audit remains a screening tool. Full-size rendered PNG inspection is still the final authority for typography, density, and visual clarity.

Upgrade

Clone the immutable release tag, validate it, and install with backup-preserving replacement:

git clone --branch v1.2.0 --depth 1 https://github.com/bluetape4k/bluetape-skills.git bluetape-skills-v1.2.0
cd bluetape-skills-v1.2.0
./scripts/validate.sh
./scripts/install.sh --force

Validation requires Bash, rg, Python 3, and uv. Restart Codex after installation so the updated skills are discovered.

Verification

• The merged candidate passed 133 workflow tests, 151 subtests, and 17 diagram regression tests.
• Ruff formatting/lint, Python compilation, the complex cache diagram benchmark, live/chezmoi/public parity, and Codex self-audit passed.
• Both release archives passed checksum verification, the complete bundle validator, and fresh installation of all 14 canonical skills.
• The immutable annotated tag is SSH signed and targets merge commit 70167032fb354861bf4ba6aaaac1d5ac09c7c92c.

Related: release PR #7

Full Changelog: v1.1.0...v1.2.0

Bluetape Skills 1.1.0

Highlights

Bluetape Skills 1.1.0 is a feature and maintenance release that adds the Phase 2 native workflow runtime to the canonical public bundle. It keeps all 14 Bluetape skills aligned on one manifest-driven coordination contract while preserving the boundary between reusable skills and private Codex runtime state.

Native workflow runtime

• Adds guarded run and lane lifecycle commands through bluetape-flow.py, the only supported writer for .bluetape workflow state.
• Adds topology-based completion, liveness decisions, receipt-backed recovery and handoff, immutable live reports, and bounded evidence handling.
• Ships manifest 1.1 together with receipt, topology, and liveness contracts plus regression coverage for lifecycle, recovery, locking, scale, and rendered layouts.

The runtime records observed Codex coordination; it does not replace Codex agent spawn, messaging, waiting, or interruption tools.

Security and distribution boundary

• Hardens owner fencing, filesystem containment, permission checks, stale-lock recovery, receipt verification, and recovery-run provenance.
• Keeps user memory, local rules and hooks, configuration, plugin caches, secrets, private runtime state, and retired aliases outside the public bundle.
• Declares code-review and self-audit as external companion skills. They remain separate installations and are not bundled here.

Upgrade

Clone the immutable release tag, validate it, and install with backup-preserving replacement:

git clone --branch v1.1.0 --depth 1 https://github.com/bluetape4k/bluetape-skills.git bluetape-skills-v1.1.0
cd bluetape-skills-v1.1.0
./scripts/validate.sh
./scripts/install.sh --force

Validation requires Bash, rg, Python 3, and uv. Restart Codex after installation so the updated skills are discovered.

Verification

The release candidate passed the complete bundle validator with 14 canonical skills, 133 tests, and 151 subtests. The canonical source and public bundle matched across 83 files with no missing, extra, or changed payloads. Both tar.gz and zip archives passed validation and fresh installation of all 14 skills; SHA-256 manifests, secret scanning, private-path boundary checks, and SSH signing readiness also passed.

Related: tracking issue #5, release candidate PR #6

Full Changelog: v1.0.0...v1.1.0

Bluetape Skills 1.0.0

Highlights

Bluetape Skills 1.0.0 is the first stable public distribution of the reusable Codex workflow contract used across the Bluetape ecosystem. It packages 14 canonical skills with the references, templates, scripts, and agent prompts required to execute them as complete units.

Install

Download either release bundle, extract it, validate the contents, and run the installer:

./scripts/validate.sh
./scripts/install.sh

The installer targets ${CODEX_HOME:-~/.codex}/skills. Existing canonical skills are preserved unless --force is supplied; forced replacement creates a timestamped backup first.

Workflow and review model

• $bluetape-workflow classifies work into the lightest safe execution lane.
• Full Feature work applies the same 7-Tier review engine at 2-R Spec Review, 3-R Plan Review, and 6-R Pre-PR Review.
• Six independent perspectives feed main-session integration, and any P0 or P1 finding blocks progression until repair, validation, and affected reviews converge again at P0=0, P1=0.

Distribution boundary

The bundle includes canonical reusable skill resources. It deliberately excludes user memory, local rules and hooks, configuration, plugin caches, secrets, private runtime state, and retired bluetape4k-* aliases.

Documentation

• Sharing and installing Bluetape skills
• Using the Bluetape workflow
• 한국어: Bluetape skill 공유와 설치
• 한국어: Bluetape workflow 사용법

Verification

The release candidate passed canonical inventory and private-payload validation, a temporary Codex-home installation with all 14 skill directories, archive extraction/integrity checks, bilingual README parity, diagram XML/CairoSVG/geometry audits, and independent review with P0/P1/P2/P3 all at zero.

Related: release tracking issue #3, release-readiness PR #4, public-guide PR #2

Full history: https://github.com/bluetape4k/bluetape-skills/commits/v1.0.0