clone

a browser grid puzzle game where you push words around to rewrite the rules of each level

main
miau-is-true / openspec / changes / archive / 2026-09-24-fix-undo-death-visual / specs / game-presentation / spec.md
spec.md 1.7K source

ADDED Requirements

Requirement: Undo SHALL restore the complete visual entity state

After a successful Undo, the presentation SHALL reconcile visible entities from the restored engine snapshot by stable ID, including existence, noun or glyph, grid position, facing, control marker, and active visual effects. Effects created by the undone death turn SHALL not remain visible after reconciliation.

Scenario: Proof 05 death then Undo restores MIAU immediately

  • WHEN MIAU dies in proof 05 and the player invokes Undo on a mobile viewport
  • THEN the restored MIAU glyph and its control marker are visible at the prior position on the next presentation frame, and the red death shadow from the undone turn is absent

Scenario: Repeated death and Undo does not accumulate stale effects

  • WHEN the player repeats a death followed by Undo multiple times
  • THEN each restored snapshot shows exactly the engine entities for that turn and no prior death shadow or missing glyph persists

Scenario: Reset clears death presentation state

  • WHEN the player resets after a death or after an Undo
  • THEN the board shows the native initial entities and facing, with no stale destruction effect or missing controlled glyph

Scenario: Reduced motion restores without a transition gap

  • WHEN reduced motion is enabled and the player invokes Undo after death
  • THEN the restored entities and controls appear immediately with no intermediate death animation frame

Scenario: Input paths share the same recovery

  • WHEN Undo is invoked by keyboard, touch, or Standard gamepad after a death
  • THEN each input path produces the same restored visual state and unchanged engine move history