# ISIS v2 Environment Tileset Pack Side-by-Side Comparison Tools

Generated: 2026-02-28T13:13:38.824Z Checklist: `MXA-0174` (ISIS2-00372) Asset
Family: `environment-tileset-pack` Phase: Phase 4 | Milestone: M3 Launch
(2026-07-27 to 2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for environment-tileset-pack
outputs with profile-aware workflow filtering, recommended dimension presets,
and
tileset/biome/style/topology/material/lighting/continuity/control/reference/seed
scoring layered over generic style/identity consistency checks.

## Comparison Profile Modes

- `auto`
- `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`

## Environment-Specific Metrics

- `Environment Tileset Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Tileset Theme Match`: present
- `Biome Context Match`: present
- `Architectural Style Match`: present
- `Tile Set Scope Match`: present
- `Tileable Axes Match`: present
- `Seam Blend Strategy Match`: present
- `Edge Transition Profile Match`: present
- `Atlas Layout Match`: present
- `Texel Density Class Match`: present
- `Material Response Profile Match`: present
- `Lighting Reference Match`: present
- `Color Palette Profile Match`: present
- `Style Preset Match`: present
- `Scene Profile Match`: present
- `Style Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Control Toggle Alignment`: present
- `Reference Toggle Alignment`: present
- `Style Lock 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     |
| environment-tileset-pack-comparison-utils | `isEnvironmentTilesetPackOutput`                            | yes     |
| environment-tileset-pack-comparison-utils | `buildEnvironmentTilesetPackComparisonContext`              | yes     |
| environment-tileset-pack-comparison-utils | `resolveEnvironmentTilesetPackComparisonProfileFromOutputs` | yes     |
| environment-tileset-pack-comparison-utils | `buildEnvironmentTilesetPackConsistencyReport`              | 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/environment-tileset-pack-comparison-utils.spec.ts src/pages/environment-concept-art-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts src/pages/OutputComparisonWorkspacePage.spec.tsx src/pages/creature-concept-art-comparison-utils.spec.ts src/pages/npc-crowd-variation-pack-comparison-utils.spec.ts src/pages/character-prop-interaction-sheet-comparison-utils.spec.ts src/pages/character-costume-variant-pack-comparison-utils.spec.ts src/pages/character-expression-sheet-comparison-utils.spec.ts src/pages/character-turnaround-sheet-comparison-utils.spec.ts src/pages/character-concept-art-comparison-utils.spec.ts`
- `pnpm --filter @isis/web exec vite build`

## Acceptance Criteria

- Comparison workspace supports explicit profile selection (`auto`, `general`,
  `environment-tileset-pack`) with query-string persistence.
- Environment tileset pack profile exposes recommended comparison dimensions and
  narrows selectable outputs to relevant workflow-family candidates.
- Environment tileset pack side-by-side report adds
  tileset/biome/style/topology/material/lighting/continuity/control/reference/style-lock/seed
  metrics in addition to base consistency metrics.
- Web tests validate profile URL state, specialized metric rendering, mismatch
  guarding, and preset dimension behavior for environment tileset pack
  comparison workflows.

## Traceability

- Checklist item: `MXA-0174`
- Ticket key: `ISIS2-00372`
- Source TODO: `ISIS_TODOS_2.md`

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_ENVIRONMENT_TILESET_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/environment-tileset-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/environment-tileset-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
