# ISIS v2 Prop Pack General Side-by-Side Comparison Tools

Generated: 2026-02-28T21:08:29.784Z Checklist: `MXA-0228` (ISIS2-00426) Asset
Family: `prop-pack-general` Phase: Phase 4 | Milestone: M3 Launch (2026-07-27 to
2026-10-30)

## Objective

Deliver side-by-side comparison tools specialized for prop-pack-general outputs
with profile-aware workflow filtering, recommended dimension presets, and prop
category/era/context/scale/layout/material/silhouette/assembly/atlas/texel/finish/light/palette/continuity/control/reference/focal-length/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`

## Prop-Specific Metrics

- `Prop Pack General Family Match`: present
- `Workflow Variant Alignment`: present
- `Prop Category Match`: present
- `Design Era Match`: present
- `Usage Context Match`: present
- `Scale Class Match`: present
- `Asset Set Profile Match`: present
- `Presentation Layout Match`: present
- `Material Family Match`: present
- `Silhouette Profile Match`: present
- `Assembly Condition Match`: present
- `Atlas Layout Match`: present
- `Texel Density Class Match`: present
- `Finish 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
- `Continuity Locked Dimensions Match`: present
- `Control Toggle Alignment`: present
- `Reference Toggle Alignment`: present
- `Style Lock Alignment`: present
- `Focal Length 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     |
| prop-pack-general-comparison-utils | `isPropPackGeneralOutput`                            | yes     |
| prop-pack-general-comparison-utils | `buildPropPackGeneralComparisonContext`              | yes     |
| prop-pack-general-comparison-utils | `resolvePropPackGeneralComparisonProfileFromOutputs` | yes     |
| prop-pack-general-comparison-utils | `buildPropPackGeneralConsistencyReport`              | 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/prop-pack-general-comparison-utils.spec.ts src/pages/output-consistency-utils.spec.ts src/pages/OutputComparisonWorkspacePage.spec.tsx`
- `pnpm --filter @isis/web exec vite build`

## Acceptance Criteria

- Comparison workspace supports explicit prop-pack-general profile selection
  with query-string persistence and auto-detect fallback.
- Prop pack general profile exposes recommended comparison dimensions and
  narrows selectable outputs to prop-pack-general candidates.
- Prop side-by-side report adds prop
  category/era/context/scale/layout/material/silhouette/assembly/atlas/texel/finish/light/palette/continuity/control/reference/focal-length/seed
  metrics in addition to base consistency metrics.
- Web tests validate prop profile URL state, specialized metric rendering,
  mismatch guarding, and preset dimension behavior.

## Traceability

- Checklist item: `MXA-0228`
- Ticket key: `ISIS2-00426`
- Source TODO: `ISIS_TODOS_2.md`

## References

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