# Asset Backlog

This backlog tracks sequential visual asset expansion for story images, portraits,
and unit sheets. Counts are refreshed at the start of each batch, then the batch is
generated, connected, validated, built, flow-tested, committed, and pushed.

## Current Baseline

- Story images: 76 files after Batch 5.
- Portraits: 38 files after Batch 5.
- Unit sheets: 132 files, 66 complete base/action design pairs after Batch 5.
- Target direction:
  - Story: about 5 images per major campaign chapter across 65 campaign stages.
  - Portraits: one portrait for every important `scenario.ts` speaker.
  - Units: 100+ complete unit designs, each with a base 4x4 sheet and an actions 4x4 sheet.

## Batch 1 Priority

Status: complete and ready for build/flow verification.

The first batch targets the most repeated story backgrounds and the highest-frequency
missing portrait speakers.

### Story

- `37-yizhou-luo-road-ambush.png`
- `38-yizhou-luo-road-supply-train.png`
- `39-nanzhong-captures-jungle-net.png`
- `40-nanzhong-captures-river-ford.png`
- `41-wandering-night-camp.png`
- `42-wandering-river-crossing.png`
- `43-northern-qishan-snow-march.png`
- `44-northern-wei-fortress.png`

### Portraits

- `fa-zheng.png`
- `jian-yong.png`
- `pang-tong.png`
- `mi-zhu.png`
- `zhou-yu.png`
- `yi-ji.png`
- `yan-yan.png`

### Units

- `unit-wei-archer-veteran.png` + `unit-wei-archer-veteran-actions.png`
- `unit-wu-cavalry-elite.png` + `unit-wu-cavalry-elite-actions.png`
- `unit-nanman-shaman-ember.png` + `unit-nanman-shaman-ember-actions.png`

## Next Backlog Pool

- Story variants: `story-yizhou`, `story-jingzhou-crisis`,
  `story-fan-castle-flood`, `story-jieting-crisis`, `story-chengdu-surrender`,
  `story-anti-dong`.
- Portraits: `wu-yi.png`, `li-yan.png`, `ma-chao.png`, `gong-zhi.png`,
  `huang-zhong.png`, `cao-cao.png`, `wei-yan.png`, `ma-dai.png`, `meng-huo.png`.
- Units: faction/class variants for Shu, Wei, Wu, Nanman, rebel remnants, and
  named-general alternates until the complete design count reaches 100+.

## Batch 2 Priority

Status: complete and ready for build/flow verification.

### Story

- `45-yizhou-council-at-river.png`
- `46-yizhou-mountain-gate.png`
- `47-jingzhou-crisis-watchtower-alarm.png`
- `48-jingzhou-crisis-refugee-court.png`
- `49-fan-castle-flood-rising-water.png`
- `50-fan-castle-flood-siege-engines.png`
- `51-jieting-crisis-supply-line.png`
- `52-jieting-crisis-mountain-camp.png`
- `53-chengdu-surrender-hall.png`
- `54-anti-dong-hulao-pass.png`

### Portraits

- `wu-yi.png`
- `li-yan.png`
- `ma-chao.png`
- `gong-zhi.png`
- `huang-zhong.png`
- `cao-cao.png`
- `wei-yan.png`
- `meng-huo.png`

### Units

- `unit-shu-infantry-guard.png` + `unit-shu-infantry-guard-actions.png`
- `unit-shu-cavalry-white.png` + `unit-shu-cavalry-white-actions.png`
- `unit-wei-cavalry-iron.png` + `unit-wei-cavalry-iron-actions.png`
- `unit-wu-archer-river.png` + `unit-wu-archer-river-actions.png`

## Batch 3 Priority

Status: complete and ready for build/flow verification.

The early-game unit sheets should be remastered because the newer generated units
have a stronger silhouette, cleaner 4x4 framing, and better action readability.
Keep the existing texture keys so code paths and saved scenarios continue to work.

