tvproductions/gzkit / .agents/skills/gz-migrate-semver
gz-migrate-semver
VerifiedUse to record ADR or OBPI semver renaming migration events.
gz migrate-semver
Overview
Append artifact_renamed events so the ledger resolves an old ADR or OBPI id to
its canonical id. The ledger is never rewritten. gz migrate-semver proposes a
rename from two sources:
SEMVER_ID_RENAMESinsrc/gzkit/commands/register.py, a fixed table of legacy renames (pool and SemVer re-sequencing, early slug corrections);- on-disk drift (GHI #345): for each ADR or OBPI file whose stem is a slug id,
the bare id (
ADR-0.35.0,OBPI-0.1.0-01) when ledger events still carry it.
A pair is skipped when its rename event already exists, when the old id never
appears in the ledger, or when the ledger already canonicalizes the old id.
Re-running is safe. Each event has reason semver_minor_sequence_migration.
It covers bare→slug renames and the table only. A slug→slug correction to an
OBPI id goes through uv run python -m gzkit.governance.obpi_slug_rename, and a
pool ADR promotion records its own rename through gz adr promote.
Workflow
- Preview:
uv run gz migrate-semver --dry-runlists eachWould append artifact_renamed: <old> -> <new>and writes nothing. - Show the operator the list. The run writes one ledger event per pair in bulk and has no confirmation step, and a bulk rename written in error cannot be removed from an append-only ledger, only countered (GHI #584).
- On the operator's approval, run
uv run gz migrate-semverand report the count it prints.No applicable SemVer ID migrations found.means nothing was pending.
Example
uv run gz migrate-semver --dry-run
uv run gz migrate-semver
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |