Generate clean 2D game sprites & animation atlases — component-row pipeline: state rows, alpha cleanup, frame extraction, runtime atlases. Codex/Claude skill.
release: 2.40.0 candidate — a restored cell that brings back the jump the repair took out is not an improvement
Soohong Kimbf6ea107abc2
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex afe1e93..aff5ece 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -2,6 +2,13 @@All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.+## v2.40.0 - A restored cell that brings back the jump the repair took out is not an improvement++- **Output change: source restoration's comparison reads the jump around the restored cell (`axes.jump`).** A cell the restoration rebuilds is one the jump repair replaced, because a step into or out of its source frame jumped. The source frame's pixels clear the in-between's melt and can bring that jump back, and the comparison read only the melt. `video-loop-compare` (and the preview in `video-loop-repair`) now scores the final cells of both loops with the jump repair's own step score (`repair.jump_scores`: per step, the change of coverage over the whole body and over the hair behind it, each over its median in the loop, the larger of the two), on the source cells' union box and with the `facing` the loop report's `jump_repair` recorded. A changed cell reads the larger score of the step into it and the step out of it; more than the baseline's is `regressed`, reason `jump:regressed`, as on every other axis. No bound is read (`JUMP_RATIO` included) and no constant is added: the baseline is the measure. A cell the jump repair made is now restored only where its in-between jumped more than the source frame does, as when it lost coverage; where the in-between was the smoother step and only its drawing melted, the delivered in-between stays. The guard reads coverage, not colour. `axes.jump` carries both loops' step scores and their whole-body and hair parts, the facing, the hair box, the box and, per changed cell, its two steps and both readings. A loop report whose jump repair names replaced cells but no facing (`right` or `left`) is shared `unknown`, `jump-repair-facing-unverified`; a loop whose repair replaced nothing needs none and stays a no-op. [docs/loop-comparison.md](docs/loop-comparison.md#the-jump-guard).+- **Contract versions: comparison schema 5, metric `source-restoration-v4`, policy `key-protected-source-copy-one-step-cap-jump-guard-v1`.** The repair report stays schema 3, and a restored cell's pixels are made as in 2.39.0. Evidence and receipts of `source-restoration-v3` (2.39.0) are refused, never read as v4: a v3 repair report given to `video-loop-compare` is an input error, and a request whose baseline carries a v3 receipt in its loop report is shared `unknown`, `restoration-receipt-policy-unsupported`. The origin itself is still a valid first request. Proposal IDs change with the versions.+- **`scripts/dev/source_restoration_demo.py`** still ends with both requests `improved` and the third a no-op, its 25 checks unchanged: each melted in-between there left the feet a pale ghost, a larger jump than the source frame's. Its stand-in loop report now records the jump repair's `facing`, as `video-loop` writes it.+- **`tests/video/test_source_restoration.py`**, facing right and left: a restored cell whose source frame stands six pixels to one side of its neighbours clears the melt and is `regressed` with `jump:regressed` alone, while the other proposal stays `improved`; a restored cell that gives the steps back the source's reads no higher than the in-between; the axis is the jump repair's own score on the source cells' box. A record without a facing, or with another word, is shared `unknown`, and a loop with nothing replaced is still a no-op. Receipts and evidence of v3 are refused.+## v2.39.0 - A damaged cell is restored from its own source frame; a faulty in-between is no longer adopted; a follow-through is shown in every cell- **Output change: a jump repair adopts RIFE's in-between only when it has no interpolation fault.** In a walk or run loop (`video-loop --repair auto|on`), the frame that breaks a jump used to be replaced by whatever RIFE drew between its two neighbours. RIFE's frame is now a proposal, measured against those neighbours with `rife.smear` and adopted only without a fault: a smear inside the body (`dark_excess` over 0.001), a lost outline (`outline_loss` over 0.05) or an empty frame keeps the filmed frame. These are the bounds cycle alignment already used, now one policy for both (`sprite_gen/video/interpolation_quality.py`). The limit of 3 (`MAX_REPAIRS`) counts interpolation calls, rejected proposals included; a rejected target is not tried again in that run, and a target next to a frame already made is skipped while an independent one remains, where it used to end the search. The report's `jump_repair` adds `attempts`, `blocked` and, per round, `target`, the `original` and `proposal` measurements, `faults` and `outcome` (`accepted` or `rejected`). A rejection keeps the filmed frame and its jump: it is not a verdict on the loop. [docs/loop-repair.md](docs/loop-repair.md).diff --git a/SKILL.md b/SKILL.mdindex 2a6c569..88bd274 100644--- a/SKILL.md+++ b/SKILL.md@@ -1,6 +1,6 @@---name: sprite-gen-version: 2.39.0+version: 2.40.0description: "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.0depends_on:diff --git a/pyproject.toml b/pyproject.tomlindex 6d2378c..d778050 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.39.0"+version = "2.40.0"description = "Component-row pipeline for clean 2D game sprites and animation atlases"readme = "README.md"license = "Apache-2.0"