Strengthen Huang Quan quartermaster identity

docs/propfix-huang-quan-v4-report.md

@@ -0,0 +1,34 @@
+# Huang Quan Quartermaster v4 report
+
+- source: `propfix-huang-quan-v4-source.png`
+- base status: ok
+- action status: ok
+- base partial alpha: 0, opaque pixels: 2173988
+- action partial alpha: 0, opaque pixels: 4428440
+- base frame border hits: 0
+- action frame border hits: 0
+- base empty frames: 0
+- action empty frames: 0
+- base bbox width range: 179..200
+- base bbox height range: 282..288
+- base bottom range: 303..303
+- action bbox width range: 147..211
+- action bbox height range: 282..290
+- action bottom range: 303..303
+- contact: `propfix-huang-quan-v4-contact.png`
+- animation: `propfix-huang-quan-v4-animation.gif`
+- before/after: `propfix-huang-quan-v4-before-after.png`
+- scale compare: `propfix-huang-quan-v4-scale-compare.png`
+- battle composite: `propfix-huang-quan-v4-battle-composite.png`
+- local browser check: `propfix-huang-quan-v4-browser-check.png`
+- deployed browser check: `propfix-huang-quan-v4-prod-browser-check.png`
+- identity check: no white feather fan or large fan read; Huang Quan reads as a Shu logistics quartermaster through supply ledger, ration register, supply-route map board, bamboo tally slips, bronze counting rods, sealed requisition scroll, and document case.
+- readability adjustment: widened the final sheet from the first v4 assembly so the 50px battle read does not feel too thin while preserving the records/map silhouette.
+- validation: `audit-unit-sprite-sheets`, review board render, batch queue, next steps, release approval gate, art quality gate, and workflow consistency all passed.
+- build: `pnpm build` passed.
+- local browser verification: `http://127.0.0.1:4176/heros_web/?debug&debugSpritePreview=unit-huang-quan&v=huang-quan-v4-local-wide`
+- local console errors: 0
+- deploy: `pnpm deploy:nas` passed; deployed to `/volume1/web/heros_web`
+- deployed browser verification: `https://comtropy.synology.me/heros_web/?debug&debugSpritePreview=unit-huang-quan&v=huang-quan-v4-prod-wide`
+- deployed console errors: 0
+- note: battle composite is a scale review image; gameplay roster is unchanged during sample approval

docs/strategist-character-direction.md

@@ -16,7 +16,7 @@ Zhuge Liang owns the large white feather fan and white-robed sage read. Other st
 | `unit-fa-zheng` | cold legal strategist | deep green, charcoal, muted gold | map board, tally baton, command slips | sage-white costume |
 | `unit-sima-yi` | black court conspirator | black, gray, dark violet | command tablet, sealed order, small dark fan | white fan, pale robe |
 | `unit-yi-ji` | envoy and letter carrier | cream-tan, muted green, brown | sealed letter, bamboo slips, travel scroll | feather fan |
-| `unit-huang-quan` | quartermaster official | blue, dark teal, muted gold | map board, records, baton | white fan |
+| `unit-huang-quan` | Shu logistics quartermaster | blue, dark teal, muted gold | supply ledger, ration register, supply-route map board, tally slips, sealed requisition scroll | white fan |
 | `unit-shu-strategist` | Shu field tactician | olive, tan, dark green | brush, bamboo slips, compact map | white-robed sage silhouette |
 | `unit-shu-strategist-field` | frontline staff officer | green, leather brown, brass | field map, short baton, scroll case | large sleeves and white fan |
 | `unit-shu-strategist-white` | pale-robed civil aide | warm tan, muted jade, limited cream | paper bundle, brush case, small tablet | Zhuge-style white robe/fan pairing |
@@ -32,7 +32,7 @@ Zhuge Liang owns the large white feather fan and white-robed sage read. Other st
 
 ## Next Representative Fixes
 
-1. `unit-huang-quan`: verify the quartermaster official stays records/map focused without a fan read.
+No representative strategist prop fixes remain after the Huang Quan quartermaster pass.
 
 Completed representative pass:
 
