Skip to content

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

docs(changelog): Unreleased — video-loop-repair restores a held fixed cut from its source frames held again by the moves its report records (size_hold.cut_frames); a 3.1.0 report of a held cut stays source-processing-unsupported, a cut not held restores as before; the held walk away's cell 9 restored byte for byte (119 px, feet on row 129, as filmed 111 px on row 120), unheld cuts' video-loop and video-loop-repair bytes as 3.1.0 but the engine fingerprint. Text by the writing hand-off.

Soohong Kimc8ea86f27dce
diff --git a/CHANGELOG.md b/CHANGELOG.md
index e6ab373..5ff1f49 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -2,6 +2,17 @@
All notable public changes to `sprite-gen` are recorded here. Versions track the `version:` field in `SKILL.md` and `pyproject.toml`.
+## Unreleased
+
+**Upgrading from 3.1.0: `video-loop-repair` can now restore damaged cells on held fixed cuts by reading source frames through recorded frame holds.** Fixed cuts held with `--size-hold auto` now record per-frame holds in `size_hold.cut_frames`. A 3.1.0 report of a held fixed cut lacks this record and stays `source-processing-unsupported`; cut it again with this version to enable repair. A report of a cut that was not held restores as before.
+
+- **Held fixed cuts can now be restored from source frames.** Source projection applies each cut frame's recorded move and `padding_ltrb` before scrub, small-component cleanup, optional integer body ramp, one shared integer crop, and standard resampling. Unmodified cells must reproduce exactly, and cut frames must match `source_projection` hashes; a changed move on a replaced cell is refused as `source-processing-receipt-mismatch`. Reports without `cut_frames` stay `unknown` and `source-processing-unsupported`. Malformed `cut_frames` exit nonzero without writing a candidate. Cuts with `--anchor motion`, `motion-auto`, cycle alignment, wrap blends, or follow warps remain unprojected.
+- `<name>.loop.report.json`: `size_hold` records `cut_frames` on held fixed cuts, giving an ordered list of exact float entries with `scale`, `foot_point_px` (`[x, y]`), and `lift_px` (or `null`).
+- Repair records: `projection` in repair reports and candidate `restoration` receipts gain `size_hold` (`padding_ltrb`, `cut_frames`) on held cuts, binding proposal IDs to recorded moves.
+- Python callers: new `gait_fallback.frame_hold(k, measured, lift=None)` returns a frame's move dict, and `gait_fallback.hold_frame(frame, move, pad)` applies it to one frame. `gait_fallback.undo_scale` uses both and preserves previous byte outputs.
+- Output changes: on a synthetic walk away (15.0 % smaller over 73 frames, feet 20 px higher) cut on frames 24 to 47 with `--anchor body`, projection reproduces 24 of 24 cells. Restoring smeared cell 9 (25 pixels) yields verdict `improved` and recovers the cell byte for byte: 119 px tall with feet on row 129 (held loop cells run 119 to 120 px tall, feet on rows 129 to 130; cut with `--size-hold off`, cell 9 is 111 px tall on row 120, and the loop spans 107 to 113 px tall, feet on rows 116 to 122). In 3.1.0 this request ended `unknown`, `source-processing-unsupported` with no candidate. For six synthetic cuts (174 files), `video-loop` matches 3.1.0 except `producer` and `size_hold.cut_frames`. For five non-held cuts (110 files), `video-loop-repair` matches 3.1.0 except `measurement_engine` and candidate report digests.
+- **Tests**: `tests/video/test_held_cut_restoration.py` checks that the synthetic walk away cut on frames 24 to 47 with `--anchor body` restores smeared cell 9 byte for byte with verdict `improved`, matching first-cell height and row while the filmed source frame is under 0.95 height and 8 px or more higher; checks exact cell reproduction; checks that reports lacking `cut_frames` stay `source-processing-unsupported`; checks that four malformed records exit nonzero with no candidate; checks that a 1 % scale alteration triggers `source-processing-receipt-mismatch`; and checks that `frame_hold` round-trips through JSON to match `undo_scale` with and without feet held.
+
## v3.1.0 - Walk and run loop gates for held animation and seam pops, size hold for fixed cuts, talking face layer and default chroma decontamination
**Upgrading from 3.0.0: Fixed walk or run cuts and clips whose feet climb or sink now hold size and feet before cutting, changing bytes when size changes by 1 % or more.** Application scan numbers change for held clips, and held fixed cuts are not restored by `video-loop-repair`. Loops cut with `--size-hold off`, clips changing size by under 1 %, held `motion-auto` cuts on one row, and non-walk cuts keep their bytes. The report records `size_hold` on fixed walk or run cuts, `size_hold.feet` when size is held, `size_hold.anchor_regions` under `--anchor motion`, and `size_hold.at_cut` on fixed cuts; `producer` names the new version.