Skip to content

Release 2.1.42 (2026-06-19)

Refactoring

  • remove the legacy pr-template.yml workflow (#1701)
  • refactor(submit-pr): remove the legacy pr-template.yml submission path

vrg-submit-pr read PR metadata from .vergil/pr-workflow.json (the oracle state file) but still fell back to the legacy .vergil/pr-template.yml. That dual-mode path, plus the docs and error messages naming it, kept steering agents back into the old hand-off instead of the current vrg-pr-workflow flow.

Make the oracle state file the sole source: drop the fallback in submission.read_pr_fields and the legacy delete-on-submit in record_submission, delete lib/pr_template.py, and remove the pr_template import, TemplateError catches, and pr-template.yml mentions from vrg-submit-pr's error messages.

Migrate the submit-pr tests off the pr-template.yml fixture onto a pr-workflow.json state-file helper, and update the retention assertions (the state file is now retained and marked submitted rather than deleted). Closes the issue's code scope; historical references in specs/plans/releases are intentionally left intact.

  • docs(submit-pr): drop legacy pr-template.yml references from active docs

Update the active docs to describe only the vrg-pr-workflow / pr-workflow.json hand-off: rewrite the CLAUDE.md PR-handoff steps around the oracle, fix the CLI-tools bullet, and update the submit-pr reference and identity-architecture guide. Linkage guidance now notes that vrg-submit-pr (not the oracle) enforces the Ref-only rule, matching the code. Historical specs, plans, and release notes are left unchanged.