# ISIS v2 Material PBR Pack Side-by-Side Comparison Tools

Generated: 2026-08-02T16:03:35.218Z Checklist: `MXA-0336` (ISIS2-00534) Asset
Family: `material-pbr-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for material-pbr-pack outputs
with profile-aware workflow filtering, recommended dimension presets, and
material
category/subtype/surface-age/albedo/roughness/metallic/normal/microdetail/macro-scale/tileability/uv/displacement/light/platform/render/color/family/style/continuity/control/reference/channel-pack/seam-suppression/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`

## Material PBR Pack-Specific Metrics

- `Material PBR Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Material Category Match`: present
- `Material Subtype Match`: present
- `Surface Age Profile Match`: present
- `Albedo Palette Profile Match`: present
- `Roughness Profile Match`: present
- `Metallic Profile Match`: present
- `Normal Intensity Profile Match`: present
- `Microdetail Profile Match`: present
- `Macro Pattern Scale Match`: present
- `Tileability Mode Match`: present
- `UV Repeat Target Match`: present
- `Displacement Intent Match`: present
- `Render Lighting Context Match`: present
- `Platform Target Match`: present
- `Render Intent Match`: present
- `Color Script Match`: present
- `Material Finish Preset Match`: present
- `Material Control Preset Match`: present
- `Material Scene Profile Match`: present
- `Style Profile Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Locked Dimensions Match`: present
- `Lens Profile Match`: present
- `Texture Resolution Tier Match`: present
- `Channel Pack Profile Match`: present
- `Seam Suppression Profile Match`: present
- `Control Toggle Alignment`: present
- `Control Strength Alignment`: present
- `Reference Toggle Alignment`: present
- `Reference Strength Alignment`: present
- `Style Lock Alignment`: present
- `Continuity Lock Strength 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     |
| material-pbr-pack-comparison-utils | `isMaterialPbrPackOutput`                            | yes     |
| material-pbr-pack-comparison-utils | `buildMaterialPbrPackComparisonContext`              | yes     |
| material-pbr-pack-comparison-utils | `resolveMaterialPbrPackComparisonProfileFromOutputs` | yes     |
| material-pbr-pack-comparison-utils | `buildMaterialPbrPackConsistencyReport`              | 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/material-pbr-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 "material-pbr-pack"`

## Acceptance Criteria

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

## Traceability

- Checklist item: `MXA-0336`
- Ticket key: `ISIS2-00534`
- Source TODO: `ISIS_TODOS_2.md`

## References

- `docs/domains/isis/remediation-v2/ISIS_REMEDIATION_V2_TICKETS.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_PACK_REQUIREMENTS_BRIEF.json`
- `docs/domains/isis/remediation-v2/ISIS_V2_MATERIAL_PBR_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/material-pbr-pack-comparison-utils.ts`
- `apps/isis/web/src/pages/material-pbr-pack-comparison-utils.spec.ts`
- `ISIS_TODOS_2.md`
