Approve Shu vanguard officer handpainted sprite v2

docs/handpaint-batch2-shu-officer-vanguard-v2-report.md

@@ -0,0 +1,24 @@
+# Shu Officer Vanguard Hand-Painted v2
+
+- source: `handpaint-batch2-shu-officer-vanguard-source-v2.png`
+- base status: ok
+- action status: ok
+- base partial alpha: 0, opaque pixels: 1868580
+- action partial alpha: 0, opaque pixels: 4786586
+- base frame border hits: 0
+- action frame border hits: 0
+- base empty frames: 0
+- action empty frames: 0
+- base bbox width range: 169..226
+- base bbox height range: 277..295
+- base bottom range: 303..303
+- action bbox width range: 169..277
+- action bbox height range: 264..295
+- action bottom range: 303..303
+- contact: `handpaint-batch2-shu-officer-vanguard-v2-contact.png`
+- animation: `handpaint-batch2-shu-officer-vanguard-v2-animation.gif`
+- before/after: `handpaint-batch2-shu-officer-vanguard-v2-before-after.png`
+- scale compare: `handpaint-batch2-shu-officer-vanguard-v2-scale-compare.png`
+- battle composite: `handpaint-batch2-shu-officer-vanguard-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: 45
+- Approved baseline units: 46
 - Pending approval units: 0
-- Queued rework units: 46
+- Queued rework units: 45
 
 ## Checked Rules
 

docs/unit-sprite-batch-queue.json

@@ -35,6 +35,7 @@
     "unit-shu-infantry-guard",
     "unit-shu-officer",
     "unit-shu-officer-council",
+    "unit-shu-officer-vanguard",
     "unit-shu-spearman",
     "unit-shu-strategist",
     "unit-wei-archer",
@@ -52,8 +53,8 @@
   "pendingApproval": [],
   "nextAfterApproval": [],
   "stageCounts": {
-    "approved-baseline": 45,
-    "queued-rework": 46
+    "approved-baseline": 46,
+    "queued-rework": 45
   },
   "batches": [
     {
@@ -165,24 +166,10 @@
       "label": "Batch 2 Shu generic units",
       "total": 18,
       "stageCounts": {
-        "approved-baseline": 13,
-        "queued-rework": 5
+        "approved-baseline": 14,
+        "queued-rework": 4
       },
       "units": [
-        {
-          "stem": "unit-shu-officer-vanguard",
-          "reviewStage": "queued-rework",
-          "queueRole": "queued rework",
-          "baseStatus": "border-hits=64",
-          "actionStatus": "border-hits=144",
-          "battleBasePx": [
-            33.2,
-            41.2,
-            45.0,
-            46.0
-          ],
-          "spec": null
-        },
         {
           "stem": "unit-shu-spearman-guard",
           "reviewStage": "queued-rework",
@@ -393,6 +380,20 @@
           ],
           "spec": null
         },
+        {
+          "stem": "unit-shu-officer-vanguard",
+          "reviewStage": "approved-baseline",
+          "queueRole": "approved reference",
+          "baseStatus": "ok",
+          "actionStatus": "ok",
+          "battleBasePx": [
+            27.0,
+            36.1,
+            44.2,
+            47.1
+          ],
+          "spec": null
+        },
         {
           "stem": "unit-shu-spearman",
           "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: 45
+- Approved baseline units: 46
 - Pending approval units: 0
-- Queued rework units: 46
+- Queued rework units: 45
 - Manifest: `docs/unit-sprite-rework-manifest.json`
 - Audit: `docs/unit-sprite-rework-audit.json`
 
@@ -46,11 +46,10 @@ No next unit is currently defined.
 
 - Batch key: `batch2-shu`
 - Total units: 18
-- Stage counts: approved-baseline 13, queued-rework 5
+- Stage counts: approved-baseline 14, queued-rework 4
 
 | unit | role | stage | status | battle base px | spec |
 | --- | --- | --- | --- | --- | --- |
-| `unit-shu-officer-vanguard` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 33.2..41.2 x 45.0..46.0 |  |
 | `unit-shu-spearman-guard` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 32.3..41.2 x 45.0..46.0 |  |
 | `unit-shu-spearman-veteran` | queued rework | queued-rework | base border-hits=64; actions border-hits=144 | 32.3..41.2 x 45.0..46.0 |  |
 | `unit-shu-strategist-field` | queued rework | queued-rework | base border-hits=32; actions border-hits=98 | 38.8..39.3 x 44.7..44.9 |  |
@@ -66,6 +65,7 @@ No next unit is currently defined.
 | `unit-shu-infantry-guard` | approved reference | approved-baseline | technical ok | 27.3..32.1 x 46.0..47.1 |  |
 | `unit-shu-officer` | approved reference | approved-baseline | technical ok | 25.7..32.9 x 46.0..47.1 | `unit-sprite-batch2-shu-officer-spec.md` |
 | `unit-shu-officer-council` | approved reference | approved-baseline | technical ok | 23.5..32.7 x 46.0..47.1 |  |
+| `unit-shu-officer-vanguard` | approved reference | approved-baseline | technical ok | 27.0..36.1 x 44.2..47.1 |  |
 | `unit-shu-spearman` | approved reference | approved-baseline | technical ok | 23.3..42.0 x 43.8..46.3 | `unit-sprite-batch2-shu-spearman-spec.md` |
 | `unit-shu-strategist` | approved reference | approved-baseline | technical ok | 24.9..34.2 x 45.0..46.8 | `unit-sprite-batch2-shu-strategist-spec.md` |
 

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: 45
+- Approved baseline units: 46
 - Pending approval units: 0
-- Queued rework units: 46
+- Queued rework units: 45
 - 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": 45,
-    "queued-rework": 46
+    "approved-baseline": 46,
+    "queued-rework": 45
   },
   "rows": [
     {
@@ -2582,7 +2582,7 @@
     },
     {
       "batch": "batch2-shu",
-      "review_stage": "queued-rework",
+      "review_stage": "approved-baseline",
       "stem": "unit-shu-officer-vanguard",
       "base": {
         "key": "unit-shu-officer-vanguard",
@@ -2592,23 +2592,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 2138098,
-        "border_hits": 64,
-        "min_width": 208,
-        "max_width": 258,
-        "min_height": 282,
-        "max_height": 288,
-        "min_bottom": 281,
-        "max_bottom": 287,
+        "opaque_pixels": 1868580,
+        "border_hits": 0,
+        "min_width": 169,
+        "max_width": 226,
+        "min_height": 277,
+        "max_height": 295,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 50,
-        "height_swing": 6,
-        "bottom_swing": 6,
-        "battle_min_width_px": 33.2,
-        "battle_max_width_px": 41.2,
-        "battle_min_height_px": 45.0,
-        "battle_max_height_px": 46.0,
-        "status": "border-hits=64"
+        "width_swing": 57,
+        "height_swing": 18,
+        "bottom_swing": 0,
+        "battle_min_width_px": 27.0,
+        "battle_max_width_px": 36.1,
+        "battle_min_height_px": 44.2,
+        "battle_max_height_px": 47.1,
+        "status": "ok"
       },
       "actions": {
         "key": "unit-shu-officer-vanguard-actions",
@@ -2618,23 +2618,23 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 4783362,
-        "border_hits": 144,
-        "min_width": 208,
-        "max_width": 267,
-        "min_height": 275,
-        "max_height": 290,
-        "min_bottom": 274,
-        "max_bottom": 289,
+        "opaque_pixels": 4786586,
+        "border_hits": 0,
+        "min_width": 169,
+        "max_width": 277,
+        "min_height": 264,
+        "max_height": 295,
+        "min_bottom": 303,
+        "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 59,
-        "height_swing": 15,
-        "bottom_swing": 15,
-        "battle_min_width_px": 33.2,
-        "battle_max_width_px": 42.7,
-        "battle_min_height_px": 43.9,
-        "battle_max_height_px": 46.3,
-        "status": "border-hits=144"
+        "width_swing": 108,
+        "height_swing": 31,
+        "bottom_swing": 0,
+        "battle_min_width_px": 27.0,
+        "battle_max_width_px": 44.2,
+        "battle_min_height_px": 42.2,
+        "battle_max_height_px": 47.1,
+        "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: 45
-- queued-rework: 46
+- approved-baseline: 46
+- queued-rework: 45
 
 ## Batch Plan
 
@@ -97,7 +97,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 | batch2-shu | approved-baseline | `unit-shu-infantry-guard` | ok | ok | 171..201 x 288..295 | 171..261 x 276..295 | 27.3..32.1 x 46.0..47.1 | w30 h7 b0 |
 | batch2-shu | approved-baseline | `unit-shu-officer` | ok | ok | 161..206 x 288..295 | 161..238 x 282..295 | 25.7..32.9 x 46.0..47.1 | w45 h7 b0 |
 | batch2-shu | approved-baseline | `unit-shu-officer-council` | ok | ok | 147..205 x 288..295 | 147..286 x 276..295 | 23.5..32.7 x 46.0..47.1 | w58 h7 b0 |
-| batch2-shu | queued-rework | `unit-shu-officer-vanguard` | border-hits=64 | border-hits=144 | 208..258 x 282..288 | 208..267 x 275..290 | 33.2..41.2 x 45.0..46.0 | w50 h6 b6 |
+| batch2-shu | approved-baseline | `unit-shu-officer-vanguard` | ok | ok | 169..226 x 277..295 | 169..277 x 264..295 | 27.0..36.1 x 44.2..47.1 | w57 h18 b0 |
 | batch2-shu | approved-baseline | `unit-shu-spearman` | ok | ok | 146..263 x 274..290 | 146..276 x 280..295 | 23.3..42.0 x 43.8..46.3 | w117 h16 b0 |
 | batch2-shu | queued-rework | `unit-shu-spearman-guard` | border-hits=64 | border-hits=144 | 202..258 x 282..288 | 202..267 x 275..290 | 32.3..41.2 x 45.0..46.0 | w56 h6 b6 |
 | batch2-shu | queued-rework | `unit-shu-spearman-veteran` | border-hits=64 | border-hits=144 | 202..258 x 282..288 | 202..267 x 275..290 | 32.3..41.2 x 45.0..46.0 | w56 h6 b6 |

docs/unit-sprite-rework-manifest.json

@@ -43,6 +43,7 @@
     "unit-shu-infantry-guard",
     "unit-shu-officer",
     "unit-shu-officer-council",
+    "unit-shu-officer-vanguard",
     "unit-shu-spearman",
     "unit-shu-strategist",
     "unit-wei-archer",

docs/unit-sprite-shu-officer-vanguard-v2-approval-packet.md

@@ -0,0 +1,36 @@
+# Unit Sprite Approval Packet: unit-shu-officer-vanguard v2
+
+- Status: approved during continuous production run
+- Source art: `docs/handpaint-batch2-shu-officer-vanguard-source-v2.png`
+- Contact sheet: `docs/handpaint-batch2-shu-officer-vanguard-v2-contact.png`
+- Animation GIF: `docs/handpaint-batch2-shu-officer-vanguard-v2-animation.gif`
+- Before/after: `docs/handpaint-batch2-shu-officer-vanguard-v2-before-after.png`
+- Scale compare: `docs/handpaint-batch2-shu-officer-vanguard-v2-scale-compare.png`
+- Browser check: `docs/handpaint-batch2-shu-officer-vanguard-v2-debug-preview-battle-check.png`
+- Current approval board: `docs/unit-sprite-current-approval-board.png`
+- Debug preview URL: `http://127.0.0.1:4173/heros_web/?debug&debugSpritePreview=unit-shu-officer-vanguard&v=shu-officer-vanguard-v2-console-clean`
+
+## Visual Decision
+
+Shu officer vanguard v2 is accepted as an aggressive front-line officer. The saber, heavier armor, and red-brown cloak create a stronger martial silhouette than the council officer without drifting into Guan Yu's polearm profile.
+
+## Technical Checks
+
+- 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`
+- Base bbox width range: `169..226`
+- Base bbox height range: `277..295`
+- Base bottom range: `303..303`
+- Action bbox width range: `169..277`
+- Action bbox height range: `264..295`
+- Action bottom range: `303..303`
+- Local build: `passed`
+- Local browser console errors: `0`
+
+## Notes
+
+v2 tightens the idle height swing while keeping the saber-led action poses readable. The unit remains fully opaque, contained in-frame, and distinct from both the council officer and generic officer at 50px tactical scale.