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

Generated: 2026-03-01T23:05:29.142Z Checklist: `MXA-0354` (ISIS2-00552) Asset
Family: `decal-pack` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for decal-pack outputs with
profile-aware workflow filtering, recommended dimension presets, and decal
subject/category/style/silhouette/edge/wear/substrate/adhesion/transparency/print/contrast/roughness/metallic/normal/tileability/scale/palette/platform/render/style/control/continuity/reference/resolution/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`

## Decal Pack-Specific Metrics

- `Decal Pack Family Match`: present
- `Workflow Variant Alignment`: present
- `Decal Subject Match`: present
- `Decal Category Match`: present
- `Decal Style Family Match`: present
- `Silhouette Profile Match`: present
- `Edge Treatment Match`: present
- `Wear Profile Match`: present
- `Substrate Target Match`: present
- `Adhesion Context Match`: present
- `Transparency Mode Match`: present
- `Print Process Match`: present
- `Contrast Target Match`: present
- `Roughness Profile Match`: present
- `Metallic Profile Match`: present
- `Normal Intensity Profile Match`: present
- `Tileability Mode Match`: present
- `Scale Class Match`: present
- `Color Palette Profile Match`: present
- `Platform Target Match`: present
- `Render Intent Match`: present
- `Checkpoint ID Match`: present
- `Prompt Template ID Match`: present
- `Style Profile Match`: present
- `Color Script Match`: present
- `Lens Profile Match`: present
- `Style Preset Match`: present
- `Decal Control Preset Match`: present
- `Decal Finish Preset Match`: present
- `Decal Scene Profile Match`: present
- `Decal Scale Reference Match`: present
- `Continuity Profile Match`: present
- `Continuity Revision Match`: present
- `Continuity Locked Dimensions 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
- `Resolution Alignment`: present
- `Sampler Settings 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     |
| decal-pack-comparison-utils   | `isDecalPackOutput`                            | yes     |
| decal-pack-comparison-utils   | `buildDecalPackComparisonContext`              | yes     |
| decal-pack-comparison-utils   | `resolveDecalPackComparisonProfileFromOutputs` | yes     |
| decal-pack-comparison-utils   | `buildDecalPackConsistencyReport`              | 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/decal-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 "decal-pack"`

## Acceptance Criteria

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

## Traceability

- Checklist item: `MXA-0354`
- Ticket key: `ISIS2-00552`
- Source TODO: `ISIS_TODOS_2.md`

## References

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