Skip to content

Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.

release: 2.44.0 — the CHANGELOG section named for the release, opened by the restoration contract a pin moves with

Soohong Kimcf92f9dcbd20
diff --git a/CHANGELOG.md b/CHANGELOG.md
index aff8ae2..8d88377 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,7 +2,9 @@
All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.
-## Unreleased
+## v2.44.0 - A filmed ghost in a loop delivered as cut is given way, or named a take to film again; restoration reads the ghost; the RIFE lane runs every real-RIFE test
+
+**Upgrading from 2.43.0: the restoration contract moves with the version.** Source restoration is now metric `source-restoration-v5` under policy `key-protected-source-copy-one-step-cap-jump-ghost-guard-v1`, and writes repair report `schema_version` 4 and comparison `schema_version` 6 (`sprite_gen.video.restoration`: `METRIC`, `POLICY`, `REPAIR_SCHEMA`, `COMPARISON_SCHEMA`); a consumer that checks these values raises all four with its pin. Nothing `source-restoration-v4` (2.40.0 – 2.43.0) wrote is read as v5: a v4 repair report given to `video-loop-compare` is an input error, and a request whose baseline carries a v4 receipt in its loop report is shared `unknown`, `restoration-receipt-policy-unsupported`. A loop restored under v4 therefore goes on from its origin, not its v4 baseline: the origin itself is still a valid first request (the same five files as origin and baseline). Proposal IDs change with the versions. `video-loop-compare` without the origin and the source (`same-sample-defects-v1`) is unchanged.
- **Fix: the Linux lane's `--rife-only` runs every test of the real RIFE, not one file.** It ran `tests/video/test_rife.py` alone, while `--rife-unmeasured` skips every test that needs the real `rife-ncnn-vulkan` — so a real-RIFE test in another file (2.43.0's in `tests/video/test_crossfade.py` and `tests/video/test_ghost_screen.py`) was measured by neither run. Such a test now carries one mark, `real_rife` (registered in `pyproject.toml`): `tests/conftest.py` skips the marked tests where `rife.locate()` finds no RIFE, and `scripts/linux_lane.sh --rife-only` runs `pytest -m real_rife` over the whole suite, none skipped. A new real-RIFE test is run by `--rife-only` once it is marked. `docs/release.md` says what each run measures.
- **The lane's RIFE-less run fails a skip that `--rife-only` will not run.** `--rife-unmeasured` runs the suite as `pytest --rife-unmeasured`, where `tests/conftest.py` reads every skip — by a skip mark, in a fixture or the test body, or of a whole file at import: one whose test is not marked `real_rife` fails by name, unless `NOT_RIFE_SKIPS` in the same file names it as skipping for an input the lane does not give (the `SPRITE_GEN_CHROMA_REAL_STILLS` stills). Such a skip would be measured by neither run.
diff --git a/SKILL.md b/SKILL.md
index 5b3d93f..960ac7d 100644
--- a/SKILL.md
+++ b/SKILL.md
@@ -1,6 +1,6 @@
---
name: sprite-gen
-version: 2.43.0
+version: 2.44.0
description: "Generates images and game sprites through GPT or Grok with guided provider choices, separate saved defaults, automatic cleanup and optional curation. Handles sprite requests, ordinary image generation/editing, standalone image-to-video clips (i2v, animate this still, 그록 영상, 이매진 비디오, 스틸 움직여줘, first/last frame, reference-to-video, 영상 이어붙이기, 영상 편집, extend/edit a clip), clips from a video MCP on the agent (ZCRE, 지크 MCP), chroma removal, animation atlases, video loops, 큐레이션뷰, image candidates, 팔레트 스왑, palette swap, recolor, rig layers, engine exports, repeating backgrounds, projected shadows, motion/contact inspection and optional scene composition from existing assets."
license: Apache-2.0
depends_on:
diff --git a/pyproject.toml b/pyproject.toml
index 5c71acf..fe4aa62 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -12,7 +12,7 @@ build-backend = "setuptools.build_meta"
name = "sprite-gen"
# Release discipline: keep this package metadata version synchronized with
# SKILL.md's `version:` field in the same release commit.
-version = "2.43.0"
+version = "2.44.0"
description = "Component-row pipeline for clean 2D game sprites and animation atlases"
readme = "README.md"
license = "Apache-2.0"