Skip to content

Release 2.1.8 (2026-06-05)

Chores

  • migrate to vergil v2.1 Self-referential vergil 2.0 -> 2.1 migration for vergil-tooling itself, per the fleet playbook in #1371 (canary proven in vergil-actions#679, repeated in vergil-docker#330). The repo already releases 2.1.x but still consumed its own v2.0 tooling internally; this makes it dogfood its current major.

  • Axis 1: vergil.toml [dependencies] vergil pin v2.0 -> v2.1. As the single source of truth resolved by vrg_install_tag(), this drives uv tool install vergil-tooling@v2.1 into both the local container cache build and the CI setup/vergil step, loading v2.1 into all dev images.

  • Axis 2: bump 8 vergil-actions uses refs @v2.0 -> @v2.1 across ci.yml (5), cd.yml (2), ops.yml (1).
  • Docs: host-install lines vergil-tooling@v1.4 -> @v2.1 in CLAUDE.md, getting-started.md, and consuming-repo-setup.md.

Unlike the vergil-actions canary there is no self-referential @develop ref here: this repo consumes the actions remotely, so every action ref points at the v2.1 release tag directly. releasing.md's v1.3 -> v1.4 worked example is left unchanged (illustrative walkthrough, not a live install pin). No VERSION bump: develop already diverges from main, so the version-divergence gate passes as-is. Validated locally with vrg-validate under the rebuilt v2.1 container image.

Refactoring

  • remove deprecated vrg-finalize-repo alias vrg-finalize-repo was a deprecation shim that warned and forwarded to vrg-finalize-pr, which holds all the real logic (provenance check, merge, branch/worktree cleanup, CD verification, post-finalize validation). Keeping it invited accidental use of the legacy name. Delete the shim module, its test, and the pyproject console-script entry, and update the docstring in vrg_finalize_pr.py. Update current docs (README, CLAUDE.md, the worktree-convention spec, and the docs/site pages + nav) to reference vrg-finalize-pr; replace the deprecated reference page with one documenting the real tool, and correct stale prose that described worktree-aware finalize as future work (it ships in vrg-finalize-pr). Historical records are left untouched. The vergil-claude-plugin pr-workflow skill and remind-finalize.sh hook still name the old command and need a matching update in that repo. Ref #1404.