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#
autogeneralarchitecture-kitbash-packinterior-scene-packprop-pack-generalenvironment-tileset-packenvironment-matte-paintingenvironment-concept-artcreature-concept-artcharacter-concept-artcharacter-turnaround-sheetcharacter-expression-sheetcharacter-costume-variant-packcharacter-prop-interaction-sheetnpc-crowd-variation-packweapon-packvehicle-exterior-packvehicle-interior-packui-icon-packhud-element-packmaterial-pbr-packdecal-packterrain-heightmap-pack
Terrain Side-by-Side Metrics#
Terrain Heightmap Pack Family Match: presentWorkflow Variant Alignment: presentTerrain Theme Match: presentBiome Context Match: presentMacro Landform Profile Match: presentTerrain Scope Match: presentTileable Axes Match: presentSeam Blend Strategy Match: presentRidge Transition Profile Match: presentHeightmap Resolution Class Match: presentHeightfield Density Class Match: presentErosion Material Profile Match: presentHydrology Profile Match: presentColor Palette Profile Match: presentHeight Output Mode Match: presentElevation Range Profile Match: presentPrompt Template Match: presentStyle Profile Match: presentColor Script Match: presentLens Profile Match: presentScene Profile Match: presentContinuity Profile Match: presentContinuity Revision Match: presentContinuity Dimensions Match: presentControl Toggle Alignment: presentControl Strength Alignment: presentReference Toggle Alignment: presentReference Strength Alignment: presentStyle Lock Alignment: presentLock Strength Alignment: presentFocal Length Alignment: presentResolution Alignment: presentSampler Alignment: presentSeed 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.tspnpm --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