# ISIS v2 Foliage Pack Side-by-Side Comparison Tools

Generated: 2026-03-02T06:03:49.184Z Checklist: `MXA-0390` (ISIS2-00588) Asset
Family: `foliage-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for foliage-pack outputs with
profile-aware workflow filtering, recommended dimension presets, and
foliage/biome/canopy/species/density/wind/seasonality/tiling/seam/resolution/palette/specular/bark/lod/template/style/scene/continuity/control/reference/lock/lens/focal-length/sampler/seed
scoring layered over generic style/identity consistency checks.

## Comparison Profile Modes

- `auto`
- `general`
- `architecture-kitbash-pack`
- `interior-scene-pack`
- `prop-pack-general`
- `environment-tileset-pack`
- `environment-matte-painting`
- `environment-concept-art`
- `creature-concept-art`
- `character-concept-art`
- `character-turnaround-sheet`
- `character-expression-sheet`
- `character-costume-variant-pack`
- `character-prop-interaction-sheet`
- `npc-crowd-variation-pack`
- `weapon-pack`
- `vehicle-exterior-pack`
- `vehicle-interior-pack`
- `ui-icon-pack`
- `hud-element-pack`
- `material-pbr-pack`
- `decal-pack`
- `terrain-heightmap-pack`
- `foliage-pack`

## Foliage Side-by-Side Metrics

- `Foliage Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Foliage Theme Match`: present
- `Biome Context Match`: present
- `Canopy Structure Profile Match`: present
- `Species Mix Profile Match`: present
- `Ground Cover Density Class Match`: present
- `Leaf Cluster Scale Profile Match`: present
- `Stem Branch Complexity Profile Match`: present
- `Wind Response Profile Match`: present
- `Seasonality Profile Match`: present
- `Tiling Mode Match`: present
- `Seam Blend Strategy Match`: present
- `Foliage Resolution Class Match`: present
- `Color Palette Profile Match`: present
- `Leaf Specular Profile Match`: present
- `Branch Bark Profile Match`: present
- `LOD Transition Profile Match`: present
- `Prompt Template Match`: present
- `Style Profile Match`: present
- `Color Script Match`: present
- `Lens Profile Match`: present
- `Scene Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Dimensions Match`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference Strength Alignment`: present
- `Style Lock Alignment`: present
- `Lock Strength Alignment`: present
- `Focal Length Alignment`: present
- `Resolution Alignment`: present
- `Sampler Alignment`: present
- `Seed Alignment`: present

## Implementation Surface

| Group                         | Method/Signal                                    | Present |
| ----------------------------- | ------------------------------------------------ | ------- |
| output-consistency-utils      | `readComparisonWorkspaceStateFromSearch`         | yes     |
| output-consistency-utils      | `buildComparisonWorkspacePath`                   | yes     |
| output-consistency-utils      | `calculateAverageConsistencyScore`               | yes     |
| foliage-pack-comparison-utils | `isFoliagePackOutput`                            | yes     |
| foliage-pack-comparison-utils | `buildFoliagePackComparisonContext`              | yes     |
| foliage-pack-comparison-utils | `resolveFoliagePackComparisonProfileFromOutputs` | yes     |
| foliage-pack-comparison-utils | `buildFoliagePackConsistencyReport`              | yes     |
| OutputComparisonWorkspacePage | `comparisonProfileState`                         | yes     |
| OutputComparisonWorkspacePage | `profileSelectorRendered`                        | yes     |
| OutputComparisonWorkspacePage | `profileOptionRendered`                          | yes     |
| OutputComparisonWorkspacePage | `profilePresetActionRendered`                    | yes     |
| OutputComparisonWorkspacePage | `profileMismatchGuard`                           | yes     |
| OutputComparisonWorkspacePage | `profileAwareMetrics`                            | yes     |

## Verification Commands

- `pnpm --filter @isis/web exec vitest run src/pages/foliage-pack-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts`
- `pnpm --filter @isis/web exec vitest run src/pages/OutputComparisonWorkspacePage.spec.tsx -t "foliage-pack"`

## Acceptance Criteria

- Comparison workspace supports explicit foliage-pack profile selection with
  query-string persistence and auto-detect fallback.
- Foliage-pack profile exposes recommended comparison dimensions and narrows
  selectable outputs to foliage-pack candidates.
- Foliage side-by-side report adds foliage family and foliage
  metadata/control/reference/continuity/lock/focal-length/resolution/sampler/seed
  alignment metrics in addition to base consistency metrics.
- Web tests validate foliage profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Summary

| Metric                | Value |
| --------------------- | ----- |
| Profile modes         | 24    |
| Foliage metrics       | 36    |
| Verification commands | 2     |
| Acceptance criteria   | 4     |
| Spec assertion count  | 90    |

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_FOLIAGE_PACK_WEB_UI_CONTROLS_VALIDATION.json`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.tsx`
- `apps/isis/web/src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `apps/isis/web/src/pages/output-consistency-utils.ts`
- `apps/isis/web/src/pages/output-consistency-utils.spec.ts`
- `apps/isis/web/src/pages/foliage-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/foliage-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`

## Route Coverage

- Workspace route: `/outputs/consistency-workspace`
- Profile option: `foliage-pack`
- Preset action: `Apply Foliage Pack Preset`
- Mismatch guard:
  `Foliage pack profile requires foliage-pack outputs on both sides.`
