Audit equipment icon quality

docs/equipment-icon-quality-audit.md

@@ -0,0 +1,81 @@
+# Equipment Icon Quality Audit
+
+Generated by `scripts/audit-equipment-icon-quality.mjs`.
+
+## Summary
+
+- Catalog items: 23
+- Generated procedural item textures: 23
+- Slots: accessory 7, armor 5, weapon 11
+- Ranks: common 11, treasure 12
+- Texture size: 64px
+- Drawing grid: 28 units scaled 2.29x into the texture
+- Runtime item icon scene: `src/game/scenes/CampScene.ts`
+- Observed runtime display sizes: `14px`, `20px`, `21px`, `22px`, `30px`
+- Direct item texture render sites found: 5
+
+## Main Findings
+
+- Equipment item icons are generated at runtime in `BootScene`, not stored as individual raster images.
+- The 64px textures are drawn from a compact 28-unit source grid, so they are crisp but intentionally simple.
+- Battle combat preview mostly uses the high-resolution `battle-ui-icons` slot frames and item names; per-item textures appear primarily in camp/sortie equipment UI.
+- Treasure/common distinction often relies on UI frame color plus a small palette change, not a strong unique silhouette.
+- Reused helper silhouettes are the strongest quality risk because several different items collapse to the same shape at 14-22px.
+
+## First Improvement Target
+
+- Target: weapon spear/polearm family
+- Item ids: `green-dragon-glaive`, `serpent-spear`, `sky-piercer-halberd`, `iron-spear`, `western-cavalry-spear`
+- Reason: These are high-frequency equipment surfaces and several treasure/common weapons share a thin diagonal shaft silhouette; upgrading this group gives the clearest identity gain in sortie prep and equipment swap screens.
+
+## Follow-Up Targets
+
+- armor silhouettes: `oath-robe`, `reinforced-lamellar`, `cloth-armor`, `lamellar-armor`, `rebel-vest`
+  - Armor and robes are readable but depend on simple triangular torsos and small color accents.
+- accessory charms and tokens: `bravery-token`, `mountain-guide-scroll`, `peach-charm`, `war-manual`, `wind-quiver`, `grain-pouch`, `yellow-scarf-charm`
+  - Accessories are the smallest UI read and several use compact badge-like shapes.
+
+## Highest-Risk Shared Silhouette Groups
+
+| score | signature | slots | ranks | items |
+| ---: | --- | --- | --- | --- |
+| 15 | `drawSpearIcon` | weapon | common, treasure | `serpent-spear`, `iron-spear`, `western-cavalry-spear` |
+| 8 | `drawArmorIcon` | armor | common, treasure | `reinforced-lamellar`, `lamellar-armor` |
+| 8 | `drawCharmIcon` | accessory | common, treasure | `peach-charm`, `yellow-scarf-charm` |
+| 8 | `drawPolearmIcon` | weapon | treasure | `green-dragon-glaive`, `sky-piercer-halberd` |
+| 8 | `drawRobeIcon` | armor | common, treasure | `oath-robe`, `cloth-armor` |
+
+## Full Item Inventory
+
+| item id | slot | rank | draw helpers | calls | primitives | colors | concerns |
+| --- | --- | --- | --- | ---: | ---: | ---: | --- |
+| `green-dragon-glaive` | weapon | treasure | `drawPolearmIcon` | 1 | 11 | 2 | single helper silhouette<br>low primitive detail |
+| `serpent-spear` | weapon | treasure | `drawSpearIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `sky-piercer-halberd` | weapon | treasure | `drawPolearmIcon` | 1 | 11 | 2 | single helper silhouette<br>low primitive detail |
+| `twin-oath-blades` | weapon | treasure | `drawSwordIcon`<br>`drawSwordIcon` | 2 | 32 | 3 | none |
+| `white-feather-fan` | weapon | treasure | `drawFanIcon` | 1 | 19 | 2 | single helper silhouette |
+| `iron-spear` | weapon | common | `drawSpearIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `leader-axe` | weapon | common | `drawAxeIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `short-bow` | weapon | common | `drawBowIcon` | 1 | 18 | 2 | single helper silhouette |
+| `training-sword` | weapon | common | `drawSwordIcon` | 1 | 16 | 2 | single helper silhouette<br>low primitive detail |
+| `western-cavalry-spear` | weapon | common | `drawSpearIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `yellow-turban-saber` | weapon | common | `drawSaberIcon` | 1 | 12 | 2 | single helper silhouette<br>low primitive detail |
+| `oath-robe` | armor | treasure | `drawRobeIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `reinforced-lamellar` | armor | treasure | `drawArmorIcon` | 1 | 12 | 2 | single helper silhouette<br>low primitive detail |
+| `cloth-armor` | armor | common | `drawRobeIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `lamellar-armor` | armor | common | `drawArmorIcon` | 1 | 12 | 2 | single helper silhouette<br>low primitive detail |
+| `rebel-vest` | armor | common | `drawVestIcon` | 1 | 4 | 2 | single helper silhouette<br>low primitive detail |
+| `bravery-token` | accessory | treasure | `drawTokenIcon` | 1 | 4 | 2 | single helper silhouette<br>low primitive detail |
+| `mountain-guide-scroll` | accessory | treasure | `drawMapScrollIcon` | 1 | 13 | 2 | single helper silhouette<br>low primitive detail |
+| `peach-charm` | accessory | treasure | `drawCharmIcon` | 1 | 4 | 2 | single helper silhouette<br>low primitive detail |
+| `war-manual` | accessory | treasure | `drawBookIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `wind-quiver` | accessory | treasure | `drawQuiverIcon` | 1 | 8 | 2 | single helper silhouette<br>low primitive detail |
+| `grain-pouch` | accessory | common | `drawPouchIcon` | 1 | 7 | 2 | single helper silhouette<br>low primitive detail |
+| `yellow-scarf-charm` | accessory | common | `drawCharmIcon` | 1 | 4 | 2 | single helper silhouette<br>low primitive detail |
+
+## Recommended Next Batch Definition
+
+- Scope: replace or enrich the five spear/polearm weapon icons while keeping `item-${itemId}` texture keys stable.
+- Success criteria: each item reads as a distinct weapon silhouette at 20px and 30px, with treasure weapons visibly richer than common weapons.
+- Keep the existing 64px texture size unless a UI-wide equipment icon pass is planned.
+- Add before/after contact sheets and verify the sortie equipment list and equipment swap panel in a desktop browser.