Upgrade remaining battle UI icon gaps

docs/battle-ui-icons-hq-gapfix-v1-report.md

@@ -0,0 +1,30 @@
+# Battle UI Icon HQ Gapfix v1
+
+Date: 2026-07-09
+
+## Scope
+
+- Reworked the remaining low-detail battle UI atlas frames: attack (4), axe (10), and terrain (18).
+- Kept the runtime atlas layout unchanged at 5 columns x 6 rows, 128 px per frame.
+- Updated the generator to seed from the existing high-quality battle UI atlas and replace only the gap frames.
+- Built the new icons from project-owned visual material and existing project atlas frames.
+
+## Outputs
+
+- `src/assets/images/ui/battle-ui-icons.png`
+- `docs/battle-ui-icons-hq-gapfix-v1-atlas.png`
+- `docs/battle-ui-icons-hq-gapfix-v1-before-after.png`
+- `docs/battle-ui-icons-hq-gapfix-v1-contact.png`
+
+## Verification
+
+- `python -m py_compile scripts\build-battle-ui-icons.py` passed.
+- `pnpm run verify:static-data` passed with the bundled workspace runtime.
+- `pnpm run build` passed with the bundled workspace runtime.
+- Browser preview passed at `http://127.0.0.1:4191/heros_web/?debug&debugBattle=first-battle-zhuo-commandery&debugBattleSetup=attack-preview&v=ui-icon-gapfix`.
+- Deployment and battle screens rendered with 0 console errors; Guan Yu's unit panel showed the updated attack and terrain icon surfaces cleanly at in-game UI scale.
+
+## Notes
+
+- Pixel comparison against `docs/battle-ui-icons-hq-batch1-atlas.png` changed only frames 4, 10, and 18.
+- The terrain icon uses a cropped detail from the project battle map source instead of a low-detail vector sketch.