@@ -45,5 +45,6 @@ Completed representative pass:
 - `unit-wei-strategist-black`: changed from white-fan black strategist to generic Wei covert adviser with black command tablet, sealed military order, iron tally baton, lacquer case, and compact war ledger.
 - `unit-wei-strategist-blue`: changed from white-fan blue strategist to Wei records officer with map scroll, registry book, bamboo-slip ledger, bronze command tablet, and document case.
 - `unit-sima-yi`: strengthened from generic dark strategist to named Wei court conspirator with tall black court crown, black lacquer command tablet, sealed military order, dark decree scroll, bronze tally baton, and narrow command rod.
+- `unit-huang-quan`: strengthened from generic quartermaster official to Shu logistics quartermaster with supply ledger, ration register, supply-route map board, bamboo tally slips, bronze counting rods, sealed requisition scroll, and wooden document case.
 
 Every representative fix should include contact sheet, animation GIF, battle preview, before/after, alpha audit, build, and browser check.

docs/strategist-prop-audit.md

@@ -22,7 +22,7 @@ Detailed per-unit visual direction lives in `strategist-character-direction.md`.
 | `unit-sima-yi` | black lacquer command tablet, sealed military order, dark decree scroll, bronze tally baton, narrow command rod | fan removed; named Wei court conspirator identity strengthened | fixed in representative pass |
 | `unit-fa-zheng` | campaign map board, command slips, tally baton | fan removed | fixed in batch 1 |
 | `unit-yi-ji` | letter, bamboo slips, scroll | distinct civil envoy | keep |
-| `unit-huang-quan` | bamboo slips, map board, baton | distinct quartermaster official | keep |
+| `unit-huang-quan` | supply ledger, grain-ration register, supply-route map board, bamboo tally slips, bronze counting rods, sealed requisition scroll, wooden document case | no white fan; distinct Shu logistics quartermaster identity strengthened | fixed in representative pass |
 | `unit-shu-strategist` | writing brush, bamboo slips, compact field map | white feather fan removed | fixed in batch 1 |
 | `unit-shu-strategist-field` | folded field map, short baton, bamboo slips, leather scroll case, order pouch | white fan and sage-white read removed; frontline staff officer identity restored | fixed in representative pass |
 | `unit-shu-strategist-white` | muted jade civil aide, document bundle, brush case, bamboo-slip ledger | white robe/fan pairing removed; Shu administrative aide identity restored | fixed in representative pass |
@@ -48,6 +48,6 @@ The first correction batch changes:
 
 Next representative cleanup order:
 
-1. `unit-huang-quan`
+No representative strategist cleanup remains.
 
-Later cleanup should remove white-feather-fan reads from remaining generic strategist variants after the representative fixes are verified.
+Later cleanup should re-audit new strategist variants if additional units are added.

docs/unit-sprite-batch-queue.json

@@ -1236,10 +1236,10 @@
           "baseStatus": "ok",
           "actionStatus": "ok",
           "battleBasePx": [
-            28.9,
-            34.8,
-            46.3,
-            46.3
+            28.6,
+            31.9,
+            45.0,
+            46.0
           ],
           "spec": null
         },

docs/unit-sprite-batch-queue.md

@@ -164,7 +164,7 @@ No next unit is currently defined.
 | `unit-cao-cao` | approved reference | approved-baseline | technical ok | 32.9..36.4 x 46.3..47.3 |  |
 | `unit-fa-zheng` | approved reference | approved-baseline | technical ok | 24.3..39.9 x 45.0..47.0 |  |
 | `unit-gong-zhi` | approved reference | approved-baseline | technical ok | 33.2..35.5 x 46.3..46.3 |  |
-| `unit-huang-quan` | approved reference | approved-baseline | technical ok | 28.9..34.8 x 46.3..46.3 |  |
+| `unit-huang-quan` | approved reference | approved-baseline | technical ok | 28.6..31.9 x 45.0..46.0 |  |
 | `unit-huang-zhong` | approved reference | approved-baseline | technical ok | 27.2..36.3 x 46.3..47.3 |  |
 | `unit-jiang-wei` | approved reference | approved-baseline | technical ok | 23.2..42.5 x 45.4..46.5 |  |
 | `unit-li-yan` | approved reference | approved-baseline | technical ok | 27.2..41.9 x 45.7..46.3 |  |

