Approve Wu river archer handpainted sprite v2

docs/handpaint-batch4-wu-archer-river-v2-report.md

@@ -0,0 +1,24 @@
+# Wu River Archer v2 sprite report
+
+- source: `handpaint-batch4-wu-archer-river-source-v1.png`
+- base status: ok
+- action status: ok
+- base partial alpha: 0, opaque pixels: 2064474
+- action partial alpha: 0, opaque pixels: 3952485
+- base frame border hits: 0
+- action frame border hits: 0
+- base empty frames: 0
+- action empty frames: 0
+- base bbox width range: 209..229
+- base bbox height range: 288..288
+- base bottom range: 303..303
+- action bbox width range: 209..252
+- action bbox height range: 233..288
+- action bottom range: 303..303
+- contact: `handpaint-batch4-wu-archer-river-v2-contact.png`
+- animation: `handpaint-batch4-wu-archer-river-v2-animation.gif`
+- before/after: `handpaint-batch4-wu-archer-river-v2-before-after.png`
+- scale compare: `handpaint-batch4-wu-archer-river-v2-scale-compare.png`
+- battle composite: `handpaint-batch4-wu-archer-river-v2-battle-composite.png`
+- manual checks: run build and local browser verification after generation
+- note: battle composite is a scale review image; gameplay roster is unchanged during sample approval

docs/unit-sprite-art-quality-gate.md

@@ -6,9 +6,9 @@ This gate catches obvious sprite-art failures before user approval. It does not
 
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
-- Approved baseline units: 62
+- Approved baseline units: 63
 - Pending approval units: 0
-- Queued rework units: 29
+- Queued rework units: 28
 
 ## Checked Rules
 

docs/unit-sprite-batch-queue.json

@@ -60,6 +60,7 @@
     "unit-wei-yan",
     "unit-wu-archer",
     "unit-wu-archer-naval",
+    "unit-wu-archer-river",
     "unit-wu-cavalry",
     "unit-wu-infantry",
     "unit-wu-officer",