### Unit Remasters

- `unit-liu-bei.png` + `unit-liu-bei-actions.png`
- `unit-guan-yu.png` + `unit-guan-yu-actions.png`
- `unit-zhang-fei.png` + `unit-zhang-fei-actions.png`
- `unit-rebel.png` + `unit-rebel-actions.png`
- `unit-rebel-archer.png` + `unit-rebel-archer-actions.png`
- `unit-rebel-cavalry.png` + `unit-rebel-cavalry-actions.png`
- `unit-rebel-leader.png` + `unit-rebel-leader-actions.png`

### Remaining Portraits

- None. All currently mapped named speakers have portrait coverage after Batch 4.

## Batch 4 Priority

Status: complete. Image dimensions, unit base/action pairs, `pnpm build`, and `pnpm verify:flow` passed.

This batch finishes the named-speaker portrait backlog, adds portrait variants that
are actually selected in story scenes, and continues expanding high-repeat story
backgrounds and class/faction unit variety.

### Story

- `55-yellow-pursuit-ambush.png`
- `56-yellow-pursuit-village-relief.png`
- `57-wolong-straw-boats.png`
- `58-red-cliffs-wind-prayer.png`
- `59-yiling-baidi-mountain-retreat.png`
- `60-maicheng-isolation-snow-road.png`
- `61-yiling-fire-attack-riverbank.png`
- `62-hanzhong-rain-night-watch.png`
- `63-weishui-northbank-cavalry-screen.png`
- `64-nanzhong-forest-council.png`

### Portraits

- `ma-dai.png`
- `liu-bei-campaign.png`
- `guan-yu-campaign.png`
- `zhang-fei-campaign.png`
- `zhuge-liang-campaign.png`

### Units

- `unit-shu-spearman-veteran.png` + `unit-shu-spearman-veteran-actions.png`
- `unit-wei-strategist-blue.png` + `unit-wei-strategist-blue-actions.png`
- `unit-wu-officer-river.png` + `unit-wu-officer-river-actions.png`
- `unit-nanman-officer-warlord.png` + `unit-nanman-officer-warlord-actions.png`

## Batch 5 Priority

Status: complete. Visual contact sheets, image dimensions, unit base/action pairs,
`pnpm build`, and `pnpm verify:flow` passed. Code connection uses the existing
story, portrait, and unit variant discovery paths.

This batch expands the most repeated story backgrounds, adds variants for major
late-campaign speakers, and strengthens low-variant unit families.

### Story

- `65-yizhou-luo-road-cliff-fortress.png`
- `66-yizhou-luo-road-mountain-scouts.png`
- `67-nanzhong-captures-bamboo-gorge.png`
- `68-nanzhong-captures-river-night-camp.png`
- `69-wandering-market-shelter.png`
- `70-wandering-cold-mountain-pass.png`
- `71-northern-supply-valley.png`
- `72-northern-mountain-war-council.png`
- `73-red-cliffs-chain-smoke.png`
- `74-wolong-river-strategy.png`
- `75-jingzhou-crisis-river-watchtowers.png`
- `76-fan-castle-flood-river-breach.png`

### Portraits

- `zhao-yun-campaign.png`
- `jiang-wei-campaign.png`
- `sima-yi-campaign.png`
- `cao-cao-campaign.png`
- `ma-chao-campaign.png`
- `huang-zhong-campaign.png`
- `wang-ping-campaign.png`

### Units

- `unit-shu-archer-veteran.png` + `unit-shu-archer-veteran-actions.png`
- `unit-shu-strategist-white.png` + `unit-shu-strategist-white-actions.png`
- `unit-wei-officer-iron.png` + `unit-wei-officer-iron-actions.png`
- `unit-wu-infantry-river.png` + `unit-wu-infantry-river-actions.png`
- `unit-rebel-archer-veteran.png` + `unit-rebel-archer-veteran-actions.png`