# ISIS v2 Terrain Heightmap Pack Side-by-Side Comparison Tools

Generated: 2026-08-02T18:14:05.464Z Checklist: `MXA-0372` (ISIS2-00570) Asset
Family: `terrain-heightmap-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for terrain-heightmap-pack
outputs with profile-aware workflow filtering, recommended dimension presets,
and terrain
theme/biome/landform/scope/tileable/seam/ridge/resolution/density/erosion/hydrology/output-mode/elevation/profile/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`

## Terrain Side-by-Side Metrics

- `Terrain Heightmap Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Terrain Theme Match`: present
- `Biome Context Match`: present
- `Macro Landform Profile Match`: present
- `Terrain Scope Match`: present
- `Tileable Axes Match`: present
- `Seam Blend Strategy Match`: present
- `Ridge Transition Profile Match`: present
- `Heightmap Resolution Class Match`: present
- `Heightfield Density Class Match`: present
- `Erosion Material Profile Match`: present
- `Hydrology Profile Match`: present
- `Color Palette Profile Match`: present
- `Height Output Mode Match`: present
- `Elevation Range 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     |
| terrain-heightmap-pack-comparison-utils | `isTerrainHeightmapPackOutput`                            | yes     |
| terrain-heightmap-pack-comparison-utils | `buildTerrainHeightmapPackComparisonContext`              | yes     |
| terrain-heightmap-pack-comparison-utils | `resolveTerrainHeightmapPackComparisonProfileFromOutputs` | yes     |
| terrain-heightmap-pack-comparison-utils | `buildTerrainHeightmapPackConsistencyReport`              | 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/terrain-heightmap-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 "terrain-heightmap-pack"`

## Acceptance Criteria

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

## Traceability

- Checklist item: `MXA-0372`
- Ticket key: `ISIS2-00570`
- Workspace route: `/outputs/consistency-workspace`
- Primary artifact:
  `docs/domains/isis/remediation-v2/ISIS_V2_TERRAIN_HEIGHTMAP_PACK_SIDE_BY_SIDE_COMPARISON_TOOLS.json`
- Supporting runbook:
  `docs/domains/isis/runbooks/terrain-heightmap-pack-side-by-side-comparison-tools.md`