@@ -69,8 +70,8 @@
   "pendingApproval": [],
   "nextAfterApproval": [],
   "stageCounts": {
-    "approved-baseline": 62,
-    "queued-rework": 29
+    "approved-baseline": 63,
+    "queued-rework": 28
   },
   "batches": [
     {
@@ -678,24 +679,10 @@
       "label": "Batch 4 Wu generic units",
       "total": 16,
       "stageCounts": {
-        "approved-baseline": 6,
-        "queued-rework": 10
+        "approved-baseline": 7,
+        "queued-rework": 9
       },
       "units": [
-        {
-          "stem": "unit-wu-archer-river",
-          "reviewStage": "queued-rework",
-          "queueRole": "queued rework",
-          "baseStatus": "border-hits=64",
-          "actionStatus": "border-hits=140",
-          "battleBasePx": [
-            39.1,
-            39.3,
-            44.6,
-            44.6
-          ],
-          "spec": null
-        },
         {
           "stem": "unit-wu-cavalry-elite",
           "reviewStage": "queued-rework",
@@ -850,6 +837,20 @@
           ],
           "spec": null
         },
+        {
+          "stem": "unit-wu-archer-river",
+          "reviewStage": "approved-baseline",
+          "queueRole": "approved reference",
+          "baseStatus": "ok",
+          "actionStatus": "ok",
+          "battleBasePx": [
+            33.4,
+            36.6,
+            46.0,
+            46.0
+          ],
+          "spec": null
+        },
         {
           "stem": "unit-wu-cavalry",
           "reviewStage": "approved-baseline",

docs/unit-sprite-batch-queue.md

@@ -6,9 +6,9 @@ Use this as the long-running queue for the full hand-painted sprite rework. It i
 
 ## Current State
 
-- Approved baseline units: 62
+- Approved baseline units: 63
 - Pending approval units: 0
-- Queued rework units: 29
+- Queued rework units: 28
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
 
@@ -98,11 +98,10 @@ No next unit is currently defined.
 
 - Batch key: `batch4-wu`
 - Total units: 16
-- Stage counts: approved-baseline 6, queued-rework 10
+- Stage counts: approved-baseline 7, queued-rework 9
 
 | unit | role | stage | status | battle base px | spec |
 | --- | --- | --- | --- | --- | --- |
-| `unit-wu-archer-river` | queued rework | queued-rework | base border-hits=64; actions border-hits=140 | 39.1..39.3 x 44.6..44.6 |  |
 | `unit-wu-cavalry-elite` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 26.5..47.3 x 45.0..46.0 |  |
 | `unit-wu-cavalry-river` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 25.6..46.5 x 45.0..46.2 |  |
 | `unit-wu-infantry-marine` | queued rework | queued-rework | base border-hits=32; actions border-hits=82 | 30.7..44.2 x 44.6..44.6 |  |
@@ -114,6 +113,7 @@ No next unit is currently defined.
 | `unit-wu-yi` | queued rework | queued-rework | base border-hits=32; actions border-hits=82 | 31.9..40.6 x 44.6..44.6 |  |
 | `unit-wu-archer` | approved reference | approved-baseline | technical ok | 28.3..34.3 x 46.0..46.0 |  |
 | `unit-wu-archer-naval` | approved reference | approved-baseline | technical ok | 33.9..36.6 x 44.2..46.0 |  |
+| `unit-wu-archer-river` | approved reference | approved-baseline | technical ok | 33.4..36.6 x 46.0..46.0 |  |
 | `unit-wu-cavalry` | approved reference | approved-baseline | technical ok | 28.3..40.3 x 43.8..46.3 |  |
 | `unit-wu-infantry` | approved reference | approved-baseline | technical ok | 25.2..33.1 x 46.0..46.5 |  |
 | `unit-wu-officer` | approved reference | approved-baseline | technical ok | 25.4..32.9 x 46.0..46.0 |  |

docs/unit-sprite-next-steps.md

@@ -4,9 +4,9 @@ This file is generated by `scripts/write-unit-sprite-next-steps.py`.
 
 ## Current Gate
 
-- Approved baseline units: 62
+- Approved baseline units: 63
 - Pending approval units: 0
-- Queued rework units: 29
+- Queued rework units: 28
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
 - Current approval board: not generated until the next pending sample.

docs/unit-sprite-rework-audit.json

@@ -11,8 +11,8 @@
     "batch7-unique-officer": 19
   },
   "stage_counts": {
-    "approved-baseline": 62,
-    "queued-rework": 29
+    "approved-baseline": 63,
+    "queued-rework": 28
   },
   "rows": [
     {
@@ -4121,7 +4121,7 @@
     },
     {
       "batch": "batch4-wu",
-      "review_stage": "queued-rework",
+      "review_stage": "approved-baseline",
       "stem": "unit-wu-archer-river",
       "base": {
         "key": "unit-wu-archer-river",
@@ -4131,23 +4131,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 1937199,
-        "border_hits": 64,
-        "min_width": 245,
-        "max_width": 246,
-        "min_height": 279,
-        "max_height": 279,
-        "min_bottom": 281,
-        "max_bottom": 287,
+        "opaque_pixels": 2064474,
+        "border_hits": 0,
+        "min_width": 209,
+        "max_width": 229,
+        "min_height": 288,
+        "max_height": 288,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 1,
+        "width_swing": 20,
         "height_swing": 0,
-        "bottom_swing": 6,
-        "battle_min_width_px": 39.1,
-        "battle_max_width_px": 39.3,
-        "battle_min_height_px": 44.6,
-        "battle_max_height_px": 44.6,
-        "status": "border-hits=64"
+        "bottom_swing": 0,
+        "battle_min_width_px": 33.4,
+        "battle_max_width_px": 36.6,
+        "battle_min_height_px": 46.0,
+        "battle_max_height_px": 46.0,
+        "status": "ok"
       },
       "actions": {
         "key": "unit-wu-archer-river-actions",
@@ -4157,23 +4157,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 4320862,
-        "border_hits": 140,
-        "min_width": 220,
-        "max_width": 255,
-        "min_height": 275,
-        "max_height": 279,
-        "min_bottom": 274,
-        "max_bottom": 289,
+        "opaque_pixels": 3952485,
+        "border_hits": 0,
+        "min_width": 209,
+        "max_width": 252,
+        "min_height": 233,
+        "max_height": 288,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 35,
-        "height_swing": 4,
-        "bottom_swing": 15,
-        "battle_min_width_px": 35.1,
-        "battle_max_width_px": 40.7,
-        "battle_min_height_px": 43.9,
-        "battle_max_height_px": 44.6,
-        "status": "border-hits=140"
+        "width_swing": 43,
+        "height_swing": 55,
+        "bottom_swing": 0,
+        "battle_min_width_px": 33.4,
+        "battle_max_width_px": 40.3,
+        "battle_min_height_px": 37.2,
+        "battle_max_height_px": 46.0,
+        "status": "ok"
       }
     },
     {

docs/unit-sprite-rework-audit.md

@@ -29,8 +29,8 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 
 ## Review Stage Counts
 
-- approved-baseline: 62
-- queued-rework: 29
+- approved-baseline: 63
+- queued-rework: 28
 
 ## Batch Plan
 
@@ -124,7 +124,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 | batch3-wei | approved-baseline | `unit-wei-yan` | ok | ok | 173..219 x 277..290 | 173..264 x 232..290 | 27.6..35.0 x 44.2..46.3 | w46 h13 b0 |
 | batch4-wu | approved-baseline | `unit-wu-archer` | ok | ok | 177..215 x 288..288 | 178..242 x 288..288 | 28.3..34.3 x 46.0..46.0 | w38 h0 b0 |
 | batch4-wu | approved-baseline | `unit-wu-archer-naval` | ok | ok | 212..229 x 277..288 | 191..256 x 277..288 | 33.9..36.6 x 44.2..46.0 | w17 h11 b0 |
-| batch4-wu | queued-rework | `unit-wu-archer-river` | border-hits=64 | border-hits=140 | 245..246 x 279..279 | 220..255 x 275..279 | 39.1..39.3 x 44.6..44.6 | w1 h0 b6 |
+| batch4-wu | approved-baseline | `unit-wu-archer-river` | ok | ok | 209..229 x 288..288 | 209..252 x 233..288 | 33.4..36.6 x 46.0..46.0 | w20 h0 b0 |
 | batch4-wu | approved-baseline | `unit-wu-cavalry` | ok | ok | 177..252 x 274..290 | 177..261 x 274..290 | 28.3..40.3 x 43.8..46.3 | w75 h16 b0 |
 | batch4-wu | queued-rework | `unit-wu-cavalry-elite` | border-hits=64 | border-hits=144 | 166..296 x 282..288 | 166..305 x 274..290 | 26.5..47.3 x 45.0..46.0 | w130 h6 b6 |
 | batch4-wu | queued-rework | `unit-wu-cavalry-river` | border-hits=64 | border-hits=144 | 160..291 x 282..289 | 160..300 x 274..290 | 25.6..46.5 x 45.0..46.2 | w131 h7 b7 |

docs/unit-sprite-rework-manifest.json

@@ -68,6 +68,7 @@
     "unit-wei-yan",
     "unit-wu-archer",
     "unit-wu-archer-naval",
+    "unit-wu-archer-river",
     "unit-wu-cavalry",
     "unit-wu-infantry",
     "unit-wu-officer",

docs/unit-sprite-wu-archer-river-v2-approval-packet.md

@@ -0,0 +1,36 @@
+# Wu River Archer v2 Approval Packet
+
+- status: approved during continuous production run
+- unit: `unit-wu-archer-river`
+- source art: `handpaint-batch4-wu-archer-river-source-v1.png`
+- contact sheet: `handpaint-batch4-wu-archer-river-v2-contact.png`
+- animation GIF: `handpaint-batch4-wu-archer-river-v2-animation.gif`
+- before/after: `handpaint-batch4-wu-archer-river-v2-before-after.png`
+- scale compare: `handpaint-batch4-wu-archer-river-v2-scale-compare.png`
+- battle composite: `handpaint-batch4-wu-archer-river-v2-battle-composite.png`
+- browser check: `handpaint-batch4-wu-archer-river-v2-debug-preview-battle-check.png`
+- current board: `unit-sprite-current-approval-board.png`
+- debug URL: `http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-wu-archer-river&v=wu-archer-river-v2`
+
+## Visual Decision
+
+Approved for the continuous batch run. v2 reads as a nimble Wu river archer through the large bow, quiver, reed-brown clothing, muted teal accents, and lighter scout silhouette. It remains distinct from the heavier Wu naval archer while keeping archer readability first.
+
+## Technical Checks
+
+- base status: ok
+- action status: ok
+- base partial alpha: 0
+- action partial alpha: 0
+- base frame border hits: 0
+- action frame border hits: 0
+- base empty frames: 0
+- action empty frames: 0
+- battle scale from sample gate: 33.4..36.6 x 46.0..46.0
+- local build: passed
+- Local browser console errors: `0`
+- Local browser 404s: `0`
+
+## Notes
+
+v1 was discarded because the archer action silhouette was too narrow. v2 uses a mild horizontal expansion to make the shooting pose read at battle scale without causing border hits.