Updated perf

spikes/card-harness/README.md

@@ -67,6 +67,13 @@ unexpectedly enlarge the card. The edge mesh draws only extrusion side walls, no
 dedicated artwork faces, preventing depth-fighting bands at farther zoom distances.
 Pack assets are loaded separately on first entry, with retry on failure.
 
+Wrapper deformation is coalesced to once per rendered frame, including touch dents
+and tear input. Fixed crease/crimp calculations are cached; unchanged pouch surfaces
+and ribbons do not recalculate normals/bounds or upload vertex buffers. Hidden
+wrappers do not deform. Pack UI updates are also coalesced and only write changed
+values. These optimizations retain the same mesh resolution, deformation formulas,
+materials, lighting, pixel ratio, and antialiasing.
+
 There is no sound, haptics, particles, cloth simulation, backend, rewards persistence,
 pack progress persistence, or timeline/editor. This is a choreography proof, not an
 final pack-design or mobile performance sign-off. The approved rigid prototype and
@@ -116,6 +123,17 @@ Production build:
 npm run build
 ```
 
+Pack regression checks (Node 22.15+):
+
+```sh
+npm test
+```
+
+These check exact pre-optimization wrapper geometry snapshots, surface update
+counts, per-frame input batching, pause/resume, pinch handoff, restart, reduced
+motion, and ordered reveals. They are CPU/state checks, not a real-device GPU or
+touch-latency benchmark; mobile performance still needs on-device validation.
+
 The asset-generation script uses cross-platform Node APIs and works on Windows and Linux. The retained `export:blender` script is an optional reference utility and is not part of the application pipeline.
 
 ## Baseline