Update AGENTS commit guidance

.gitignore

@@ -309,6 +309,8 @@ public/icons/*
 !public/icons/items/**
 !public/icons/buildables/
 !public/icons/buildables/**
+!public/icons/npcs/
+!public/icons/npcs/**
 # Ignore Python scripts
 /*.py
 

AGENTS.md

@@ -5,6 +5,7 @@
   - repo-owned curated ability icons under `public/icons/abilities/` (typically via `npm run refresh:db-assets`)
   - repo-owned curated item icons under `public/icons/items/` (typically via `npm run refresh:db-assets`)
   - repo-owned curated buildable portrait icons under `public/icons/buildables/` (typically via `npm run refresh:db-assets`)
+  - repo-owned curated NPC/V Blood portrait icons under `public/icons/npcs/` when backed by `data/enrichment/npc-portrait-map.json` and materialized via `npm run refresh:db-assets`
   - approved Data Base branding assets under `static/database-assets/`, with provenance recorded in that folder
   - unchanged current-wiki branding and homepage artwork under `static/wiki-assets/`, sourced from `Odjit/VRising-Mod-Wiki` on branch `explore/theme-revamp`
   - accepted visual review baselines under `tests/visual/baselines/`

data/enrichment/asset-dump-lock.json

@@ -10,7 +10,7 @@
   "texturePngCount": 12329,
   "stunlockIconPngCount": 2139,
   "textureAggregateSha256": "1D53084D1431B65D95FF5905ECC03D4BF8C36AD5392F69222E7AD3FB26B90734",
-  "materializedPublicIconCount": 780,
+  "materializedPublicIconCount": 830,
   "materializedIcons": {
     "public/icons/abilities/Stunlock_Icon_Ability_Spell_Blood_BloodFontain.png": "BF1F67BC06652D4E1B82EEB4E3597ED3E770D77636CC78CED20AD36E70FFA7AB",
     "public/icons/abilities/Stunlock_Icon_Ability_Spell_Blood_BloodRage.png": "D1BD9EA8448FF1FE75FE581ACB89D335E7A6E716543F9049563CA57A8F38D99F",
@@ -791,6 +791,56 @@
     "public/icons/items/Stunlock_Icon_Weapon_Sword_Unique_T08_Variation01.png": "0F62CFE0A6EC72C3A44555B6C088CAF855A10E6F3F59D4AB294514AC03496E33",
     "public/icons/items/Stunlock_Icon_Weapon_Twinblades_Unique_T08_Variation01.png": "5CC2D36DBA1233BFD10D1B8AD60E06281350B4E597F8C93DE8749176B94C4467",
     "public/icons/items/Stunlock_Icon_Whip_Unique_Variation01_Shattered.png": "BCF8106CF440543F3499086EBD859BFA0B0F496570D822748E97773087A6556B",
-    "public/icons/items/Stunlock_Icon_Whip_Unique_Variation01.png": "07695CAF0BED9CE85ADC61AED8FB6CDD7057781D0AF767D49490608F11BF1B1E"
+    "public/icons/items/Stunlock_Icon_Whip_Unique_Variation01.png": "07695CAF0BED9CE85ADC61AED8FB6CDD7057781D0AF767D49490608F11BF1B1E",
+    "public/icons/npcs/CHAR_ArchMage_VBlood_HeadPortrait.png": "08DAAA492AD2532EE0B526BEFC10FAC2F8139DDDA3EF19CD86BB74E5F373DA26",
+    "public/icons/npcs/CHAR_Bandit_Bomber_VBlood_HeadPortrait.png": "5C1C15AF63EFEEC4489E14E58945E7609004DF2B2E8F206C0B25594EBD15E5ED",
+    "public/icons/npcs/CHAR_Bandit_Foreman_VBlood_HeadPortrait.png": "3EA4AA3D4D2D68437CBB6BFE9218CE78F403659ABF5BF8A93BDD8F2EB259B723",
+    "public/icons/npcs/CHAR_Bandit_Stalker_VBlood_HeadPortrait.png": "B603B52F7B773EA0C3E6AF5CB22D1037319D07DA068F09918E41BF1FFB8110B3",
+    "public/icons/npcs/CHAR_Bandit_Tourok_VBlood_HeadPortrait.png": "4C585D8B2E12AC30E3544C59A7C103AF44B3A667625103A93FAD9C6F538C9CDC",
+    "public/icons/npcs/CHAR_BatVampire_VBlood_HeadPortrait.png": "5AD6FFE4B48E8281551CAE596C7A049060B7BA38A48368D6094E075ABE529260",
+    "public/icons/npcs/CHAR_Militia_Guard_VBlood_HeadPortrait.png": "18B16F1CD17894C0A0F07337A419372B81AD80F9CF1D13C395AB399B415AAE33",
+    "public/icons/npcs/CHAR_Militia_Leader_VBlood_HeadPortrait.png": "3C778CA10412DC8C777C20650FCF82A86152D41DE0EC04E9310AF1E14997C2C1",
+    "public/icons/npcs/CHAR_Vermin_DireRat_VBlood_HeadPortrait.png": "71970D94D378AAE945F08D77F032C597F21DFE6DDE3BF7CD1B2CFF68EFE57940",
+    "public/icons/npcs/Portrait_Large_Normal_AlphaWolf.png": "AE1D98E48C0B72EB9ABD79C1FE5C8A09CF7CB7E022CF00BF987274527C196B0C",
+    "public/icons/npcs/Portrait_Large_Normal_ArenaChampion.png": "4FDD6FBAAEB8DB110BC7BA2F615FBDFC8DE3046E21DB75786351E926D42B2EDD",
+    "public/icons/npcs/Portrait_Large_Normal_AzarielSunbringer.png": "352D8295767C08929B352532566DC8FFF6324731D444B619607DF21092CB1F84",
+    "public/icons/npcs/Portrait_Large_Normal_BeatriceTailor.png": "049033227B1646D6A767CB985CEA29086F289AE0E5D5E57DB66DF2D9CAA69E01",
+    "public/icons/npcs/Portrait_Large_Normal_BloodCommander.png": "FB33348E40C5F9730285D58D4777EB4308ABAA7615C8278ABADB43E06027759E",
+    "public/icons/npcs/Portrait_Large_Normal_ChristinaSunPriestess.png": "CCCB82FF1D5416E4EB9FF409DE7D32E0EB7E41F29F15F482CF1DFC5DF95AAE2E",
+    "public/icons/npcs/Portrait_Large_Normal_CursedSmith.png": "5F9E5FBC5D46A7B01411AC684FC1F6630B7CF4323D2B7C5066F9F2633F9A356A",
+    "public/icons/npcs/Portrait_Large_Normal_CursedWanderer.png": "758907A728C5B64A357F89C97D22F4667514C13470A5E4B57E0EBAB6C879774C",
+    "public/icons/npcs/Portrait_Large_Normal_Dracula.png": "86360F13B15EC07D2599518EB1A6BF34CB5BDEAE5CC902894CBFFFAC1547E8B3",
+    "public/icons/npcs/Portrait_Large_Normal_DukeBalaton.png": "37902797970CDAD9CB80D1CBE79F177FB7F82BF4F34E5E5138F1BF4D76350061",
+    "public/icons/npcs/Portrait_Large_Normal_ErrolStonebreaker.png": "DC5243DA215E210A1A01C1B221CF79277BE813A750EFE327DCCF079A6551128A",
+    "public/icons/npcs/Portrait_Large_Normal_FerociousBear.png": "311DA62E8F94B6118D729BAE32607FD812B21A7831C1B834D2A6E922A4A990B9",
+    "public/icons/npcs/Portrait_Large_Normal_Fisherman.png": "0C06827ADAEA294F6CFBFD2EDBBAFB51291008C16B83B9C1CDA2C0C996E9B570",
+    "public/icons/npcs/Portrait_Large_Normal_ForgeBinder.png": "7367C0492739E7C4461D5AE0CBED906D454A85EE6CBA4D97DF8FA301191DDEF6",
+    "public/icons/npcs/Portrait_Large_Normal_FoulrotSoultaker.png": "39C8A4EF54A29F009BFC052A5FB881881E0079BB768DC11925EAAF346C1A8EE8",
+    "public/icons/npcs/Portrait_Large_Normal_FrostCommander.png": "667526AF4D028A57252FD0B2D992BBD0D4D5F4583606198AD87D5E1CB139CFAB",
+    "public/icons/npcs/Portrait_Large_Normal_FrostmawMountainTerror.png": "4F36145A249B2333AD6F4C7C986CDA4FE8645FAC4EF250186D546CF393341D9B",
+    "public/icons/npcs/Portrait_Large_Normal_Glassblower.png": "CB9E0D1C0235470FA75C47BC5DDF4683ADC31B0C70F346078D2D5F251BC12277",
+    "public/icons/npcs/Portrait_Large_Normal_GorecrusherBehemoth.png": "D3750FF72B62B1DE6530CF632DA767228801A643A8A5E68EC6213F756C11B76E",
+    "public/icons/npcs/Portrait_Large_Normal_GoreswineRavager.png": "9B4BDEE6F5553935F135AE1A13F3C37A7755D24F5A4C573FD5AA5200A80FADBB",
+    "public/icons/npcs/Portrait_Large_Normal_JadeVampireHunter.png": "B5A0CE78E1FD0C5FDCCCDDB0F5F03CC0139AD3F5BFC3F6D8A1BD3E29B1E2FC4F",
+    "public/icons/npcs/Portrait_Large_Normal_KeelyFrostArcher.png": "754FB41E1A649F0B0BD7946C23D7F25DEE2376B9522C40B90B6F8AE5A20496E0",
+    "public/icons/npcs/Portrait_Large_Normal_LeandraShadowPriestess.png": "5945BB69C7315D5E6F861740FDC8B8EF3784A6234254F52D0728A391AFEC86E5",
+    "public/icons/npcs/Portrait_Large_Normal_LidiaChaosArcher.png": "256EC8EE81B17310A57A104D593D5FFE685F19F65B23D58CA107785DE5E8819F",
+    "public/icons/npcs/Portrait_Large_Normal_MatkaCurseWeaver.png": "A13F8665CC6F851BB5E926D6EA7C54C065F712B9F8DA43F51B96DD2E36517D3D",
+    "public/icons/npcs/Portrait_Large_Normal_MeredithBrightArcher.png": "6F592A7E029AA4B39ED2F57889A59B8BD1DF095B4E601D8AA04CD42C20EBE48C",
+    "public/icons/npcs/Portrait_Large_Normal_MorianStormwingMatriarch.png": "CD53F2495417C396C11F14F468B6058DE7D47693866335A6657A3B79A6FCEAB4",
+    "public/icons/npcs/Portrait_Large_Normal_NicholausFallen.png": "B8C098C805E3634DE4B47A62D875811093E713CC0D417E047B46F1F46C763F45",
+    "public/icons/npcs/Portrait_Large_Normal_Overseer.png": "D25716970EC30CF7593551A1232EEC73464DDDCC1E8A9A35F72BC12DF25AECB5",
+    "public/icons/npcs/Portrait_Large_Normal_PoloraFeywalker.png": "A59ED0303AB3169A6D915F28F9ABA16A65DDC6C89410E0B9A95BAF3B1D8F21E9",
+    "public/icons/npcs/Portrait_Large_Normal_Professor.png": "A7151E9BA5A1D6EE28F42ED346FE7FB4BA1E8575DD7D69F9ECE3B995DF36AF21",
+    "public/icons/npcs/Portrait_Large_Normal_Purifier.png": "182EC3F71BFCA1786CAA5E59FBC147A7F0116648DE08671CCB49E02CCE8C39A8",
+    "public/icons/npcs/Portrait_Large_Normal_RazielShepherd.png": "E440EE3BA7F4BC2D2B2BBBDAC8AFE0E3FEDB80EE446674466C9A7AE9C1305844",
+    "public/icons/npcs/Portrait_Large_Normal_SolarusImmaculate.png": "67048A66614FF293C0138958AA91E9CD2E27B202CE700F42449D4E580067235F",
+    "public/icons/npcs/Portrait_Large_Normal_Sommelier.png": "0AE6AD617D4BE658808D61D59AE399798ADAD3459AD669F15BF7A5E5901F0FB5",
+    "public/icons/npcs/Portrait_Large_Normal_TerahGeomancer.png": "17E0699BAE5BC1B434F55AA8403CE819F3462CA30DE0CF6BBAB554C04044B960",
+    "public/icons/npcs/Portrait_Large_Normal_TerrorclawOgre.png": "1C3C3682AFB34D096F069A59CCEDF8A3DB4F8EDB13ECE4441FEFC5F47267428D",
+    "public/icons/npcs/Portrait_Large_Normal_TristanVampireHunter.png": "5E6A4FF249B0CACF35AA2B9CB51EFF1D3985990F2A9047910A58F617D2BA37EF",
+    "public/icons/npcs/Portrait_Large_Normal_UndeadGeneral.png": "44B630DAABA6843F04C2F4C6DA3FEDB22341210DC6AD2B4AD248B7DE9D35DE88",
+    "public/icons/npcs/Portrait_Large_Normal_UngoraSpiderQueen.png": "40CD8D2773FCD89E9C8D6669B6B629DB1373EFC61CEF543B4C01C53DCB007FAD",
+    "public/icons/npcs/Portrait_Large_Normal_WingedHorror.png": "CC7FA9EC52613BF0E466D55C2EA023046CE53ED3E121ADC866F2CBE12D595BA9"
   }
 }