docs/unit-sprite-rework-audit.json

@@ -254,22 +254,22 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 2387940,
+        "opaque_pixels": 2173988,
         "border_hits": 0,
-        "min_width": 181,
-        "max_width": 218,
-        "min_height": 290,
-        "max_height": 290,
+        "min_width": 179,
+        "max_width": 200,
+        "min_height": 282,
+        "max_height": 288,
         "min_bottom": 303,
         "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 37,
-        "height_swing": 0,
+        "width_swing": 21,
+        "height_swing": 6,
         "bottom_swing": 0,
-        "battle_min_width_px": 28.9,
-        "battle_max_width_px": 34.8,
-        "battle_min_height_px": 46.3,
-        "battle_max_height_px": 46.3,
+        "battle_min_width_px": 28.6,
+        "battle_max_width_px": 31.9,
+        "battle_min_height_px": 45.0,
+        "battle_max_height_px": 46.0,
         "status": "ok"
       },
       "actions": {
@@ -280,21 +280,21 @@
           1252
         ],
         "partial_alpha": 0,
-        "opaque_pixels": 5400755,
+        "opaque_pixels": 4428440,
         "border_hits": 0,
-        "min_width": 176,
-        "max_width": 251,
-        "min_height": 284,
+        "min_width": 147,
+        "max_width": 211,
+        "min_height": 282,
         "max_height": 290,
         "min_bottom": 303,
         "max_bottom": 303,
         "empty_frames": 0,
-        "width_swing": 75,
-        "height_swing": 6,
+        "width_swing": 64,
+        "height_swing": 8,
         "bottom_swing": 0,
-        "battle_min_width_px": 28.1,
-        "battle_max_width_px": 40.1,
-        "battle_min_height_px": 45.4,
+        "battle_min_width_px": 23.5,
+        "battle_max_width_px": 33.7,
+        "battle_min_height_px": 45.0,
         "battle_max_height_px": 46.3,
         "status": "ok"
       }

docs/unit-sprite-rework-audit.md

@@ -55,7 +55,7 @@ Visual review boards are generated by `scripts/render-unit-sprite-review-boards.
 | batch7-unique-officer | approved-baseline | `unit-fa-zheng` | ok | ok | 152..250 x 282..294 | 131..231 x 282..294 | 24.3..39.9 x 45.0..47.0 | w98 h12 b0 |
 | batch7-unique-officer | approved-baseline | `unit-gong-zhi` | ok | ok | 208..222 x 290..290 | 196..287 x 270..290 | 33.2..35.5 x 46.3..46.3 | w14 h0 b0 |
 | batch1-approved-core | approved-baseline | `unit-guan-yu` | ok | ok | 190..270 x 276..291 | 172..296 x 171..289 | 30.4..43.1 x 44.1..46.5 | w80 h15 b4 |
-| batch7-unique-officer | approved-baseline | `unit-huang-quan` | ok | ok | 181..218 x 290..290 | 176..251 x 284..290 | 28.9..34.8 x 46.3..46.3 | w37 h0 b0 |
+| batch7-unique-officer | approved-baseline | `unit-huang-quan` | ok | ok | 179..200 x 282..288 | 147..211 x 282..290 | 28.6..31.9 x 45.0..46.0 | w21 h6 b0 |
 | batch7-unique-officer | approved-baseline | `unit-huang-zhong` | ok | ok | 170..227 x 290..296 | 170..246 x 270..296 | 27.2..36.3 x 46.3..47.3 | w57 h6 b0 |
 | batch7-unique-officer | approved-baseline | `unit-jiang-wei` | ok | ok | 145..266 x 284..291 | 142..261 x 261..291 | 23.2..42.5 x 45.4..46.5 | w121 h7 b0 |
 | batch7-unique-officer | approved-baseline | `unit-li-yan` | ok | ok | 170..262 x 286..290 | 190..259 x 286..290 | 27.2..41.9 x 45.7..46.3 | w92 h4 b0 |